View

FieldName	Description	Size	Required	Type	DefaultValue
CODCOLIGADA	Código da coligada	-1	true	System.Int16	1
CODREPRESENTANTE	Código do representante	15	true	System.String
IDCONTATORPR	Contato do representante	-1	true	System.Int32	0
NOME	Nome	50	false	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
APLICATIVOS	Aplicativos que o representante usa	26	false	System.String
EUSUARIO	É usuário	1	false	System.String
ATIVO	ATIVO	-1	false	System.Int16	1
DATANASCIMENTO	Data de Nascimento	-1	false	System.DateTime
ESTADOCIVIL	ESTADOCIVIL	-1	false	System.String
SEXO	SEXO	-1	false	System.String
RUA	Rua	40	false	System.String
NUMERO	Numero	8	false	System.String
COMPLEMENTO	Complemento	30	false	System.String
BAIRRO	Bairro	30	false	System.String
CODETD	Estado	2	false	System.String
CIDADE	Cidade/Município	32	false	System.String
CEP	CEP	9	false	System.String
CPF	CPF	-1	false	System.String
DATACADASTRO	Data de cadastro	-1	false	System.DateTime	04/09/2023 17:03:02
DATAALTERACAO	Data de alteração	-1	false	System.DateTime
USUARIOALTERACAO	Usuário que efetuou alteração	20	false	System.String
CODUSUARIO	CODUSUARIO	-1	false	System.String	mestre

C#
ADVPL
Fluig

ReadView

/* 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 ReadView()
 {
  // 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";
  
  //o filtro pode ser qualquer campo da visão, por exemplo CODCOLIGADA=1 AND CODFILIAL = 1
  string filtro = "1=1";

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("CRMContatoRprData", 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

/* 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 ReadRecord()
 {
	  // 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";

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("CRMContatoRprData", "1;02;3", 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 = @"<CRMContatoRpr>
  <HContatoRpr>
    <CODCOLIGADA>1</CODCOLIGADA>
    <CODREPRESENTANTE>02</CODREPRESENTANTE>
    <IDCONTATORPR>3</IDCONTATORPR>
    <NOME>Carlos</NOME>
    <ATIVO>1</ATIVO>
  </HContatoRpr>
</CRMContatoRpr>";
	 
    // 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("CRMContatoRprData", 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("CRMContatoRprData", context, usuario, senha, filtro)

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

var dataset = DatasetBuilder.newDataset();   
             dataset.addColumn('CODCOLIGADA'); 
             dataset.addColumn('CODREPRESENTANTE'); 
             dataset.addColumn('IDCONTATORPR'); 
             dataset.addColumn('NOME'); 
             dataset.addColumn('EMAIL'); 
             dataset.addColumn('TELEFONE'); 
             dataset.addColumn('RAMAL'); 
             dataset.addColumn('FAX'); 
             dataset.addColumn('FUNCAO'); 
             dataset.addColumn('OBSERVACAO'); 
             dataset.addColumn('APLICATIVOS'); 
             dataset.addColumn('EUSUARIO'); 
             dataset.addColumn('ATIVO'); 
             dataset.addColumn('DATANASCIMENTO'); 
             dataset.addColumn('ESTADOCIVIL'); 
             dataset.addColumn('SEXO'); 
             dataset.addColumn('RUA'); 
             dataset.addColumn('NUMERO'); 
             dataset.addColumn('COMPLEMENTO'); 
             dataset.addColumn('BAIRRO'); 
             dataset.addColumn('CODETD'); 
             dataset.addColumn('CIDADE'); 
             dataset.addColumn('CEP'); 
             dataset.addColumn('CPF'); 
             dataset.addColumn('DATACADASTRO'); 
             dataset.addColumn('DATAALTERACAO'); 
             dataset.addColumn('USUARIOALTERACAO'); 
             dataset.addColumn('CODUSUARIO'); 
    for(var i = 0; i < xmlResultados.HContatoRpr.length(); i++) 
    { 
           dataset.addRow(new Array( 
             xmlResultados.HContatoRpr[i].CODCOLIGADA.toString(), 
             xmlResultados.HContatoRpr[i].CODREPRESENTANTE.toString(), 
             xmlResultados.HContatoRpr[i].IDCONTATORPR.toString(), 
             xmlResultados.HContatoRpr[i].NOME.toString(), 
             xmlResultados.HContatoRpr[i].EMAIL.toString(), 
             xmlResultados.HContatoRpr[i].TELEFONE.toString(), 
             xmlResultados.HContatoRpr[i].RAMAL.toString(), 
             xmlResultados.HContatoRpr[i].FAX.toString(), 
             xmlResultados.HContatoRpr[i].FUNCAO.toString(), 
             xmlResultados.HContatoRpr[i].OBSERVACAO.toString(), 
             xmlResultados.HContatoRpr[i].APLICATIVOS.toString(), 
             xmlResultados.HContatoRpr[i].EUSUARIO.toString(), 
             xmlResultados.HContatoRpr[i].ATIVO.toString(), 
             xmlResultados.HContatoRpr[i].DATANASCIMENTO.toString(), 
             xmlResultados.HContatoRpr[i].ESTADOCIVIL.toString(), 
             xmlResultados.HContatoRpr[i].SEXO.toString(), 
             xmlResultados.HContatoRpr[i].RUA.toString(), 
             xmlResultados.HContatoRpr[i].NUMERO.toString(), 
             xmlResultados.HContatoRpr[i].COMPLEMENTO.toString(), 
             xmlResultados.HContatoRpr[i].BAIRRO.toString(), 
             xmlResultados.HContatoRpr[i].CODETD.toString(), 
             xmlResultados.HContatoRpr[i].CIDADE.toString(), 
             xmlResultados.HContatoRpr[i].CEP.toString(), 
             xmlResultados.HContatoRpr[i].CPF.toString(), 
             xmlResultados.HContatoRpr[i].DATACADASTRO.toString(), 
             xmlResultados.HContatoRpr[i].DATAALTERACAO.toString(), 
             xmlResultados.HContatoRpr[i].USUARIOALTERACAO.toString(), 
             xmlResultados.HContatoRpr[i].CODUSUARIO.toString() 
									))}

// retorna...
	return dataset;

}

ReadRecord

function openZoom(){

var DATASET_ID = "CRMContatoRprData";
	var DATA_FIELDS = "CODCOLIGADA,CODREPRESENTANTE,IDCONTATORPR,NOME,EMAIL,TELEFONE,RAMAL";
	var RESULT_FIELDS = "CODCOLIGADA,CODREPRESENTANTE,IDCONTATORPR,NOME,EMAIL,TELEFONE,RAMAL";
	var TYPE = "CRMContatoRprData";
	var TITLE = "Contatos do representante";

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

function setSelectedZoomItem(selectedItem){

if(selectedItem.type == "CRMContatoRprData"){
   	    //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("CRMContatoRprData", context, usuario, senha, filtro)  
		//Transforma em XML
	    var xmlResultados = new XML(retorno);
CODCOLIGADA,CODREPRESENTANTE,IDCONTATORPR,NOME,EMAIL,TELEFONE,RAMAL
	}

}

SaveRecord

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

/* 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("CODREPRESENTANTE")) || isEmpty(hAPI.getCardValue("IDCONTATORPR")))   
        return    
        var primaryKey = hAPI.getCardValue("CODCOLIGADA") + ";" + hAPI.getCardValue("CODREPRESENTANTE") + ";" + hAPI.getCardValue("IDCONTATORPR");

// 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, "CODREPRESENTANTE" , hAPI.getCardValue("CODREPRESENTANTE")); 
        text = replaceValue(text, "IDCONTATORPR" , hAPI.getCardValue("IDCONTATORPR")); 
        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, "APLICATIVOS" , hAPI.getCardValue("APLICATIVOS")); 
        text = replaceValue(text, "EUSUARIO" , hAPI.getCardValue("EUSUARIO")); 
        text = replaceValue(text, "ATIVO" , hAPI.getCardValue("ATIVO")); 
        text = replaceValue(text, "DATANASCIMENTO" , hAPI.getCardValue("DATANASCIMENTO")); 
        text = replaceValue(text, "ESTADOCIVIL" , hAPI.getCardValue("ESTADOCIVIL")); 
        text = replaceValue(text, "SEXO" , hAPI.getCardValue("SEXO")); 
        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, "CODETD" , hAPI.getCardValue("CODETD")); 
        text = replaceValue(text, "CIDADE" , hAPI.getCardValue("CIDADE")); 
        text = replaceValue(text, "CEP" , hAPI.getCardValue("CEP")); 
        text = replaceValue(text, "CPF" , hAPI.getCardValue("CPF")); 
        text = replaceValue(text, "DATACADASTRO" , hAPI.getCardValue("DATACADASTRO")); 
        text = replaceValue(text, "DATAALTERACAO" , hAPI.getCardValue("DATAALTERACAO")); 
        text = replaceValue(text, "USUARIOALTERACAO" , hAPI.getCardValue("USUARIOALTERACAO")); 
        text = replaceValue(text, "CODUSUARIO" , hAPI.getCardValue("CODUSUARIO"));

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 "<CRMContatoRpr>" + 
"  <HContatoRpr>" + 
"    <CODCOLIGADA>1</CODCOLIGADA>" + 
"    <CODREPRESENTANTE>02</CODREPRESENTANTE>" + 
"    <IDCONTATORPR>3</IDCONTATORPR>" + 
"    <NOME>Carlos</NOME>" + 
"    <ATIVO>1</ATIVO>" + 
"  </HContatoRpr>" + 
"</CRMContatoRpr>";
	
}

Objetos

Relacionamentos

Source Code

ReadView

ReadRecord

SaveRecord

ReadView

ReadRecord

SaveRecord

ReadView

ReadRecord

SaveRecord