Upload em massa de itens da fila usando um arquivo CSV

Essa funcionalidade permite que você carregue itens da fila em massa em uma fila específica no Orchestrator usando um arquivo CSV. Para fazer isso, primeiro, carregue seu arquivo na sua instância do Orchestrator para uma fila específica. Após o arquivo ser processado com sucesso, os itens contidos nele são carregados na fila de acordo com a estratégia selecionada. Observe que o arquivo deve ser preenchido previamente usando formatos predefinidos para que a operação de upload seja bem-sucedida.

Há uma série de cabeçalhos de coluna predefinidos que você pode usar ao criar seu arquivo CSV, mas também pode usar outros cabeçalhos personalizados. Depois de carregar o arquivo CSV com êxito, as informações contidas nas colunas com cabeçalhos predefinidos são mapeadas para colunas conforme encontradas no Orchestrator. As informações contidas em colunas com cabeçalhos personalizados são colocadas na seção Dados Específicos do item correspondente no Orchestrator. Consulte informações detalhadas sobre o mapeamento de colunas aqui e um exemplo aqui.

Observação:

O upload é limitado a 15.000 itens por arquivo. Você pode baixar o limite usando a configuração do aplicativo Upload.Queues.MaxNumberOfItems .

Mapeamento de colunas

Cabeçalho da coluna do arquivo	Campo do Orchestrator
Referência Obrigatório para filas de referência exclusivas. É compatível com todos os caracteres especiais, exceto aspas duplas - ".	Referência Observação: as referências não são compatíveis com as versões v2016.2 ou inferiores do Orchestrator ou do Robot.
Prazo Se usados, eles devem ser preenchidos com uma data em um dos seguintes formatos: DD-MM-AAAA AAAA/MM/DD AAAA MM DD AAAA-MM-DD HH:mm AAAA/MM/DD HH:mm AAAA MM DD HH:mm AAAA-MM-DD HH:mm:ss AAAA/MM/DD HH:mm:ss AAAA MM DD HH:mm:ss	Prazo
Adiar Se usados, eles devem ser preenchidos com uma data em um dos seguintes formatos: DD-MM-AAAA AAAA/MM/DD AAAA MM DD AAAA-MM-DD HH:mm AAAA/MM/DD HH:mm AAAA MM DD HH:mm AAAA-MM-DD HH:mm:ss AAAA/MM/DD HH:mm:ss AAAA MM DD HH:mm:ss	Adiar
Prioridade Se usados, eles devem ser preenchidos com uma data em um dos seguintes formatos: Low or 1 Normal or 2 Alta ou 3 Se a prioridade não estiver especificada no arquivo, os itens serão carregados com uma prioridade alta, por padrão.	Prioridade Mapeada para os seguintes valores, respectivamente: Baixa Normal Alta
[Custom_Name] O nome só pode ser composto por caracteres alfanuméricos: 0-9, a-z ou sublinhados.	Dados Específicos Mapeado no formato JSON. Por exemplo: On-Us Check: 5540

Observe que você não pode ter cabeçalhos de colunas vazios em seu arquivo.

Observação:

Os cabeçalhos de colunas predefinidos diferenciam maiúsculas de minúsculas e, portanto, certifique-se de seguir as regras de mapeamento acima. Uma coluna em seu CSV chamada reference é mapeada para a seção Dados Específicos, em vez da coluna Referência.

Estratégias de carregamento

Há duas estratégias para lidar com o carregamento:

• ProcessAllIndependently - processa todos os itens individualmente e os adiciona à fila, se for bem-sucedido. Caso contrário, retorna uma lista daqueles cujo processamento falhou.Você tem a opção de baixar a lista em um arquivo CSV preenchido com os mesmos campos do arquivo carregado inicialmente.
• AllOrNothing - adiciona os itens apenas se todos eles forem processados com sucesso. Caso contrário, nenhum será adicionado.

Digitação dinâmica

Ao carregar itens da fila para filas com definições de esquema, às vezes você precisa que o Orchestrator interprete os caracteres String como inteiros ou booleanos para corresponder à definição do esquema.

A tipagem dinâmica é uma opção que permite controlar como o Orchestrator analisa o valor da string dentro dos arquivos.csv usados para carregar itens da fila.

Observação:

Os dados numéricos devem estar de acordo com a definição de um literal decimal. Valores numéricos maiores que 2⁵³ ou menores que -2⁵³ não são convertidos em Inteiros para preservar a precisão. Certifique-se de usar o ponto como separador decimal e a vírgula como separador de milhar.

Carregar itens da fila usando um arquivo CSV

Esta seção trata da adição de itens a uma fila usando um arquivo CSV a partir do Orchestrator.

1. Na página Filas, clique no botão Mais ações correspondente à fila desejada e, em seguida, clique em Carregar Itens. A janela Carregar Itens é exibida.

   Figura 1. Carregar Itens

   

2. Selecione Pesquisar e selecione o arquivo CSV desejado.

3. Selecionar Abrir. Se seu arquivo estiver em conformidade com as regras de formatação compatíveis, a operação de carregamento será bem-sucedida.

4. Selecione a estratégia de carregamento:

   • Processar todos independentemente - processa todos os itens individualmente e os adiciona à fila, se for bem-sucedido. Caso contrário, retorna uma lista daqueles cujo processamento falhou.Você tem a opção de baixar a lista em um arquivo CSV preenchido com os mesmos campos do arquivo enviado inicialmente
   • Todos ou nenhum - adiciona os itens apenas se todos forem processados com sucesso. Caso contrário, nenhum será adicionado.

5. Selecione a caixa de seleção Tipagem dinâmica se você quiser que o Orchestrator interprete caracteres de string nos arquivos CSV como inteiros ou booleanos. Isso é recomendado ao carregar itens de fila para filas com definições de esquema quando é necessário corresponder à definição de esquema. Leia mais sobre a tipagem dinâmica. Deixe-a desmarcada se quiser que as strings sejam interpretadas como strings.

   Figura 2. Digitação dinâmica

   

6. Clique em Carregar. Os itens são adicionados à sua fila de acordo com a estratégia selecionada anteriormente.

7. Se você usou a opção Processar todos independentemente e houver itens não processados, o botão Carregar se tornará Baixar e habilitará você a baixar um arquivo CSV contendo os itens não processados.

Exemplo

Digamos que você carregue em uma fila o conteúdo do seguinte arquivo CSV. Uma maneira fácil de criar esse arquivo é preencher os dados em um arquivo do Excel e salvá-lo como um arquivo CSV.

Ou você pode baixar um arquivo .CSV com todos os cabeçalhos de colunas pré-preenchidos e personalizá-lo de acordo com suas necessidades.

Observe que esse arquivo contém três colunas predefinidas, com o mesmo nome que no Orchestrator (Referência, Prazo e Prioridade, destacadas em verde) e duas colunas personalizadas (Cliente e Cor, destacadas em vermelho).

Figura 3. Arquivo CSV

1. Clique em Carregar Itens para a fila desejada, e selecione o arquivo CSV. O Orchestrator analisa o arquivo para confirmar se ele atende às regras de formatação.
2. Selecione as estratégias de carregamento desejadas e clique em Carregar para concluir o processo.
3. Selecione Mais ações > Exibir transações para exibir os itens da fila carregados.

A página Transações exibe cada item carregado do seu arquivo. As informações contidas nas colunas predefinidas do arquivo são mapeadas para as colunas com o mesmo nome no Orchestrator (Referência, Prazo e Prioridade, destacadas em verde).

Figura 4. Página de transações

As informações nas colunas personalizadas são mapeadas no formato JSON para a seção Dados específicos de cada item. Selecione Exibir detalhes para o item desejado verificar os detalhes.

Figura 5. Aba Detalhes