Trabalhos

Cada ação realizada no Workspaces gera um Trabalho. Estas permitem analisar o resultado das execuções realizadas; por exemplo, consultando o output da execução de um microsserviço. Trabalhos reúne todos os trabalhos realizados na organização, por isso também fornece registros históricos de execuções, o que permite utilizá-lo como registro de auditoria.

Vista de lista

A vista de trabalhos é composta pelos seguintes elementos:

• Opções do topo da interface
• Visualização de lista de trabalhos

Opções da parte superior

• Atualizar a lista de trabalhos e mostrar os valores atualizados.
• Restabelecer todas as configurações feitas para a visualização de trabalhos.
• Filtrar os trabalhos por antiguidade:
  • Hoje (filtro padrão)
  • Esta semana
  • Este mês
  • Este trimestre
  • Este ano
• O botão Cancelar permite cancelar os trabalhos em estado pendente.
• O botão Notificar permite inscrever-se em um trabalho específico para receber uma notificação por e-mail quando for concluído.
• O botão Exportar para permite exportar no tipo selecionado.
• O botão Meus filtros permite acessar Filtros predefinidos ou criados pelo usuário.
• Podem ser filtrados os trabalhos por qualquer parâmetro da lista no quadro Buscar.

Lista de trabalhos

A lista de trabalhos, como todas as vistas de lista de Workspaces, permite múltiplas opções de filtragem e personalização, definidas em Opções de filtragem nas listas.

Vista de detalhes

A visualização do detalhe inclui uma barra de progresso que indica a porcentagem do trabalho que já foi executado.

Estados

Um trabalho pode ter quatro estados:

• Pendente: a tarefa está pendente de início.
• Em curso: a tarefa começou e ainda está em processo.
• Concluído: a tarefa foi finalizada.
• Erro: a tarefa não foi finalizada corretamente ou foi finalizada com erros.
• Cancelado pelo usuário: quando um usuário cancela a tarefa.
• Concluído com erros: quando a tarefa foi concluída, mas pelo menos um passo falhou com erros não críticos.

Suponha que um trabalho leva muito tempo no estado "em andamento" sem registrar nenhuma informação. Nesse caso, seu estado mudará automaticamente para Erro. No entanto, isso não significa que o trabalho não será concluído com sucesso, mas sim que há um timeout devido a um bloqueio de atividade durante a execução da tarefa.

Informação disponível

Em todos os casos, os trabalhos incluem as seguintes informações:

• Mudança a realizar (INFO)
• Estado
• Data de criação
• Data de início
• Data de finalização
• Usuário que realizou a mudança (OWNER)

Na parte inferior da tela, dependendo do tipo de trabalho, podem aparecer as seguintes abas:

• Registros
• Workspaces

Registros

A aba de registros permite consultar os dados de cada passo na execução; por exemplo, quando se executa um microsserviço em um dispositivo e se quer verificar o output da execução do script. Esta informação é guardada no passo correspondente (linha de registros na lista).

Para melhorar a visibilidade do output de scripts, recomenda-se, no caso de scripts PowerShell, o uso do comando Write-Output em vez de Write-Host. Mais informações em Considerações sobre o código a utilizar.

Workspaces

A aba Workspaces permite ver de forma simples a informação dos dispositivos que executaram o trabalho, no caso de execuções múltiplas.

Assinatura de trabalhos

Esta função permite subscrever-se a trabalhos específicos, que ainda não começaram ou que estão em curso. O sistema notificará por e-mail quando forem concluídos.

Para assinar, é necessário selecionar os trabalhos da lista e ativar o botão Enviar notificação.