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

...

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.

Caminhos alternativos

Exibir dataset

, ou utilizar o botão Filtrar, para escolher os datasets que serão retornados.


Filtrar dataset

...

01. Acionar o botão Filtrar01. No campo Exibir, 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

Caso não possua nenhum serviço esteja listadocadastrado, basta cadastrar um novo, acionando o botão Cadastrar.

No campo Tipo, selecione o tipo desejado: SOAP ou DATABASE.

Se selecionado o tipo SOAP, os campos a serem preenchidos são:

  • Nome: neste campo, adicione um nome para o serviço que deseja cadastrar.
  • Descrição: neste campo, adicione uma descrição para o serviço.
  • URL: neste campo, adicione a URL do webservice que deseja utilizar.

Se selecionado o tipo DATABASE, os campos a serem preenchidos são:

  • Driver: neste campo, será selecionado o driver desejado: MySQL, SQLServer ou Oracle.
Painel

O botão Configurar permite ao usuário selecionar quais os drivers poderão estar disponíveis na listagem. Para deixá-lo disponivel basta acionar ON e para deixá-lo indisponível, acione OFF.

  • Nome: neste campo, adicione um nome para o serviço que deseja cadastrar.
  • Descrição: neste campo, adicione uma descrição para o serviço.
  • URL: neste campo, após definir o driver, a url será preenchida automaticamente.
Painel

Na URL, os dados que se encontram entre as chaves deverão ser alterados. Por exemplo:

jdbc:oracle:thin:@<host>:1521:<db>

Os dados em negrito deverão ser alterados.

  • Usuário:
  • Senha:

Acionar Salvar.

Painel

Ao criar um serviço no fluig, apontando para um webservice, é gerado um arquivo.jar no volume, que é utilizado para acessar esse webservice. As classes dentro do arquivo.jar são chamadas de stubs. Por isso,  ao criar um serviço podem ocorrer alguns conflitos que impedem a geração dos stubs. Com isso, será necessário utilizar um arquivo de bind JAXB.

Somente será utilizado o arquivo de binding para serviços criados utilizando a API CXF.

Para incluir, basta acionar Escolher arquivo no campo Arquivo de Binding e incluir.

Mais detalhes referente a binding, você encontra na nossa documentação técnica de Integração com Aplicativos Externos.

05. No campo Operação, selecione uma operação para o dataset.

Painel

É possível configurar uma operação acionando o campo Configurar.

01. Na janela de configurações, defina a autenticação selecionando a opção Autenticação Básica. Caso não selecione esta opção, o campo de usuário e senha permanecem desabilitados.

02. No campo Usuário, defina um usuário.

03. No campo Senha, defina uma senha.

04. Caso deseje desabilitar chunking, selecione a opção Desabilitar chunking.

05. Caso deseje habilitar lista de mensagens soap, selecione a opção Listar Mensagens SOAP.

06. No campo Tempo de Resposta, definir o tempo de resposta.

07. Acionar Salvar.

06. No campo Parâmetros, definir a atribuição e o valor de cada parâmetro.

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

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

...

02. Efetuar alterações necessárias.

03. Acionar Salvar.

...

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

...

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.20 - Lake. 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>