Índice


Falando de datasets...

Esse recurso permite criar datasets e definir quais serão offline em dispositivos móveis, quais devem ser sincronizados com o provedor externo de dados, a frequência de sincronização, dentre outras opções.

Datasets são componentes que permitem padronizar o acesso às informações provenientes de locais externos à plataforma, tais como aplicativos e banco de dados. Os datasets de alta performance possuem um cache de armazenamento de dados obtidos externamente, que tem como objetivo reduzir o número de acessos aos serviços de dados externos, ou seja, cria uma cópia da estrutura dos dados dentro da plataforma para consulta, aprimorando a performance dos datasets desenvolvidos sobre a plataforma. Desta forma, os dados são consultados na própria plataforma, evitando acessar os dados no sistema provedor externo a cada requisição.

Para atualizar os dados da cópia criada na plataforma, é necessário definir uma frequência de sincronização no Agendador de tarefas.



Datasets


01. No menu principal, acionar Painel de Controle.

02. No agrupador Desenvolvimento, acionar Datasets.

03. Visualizar todos os datasets exibidos na listagem.

É possível pesquisar um dataset específico por meio do campo Buscar, localizado no canto superior direito da janela, ou utilizar o botão Filtrar, para escolher os tipos de dataset que serão retornados: internos, simples ou avançados.



Exibir  Dataset


01. Acionar o botão Filtrar, localizado na parte superior direita da tela.

02. Selecione os tipos de dataset que deseja visualizar: Internos, Simples ou Avançados.

03. Os datasets do(s) tipo(s) escolhido(s) serão listados.


Novo Dataset


01. Acionar Novo Dataset.

02. No campo Código, inserir um código para o dataset.

03. No campo Descrição, inserir uma descrição para o dataset.

04. No campo Serviço, selecione um serviço para o dataset.

Caso não possua nenhum serviço cadastrado, inclua um serviço conforme as orientações contidas aqui.

05. O serviço selecionado pode ser do tipo: SOAP, REST ou JDBC. As opções de preenchimento aparecerão de forma diferente de um para o outro. Preencha os campos de acordo com o serviço selecionado.

Ao selecionar o tipo de serviço SOAP, preencha os seguintes campos:

Operação
Ao selecionar o ícone de lupa, permitirá selecionar uma das operações disponíveis. As operações estarão listadas por Nome e PortType (ColleagueService).

Configurar
Nas configurações da operação selecionada, podem ser configuradas as Propriedades, Chaves do Dataset, SOAP Headers e Tratamento retorno.

Propriedades

  • Autenticação Básica - selecionar se a autenticação for necessária, nesse caso será requisitado usuário e senha.
  • SSL - habilitar quando o serviço SOAP exigir utilização de SSL (camada extra de segurança).
  • Desabilitar Chunking - desabilitar o envio do envelope SOAP inteiro.
  • Listar mensagens SOAP - habilitar para mostrar as mensagens de envio e recebimento no log.
  • Tempo de resposta - habilitar para mostrar o tempo que a requisição aguarda pela resposta.

Chaves do Dataset

Permite definir as chaves que serão utilizadas no momento da sincronização offline, para evitar duplicação de registros a cada sincronização.

SOAP Headers
Permite adicionar um header (cabeçalho).

Tratamento Retorno

  • Extrair resultado - permite selecionar esta opção para extrair um relatório em formato XML e incluir uma tag.

Acionar Salvar para concluir a configuração.

Parâmetros
Preencha os parâmetros de acordo com o solicitado:

Atribuição
-Nulo, Valor ou Variável (Ao selecionar Nulo, o campo Valor é automaticamente dispensado)

Valor
-WKCompany ou WKUser (Será visualizado quando o campo de atribuição for selecionado como Variável).

Ao selecionar o tipo de serviço REST, preencha os seguintes campos:

Operação
Ao selecionar o ícone de lupa, permitirá selecionar uma das operações disponíveis. As operações estarão listadas por Nome, Método(GET) e API.

Configurar
Nas configurações da operação selecionada, podem ser configuradas as Propriedades, Chaves do Dataset, Headers e Tratamento retorno.

Propriedades

  • SSL - habilitar quando o serviço exigir utilização de SSL (camada extra de segurança).
  • Listar mensagens - habilitar para mostrar as mensagens de envio e recebimento no log.
  • Tempo de resposta - habilitar para mostrar o tempo que a requisição aguarda pela resposta.

Chaves do Dataset

Permite definir as chaves que serão utilizadas no momento da sincronização offline, para evitar duplicação de registros a cada sincronização.

Headers

Permite adicionar um header (cabeçalho).

Tratamento Retorno

  • Extrair resultado: Permite selecionar esta opção para extrair um relatório em formato JSON e incluir um caminho.

Acionar Salvar para concluir a configuração.

Parâmetros
Preencha os parâmetros de acordo com o solicitado:

Atribuição
-Nulo, Valor ou Variável (Ao selecionar Nulo, o campo Valor é automaticamente dispensado)

Valor
-WKCompany ou WKUser (Será visualizado quando o campo de atribuição for selecionado como Variável).

Ao selecionar o tipo de serviço JDBC, preencha os seguintes campos:

Tabela
Ao selecionar o ícone de lupa, permitirá selecionar uma das tabelas disponíveis. As operações estarão listadas por Nome e Tipo (Table, View ou Synonym).

Configurar
Nas configurações da tabela selecionada, podem ser configuradas algumas propriedades como:

  • Limitar Resultado - habilitar para limitar o número de registros retornados.
  • Campo chave para a tabela - Permite selecionar um campo chave para a tabela, podendo ser: limit ou offset.

Acionar Salvar para concluir a criação.

Campos
Preencha os campos de acordo com o solicitado:

  • Filtros - Permite adicionar filtros para os campos.

Para criar filtros, é necessário configurar algumas informações. São elas:

Operação
Permite selecionar uma das operações disponíveis: AND, OR ou NOT.

Valor inicial
Definir um valor inicial. Ex: 1

Valor final
Definir um valor final. Ex: 3

Utilizar Like
Buscar pelo conteúdo, não exato, mas que contenha parte do valor informado. Basta selecionar Sim ou Não.

  • Retornar - Se necessário, marcar Sim para retornar um valor.
  • Ordenar - Permite ordenar os campos em ordem crescente ou decrescente.

06. Acionar Salvar.



Habilitar dataset offline no mobile


01. Acionar o ícone de edição presente na coluna Offline mobile, representado pelo ícone de um lápis.

02. Na janela apresentada, definir as informações solicitadas.

A configuração padrão é Não (Off).

As informações solicitadas são:

Utilizar cache em dispositivos móveis?

Quando habilitado, determina que os dados do dataset serão armazenados no cache quando ele é utilizado em dispositivos móveis. Nesse caso, o botão é apresentado com o indicativo ON (sim), informando que o recurso está ativo. Quando acionado para desabilitar o recurso, o botão é apresentado com o indicativo OFF (não), informando que o recurso está desabilitado.

Tempo de expiração do cache mobile

Tempo no qual os dados armazenados são considerados válidos e permanecem no cache de dispositivos móveis antes de serem atualizados novamente.

Não utilizar cache quando o dispositivo mobile estiver online?

Quando habilitado, determina que não serão consultados os dados em cache quando o dispositivo móvel estiver online, ou seja, serão requisitados do sistema externo.

03. Acionar Salvar.

Novos dados criados em dispositivos móveis, quando utilizando o modo offline, só estarão disponíveis para consulta em outros formulários depois que o aplicativo móvel passar por um processo de sincronização com o servidor do fluig. Para entender mais sobre este processo, acesse nesta página o passo Sincronizar dados de datasets.

Para alguns Datasets do tipo Interno este recurso não é disponibilizado.


Sincronizar dados do dataset


01. Acessar a tela de configuração da sincronização, acionando o link da coluna Sincronização.

02.  Acionar On para habilitar.

03. Acionar Sincronizar agora.

Ao acionar essa opção, os dados do dataset gravados na plataforma são sincronizados com os dados correspondentes do sistema externo.

Somente é possível habilitar a sincronização de dados para datasets desenvolvidos sobre a plataforma. Ao habilitar a sincronização, ela será efetuada de acordo com o agendamento criado no Agendador de tarefas. Informações sobre como definir a frequência de sincronização podem ser obtidas no caminho alternativo Editar agendamentos.

04. Acionar Off para desabilitar.

05. Acionar Salvar.

06. Acionar fechar.

Essa opção não está disponível para os datasets do tipo Interno.


Visualizar informações de sincronização


01. Acessar a tela de configuração da sincronização, acionando o link da coluna Sincronização.

02. Visualizar as informações da última sincronização de dados do dataset.

03. Acionar Fechar para retornar à janela principal.

Essa opção não está disponível para os datasets do tipo Interno.



Editar agendamento de sincronização


01. Acessar a tela de configuração da sincronização, acionando o link da coluna Sincronização.

02. Acionar Editar agendamento.

03. Na janela Configurações do agendamento, alterar as informações desejadas.

Informações sobre os campos apresentados podem ser obtidas em Agendador de tarefas.

04. Acionar Confirmar.

Para visualizar a próxima sincronização agendada, siga os passos do item Visualizar informações de sincronização.

Essa opção não está disponível para os datasets do tipo Interno.



Apagar dados


01. Acessar a tela de configuração da sincronização, acionando o conteúdo da coluna Sincronização.

02. Acionar Apagar dados.

03. Na mensagem apresentada, acionar Apagar.

Ao acionar essa opção, todos os dados contidos no dataset são apagados.

Essa opção não está disponível para os datasets do tipo Interno.



Consultar dataset


01. Acionar o ícone de barras horizontais, localizado na coluna Mais ações.

02. Acionar Consultar.

03. Visualizar os dados do dataset.

04. Acionar Fechar.



Editar dataset


01. Acionar o ícone de barras horizontais, localizado na coluna Mais ações.

02. Acionar Editar dataset.

03. Efetuar alterações necessárias.

04. Acionar Salvar.

Essa opção só está disponível para os datasets simples ou avançados, os datasets internos não podem ser editados.

  • Simples: a plataforma disponibiliza a edição conforme campos apresentados no passo Novo Dataset
  • Avançado: abre a edição do código fonte em javascript



Editar em modo avançado


01. Acionar o ícone de barras horizontais, localizado na coluna Mais ações.

02. Acionar Editar em modo avançado.

03. Na janela de confirmação, acionar Editar em modo avançado.

04. Editar o código do dataset, conforme necessidade.

05. Acionar Publicar para concluir as alterações.

Os datasets internos não podem ser editados.

A partir do momento em que um dataset simples for editado em modo avançado, ele passa a ser um dataset avançado, e com isso, não poderá ser editado em modo simples. Saiba mais sobre a construção de um dataset avançado acessando a nossa documentação técnica disponível aqui.


Exibir código


01. Acionar o ícone de barras horizontais, localizado na coluna Mais ações.

02. Acionar Exibir código.

03. Visualizar o código fonte em javascript do dataset desenvolvido.

04. Acionar Fechar.



Remover dataset


01. Acionar o ícone de barras horizontais, localizado na coluna Mais ações.

02. Acionar Remover dataset.

03. Acionar Apagar.

Essa opção está disponível somente para Datasets do tipo Simples.




Importar dataset


01. Acionar o botão Importar.

02. Selecionar o servidor para o qual o dataset será importado.

O servidor deve estar corretamente cadastrado, conforme as instruções do item Servidores.

03. Acionar Importar.



Exportar dataset


01. Selecionar na listagem o(s) dataset(s) que deve(m) ser exportado(s).

02. Acionar o botão Exportar.

03. Selecionar o servidor para o qual o dataset será exportado.

O servidor deve estar corretamente cadastrado, conforme as instruções do item Servidores.

04. Acionar Exportar.


Esta documentação é válida a partir da atualização 1.6.5. Se você utiliza uma atualização anterior, ela pode conter informações diferentes das quais você vê na sua plataforma.

<script>
	$("b:contains('oculto')").parent().parent().hide();
</script>