DataSet JSON Request

Objeto que reúne conjunto de parâmetros para requisição de um dataset. É enviado via request http post para server. A session ativa deve estar válida.

Objeto e atributos

javascript

var dstOpt = {
dataSetId:"20170124004024"
, sessionId:"#system.sessionId#"
, var: [
    {id:"filterINI", value:"'20170101'"},
    {id:"filterEND", value:"'20170102'"}
    ]
};

Atributo	Descrição
dataSetId (string)	Id do dataSet a ser retornado.
sessionId (string)	Sessão ativa, deve ter a constante #system.sessionId#, que é automaticamente substituída pela sessão ativa.
var (array object)	Conjunto de variáveis a serem enviadas para execução do dataSet. Cada objeto deve conter dois atributos string ( id / value).
var[..].id (string)	Identificação única da variável. Caso seja repetido a identificação, será considerada a última referência lida.
var[..].value (string)	Valor da variável.

Enviando request

Depois que o objeto DataSet Request está criado e com os parâmetros atribuídos, deve ser enviado ao server. Para o envio é utilizada a função cpGetData, presente na biblioteca de apoio cpApi.js.

javascript

cpGetData(dstOpt,callBack);

Atributo	Descrição
dstOpt	DataSet JSON Request.
callBack	Função a ser executada quando do retorno dos dados pelo server. Caso retorne dados, os mesmos serão retornados como primeiro argumento da função callBack, podendo ser capturados com a função arguments[0]. O DataSet obrigatoriamente deverá retornar uma string no formato JSON válido.

Exemplo

javascript

var sfdata;
function drawReport(){
    if (arguments[0] != '' && arguments[0] != undefined) {
        sfdata = eval("[" + arguments[0] + "]");
    } else {
        sfdata = eval("[]");
    };
    // Demais código... 
}
 
function drawReport_Filter() {
    var dstOpt = {
      dataSetId:"20170124004024"
      , sessionId:"#system.sessionId#"
      , var: [
          {id:"filterINI", value:"'20170101'"},
          {id:"filterEND", value:"'20170102'"}
      ]
    };
    cpGetData(dstOpt,drawReport);
}