Criando tabelas de gravação
Você pode criar uma tabela de gravação na sua pasta, adicionando dimensões, medidas e colunas editáveis conforme necessário. Após criar uma tabela de gravação em um aplicativo, os usuários com acesso a esse aplicativo, bem como permissões de tabela de gravação, poderão fazer alterações nas colunas editáveis. As alterações podem então ser exportadas para sistemas externos.
Criar uma tabela de gravação
Você pode adicionar uma tabela de gravação à sua pasta a qualquer momento.
Faça o seguinte:
-
No painel de ativos, abra Gráficos.
-
Em Visualizações, arraste uma Tabela de gravação para a pasta.
Clique Adicionar dimensão e selecione uma dimensão ou um campo.
Adicione colunas adicionais de dimensão e medida clicando em
em Dados no painel de propriedades. Um menu suspenso é aberto. Selecione uma das opções a seguir:- Campos e itens mestre: abre uma caixa de diálogo pesquisável exibindo cada campo e item mestre. Você pode optar por adicionar qualquer item como uma dimensão ou medida.
- Expressão personalizada: abre uma caixa de diálogo na qual você pode digitar uma expressão ou abrir o editor de expressão
.
Adicione colunas editáveis clicando em
em Dados no painel de propriedades e selecionando Coluna editável.Defina uma ou mais chaves primárias para a tabela. Na tabela de gravação, na coluna editável, clique em Definir e selecione uma ou mais colunas de dimensão para usar como chaves primárias.
Para obter mais informações sobre chaves primárias, consulte Chave primária.
Clique em Salvar.
Depois de criar a tabela de gravação, permita que os usuários interajam com ela e adicionem alterações às colunas editáveis. Você também pode personalizar a aparência da tabela de gravação configurando suas propriedades. Consulte Configurando propriedades da tabela de gravação.
Extrair e usar alterações
Quando os usuários adicionam dados em colunas editáveis, 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 um repositório de alterações gerenciado pelo 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 Repositório de alterações.
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:
Conceitos
Esta seção fornece uma visão geral dos conceitos fundamentais da tabela de gravação.
Coluna editável
Em uma tabela de gravação, as colunas editáveis permitem que os usuários insiram dados dinamicamente durante a análise. Ao salvar as alterações em uma coluna editável, o usuário grava as alterações em um repositório de alterações, de onde podem ser recuperadas por desenvolvedores e integradores de aplicativos.
Para obter mais informações sobre onde você cria colunas editáveis, consulte Criar uma tabela de gravação.
Depois de adicionar uma coluna editável, você pode personalizá-la ainda mais para atender às suas necessidades.
Faça o seguinte:
-
No painel de propriedades, em Dados, clique na coluna editável.
As propriedades da coluna são abertas.
-
Você pode alterar qualquer uma das seguintes propriedades:
-
Título: altere o título da coluna padrão.
-
Mostrar conteúdo: altere como os usuários podem editar dados na tabela. Você pode escolher entre:
-
Seleção única: especifique um conjunto de valores que os usuários podem selecionar para cada célula ao editar. Por exemplo, você pode adicionar dois valores para status de pedidos: Em Andamento e Atrasado. Os usuários podem então selecionar entre esses valores ao comentar em registros de dados.
-
Entrada manual do usuário: os usuários editam dados digitando texto manualmente nas células.
-
-
Mostrar coluna: alterne se a coluna está visível ou oculta.
-
Largura da coluna: defina a largura da coluna.
-
Repositório de alterações
Um repositório de alterações é uma localização de armazenamento gerenciada pelo Qlik que contém as alterações adicionadas pelo usuário de colunas editáveis em uma tabela de gravação. O repositório de alterações é um local de armazenamento temporário; as alterações são armazenadas por um máximo de 90 dias, após os quais são excluídas.
O repositório de alterações da sua tabela de gravação está pré-configurado para o seu locatário e pode ser acessado através da change-stores API. Com seu ID do repositório de alterações, você pode formular solicitações de API e automações que sincronizam as alterações do usuário com um local permanente, como uma pasta ou um banco de dados. Para obter mais informações, consulte Extrair e usar alterações.
Você pode copiar o ID do repositório de alterações de duas maneiras:
-
No modo de edição da pasta depois de criar a tabela de gravação. No painel de propriedades, em Repositório de alterações> ID do repositório de alterações, clique em
.Copie o ID do repositório de alterações do painel de propriedades.
-
No modo de análise ao visualizar a tabela de gravação. Clique no ícone
no canto inferior direito. Clique em para copiar o ID do repositório de alterações.Copiando o ID do repositório de alterações ao visualizar uma tabela de gravação.
Chave primária
Para adicionar colunas editáveis a uma tabela de gravação, você precisa definir pelo menos uma chave primária.
Uma chave primária é um campo usado para vincular alterações em colunas editáveis de volta aos dados originais do modelo de dados. As chaves primárias fornecem o mapeamento entre os registros na tabela de gravação — que representam dados do modelo de dados — e as edições que os usuários introduzem nas colunas editáveis.
A chave primária pode ser um único campo, ou pode ser uma chave composta que abrange vários campos.
Após definir as chaves primárias em uma tabela de gravação, você pode alterá-las a qualquer momento. No painel de propriedades, em Repositório de alterações > Chaves primárias, clique em Modificar.
A chave primária também é importante ao extrair alterações da change-stores API.
Usando ferramentas do Qlik Cloud para extrair alterações de 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.
Acessando os blocos Qlik Automate disponíveis para extrair alterações da tabela de gravação
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.
Bloco List Current Changes From Change Store no Qlik Automate
Esse bloco também possui uma variante incremental List Current Changes From Change Store Incrementally. Essa variante funciona da seguinte forma:
-
Na primeira execução, o bloco recupera todos os registros.
- Nas execuções subsequentes, o bloco recupera apenas valores novos e atualizados no mesmo formato de registro.
- Se apenas um único valor tiver sido atualizado em um registro, este bloco retornará apenas esse valor (juntamente com as chaves primárias e os parâmetros updatedAt e updatedBy). Se a mesma célula tiver sido atualizada várias vezes entre duas execuções deste bloco, então apenas a atualização final (o valor “atual”) será retornada por esse bloco.
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.
Bloco List Change Store History no Qlik Automate
Permissões
Para criar tabelas de gravação e interagir com a change-stores API, você precisa de permissões específicas. Para obter mais informações, consulte Permissões de tabela de gravação.