Gerenciamento de filas no Orchestrator

Criação de uma fila

1. Na página Filas, clique em Adicionar fila. Duas opções são exibidas, permitindo criar uma nova fila ou vincular filas de outras pastas.
2. Clique em Criar uma nova fila. A janela Criar fila será exibida.
3. No campo Nome, insira um nome para a fila.
4. No campo Descrição, adicione uma descrição para a fila.
5. Selecione a caixa de seleção Impor referências exclusivas se quiser que as referências de transação sejam exclusivas ou não.
6. Marque a caixa de seleção Armazenar em formato criptografado se você quiser que os dados e resultados de itens de fila sejam criptografados no banco de dados.
   Observação:

   • A operação de criptografia não pode ser desfeita.
   • Apenas os valores de Dados específicos e Resultado de um item da fila estão sendo criptografados. Esses valores são criptografados apenas no banco de dados, protegendo conteúdo confidencial dos administradores do banco de dados. A IU do Orchestrator continua a exibir o conteúdo descriptografado. Para criptografia de ponta a ponta, você precisa criptografar o item da fila antes de adicioná-lo à fila.
   • Filas existentes não podem ser criptografadas. Como alternativa, você pode recriar a fila e selecionar a caixa de seleção Armazenar em formato criptografado.
   • Devido ao formato criptografado, não é mais possível realizar análises de relatórios nos campos Dados específicos e Resultado do banco de dados, e os painéis correspondentes no Insights não estão disponíveis.
7. Na seção Repetição automática, você pode encontrar duas opções, da seguinte forma:
   • Itens com falha - se ativo, tenta novamente quaisquer itens de fila que falham após criar a fila.
   • Itens abandonados - se ativo, revela o campo Número máximo de repetições, onde você pode definir o número máximo de novas tentativas para itens de fila abandonados. Se inativas, as transações serão abandonadas após 24 horas de inatividade.
   Observação: os itens de fila tentados novamente são marcados de acordo na interface do usuário.
8. Carregue um esquema JSON para cada Dado específico, Dados de saída e Dados do Analytics usando o botão Procurar correspondente.
9. Habilite as previsões do SLA se quiser controlar melhor o tempo de processamento dos seus itens e avaliar de quais recursos você precisa para cumprir seu prazo. Se as previsões de SLA estiverem habilitadas, configure os seguintes campos:
   • No menu suspenso Processo, selecione o processo que lida com os itens da fila e preencha o valor do SLA abaixo. O valor máximo é de 90 dias.
   • Habilite o SLA de risco se você quiser definir uma zona de buffer antes do SLA real, e preencha o valor abaixo. O SLA de risco deve ser menor que o SLA.
10. Clique em Adicionar. A fila é criada e exibida na página Filas e ela está vazia.

Você pode preencher as filas usando o Studio ou na janela Carregar itens. O processamento de itens de uma fila só é possível usando o Studio. Para obter mais informações, consulte a página Gerenciar filas no Studio.

Editar Filas

Você pode atualizar as configurações de fila existentes, como:

• Nome e Descrição da fila
• A seção Repetição automática
• O número máximo de repetições

Como editar o nome ou descrição de uma fila

Para editar um nome de fila existente no Orchestrator:

1. Na página Filas, clique no botão Mais Opções para a fila desejada.
2. Clique em Editar . O assistente Atualizar Fila é exibido.
3. No campo Nome, insira o novo nome para a fila selecionada.
   Observação:

   • Certifique-se de inserir um nome exclusivo. Se uma fila com o mesmo nome já existir no seu tenant, você receberá a mensagem de erro: The name <QueueName> is already used. (#1001).
   • O nome não é sensível a maiúsculas e minúsculas. Portanto, NEW_QueueName e new_queuename são duplicatas.
4. No campo Descrição, atualize a descrição da sua fila.
5. Clique em Atualizar.
   Importante: certifique-se de atualizar o nome da fila nos fluxos de trabalho correspondentes no Studio. Você deve fazer isso manualmente, pois não há maneira automática de atualizar o nome de fila no Studio.

Alteração das opções de Repetição automática

Para alterar as opções na seção Repetição automática para uma fila existente:

1. Na página Filas, selecione o botão Mais opções para a fila desejada.
2. Selecione Editar . Em seguida, o assistente Atualizar fila é exibido.
3. Na seção Repetição automática, selecione a opção que você precisa.
4. Selecione Atualizar.

Definir um número máximo de repetições

Itens abandonados: caixa de seleção selecionada

Se você selecionou a opção Itens abandonados, o campo Número máximo de repetições será exibido.

Insira um valor na faixa de 1 a 50 como a quantidade de repetições de transações com falha.

Importante:

1. As transações existentes com falha não são repetidas. Apenas as transações que falham após você definir o novo valor são repetidas.

2. Novas tentativas manuais não são contadas para o número máximo de novas tentativas definidas para itens de fila. Em tais casos, na API, RetryNumber é 0 e AncestorId é null.

Além disso, cada item da fila aponta, por meio do campo Key, para o item da fila original de uma cadeia de repetições.

Os seguintes campos estão incluídos:

• ManualRetryNumber - a quantidade de repetições manuais de um item da fila
• ManualAncestorId - o ID do item da fila que foi repetido manualmente
• ManualAncestorUniqueKey - o GUID exclusivo global do item da fila que foi repetido manualmente
• UniqueKey - o GUID exclusivo global de qualquer item da fila (diferente para cada repetição, manual ou automática)
• AncestorUniqueKey - o GUID exclusivo global do item da fila que foi repetido automaticamente
• RetryNumber - a quantidade de repetições automáticas de um item da fila
• AncestorId - o ID do item da fila que foi repetido automaticamente
• Key - o GUID do item da fila inicial de uma cadeia de repetições

O objetivo é ter a rastreabilidade completa das repetições de itens da fila.

3. Os itens de fila repetidos e excluídos não participam de verificações de referência exclusivas. Dessa forma, recomendamos que você não exclua um item da fila inicial de uma cadeia de repetições, pois isso impede a validação de referências exclusivas. No entanto, se o item da fila inicial tiver sido coletado por retenção de dados, essa validação ainda será realizada.

Digamos que você tenha uma lista de transações falhas que estejam sendo repetidas uma vez. O valor atual do Número Máximo de repetições é 2. Atualize o valor para 3 e as transações falhas são repetidas mais duas vezes em vez de uma.

Itens abandonados: caixa de seleção não selecionada

Se você não selecionou a opção Itens abandonados, o campo Número máximo de repetições será oculto.

Nenhuma transação está sendo repetida.

Gerenciamento de Links de Fila

Compartilhar filas entre as pastas habilita o lançamento de trabalhos em várias pastas sem reprojetar seus fluxos de trabalho no Studio quando os processos subjacentes estão direcionados a essa fila. Vincular uma fila a uma pasta torna a fila e todos os objetos associados a ela, como os itens de fila, disponíveis nessa pasta.

Observação:

Uma fila vinculada a várias pastas é marcada usando o ícone . Se o ícone não estiver presente, a pasta atual é a única pasta na qual a fila reside. Excluí-lo aqui remove completamente a fila do Orchestrator.

Você precisa da permissão Filas - Criar nas pastas onde deseja adicionar a fila (pastas de destino) e Filas - Exibir na pasta na qual a fila reside atualmente (pasta original). Se você tiver Filas - Editar na pasta de destino, você também precisa de Filas - Editar na pasta original.

Vinculação de várias filas à pasta atual

1. Na pasta a qual deseja vincular uma fila, na página Filas Clique em Adicionar. Três botões são exibidos permitindo que você adicione uma fila, vincule filas de outras pastas ou oculte as opções.
2. Clique em Link de outras pastas. A janela Vincular Filas é exibida, mostrando uma lista de todas as filas nas pastas nas quais você tem permissões de Exibir em Filas.
3. Na seção Selecionar Filas, selecione uma ou várias filas na lista.
   
   

   

   
   
4. Clique em Continuar. Você será direcionado à seção Validação da Pasta. Aqui você pode ver as pastas às quais as filas já estão vinculadas. Se houver várias pastas, seus nomes serão exibidos.
   
   

   

   
   
5. Clique em Remover para a fila correspondente para reverter a alteração ou clique em Sair para cancelar a operação.
6. Clique em Vincular se quiser criar o link entre as filas que você selecionou e a pasta atual. As filas são exibidas na página Filas.
   
   

   

   
   

Vincular uma fila a várias pastas

1. Navegue até uma pasta em que a fila a ser vinculada reside.
2. Clique em Mais ações > Gerenciar Links para a fila desejada para abrir a janela Gerenciar Links. A janela Gerenciar Links de Fila é exibida.

   1 - Painel da esquerda, exibindo todas as pastas que receberam permissões para Visualizar em Filas. 2 - O estado atual da fila, exibindo o número de pastas nas quais reside atualmente bem como seus nomes. 3 - As pastas nas quais a fila deve ser adicionada de acordo com sua seleção no painel da esquerda. 4 - As pastas das quais a fila será removida.

   
   

   

   
   
3. Clique em Atualizar. Uma janela de confirmação é exibida.
4. Clique em Cancelar se quiser abortar as alterações ou Continuar para que as alterações entrem em vigor. As operações estão agora refletidas no Orchestrator de acordo com suas alterações.

Desvinculação de filas das pastas

A desvinculação das filas das pastas pode ser executada de uma maneira semelhante à operação de vinculação. Navegue até as áreas de gerenciamento de links apresentadas nos procedimentos acima e remova as conexões entre uma determinada fila e uma determinada pasta.

Como alternativa, você pode remover uma fila usando a funcionalidade Remover.

Importante:

Remover uma fila que existe em várias pastas apenas a remove da pasta na qual a operação de remoção é realizada, ele não a remove das outras pastas. Para excluir completamente uma fila, você deve remover todos os seus links existentes.

Você pode desvincular uma fila de uma pasta nas seguintes situações:

• a SLA da fila foi habilitada nessa pasta;
• um gatilho de fila está anexado à fila.

Exibição de transações

Na página Filas , clique em Mais ações > Exibir transações. A página Transações é exibida, contendo apenas os itens da fila indicada.

Exibição de solicitações de revisão

Na página Filas, clique em Solicitações de Revisão para exibir todos os itens da fila atribuídos para revisão ao usuário atualmente logado. A página permite alterações de status e o gerenciamento de informações dos itens.

Exibição do gráfico de filas

Para exibir o gráfico para uma fila específica, clique no botão Mais ações e, em seguida, Exibir gráfico.

Um gráfico de linha exibe a evolução de status da transação durante um período de tempo específico. O período de tempo (última hora, dia, semana e 30 dias) pode ser alterado e você pode ver o tempo de execução médio e o número máximo de repetições.

Upload de itens em uma fila usando um arquivo CSV

Consulte aqui os detalhes sobre o carregamento de itens de fila usando um arquivo CSV.

Monitorar uma fila

Para monitorar uma fila, clique no botão Mais ações correspondente e depois em Monitorar Fila. Como alternativa, selecione-o no widget Visão geral de filas (Monitoramento > Filas).

Observe que o monitoramento de uma fila exige que seu usuário tenha permissões de Visualização em filas e em monitoramento. Além disso, é necessário Editar no Monitoramento para desabilitar erros do Feed de erros na página Monitoramento > Filas.

Como adicionar tags às filas

Observação:

Você precisa ter as permissões de Editar em filas e Visualizar em tags para adicionar tags existentes às filas.

Você precisa ter as permissões de Editar em filas e Criar em tags para adicionar novas tags às filas.

Observação:

• Cada fila pode ter no máximo um milhão de pares de chave/valor.
• Rótulos e propriedades de chave/valor tem um limite de 256 caracteres.
• Nomes de tags não podem conter estes caracteres: <, >, %, &, \)\), ?, /, :

É possível aplicar tags em uma fila no momento de sua criação ou ao editar uma já existente. Para adicionar tags a uma fila ao editá-la, siga estas etapas:

1. Na página Filas, clique em Mais ações > Editar ao lado da fila desejada. A fila será aberta para edição.
2. No campo Rótulos, comece a digitar o nome do rótulo. Você pode escolher um rótulo existente ou criar um novo.
3. No campo Propriedades (pares de chave-valor), clique em Adicionar novo.
4. Adicione novas chaves e valores. Você pode escolher chaves e/ou valores existentes, ou pode criar novos.
5. Quando finalizar, clique em Atualizar. Sua fila será atualizada, e as tags recém-criadas, caso haja alguma, ficarão disponíveis para outros objetos.

Como remover tags de filas

Para remover tags de uma fila, siga estas etapas:

1. Na página Filas, clique em Mais ações > Editar ao lado da fila desejada. A fila será aberta para edição.
2. No campo Rótulos, clique no X ao lado do nome do rótulo para removê-lo. O rótulo será removido.
3. No campo Propriedades (pares de chave-valor), clique no X ao lado das chaves e/ou valores para removê-los. As chaves e/ou valores serão removidos.
4. Para excluir um par de chave/valor, clique no ícone Remover correspondente a essa entrada. O par chave/valor será removido.
5. Quando finalizar, clique em Atualizar. Suas filas serão atualizadas e as tags serão removidas.

Remover uma fila

Para remover uma fila, clique no botão Mais ações correspondente e, em seguida, em Remover.

Como alternativa, selecione-o na página Filas e clique em Remover. A fila não é mais exibida na página Filas.

Importante: a remoção de uma fila que existe em várias pastas apenas a remove da pasta na qual a operação de remoção ocorrer; ela não a removerá das outras pastas. Para excluir completamente uma fila, você deve remover todos os seus links existentes.

Observação: Após uma fila ser excluída, os itens de transação atribuídos pertencentes à fila não ficam mais visíveis na página Analisar solicitações.

Gravação de transações da fila com falha

Você pode gravar transações da fila com falha associadas a um processo que tem a opção de gravação habilitada. Isso ajuda a identificar e solucionar problemas que levam a falhas e ajuda no monitoramento e na auditoria.

Esta opção está habilitada no nível do processo, na seção Gravação de trabalhos da guia Configurações adicionais.

Se um processo contendo uma fila falhar, sua execução é gravada e disponibilizada no Orchestrator nos seguintes lugares:

• No nível da fila, clicando em Abrir gravação no menu contextual da fila afetada.

  Esta opção não estará ativa se:

  • a fila estiver associada a um processo cuja execução não falhou.

  • a opção Gravar e armazenar transações da fila com falha não tiver sido habilitada para o processo ao qual essa fila está associada.

• No nível da transação, clicando em Abrir gravação na janela Visualizar detalhes da transação afetada.

Duração da gravação

A duração máxima da gravação é de 3 minutos, e se aplica aos últimos momentos da execução.

A duração mínima da gravação é de 10 segundos. Se o processamento de uma transação levar menos de 10 segundos, a gravação também pode incluir outras transações.