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.

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.

You can lower the limit using the Upload.Queues.MaxNumberOfItems app setting.

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 References are not compatible with v2016.2 or lower versions of Orchestrator or 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. Select Open. If your file is compliant with the supported formatting rules, the upload operation is successful.

4. Select the upload strategy:

   • 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. Select the Dynamic typing checkbox if you want Orchestrator to interpret string characters in the CSV files as integer or boolean. This is recommended when uploading queue items to queues with schema definitions when it's required to match the schema definition. Read more about dynamic typing. Leave it unselected, if you want strings to be interpreted as 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