Árvore de páginas

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

Índice

Índice
outlinetrue
exclude.*ndice
stylenone


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.

Image Removed

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, inativar aqueles que não estiverem mais em uso, entre outras opções.

Os datasets ativos são apresentados com uma cor de fonte mais forte, para se destacarem em relação aos datasets que não estão mais sendo utilizados.

Painel
titleFique por dentro!

Saiba mais sobre o desenvolvimento de datasets acessando a documentação técnica.


Image Added


Listar os datasets

...

...

01. No menu principal, acionar Painel de Controle.02. No agrupador Desenvolvimento, , logo depois verificar o agrupador Desenvolvimento e acionar Datasets.

0302. Visualizar todos os datasets exibidos na listagem.

Painel

É 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 datasets que serão retornados: internos, simples ou avançados.

...


Filtrar dataset

...

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

02. Selecione os tipos de datasetos datasets que deseja visualizar Internos, Simples ou Avançadosem tela. É possível filtrar por situação (ativos, inativos e/ou em edição) e também por tipo (internos, simples e/ou avançados).

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


Âncora
novo
novo

Novo dataset simples

...

DatasetImage Added Visualize o passo a passo


01. Acionar Novo Dataset e selecionar a opção Simples.

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

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

Painel

Para evitar inconsistências, o código e a descrição do dataset não devem conter caracteres especiais (com exceção de "_" e "-").

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

Painel

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.

Painel
Deck of Cards
historyfalse
id1
Card
idsoap
labelSOAP

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.

Painel

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).

Card
idrest
labelREST

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.

Painel

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).

Card
idjdbc
labelJDBC

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.
Painel

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.


Âncora
avançado
avançado

Novo dataset avançado

...

Image Added Visualize o passo a passo


01. Acionar Novo Dataset e selecionar a opção Avançado.

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

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

Painel

Para evitar inconsistências, o código e a descrição do dataset não devem conter caracteres especiais (com exceção de "_" e "-").

04. Acionar a opção Próximo.

Painel

Com isso, será incluído um novo registro de dataset avançado, e será aberta a tela para edição do código-fonte do dataset. O código-fonte será mantido como rascunho enquanto o usuário autenticado acionar a opção Salvar. As alterações de código-fonte só serão aplicadas ao dataset no momento em que o usuário tiver concluído as alterações, acionando o botão Publicar.

Saiba mais sobre a construção de um dataset avançado acessando a nossa documentação técnica disponível aqui.


Habilitar dataset offline no mobile

...

01. Acionar o ícone de edição presente na Abrir a tela de Comportamento mobile, acionando o link da coluna Offline mobile, representado pelo ícone de um lápis.

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

...

Nota
titleAtenção

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 a página de Sincronização de datasets.

Painel
  • Para alguns Datasets do tipo Interno este recursonão é disponibilizado.

...


Importar dataset

...

01. Acionar o botão Importar.

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

Painel

O servidor deve estar corretamente cadastrado, conforme as instruções do item Servidores. A importação só irá funcionar se, no servidor selecionado, a plataforma estiver em uma atualização 1.6.5 (Liquid) ou superior.

Caso já exista um dataset com o mesmo código do dataset importado de outro servidor, a plataforma irá emitir uma mensagem de alerta e, caso o usuário confirme a ação, será criada uma nova versão com a implementação do dataset importado.

03. Acionar Importar.


Exportar dataset

...

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.

Painel

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.

Painel

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.

Painel

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.

Painel

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

04. Acionar Confirmar.

Painel

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.

Painel

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.

Painel

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.

Painel

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.

...

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.

Painel

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.

Painel

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

03. Acionar Importar.

...

...

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

02. Acionar o botão Exportar.

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

Painel

O servidor deve estar corretamente cadastrado, conforme as instruções do item Servidores. A importação só irá funcionar se, no servidor selecionado, a plataforma estiver em uma atualização 1.6.5 (Liquid) ou superior.

04. Acionar Acionar Exportar.


Configurar permissão de acesso no dataset

...

Por meio do recurso de Permissões do Painel de controle, é possível definir os usuários, papéis ou grupos que terão acesso ao datasets do tipo Interno. Confira mais detalhes em Recursos de permissão em APIs, datasets e webservices.


Sincronização de datasets

...

Os recursos de sincronização se encontram em uma tela específica, que pode ser acessada acionando o link da coluna Sincronização. Para saber mais sobre esse recurso, acesse a página de Sincronização de datasets.


Mais ações do dataset

...

Os datasets apresentam diversas ações específicas, que podem ser conferidas acionando o ícone Barras horizontaisImage Added, localizado na coluna Mais ações. Para saber mais sobre esses recursos, acesse a página Mais ações de datasets.



Informações
titleFique atento!

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

...