View

FieldName	Description	Size	Required	Type	DefaultValue
CODCOLIGADA	Coligada	-1	true	System.Int16	1
IDPERLET	Id. Período letivo	-1	true	System.Int32	0
CODPERLET	Período letivo	10	true	System.String	0
DESCRICAO	Descrição	60	false	System.String
DIASLETIVOS	Nº de dias letivos	-1	false	System.Int32
CARGAHORARIA	Carga horária	-1	false	System.Decimal
OBS	Observação	2000	false	System.String
ENCERRADO	Período letivo encerrado	1	false	System.String	N
DTINICIO	Data de Início	-1	true	System.DateTime
DTFIM	Data de Término	-1	false	System.DateTime
DTPREVISTA	Data prevista para o fim do P. Letivo	-1	false	System.DateTime
CALENDARIO	Calendário	16	false	System.String
CODFILIAL	Filial	-1	true	System.Int16
CODTIPOCURSO	Nível de ensino	-1	true	System.Int16
ENCERRADOPGTO	Período letivo encerrado para pagamento de professores	1	false	System.String	S
IDPERLETANT	Período letivo anterior	-1	false	System.Int32
DTCOMPETENCIAINICIAL	Data de competência inicial	-1	false	System.DateTime
DTCOMPETENCIAFINAL	Data de competêncial final	-1	false	System.DateTime
DTCOMPETENCIAINICIALMOV	Data de competência inicial movimento	-1	false	System.DateTime
DTCOMPETENCIAFINALMOV	Data de competência final movimento	-1	false	System.DateTime
IDPERLETPROX	Próximo período letivo	-1	false	System.Int32
NOMETIPOCURSO	Nome do nível de ensino	60	false	System.String
NOMEFILIAL	Nome da filial	100	false	System.String
ENCERRADOCONTABIL	Período Letivo encerrado para Contabilização	1	false	System.String	N
EXIBIRPORTAL	Exibir no Portal	1	true	System.String	S
ENCERRADOFINANCEIRO	Período letivo encerrado para geração de lançamentos	1	false	System.String	N

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("EduPLetivoData", 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("EduPLetivoData", "1;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 = @"<EduPLetivo>
  <SPLetivo>
    <CODCOLIGADA>1</CODCOLIGADA>
    <IDPERLET>1</IDPERLET>
    <CODPERLET>1999/2</CODPERLET>
    <DESCRICAO>2º Semestre de 1999</DESCRICAO>
    <DIASLETIVOS>152</DIASLETIVOS>
    <CARGAHORARIA>635.2000</CARGAHORARIA>
    <OBS xml:space="preserve"> </OBS>
    <ENCERRADO>N</ENCERRADO>
    <DTINICIO>1999-07-01T00:00:00</DTINICIO>
    <DTFIM>1999-12-31T00:00:00</DTFIM>
    <DTPREVISTA>1999-12-31T00:00:00</DTPREVISTA>
    <CODFILIAL>1</CODFILIAL>
    <CODTIPOCURSO>1</CODTIPOCURSO>
    <ENCERRADOPGTO>S</ENCERRADOPGTO>
    <EXIBIRPORTAL>S</EXIBIRPORTAL>
    <ENCERRADOFINANCEIRO>N</ENCERRADOFINANCEIRO>
  </SPLetivo>
</EduPLetivo>";
	 
    // 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("EduPLetivoData", 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("EduPLetivoData", context, usuario, senha, filtro)

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

var dataset = DatasetBuilder.newDataset();   
             dataset.addColumn('CODCOLIGADA'); 
             dataset.addColumn('IDPERLET'); 
             dataset.addColumn('CODPERLET'); 
             dataset.addColumn('DESCRICAO'); 
             dataset.addColumn('DIASLETIVOS'); 
             dataset.addColumn('CARGAHORARIA'); 
             dataset.addColumn('OBS'); 
             dataset.addColumn('ENCERRADO'); 
             dataset.addColumn('DTINICIO'); 
             dataset.addColumn('DTFIM'); 
             dataset.addColumn('DTPREVISTA'); 
             dataset.addColumn('CALENDARIO'); 
             dataset.addColumn('CODFILIAL'); 
             dataset.addColumn('CODTIPOCURSO'); 
             dataset.addColumn('ENCERRADOPGTO'); 
             dataset.addColumn('IDPERLETANT'); 
             dataset.addColumn('DTCOMPETENCIAINICIAL'); 
             dataset.addColumn('DTCOMPETENCIAFINAL'); 
             dataset.addColumn('DTCOMPETENCIAINICIALMOV'); 
             dataset.addColumn('DTCOMPETENCIAFINALMOV'); 
             dataset.addColumn('IDPERLETPROX'); 
             dataset.addColumn('NOMETIPOCURSO'); 
             dataset.addColumn('NOMEFILIAL'); 
             dataset.addColumn('ENCERRADOCONTABIL'); 
             dataset.addColumn('EXIBIRPORTAL'); 
             dataset.addColumn('ENCERRADOFINANCEIRO'); 
    for(var i = 0; i < xmlResultados.SPLetivo.length(); i++) 
    { 
           dataset.addRow(new Array( 
             xmlResultados.SPLetivo[i].CODCOLIGADA.toString(), 
             xmlResultados.SPLetivo[i].IDPERLET.toString(), 
             xmlResultados.SPLetivo[i].CODPERLET.toString(), 
             xmlResultados.SPLetivo[i].DESCRICAO.toString(), 
             xmlResultados.SPLetivo[i].DIASLETIVOS.toString(), 
             xmlResultados.SPLetivo[i].CARGAHORARIA.toString(), 
             xmlResultados.SPLetivo[i].OBS.toString(), 
             xmlResultados.SPLetivo[i].ENCERRADO.toString(), 
             xmlResultados.SPLetivo[i].DTINICIO.toString(), 
             xmlResultados.SPLetivo[i].DTFIM.toString(), 
             xmlResultados.SPLetivo[i].DTPREVISTA.toString(), 
             xmlResultados.SPLetivo[i].CALENDARIO.toString(), 
             xmlResultados.SPLetivo[i].CODFILIAL.toString(), 
             xmlResultados.SPLetivo[i].CODTIPOCURSO.toString(), 
             xmlResultados.SPLetivo[i].ENCERRADOPGTO.toString(), 
             xmlResultados.SPLetivo[i].IDPERLETANT.toString(), 
             xmlResultados.SPLetivo[i].DTCOMPETENCIAINICIAL.toString(), 
             xmlResultados.SPLetivo[i].DTCOMPETENCIAFINAL.toString(), 
             xmlResultados.SPLetivo[i].DTCOMPETENCIAINICIALMOV.toString(), 
             xmlResultados.SPLetivo[i].DTCOMPETENCIAFINALMOV.toString(), 
             xmlResultados.SPLetivo[i].IDPERLETPROX.toString(), 
             xmlResultados.SPLetivo[i].NOMETIPOCURSO.toString(), 
             xmlResultados.SPLetivo[i].NOMEFILIAL.toString(), 
             xmlResultados.SPLetivo[i].ENCERRADOCONTABIL.toString(), 
             xmlResultados.SPLetivo[i].EXIBIRPORTAL.toString(), 
             xmlResultados.SPLetivo[i].ENCERRADOFINANCEIRO.toString() 
									))}

// retorna...
	return dataset;

}

ReadRecord

function openZoom(){

var DATASET_ID = "EduPLetivoData";
	var DATA_FIELDS = "CODCOLIGADA,IDPERLET,CODPERLET,DESCRICAO,DIASLETIVOS,CARGAHORARIA,OBS";
	var RESULT_FIELDS = "CODCOLIGADA,IDPERLET,CODPERLET,DESCRICAO,DIASLETIVOS,CARGAHORARIA,OBS";
	var TYPE = "EduPLetivoData";
	var TITLE = "Período Letivo";

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

function setSelectedZoomItem(selectedItem){

if(selectedItem.type == "EduPLetivoData"){
   	    //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("EduPLetivoData", context, usuario, senha, filtro)  
		//Transforma em XML
	    var xmlResultados = new XML(retorno);
CODCOLIGADA,IDPERLET,CODPERLET,DESCRICAO,DIASLETIVOS,CARGAHORARIA,OBS
	}

}

SaveRecord

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

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

// 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, "IDPERLET" , hAPI.getCardValue("IDPERLET")); 
        text = replaceValue(text, "CODPERLET" , hAPI.getCardValue("CODPERLET")); 
        text = replaceValue(text, "DESCRICAO" , hAPI.getCardValue("DESCRICAO")); 
        text = replaceValue(text, "DIASLETIVOS" , hAPI.getCardValue("DIASLETIVOS")); 
        text = replaceValue(text, "CARGAHORARIA" , hAPI.getCardValue("CARGAHORARIA")); 
        text = replaceValue(text, "OBS" , hAPI.getCardValue("OBS")); 
        text = replaceValue(text, "ENCERRADO" , hAPI.getCardValue("ENCERRADO")); 
        text = replaceValue(text, "DTINICIO" , hAPI.getCardValue("DTINICIO")); 
        text = replaceValue(text, "DTFIM" , hAPI.getCardValue("DTFIM")); 
        text = replaceValue(text, "DTPREVISTA" , hAPI.getCardValue("DTPREVISTA")); 
        text = replaceValue(text, "CALENDARIO" , hAPI.getCardValue("CALENDARIO")); 
        text = replaceValue(text, "CODFILIAL" , hAPI.getCardValue("CODFILIAL")); 
        text = replaceValue(text, "CODTIPOCURSO" , hAPI.getCardValue("CODTIPOCURSO")); 
        text = replaceValue(text, "ENCERRADOPGTO" , hAPI.getCardValue("ENCERRADOPGTO")); 
        text = replaceValue(text, "IDPERLETANT" , hAPI.getCardValue("IDPERLETANT")); 
        text = replaceValue(text, "DTCOMPETENCIAINICIAL" , hAPI.getCardValue("DTCOMPETENCIAINICIAL")); 
        text = replaceValue(text, "DTCOMPETENCIAFINAL" , hAPI.getCardValue("DTCOMPETENCIAFINAL")); 
        text = replaceValue(text, "DTCOMPETENCIAINICIALMOV" , hAPI.getCardValue("DTCOMPETENCIAINICIALMOV")); 
        text = replaceValue(text, "DTCOMPETENCIAFINALMOV" , hAPI.getCardValue("DTCOMPETENCIAFINALMOV")); 
        text = replaceValue(text, "IDPERLETPROX" , hAPI.getCardValue("IDPERLETPROX")); 
        text = replaceValue(text, "NOMETIPOCURSO" , hAPI.getCardValue("NOMETIPOCURSO")); 
        text = replaceValue(text, "NOMEFILIAL" , hAPI.getCardValue("NOMEFILIAL")); 
        text = replaceValue(text, "ENCERRADOCONTABIL" , hAPI.getCardValue("ENCERRADOCONTABIL")); 
        text = replaceValue(text, "EXIBIRPORTAL" , hAPI.getCardValue("EXIBIRPORTAL")); 
        text = replaceValue(text, "ENCERRADOFINANCEIRO" , hAPI.getCardValue("ENCERRADOFINANCEIRO"));

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

function GetXml()
{
	return "<EduPLetivo>" + 
"  <SPLetivo>" + 
"    <CODCOLIGADA>1</CODCOLIGADA>" + 
"    <IDPERLET>1</IDPERLET>" + 
"    <CODPERLET>1999/2</CODPERLET>" + 
"    <DESCRICAO>2º Semestre de 1999</DESCRICAO>" + 
"    <DIASLETIVOS>152</DIASLETIVOS>" + 
"    <CARGAHORARIA>635.2000</CARGAHORARIA>" + 
"    <OBS xml:space="preserve"> </OBS>" + 
"    <ENCERRADO>N</ENCERRADO>" + 
"    <DTINICIO>1999-07-01T00:00:00</DTINICIO>" + 
"    <DTFIM>1999-12-31T00:00:00</DTFIM>" + 
"    <DTPREVISTA>1999-12-31T00:00:00</DTPREVISTA>" + 
"    <CODFILIAL>1</CODFILIAL>" + 
"    <CODTIPOCURSO>1</CODTIPOCURSO>" + 
"    <ENCERRADOPGTO>S</ENCERRADOPGTO>" + 
"    <EXIBIRPORTAL>S</EXIBIRPORTAL>" + 
"    <ENCERRADOFINANCEIRO>N</ENCERRADOFINANCEIRO>" + 
"  </SPLetivo>" + 
"</EduPLetivo>";
	
}

Objetos

Relacionamentos

Source Code

ReadView

ReadRecord

SaveRecord

ReadView

ReadRecord

SaveRecord

ReadView

ReadRecord

SaveRecord