Upload em massa de itens da fila usando um arquivo CSV

Carregue itens de fila em massa para uma fila do Orchestrator 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.

There is a series of predefined column headers that you can use when building your CSV file, but you can also use other custom headers. After successfully uploading the CSV file, information contained in columns with predefined headers is mapped to columns as found in Orchestrator.

Information contained in columns with custom headers is placed under the Specific Data section of the corresponding item in Orchestrator. See detailed information about column mapping here and an example here.

Observação:

O upload é limitado a 15.000 itens por arquivo.

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. In the Queues page, Select the corresponding More Actions button for the desired queue, and then Upload Items. The Upload Items window is displayed.

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. Select Upload. The items are added to your queue according to the previously selected strategy.
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. Select Upload Items for the desired queue, and select the CSV file. Orchestrator parses the file to confirm it meets formatting rules.
2. Select the desired upload strategies and Select Upload to finish the process.
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