Importando artefatos de governança por tipo com arquivos CSV

Pré-requisitos

Antes de importar artefatos de governança com um arquivo CSV, crie o arquivo com o formato correto e certifique-se de ter as permissões necessárias.

Preparando-se para importar artefatos de governança

Antes de se importar artefatos de governança, todas as categorias e subcategorias que estão listadas no arquivo de importação para esses artefatos devem existir. Caso contrário, os artefatos com categorias indefinidas não são importados. Para obter mais informações, consulte Solutando problemas de importação de artefatos de governança.

Antes de importar um arquivo CSV com definições de categorias, as categorias de nível superior devem existir, a menos que você as defina no arquivo.

Para criar as categorias necessárias, você pode utilizar qualquer um desses métodos:

• Crie as categorias através da UI. Veja Gerenciando categorias.
• Importe as categorias com um arquivo CSV, seja por meio da interface do usuário ou com uma solicitação de API.

Seus arquivos de importação podem incluir relacionamentos para outros tipos de artefatos de governança que você ainda não importou. Os artefatos que são definidos no arquivo são criados. No entanto, os relacionamentos para artefatos que não existem não são criados e você recebe uma mensagem de erro. Você pode adicionar os relacionamentos importando os arquivos que receberam erros novamente depois de importar e publicar os outros tipos de artefatos de governança.

Importando um arquivo CSV pela interface do usuário

Para importar um arquivo CSV através da interface do usuário:

1. Se necessário, crie categorias. Veja Preparando para importar artefatos de governança.

2. A partir do menu de navegação, abra a seção Governança e selecione Categorias, Termos de Negócios, Classificações, Classes de dados, Dados de referência, Políticas, ou Regras.

3. Clique em Adicionar artefato-tipo > Importar do arquivo. Se o botão estiver desativado, certifique-se de ter as permissões necessárias.

4. Adicione seu arquivo CSV.

5. Configure o método de mesclagem para resolver conflitos com quaisquer artefatos existentes:

   • Substituir todos os valores
   • Substituir por valores definidos
   • Substitua valores vazios

   Para novos artefatos, cada um desses métodos produz os mesmos resultados.

6. Clique em Importar. O processo de importação é executado de forma assíncrona Se você deixar a janela de importação aberta, poderá visualizar os resultados de importação. Caso contrário, é possível fechar a janela de importação para continuar trabalhando. No entanto, você não é notificado quando a importação está completa e não é possível acessar os resultados de importação.

7. Quando o processo de importação estiver concluído, termine seus artefatos e categorias.

Importando arquivos CSV com uma solicitação de API

Na solicitação de API, você pode especificar para executar processos de importação paralelos ou configurar a especificação do tipo de conteúdo para uma codificação diferente do UTF-8.

Para importar um arquivo CSV usando a API REST:

1. Se necessário, crie categorias. Veja Preparando para importar artefatos de governança.
2. Envie uma solicitação POST /v3/governance_artifact_types/{artifact_type}/import. Configure os parâmetros de consulta:
   1. Configure o parâmetro merge option para resolver conflitos com artefatos existentes:
      • all: Substitua todos os valores.
      • specified: Substitua com valores definidos
      • empty: Substitua valores vazios
   2. Opcional. Configure o parâmetro async_mode para true se você quiser executar vários processos de importação em paralelo.
   3. Se necessário, inclua informações de codificação na solicitação de API. Consulte Importação de arquivos CSV com codificação diferente de UTF-8. Consulte a documentação da API: Importar valores do arquivo CSV especificado. Após a solicitação ser enviada, um ID do processo é fornecido na resposta (parâmetro process_id ).
3. Opcional. Você pode utilizar o ID do processo que é fornecido na resposta para verificar o status da importação. Envie uma solicitação GET /v3/governance_artifact_types/import/status/{process_id} para devolver o status do processo de importação. Consulte a documentação da API: Status da importação
4. Quando o processo de importação estiver concluído, termine seus artefatos e categorias.

curl -X POST "https://{server}:{port}/v3/governance_artifact_types/{artifact_type}/import?merge_option={merge_option}" -H "accept: application/json" -H "Authorization: $AUTHORIZATION_HEADER" -H "content-type: multipart/form-data" -F "file=@\"./import_glossary.csv\";type=text/csv;charset=windows-1250" -k

Terminando seus artefatos e categorias

Os artefatos de governança no seu arquivo CSV são importados como rascunhos e estão sujeitos ao fluxo de trabalho. Os artefatos de rascunho devem seguir o fluxo de trabalho para esse tipo de artefato de governança. Você pode visualizar os artefatos de governança de rascunho na guia Rascunho para o respectivo tipo de artefato, por exemplo, termos de negócios.

Para finalizar seus artefatos importados:

1. Depois de importar todos os tipos de artefatos, pubque todos os artefatos de rascunho. Vá em sua Caixa de entrada de tarefas e inicie o processo de publicação. Você deve ter permissão para publicar os artefatos. Veja Fluxos de Workflows para artefatos de governança.
2. Se necessário, reexecute a importação para arquivos que receberam erros de relacionamento com o método de mesclagem Substituir todos os valores . Em seguida, pubque os artefatos atualizados.

Quaisquer categorias que você importar são publicadas imediatamente porque as categorias não estão sujeitas a fluxo de trabalho. As categorias importadas possuem os seguintes colaboradores:

• Você é um colaborador em todas as categorias que você importa, com a função Proprietário .
• Se você importar novas categorias de alto nível, você é o único colaborador.
• Se você importar subcategorias para as categorias existentes, as novas subcategorias herdam todos os colaboradores de suas categorias de nível superior.

Para obter mais informações, consulte Solutando problemas de importação de artefatos de governança.

Para finalizar suas categorias importadas, inclua outros colaboradores nas novas categorias. Se você adicionar o grupo Acesso Público a uma categoria importada, ele tem a função de categoria Editor designada por padrão, em vez da função Viewer , que é atribuído a este grupo quando você cria manualmente categorias.

Veja Gerenciando colaboradores da categoria.

Tratamento de erros de importação

Ao importar artefatos de um arquivo CSV, algumas linhas podem ser ignoradas se os valores não atenderem aos requisitos. A tabela a seguir resume como as linhas com valores inválidos são tratadas no processo de importação.

Saiba Mais

• CSV formato de arquivo para importar artefatos de governança