Extraindo alterações de tabelas de gravação

Quando os usuários adicionam dados em colunas editáveis em tabelas de escrita, suas alterações não são aplicadas ao modelo de dados do aplicativo. Elas também são temporárias — as alterações são armazenadas em repositórios de alterações gerenciados pela Qlik por 90 dias, após os quais são excluídas.

Você pode recuperar essas alterações por meio da change-stores API. As alterações podem ser usadas de várias maneiras, incluindo:

• Carregue as alterações em QVDs ou aplicativos para armazenamento permanente e uso no Qlik Cloud.

• Extraia as alterações, adicionando-as a sistemas externos, como pastas do Excel ou bancos de dados SQL.

• Integre dinamicamente os dados em processos automatizados, como envio de e-mails e compra de inventário.

• Crie seus próprios aplicativos e integre chamadas para a change-stores API em seus fluxos de trabalho operacionais.

Pré-requisitos

Para poder acessar os dados salvos no repositório de alterações, você precisa ser capaz de acessar a change-stores API. Para fazer isso, você precisa:

• Chave de API para o locatário do Qlik Cloud. Consulte Gerenciando chaves de API.

• As permissões necessárias para trabalhar com tabelas de gravação, atribuídas pelos administradores de locatários. Consulte:

  • Configurando permissões para tabelas de gravação (assinaturas baseadas em capacidade)

  • Configurando permissões para tabelas de gravação (assinaturas baseadas em usuário)

• O ID do repositório de alterações. Isso pode ser recuperado após a criação da tabela de gravação em uma pasta. Consulte Trabalhando com armazenamentos de mudança.

Ferramentas disponíveis para extração de alterações

Você pode usar as seguintes ferramentas para extrair e usar as alterações da change-stores API:

• Qlik Automate

• O conector REST disponível com scripts e preparação de dados do Qlik.

Para obter exemplos e casos de uso, consulte:

• Extraindo alterações da tabela de gravação com o Qlik Automate

• Extraindo alterações da tabela de gravação com o conector REST

• Casos de uso para tabelas de gravação

Extraindo alterações da tabela de gravação com o Qlik Automate

As alterações salvas no repositório de alterações podem ser extraídas usando os blocos Change Store no conector do Qlik Cloud Services no Qlik Automate. Esse conector se conecta automaticamente à conta Qlik do proprietário da automação, portanto, não há etapas adicionais necessárias para autenticar.

Mais informações sobre o Qlik Automate estão disponíveis no Qlik Automate.

Listando alterações atuais do repositório de alterações

O bloco List Current Changes From Change Store usa o endpoint da API /changes/tabular-views e retornará apenas o valor mais recente para cada célula (em outras palavras, ele retorna os valores atuais). Ele retorna esses valores como uma lista de objetos em que cada objeto contém as chaves primárias e os valores de alteração. Cada registro também é estendido com um carimbo de data/hora updatedAt para a data e hora em que a última atualização foi feita no registro e um ID de usuário updatedBy para o usuário que fez essa alteração.

Listando o histórico do repositório de alterações

O bloco List Change Store History usa o endpoint da API /changes e retorna o histórico completo para cada célula. Se uma célula tiver sido atualizada várias vezes, esse bloco retornará cada valor, userId e o carimbo de data/hora updatedAt para cada atualização.

Trabalhando com modelos

Você também pode começar com um modelo de automação se estiver extraindo os dados para um banco de dados MySQL. Os seguintes modelos estão disponíveis em Insights to Action:

• Extract Change Store Data to a MySQL Database

• Extract Change Store Data to a MySQL Database in Bulk

Esses modelos organizam os blocos Change Store (descritos acima) com outros blocos para ajudá-lo a extrair os dados mais rapidamente. Basta ajustar os parâmetros do bloco para se conectar aos seus recursos. Veja um passo a passo detalhado neste artigo da Comunidade.

Extraindo alterações da tabela de gravação com o conector REST

Este exemplo mostra como você pode configurar uma conexão REST com o change-stores API. Essa conexão pode ser usada para extrair dados da API e, em seguida, carregar as alterações de volta em um aplicativo ou armazená-las em QVDs no Qlik Cloud.

Faça o seguinte:

1. No Qlik Cloud Analytics, crie uma nova conexão para o conector REST. Consulte Adicionando conexões de dados.

2. Defina os seguintes parâmetros para a conexão:

   • URL: your_tenant_base_URL/api/analytics/change-stores/your change store id/changes/tabular-views

   • Additional request parameters

     • Query parameters

       • Limit (Key): 100 (Value)

     • Query headers

       • Authorization (Key): Bearer your_API_token (Value)

   • Pagination type: Next URL

     • 'Next url' path: links/next/href