Formato dos arquivos de importação

A Importação permite que os objetos gerenciados pelo Blazon, tais como Usuários, Papéis, Recursos, Direitos, Contas, Membros de Direitos e Membros de Papéis, sejam inseridas, atualizados e até removidos no sistema de forma simples e rápida, em lote, por meio da utilização de um arquivo que contenha as informações necessárias para a alteração dos objetos dentro da plataforma.

O arquivo deve conter as informações a serem importadas, no formato de uma tabela na qual as colunas (campos da tabela) são separadas pelo caracter Vírgula (Formato CSV), que deve obrigatoriamente ser utilizado como delimitador entre os valores em cada linha da tabela. A primeira linha, que corresponde ao Nome da Coluna, é utilizada no processo de importação como cabeçalho das informações contidas nas linhas seguintes.

Portanto, o cabeçalho do arquivo CSV utilizado na importação variará de acordo com o esquema do objeto e com a ação a ser realizada, podendo ser (nas páginas a seguir * significa obrigatório, ** imutável e *** padrão).

É importante reforçar que os campos marcados com o caracter Asterisco (*) são obrigatórios e os campos marcados com dois caracteres Asterisco (**) são campos imutáveis que não mudam durante o ciclo de vida da entrada. Além disso alguns valores marcados com *** referem-se a valores padrão caso o campo não seja definido.

Observação: é possível ainda incluir os campos adicionais definidos na configuração dos esquemas de Usuários e Contas. Ressalte-se que a obrigatoriedade ou não desses campos variará de acordo com a configuração de cada campo.

A utilização de um dos campos, que identifica a entrada que será importada, é suficiente para o processo. Exemplos:

  • Atualização de usuário: basta a utilização do identifier ou do username do usuário para realizar o processo de atualização dos campos desejados.

  • Criação de associação a direito: basta a utilização do entitlementId ou do name para identificar o direito e a utilização do accountId ou do accountIdentifier para identificar a conta envolvida no processo de importação.

Last updated