Lex Privacy AIManual do Sistema
Ajuda

Gestão de catálogos

Admin Catálogo

Crie e mantenha catálogos que associam uma taxonomia, fontes de dados e critérios de busca usados na Linhagem.

Visão geral

1. Para que serve

O módulo Admin Catálogo administra os catálogos disponíveis na unidade ativa. Cada catálogo reúne uma taxonomia, fontes de dados e até três critérios de busca para uso na Linhagem.

A tela principal permite pesquisar catálogos, identificar se usam uma taxonomia PII, consultar a origem (matriz ou filial) e executar ações de edição, compartilhamento, API e exclusão quando disponíveis.

Lista de catálogos com taxonomia, fontes, critérios, origem e ações
Figura 1 — Tela principal de Catálogos.

Consulta

2. Consultar catálogos

Use o campo Buscar catálogo... para localizar um registro pelo nome ou pela chave. A tabela apresenta:

Coluna Informação apresentada
Catálogo Nome e chave identificadora do catálogo.
Taxonomia Domínio de classificação associado.
Fontes Quantidade de fontes vinculadas ou Todas do escopo.
PII Indica quando a taxonomia do catálogo é de dados pessoais.
Critérios Critérios selecionados para busca e associação na Linhagem.
Origem Indica se o catálogo pertence à matriz ou a uma filial.

Cadastro

3. Escolher como criar um catálogo

  1. Clique em Novo Catálogo.
  2. Escolha Criar com IA (assistente), Criar no Canvas ou Criar manualmente (formulário).

Os três modos podem ser editados depois.

Modal Novo Catálogo com as opções assistente de IA, Canvas e formulário
Figura 2 — Modos de criação de um catálogo.

Cadastro manual

4. Criar ou editar pelo formulário

O formulário manual permite associar o catálogo a uma taxonomia já disponível e selecionar as fontes e os critérios que serão usados.

Campo Descrição Obrigatório
Nome Nome exibido para o catálogo. Sim
Chave Identificador único; usa letras, números e sublinhado. Sim na criação
Descrição Texto de apoio sobre a finalidade do catálogo. Não
Taxonomia Domínio de classificação associado ao catálogo. Sim
Critérios de busca Até três critérios marcados como pesquisáveis na taxonomia. Não
Fontes de dados Fontes incluídas no catálogo. Sem seleção, são usadas todas as fontes do escopo. Não
  1. Preencha Nome, Chave e Taxonomia.
  2. Informe a descrição, se necessário.
  3. Marque os critérios de busca e as fontes desejadas.
  4. Clique em Salvar.
Formulário para editar um catálogo com nome, chave, descrição, taxonomia, critérios e fontes
Figura 3 — Formulário de edição do catálogo.

Assistente

5. Criar um catálogo com IA

O assistente processa as fontes em segundo plano e apresenta uma prévia para revisão antes da publicação.

  1. Na tela Novo Catálogo, escolha Criar com IA (assistente).
  2. Na primeira etapa, informe nome, chave opcional, descrição e, quando aplicável, indique que a taxonomia é de PII (LGPD).
  3. Na segunda etapa, selecione uma ou mais fontes de dados.
  4. Na terceira etapa, descreva a Finalidade do catálogo para orientar a proposta de categorias.
  5. Clique em Iniciar processamento e aguarde a conclusão.
  6. Revise as categorias propostas e ajuste os nomes ou chaves dos campos quando necessário.
  7. Selecione até três critérios de busca para dados estruturados. Quando houver documentos, os critérios de dados não estruturados são apresentados separadamente.
  8. Escolha Aprovar e publicar, Salvar rascunho ou Reprocessar.

Se o processamento falhar, o assistente oferece a opção Tentar novamente. Durante um processamento em andamento, a ação disponível é Cancelar.

Primeira etapa do assistente de criação de catálogo com IA
Figura 4 — Identidade do catálogo no assistente de IA.
Segunda etapa do assistente de criação de catálogo com seleção de fontes
Figura 5 — Seleção das fontes que serão analisadas.
Terceira etapa do assistente de criação de catálogo com campo de finalidade
Figura 6 — Descrição da finalidade para a IA.
Prévia das categorias propostas pela IA para o catálogo
Figura 7 — Revisão das categorias propostas.
Seleção de critérios de busca estruturados e não estruturados
Figura 8 — Critérios de busca antes da publicação.

Canvas

6. Criar ou editar no Canvas

O Canvas apresenta o fluxo do catálogo em nós conectados. Ele organiza as etapas de identidade, fontes, finalidade, processamento, revisão de campos e publicação.

Na etapa de revisão, ajuste os nomes e aliases dos campos propostos pela IA, se necessário. Depois, selecione os critérios de busca e use Publicar ou Rascunho. O Canvas também oferece Reprocessar para executar novamente a análise.

Canvas de criação de catálogo com etapas conectadas de processamento e publicação
Figura 9 — Canvas para criar um catálogo com IA.
Canvas de edição de catálogo com campos classificados e critérios de busca
Figura 10 — Canvas com revisão e publicação do catálogo.

Ações

7. Ações disponíveis na listagem

Ação Uso
Criar API / Editar API Gerencia credenciais para consultas externas ao catálogo.
Compartilhar Permite à matriz escolher quais filiais podem visualizar o catálogo.
Editar Abre a escolha entre edição no Canvas e edição no formulário.
Excluir Solicita confirmação para remover o catálogo e seus vínculos.

O botão Compartilhar é apresentado para catálogos da matriz quando o usuário tem contexto de matriz. Catálogos padrão do sistema não apresentam a ação de exclusão.

Unidades

8. Compartilhar um catálogo com filiais

  1. Na listagem, clique em Compartilhar.
  2. Marque as filiais que poderão visualizar o catálogo.
  3. Clique em Salvar compartilhamento.

Sem nenhuma filial selecionada, o catálogo fica restrito à matriz. A matriz continua podendo visualizar catálogos das filiais ao trocar o contexto no cabeçalho.

Tela de compartilhamento de um catálogo com filiais
Figura 11 — Compartilhamento de um catálogo com filiais.

Integração

9. Disponibilizar uma API do catálogo

Use Criar API para gerar uma credencial que permita a uma aplicação externa consultar o catálogo sem login.

Dados da credencial

Campo Descrição
Identificação / parceiro Identificação opcional da aplicação consumidora.
Limite por minuto Quantidade máxima de requisições por minuto.
IPs autorizados Lista opcional de origens autorizadas. Vazia, permite qualquer origem.
Evitar duplicidades Impede o envio de dados repetidos quando habilitado.

Depois de criar a API, copie o token e a documentação exibidos. O token é mostrado uma única vez; se necessário, use Reemitir token para invalidar o anterior e gerar outro.

A documentação da API informa o endpoint, o header de autenticação, os parâmetros JSON criterion, value e sources, além de exemplos em cURL e do formato da resposta.

Para uma credencial existente, use Documentação, Editar, Reemitir token ou Revogar, conforme a necessidade. A revogação é auditada.

Tela de criação de uma API do catálogo
Figura 12 — Criação de uma API do catálogo.
API criada com o token exibido na tela
Figura 13 — API criada e token exibido uma única vez.
Documentação da API do catálogo
Figura 14 — Documentação da API do catálogo.
Proteja o token

Copie o token antes de fechar a janela e não o registre no manual, em screenshots ou em canais públicos. A aplicação não o exibe novamente após a criação.

Manutenção

10. Excluir um catálogo

  1. Na linha do catálogo, clique em Excluir.
  2. Confira a mensagem de confirmação.
  3. Confirme a exclusão ou clique em Cancelar.

A exclusão remove os critérios e os vínculos com fontes do catálogo. A taxonomia associada não é alterada. O catálogo PII padrão do sistema não pode ser excluído pela listagem.

Acesso

11. Permissões e cuidados

As operações do Admin Catálogo exigem a capacidade de gestão de políticas. O acesso efetivo também depende da identidade autenticada, da unidade ativa e das permissões configuradas para o perfil.

Revise antes de publicar

Confirme a taxonomia, as fontes e os critérios antes de publicar. Ao disponibilizar uma API, compartilhe o token somente com o parceiro autorizado.

Resumo

12. Principais fluxos

  • Consultar: Admin Catálogos → buscar catálogo → revisar taxonomia, fontes, critérios e origem.
  • Criar manualmente: Novo Catálogo → Criar manualmente → preencher dados → Salvar.
  • Criar com IA: Novo Catálogo → Criar com IA → identidade → fontes → finalidade → processar → revisar → publicar ou salvar rascunho.
  • Editar: linha do catálogo → Editar → escolher Canvas ou formulário → revisar → salvar/publicar.
  • Compartilhar: linha do catálogo → Compartilhar → selecionar filiais → Salvar compartilhamento.
  • Integrar: linha do catálogo → Criar API ou Editar API → criar, copiar a documentação, reemitir ou revogar a credencial.