View

FieldName	Description	Size	Required	Type	DefaultValue
CODCOLIGADA	Coligada	-1	true	System.Int16	1
CODCFO	Cliente/Fornecedor	25	true	System.String
IDCONTATO	Identificador	-1	true	System.Int32	0
NOME	Nome	50	true	System.String
EMAIL	E-Mail	80	false	System.String
TELEFONE	Telefone	15	false	System.String
RAMAL	Ramal	6	false	System.String
FAX	Fax	15	false	System.String
FUNCAO	Função	50	false	System.String
OBSERVACAO	Observação	80	false	System.String
CODUSUARIO	Cod. Usuário	20	false	System.String	mestre
RUA	Rua	100	false	System.String
NUMERO	Número	8	false	System.String
COMPLEMENTO	Complemento	60	false	System.String
BAIRRO	Bairro	80	false	System.String
CIDADE	Cidade	32	false	System.String
CODETD	Estado	2	false	System.String
CEP	CEP	9	false	System.String
PAIS	País	20	false	System.String
USUARIOALTERACAO	Usuário Alteração	20	false	System.String
DATAALTERACAO	Data de alteração do cadastro	-1	false	System.DateTime
ATIVO	Ativo	-1	false	System.Int16	1
DATANASCIMENTO	Data de Nascimento	-1	false	System.DateTime
DEFAUTPARAEMAIL	Cliente/Fornecedor Default para E-mail	-1	false	System.Int16
CODAPLIC	Código Aplicativo	2	false	System.String	T
CODUSUARIOACESSO	Usuário de acesso	20	false	System.String
RECCREATEDBY	RECCREATEDBY	50	false	System.String
RECCREATEDON	RECCREATEDON	-1	false	System.DateTime
RECMODIFIEDBY	RECMODIFIEDBY	50	false	System.String
RECMODIFIEDON	RECMODIFIEDON	-1	false	System.DateTime
IDINTEGRACAO	IDINTEGRACAO	100	false	System.String

FieldName	Description	Size	Required	Type	DefaultValue
CODCOLIGADA	CODCOLIGADA	-1	true	System.Int16	1
CODCFO	CODCFO	25	true	System.String
IDCONTATO	IDCONTATO	-1	true	System.Int32
RECCREATEDBY	RECCREATEDBY	50	false	System.String
RECCREATEDON	RECCREATEDON	-1	false	System.DateTime
RECMODIFIEDBY	RECMODIFIEDBY	50	false	System.String
RECMODIFIEDON	RECMODIFIEDON	-1	false	System.DateTime
CELULAR	CELULAR	-1	false	System.String

FieldName	Description	Size	Required	Type	DefaultValue
FUNCAO	FUNCAO	-1	false	System.String

Name	ParentTable	ChildTable	ParentColumnName	ChildColumnName
FKFCFOCONTATOCOMPL_FCFOCONTATO	FCFOContato	FCFOContatoCompl	CODCOLIGADA; CODCFO; IDCONTATO	CODCOLIGADA; CODCFO; IDCONTATO

C#
ADVPL
Fluig

ReadView

string recordData;
  
  // Retorna as credenciais para acesso ao WS
  DataClient dataclient = new DataClient(url, contexto,  usuario, senha);
	// lê os dados da visão respeitando o filtro passado
  DataSet ds = dataclient.ReadView("FinCFOContatoDataBR", filtro, out recordData);
  // Pode utilizar o ds tipado para DataSet ou a variável recordData que possui o XML da solicitação 
  MessageBox.Show(recordData);

}

ReadRecord

string recordData;
	  // Retorna as credenciais para acesso ao WS
      DataClient dataclient = new DataClient(url, contexto,  usuario, senha);
	  //O ReadRecord retorna o registro da edição do cadastro RM respeitando a chave primária
	  DataSet ds = dataclient.ReadRecord("FinCFOContatoDataBR", "1;C00001;1", out recordData);
      // Pode utilizar o ds tipado para DataSet ou a variável recordData que possui o XML da solicitação 
	  MessageBox.Show(recordData);
 }

SaveRecord

/* Programa responsável por integrar com os Webservices do RM
 Para executar o programa, seguir os passos abaixo:
    1) Entrar no Visual Studio e criar um "Service References" apontando para 
        http://localhost:8051/wsDataServer/MEX?wsdl   
		Dúvidas? Consulte https://msdn.microsoft.com/pt-br/library/bb628652.aspx 
		                     
        1.1) Nomear o serviço como DataServer          
        1.2) Substituir localhost pelo nome ou IP do servidor que executa o serviço do RM.Host
      Em caso de dúvidas sobre como habilitar o serviço de Webservices do RM, consultar o link abaixo:
http://tdn.totvs.com/pages/releaseview.action?pageId=89620766
   
    2) Adicionar os arquivos abaixo ao seu projeto:
            http://tdn.totvs.com/download/attachments/211064343/Utils.cs
            http://tdn.totvs.com/download/attachments/211064343/DataClient.cs     
        2.1) Ajustar os NameSpace da classe DataClient      
    3) Adicionar referencia a System.Web.HttpUtility
	  Dúvidas? Consulte: https://msdn.microsoft.com/pt-br/library/7314433t(v=vs.90).aspx
*/public void SaveRecord()
 {
	//pode ser o mesmo XML retornado pelo método ReadRecord, alterando os valores que deseja aplicar no BD 
    string xml = @"<FinCFOContatoBR >
  <FCFOContato>
    <CODCOLIGADA>1</CODCOLIGADA>
    <CODCFO>C00001</CODCFO>
    <IDCONTATO>1</IDCONTATO>
    <NOME>Afonso Carlos Ferreira</NOME>
    <EMAIL>afonso@rmexemplo.com.br</EMAIL>
    <TELEFONE>32210546</TELEFONE>
    <RAMAL>3214</RAMAL>
    <FAX>32210535</FAX>
    <FUNCAO>Analista de Sistemas</FUNCAO>
    <ATIVO>1</ATIVO>
    <DEFAUTPARAEMAIL>0</DEFAUTPARAEMAIL>
  </FCFOContato>
  <FCFOContatoCompl>
    <CODCOLIGADA>1</CODCOLIGADA>
    <CODCFO>C00001</CODCFO>
    <IDCONTATO>1</IDCONTATO>
  </FCFOContatoCompl>
  <FuncaoContato>
    <FUNCAO>Administradora de Empresas</FUNCAO>
  </FuncaoContato>
  <FuncaoContato>
    <FUNCAO>Analista de Sistema</FUNCAO>
  </FuncaoContato>
  <FuncaoContato>
    <FUNCAO>Analista de Sistemas</FUNCAO>
  </FuncaoContato>
  <FuncaoContato>
    <FUNCAO>Aux. Técnico</FUNCAO>
  </FuncaoContato>
  <FuncaoContato>
    <FUNCAO>Economista</FUNCAO>
  </FuncaoContato>
  <FuncaoContato>
    <FUNCAO>Engenheiro Civil</FUNCAO>
  </FuncaoContato>
  <FuncaoContato>
    <FUNCAO>Gerente</FUNCAO>
  </FuncaoContato>
  <FuncaoContato>
    <FUNCAO>Gerente de Finanças</FUNCAO>
  </FuncaoContato>
  <FuncaoContato>
    <FUNCAO>Vendedor</FUNCAO>
  </FuncaoContato>
</FinCFOContatoBR>";
	 
    // ajuste o nome o servidor e porta. Em caso de dúvidas, consulte o link abaixo:
	// http://tdn.totvs.com/pages/releaseview.action?pageId=89620766	
	string url = "http://localhost:8051";

//importante passar no contexto o mesmo código de usuário usado para logar no webservice
	string contexto = "CODSISTEMA=G;CODCOLIGADA=1;CODUSUARIO=mestre";

//usuário e senha do aplicativo RM. O mesmo utilizado para logar no sistema e que 
	//tenha permissão de acesso ao cadastro que deseja utilizar
	string usuario = "mestre";
	string senha = "integracao";

// Retorna as credenciais para acesso ao WS
	DataClient dataclient = new DataClient(url, contexto,  usuario, senha);
	 //Salva o registro na base de dados. Executará "Update" caso encontre outro registre que respeite 
	 //a chave primária do dataserver, do contrário, executará "Insert".
	string[] retorno  = dataclient.SaveRecord("FinCFOContatoDataBR", xml);
	
	MessageBox.Show(retorno.ToString());
 }

ReadView

// Programa responsável por integrar com os Webservices do RM
// Para executar o programa, seguir os passos abaixo:
//    1) Adicionar o arquivo abaixo ao seu projeto:
//            http://tdn.totvs.com/download/attachments/211064343/DataClientfluig.js
//     2) Inclua um serviço no Fluig com o nome WSDATASERVER apontando para  
//       http://localhost:8051/wsDataServer/MEX?singlewsdl (substituir localhost pelo IP e Porta do servidor RM)//.

function createDataset(fields, constraints, sortFields)
{
    /* Prepararação das variaveis */

//usuário e senha do aplicativo RM. O mesmo utilizado para logar no sistema e que tenha permissão de   
    //acesso ao cadastro que deseja utilizar  
    var usuario = "mestre";  
    var senha = "integracao";  
    //importante passar no contexto o mesmo código de usuário usado para logar no webservice  
    	
		
		
	var context = "CodUsuario=mestre;CodSistema=F;CodColigada=1"  
    //o filtro pode ser qualquer campo da visão, por exemplo CODCOLIGADA=1 AND CODFILIAL = 1  
    var filtro = "1=1" ;  
    /* Fim Prepararação das variaveis */

var retorno = dcReadView("FinCFOContatoDataBR", context, usuario, senha, filtro)

//Caso deseje utilizar as contraints do formulário
	//var parsedConstraints = parseConstraints(constraints, true);
	//var retorno = authService.readView("FinCFOContatoDataBR", parsedConstraints.filter, parsedConstraints.context, senha, filtro);
	
	
	var xmlResultados = new XML(retorno);

var dataset = DatasetBuilder.newDataset();   
             dataset.addColumn('CODCOLIGADA'); 
             dataset.addColumn('CODCFO'); 
             dataset.addColumn('IDCONTATO'); 
             dataset.addColumn('NOME'); 
             dataset.addColumn('EMAIL'); 
             dataset.addColumn('TELEFONE'); 
             dataset.addColumn('RAMAL'); 
             dataset.addColumn('FAX'); 
             dataset.addColumn('FUNCAO'); 
             dataset.addColumn('OBSERVACAO'); 
             dataset.addColumn('CODUSUARIO'); 
             dataset.addColumn('RUA'); 
             dataset.addColumn('NUMERO'); 
             dataset.addColumn('COMPLEMENTO'); 
             dataset.addColumn('BAIRRO'); 
             dataset.addColumn('CIDADE'); 
             dataset.addColumn('CODETD'); 
             dataset.addColumn('CEP'); 
             dataset.addColumn('PAIS'); 
             dataset.addColumn('USUARIOALTERACAO'); 
             dataset.addColumn('DATAALTERACAO'); 
             dataset.addColumn('ATIVO'); 
             dataset.addColumn('DATANASCIMENTO'); 
             dataset.addColumn('DEFAUTPARAEMAIL'); 
             dataset.addColumn('CODAPLIC'); 
             dataset.addColumn('CODUSUARIOACESSO'); 
             dataset.addColumn('RECCREATEDBY'); 
             dataset.addColumn('RECCREATEDON'); 
             dataset.addColumn('RECMODIFIEDBY'); 
             dataset.addColumn('RECMODIFIEDON'); 
             dataset.addColumn('IDINTEGRACAO'); 
    for(var i = 0; i < xmlResultados.FCFOContato.length(); i++) 
    { 
           dataset.addRow(new Array( 
             xmlResultados.FCFOContato[i].CODCOLIGADA.toString(), 
             xmlResultados.FCFOContato[i].CODCFO.toString(), 
             xmlResultados.FCFOContato[i].IDCONTATO.toString(), 
             xmlResultados.FCFOContato[i].NOME.toString(), 
             xmlResultados.FCFOContato[i].EMAIL.toString(), 
             xmlResultados.FCFOContato[i].TELEFONE.toString(), 
             xmlResultados.FCFOContato[i].RAMAL.toString(), 
             xmlResultados.FCFOContato[i].FAX.toString(), 
             xmlResultados.FCFOContato[i].FUNCAO.toString(), 
             xmlResultados.FCFOContato[i].OBSERVACAO.toString(), 
             xmlResultados.FCFOContato[i].CODUSUARIO.toString(), 
             xmlResultados.FCFOContato[i].RUA.toString(), 
             xmlResultados.FCFOContato[i].NUMERO.toString(), 
             xmlResultados.FCFOContato[i].COMPLEMENTO.toString(), 
             xmlResultados.FCFOContato[i].BAIRRO.toString(), 
             xmlResultados.FCFOContato[i].CIDADE.toString(), 
             xmlResultados.FCFOContato[i].CODETD.toString(), 
             xmlResultados.FCFOContato[i].CEP.toString(), 
             xmlResultados.FCFOContato[i].PAIS.toString(), 
             xmlResultados.FCFOContato[i].USUARIOALTERACAO.toString(), 
             xmlResultados.FCFOContato[i].DATAALTERACAO.toString(), 
             xmlResultados.FCFOContato[i].ATIVO.toString(), 
             xmlResultados.FCFOContato[i].DATANASCIMENTO.toString(), 
             xmlResultados.FCFOContato[i].DEFAUTPARAEMAIL.toString(), 
             xmlResultados.FCFOContato[i].CODAPLIC.toString(), 
             xmlResultados.FCFOContato[i].CODUSUARIOACESSO.toString(), 
             xmlResultados.FCFOContato[i].RECCREATEDBY.toString(), 
             xmlResultados.FCFOContato[i].RECCREATEDON.toString(), 
             xmlResultados.FCFOContato[i].RECMODIFIEDBY.toString(), 
             xmlResultados.FCFOContato[i].RECMODIFIEDON.toString(), 
             xmlResultados.FCFOContato[i].IDINTEGRACAO.toString() 
									))}

// retorna...
	return dataset;

}

ReadRecord

function openZoom(){

var DATASET_ID = "FinCFOContatoDataBR";
	var DATA_FIELDS = "CODCOLIGADA,CODCFO,IDCONTATO,NOME,EMAIL,TELEFONE,RAMAL";
	var RESULT_FIELDS = "CODCOLIGADA,CODCFO,IDCONTATO,NOME,EMAIL,TELEFONE,RAMAL";
	var TYPE = "FinCFOContatoDataBR";
	var TITLE = "Contato do Cli/For";

abrirPesquisa(DATASET_ID, DATA_FIELDS, RESULT_FIELDS, TYPE, TITLE);
}

function setSelectedZoomItem(selectedItem){

if(selectedItem.type == "FinCFOContatoDataBR"){
   	    //usuário e senha do aplicativo RM. O mesmo utilizado para logar no sistema e que tenha permissão de   
		//acesso ao cadastro que deseja utilizar 
		//LEMBRANDO QUE O ABAIXO É APENAS A TITULO DE EXEMPLO E SENHAS NÃO DEVEM FICAR NO CLIENT
		var usuario = "mestre";  
		var senha = "integracao";   
		var context = "CodUsuario=mestre;CodSistema=F;CodColigada=1"  
  
		//Faz a leitura do registro
		var retorno = dcReadRecord("FinCFOContatoDataBR", context, usuario, senha, filtro)  
		//Transforma em XML
	    var xmlResultados = new XML(retorno);
CODCOLIGADA,CODCFO,IDCONTATO,NOME,EMAIL,TELEFONE,RAMAL
	}

}

SaveRecord

function beforeTaskSave(colleagueId,nextSequenceId,userList){
	var NOME_DATASERVER = "FinCFOContatoDataBR";

/* Prepararação das variaveis */
	  //usuário e senha do aplicativo RM. O mesmo utilizado para logar no sistema e que tenha permissão de 
	  //acesso ao cadastro que deseja utilizar
	  var usuario = "mestre";
	  var senha = "integracao";
	  //importante passar no contexto o mesmo código de usuário usado para logar no webservice
	  var context = "CodUsuario=mestre;CodSistema=F;CodColigada=1"
	/* Fim Prepararação das variaveis */

try{
		
        if (isEmpty(hAPI.getCardValue("CODCOLIGADA")) || isEmpty(hAPI.getCardValue("CODCFO")) || isEmpty(hAPI.getCardValue("IDCONTATO")))   
        return    
        var primaryKey = hAPI.getCardValue("CODCOLIGADA") + ";" + hAPI.getCardValue("CODCFO") + ";" + hAPI.getCardValue("IDCONTATO");

// carrega o webservice...
		var authService = getWebService(usuario, senha);
		// define o contexto...
		var context = "CodUsuario=mestre;CodSistema=F;CodColigada=1"
		// faz a leitura...
		var text = new String(authService.readRecord(NOME_DATASERVER, primaryKey, context));

if (!ChekExist(text))
    		text = GetXml();

// atualiza o valor...
        text = replaceValue(text, "CODCOLIGADA" , hAPI.getCardValue("CODCOLIGADA")); 
        text = replaceValue(text, "CODCFO" , hAPI.getCardValue("CODCFO")); 
        text = replaceValue(text, "IDCONTATO" , hAPI.getCardValue("IDCONTATO")); 
        text = replaceValue(text, "NOME" , hAPI.getCardValue("NOME")); 
        text = replaceValue(text, "EMAIL" , hAPI.getCardValue("EMAIL")); 
        text = replaceValue(text, "TELEFONE" , hAPI.getCardValue("TELEFONE")); 
        text = replaceValue(text, "RAMAL" , hAPI.getCardValue("RAMAL")); 
        text = replaceValue(text, "FAX" , hAPI.getCardValue("FAX")); 
        text = replaceValue(text, "FUNCAO" , hAPI.getCardValue("FUNCAO")); 
        text = replaceValue(text, "OBSERVACAO" , hAPI.getCardValue("OBSERVACAO")); 
        text = replaceValue(text, "CODUSUARIO" , hAPI.getCardValue("CODUSUARIO")); 
        text = replaceValue(text, "RUA" , hAPI.getCardValue("RUA")); 
        text = replaceValue(text, "NUMERO" , hAPI.getCardValue("NUMERO")); 
        text = replaceValue(text, "COMPLEMENTO" , hAPI.getCardValue("COMPLEMENTO")); 
        text = replaceValue(text, "BAIRRO" , hAPI.getCardValue("BAIRRO")); 
        text = replaceValue(text, "CIDADE" , hAPI.getCardValue("CIDADE")); 
        text = replaceValue(text, "CODETD" , hAPI.getCardValue("CODETD")); 
        text = replaceValue(text, "CEP" , hAPI.getCardValue("CEP")); 
        text = replaceValue(text, "PAIS" , hAPI.getCardValue("PAIS")); 
        text = replaceValue(text, "USUARIOALTERACAO" , hAPI.getCardValue("USUARIOALTERACAO")); 
        text = replaceValue(text, "DATAALTERACAO" , hAPI.getCardValue("DATAALTERACAO")); 
        text = replaceValue(text, "ATIVO" , hAPI.getCardValue("ATIVO")); 
        text = replaceValue(text, "DATANASCIMENTO" , hAPI.getCardValue("DATANASCIMENTO")); 
        text = replaceValue(text, "DEFAUTPARAEMAIL" , hAPI.getCardValue("DEFAUTPARAEMAIL")); 
        text = replaceValue(text, "CODAPLIC" , hAPI.getCardValue("CODAPLIC")); 
        text = replaceValue(text, "CODUSUARIOACESSO" , hAPI.getCardValue("CODUSUARIOACESSO")); 
        text = replaceValue(text, "RECCREATEDBY" , hAPI.getCardValue("RECCREATEDBY")); 
        text = replaceValue(text, "RECCREATEDON" , hAPI.getCardValue("RECCREATEDON")); 
        text = replaceValue(text, "RECMODIFIEDBY" , hAPI.getCardValue("RECMODIFIEDBY")); 
        text = replaceValue(text, "RECMODIFIEDON" , hAPI.getCardValue("RECMODIFIEDON")); 
        text = replaceValue(text, "IDINTEGRACAO" , hAPI.getCardValue("IDINTEGRACAO"));

var result = new String(authService.saveRecord(NOME_DATASERVER, text, context)); 
		
	// se retornou a chave, salvou ok...
		checkIsPK(result, 3);
	}
	catch (e) 
	{
		if (e == null)	e = "Erro desconhecido!";
		var mensagemErro = "Ocorreu um erro ao salvar dados no RM: " + e;
		throw mensagemErro;
	}	
}

function GetXml()
{
	return "<FinCFOContatoBR >" + 
"  <FCFOContato>" + 
"    <CODCOLIGADA>1</CODCOLIGADA>" + 
"    <CODCFO>C00001</CODCFO>" + 
"    <IDCONTATO>1</IDCONTATO>" + 
"    <NOME>Afonso Carlos Ferreira</NOME>" + 
"    <EMAIL>afonso@rmexemplo.com.br</EMAIL>" + 
"    <TELEFONE>32210546</TELEFONE>" + 
"    <RAMAL>3214</RAMAL>" + 
"    <FAX>32210535</FAX>" + 
"    <FUNCAO>Analista de Sistemas</FUNCAO>" + 
"    <ATIVO>1</ATIVO>" + 
"    <DEFAUTPARAEMAIL>0</DEFAUTPARAEMAIL>" + 
"  </FCFOContato>" + 
"  <FCFOContatoCompl>" + 
"    <CODCOLIGADA>1</CODCOLIGADA>" + 
"    <CODCFO>C00001</CODCFO>" + 
"    <IDCONTATO>1</IDCONTATO>" + 
"  </FCFOContatoCompl>" + 
"  <FuncaoContato>" + 
"    <FUNCAO>Administradora de Empresas</FUNCAO>" + 
"  </FuncaoContato>" + 
"  <FuncaoContato>" + 
"    <FUNCAO>Analista de Sistema</FUNCAO>" + 
"  </FuncaoContato>" + 
"  <FuncaoContato>" + 
"    <FUNCAO>Analista de Sistemas</FUNCAO>" + 
"  </FuncaoContato>" + 
"  <FuncaoContato>" + 
"    <FUNCAO>Aux. Técnico</FUNCAO>" + 
"  </FuncaoContato>" + 
"  <FuncaoContato>" + 
"    <FUNCAO>Economista</FUNCAO>" + 
"  </FuncaoContato>" + 
"  <FuncaoContato>" + 
"    <FUNCAO>Engenheiro Civil</FUNCAO>" + 
"  </FuncaoContato>" + 
"  <FuncaoContato>" + 
"    <FUNCAO>Gerente</FUNCAO>" + 
"  </FuncaoContato>" + 
"  <FuncaoContato>" + 
"    <FUNCAO>Gerente de Finanças</FUNCAO>" + 
"  </FuncaoContato>" + 
"  <FuncaoContato>" + 
"    <FUNCAO>Vendedor</FUNCAO>" + 
"  </FuncaoContato>" + 
"</FinCFOContatoBR>";
	
}

Objetos

Relacionamentos

Source Code

ReadView

ReadRecord

SaveRecord

ReadView

ReadRecord

SaveRecord

ReadView

ReadRecord

SaveRecord