Importações

Realize ações em lote

As importações permitem que sejam realizadas ações como criação, atualização, remoção, etc, em lote nos objetos do diretório.

Além disso, pode-se importar praticamente qualquer objeto do diretório como usuários, recursos, papéis, direitos, contas dentre outros.

A documentação do administrador descreve detalhadamente os objetos e ações que podem ser realizadas via importação e pode ser acessado nesse link.

Nova importação

Para configurar uma nova importação, via admin-console, deve-se seguir os passos:

1. Autentique-se no Admin console;

2. Acesse a página de importações através do menu Plataforma > Ferramentas > Importações > Importações;

3. Acionar o botão Nova importação;

4. Selecione a opção que deseja importar;

   • Esquema: representa o tipo de objeto que será importado ou que está relacionado à importação desejada

   • Ação: representa a ação de importação que será realizada sobre o objeto importado, exemplo:

     • Criar

     • Editar

     • Remover

     • Etc.

5. Acione o botão Continuar;

6. Acione o botão Selecionar arquivo e escolher o arquivo a ser utilizado na importação;

7. Acione o botão Continuar;

8. Forneça a justificativa para a importação e acionar o botão Finalizar.

Acompanhando uma importação

O processo de importação é realizado off-line, iniciado a partir da criação da importação, e pode ser acompanhado na página de listagem de importações:

1. Autentique-se no Admin console;

2. Acesse a página de importações através do menu Plataforma > Ferramentas > Importações > Importações;

3. Filtre e/ou selecione as entradas que deseja acompanhar.

Pode-se acessar o histórico de importações clicando no botão Histórico na página de listagem de importações.

Detalhando uma importação

Para detalhar as informações de uma importação, primeiro selecione uma linha de importação. Os passos para selecionar uma importação estão descritos em Acompanhando uma importação.

Ao clicar em uma linha da importação tem-se acesso à algumas informações adicionais bem como um botão Detalhar.

Ao clicar no botão Detalhar, tem-se a página de detalhamento com duas abas:

1. Resumo:

   • descreve os dados básicos da importação como o que foi importado, data da importação, quem realizou a importação, justificativa, etc.

2. Linhas:

   • descreve os detalhes de cada linha importada, seus campos e valores, bem como mensagens de erro caso ocorra na importação da linha.

A aba Resumo descreve os dados básicos de uma configuração de importação e a aba Linhas detalha as linhas de importação.

Os status possíveis para uma importação são:

1. Nova: a imporatação acabou de ser configurada e ainda não está em processamento;

2. Aguardando processamento: a importação já está em processamento;

3. Processada: a importação foi processada com sucesso e todas as linhas foram importadas adequadamente;

4. Processada com erro: a importação foi totalmente processada, mas uma ou mais linhas foram processadas com erro e nesse caso não foram importadas;

5. Cancelada: a importação foi cancelada por uma ação do administrador.

Cancelando uma importação

Caso seja necessário, pode-se cancelar uma entrada de importação que ainda não tenha sido processada. Para isso:

1. Autentique-se no Admin console;

2. Acesse a página de importações através do menu Plataforma > Ferramentas > Importações > Importações;

3. Filtre e/ou selecione as entradas que deseja cancelar e clique no botão Cancelar.

Throubleshooting

Alguns problemas podem ocorrer durante a importação e de modo geral estão correlacionados com o arquivo de dados e os dados informados.

A seção de Nova importação do guia do administrador descreve todos campos necessários por tipo de objeto, ou esquema, selecionado na importação.

Alguns campos são opcionais e alguns são obrigatórios. Toda importação deve ser feita com um arquivo no formato CSV.

O que é uma importação "Importada com erro"?

Quando uma ou mais linhas do arquivo de importação não são de fato importadas por conta de erros de dados ou inconsistência do arquivo, ocorre o processamento das demais linhas do arquivo.

Porém as linhas que não são importadas são sinalizadas com erro e o status da importação é dado como "Importada com erro".

No detalhamento da importação, descrito nesse link, define esse possível status e na aba Linhas pode-se verificar cada linha da importação, bem como as mensagens de erro por linha.

Uma nova importação pode ser feita apenas com as linhas com erro, após ajustes no arquivo de importação.

O que é uma linha com erro?

Uma linha de importação com erro representa uma linha não importada exatamente devido á algum erro de dado ou formato no arquivo.

Cada linha com erro, tem sua respectiva mensagem de erro descrita na própria linha, acessada no detalhamento da importação, na aba Linhas.