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

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. Na guia Gerais, , logo depois verificar o agrupador Desenvolvimento e acionar Datasets.

0302. Visualizar todos os datasets internos, gerados ou codificados 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 datasets que serão retornados.

...


Filtrar dataset

...

01. No campo Exibir Acionar o botão Filtrar, localizado na parte superior esquerda direita da tela, selecionar o tipo de dataset que deseja visualizar.

02. Selecione o tipo de dataset que deseja visualizar: Internos, Codificados ou Geradosos datasets que deseja visualizar em 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 tipo escolhido  Os datasets do(s) tipo(s) escolhido(s) serão listados.


Âncora
novo
novo

Novo

...

dataset simples

...

Image 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

É possível cadastrar um novo Dataset a partir de serviços REST. Para isso, basta ter serviços deste tipo já cadastrados.

Caso não possua nenhum serviço cadastrado, basta seguir até o menu de Serviços na aba Gerais do Painel de controle para criar um novoinclua um serviço conforme as orientações contidas aqui.

05. Ao selecionar os serviços O serviço selecionado pode ser do tipo: SOAP, REST ou JDBC, as opçoes . 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
deseja ou não de autenticação. Podendo definir um
  • a autenticação for necessária, nesse caso será requisitado usuário e senha.
  • SSL - habilitar quando o serviço
soap
  • SOAP exigir utilização
de ssl
  • de SSL (camada extra de segurança).
  • Desabilitar Chunking - desabilitar o envio do envelope
soap
  • 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
  • - permite selecionar esta opção para extrair um relatório em formato
xml
  • 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).

Acionar Salvar para concluir a criação.

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
soap
  • exigir utilização
de ssl
  • 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).

Acionar Salvar para concluir a criação.

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

View ou Synonym).

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

  • Limitar Resultado - habilitar para limitar o
numero
  • 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

conteudo

conteúdo,

nao

não exato, mas que contenha parte do valor informado. Basta selecionar Sim ou Não.

  • Retornar -
permitir retornar ou não um valor. Basta flegar Sim ou Não
  • Se necessário, marcar Sim para retornar um valor.
  • Ordenar -
permite
  • 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 pela imagem de um lápis.

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

Painel

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.

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

Painel
  • Para alguns Datasets do tipo
Internos, não terão esta opção editável. Somente serão visualizadas como padrão, Interno.

Sincronizar dados do dataset


Importar dataset

...

01. Acionar o botão Importar01. Acionar o ícone de edição, representado pela imagem de um lápis, localizado na coluna Sincronização.

02. Acionar On para habilitar.03. Acionar Sincronizar agoraSelecionar o servidor para o qual o dataset será importado.

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

Somente Datasets do tipo Gerados, poderão ter esta opção editada. Já os Datasets do tipo Interno, serão visualizados como padrão.

Visualizar informações de sincronização

01. Acionar o ícone de informação, localizado na coluna Última sincronização.

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

03. Acionar Fechar para retornar à janela principal.

Painel

Somente Datasets do tipo Gerados, poderão ter esta opção editada.

Editar agendamento de sincronização

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

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, basta ficar atento a coluna Próxima sincronização, que mostra a data e hora exatas da próxima sincronização que irá ocorrer.

Somente Datasets do tipo Gerados, poderão ter esta opção editada.

Exibir código

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

02. Acionar Exibir código.

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

04. Acionar Fechar.

Apagar dados

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

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.

Somente Datasets do tipo Gerados, poderão ter esta opção editada.

Consultar dataset

01. Acionar Consultar, representado pelo ícone de lupa, localizado na coluna Opções.

02. Visualizar os dados do dataset.

03. Acionar Fechar.

Editar dataset

01. Acionar Editar dataset, representado pelo ícone de lápis, localizado na coluna Opções.

02. Efetuar alterações necessárias.

03. Acionar Salvar.

...

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

...

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.

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 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.4 0 - WaterdropLake. Se você utiliza uma atualização anterior, ela pode conter informações diferentes das quais você vê na sua plataforma.

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