Verifique a prontidão antes de um fechamento

Descrição

Nos dias mais importantes (fim de mês, o envio de uma previsão, um pacote para o conselho), a pergunta não é “o que o Weave notou?”, e sim “estamos prontos?”. Um conjunto de prontidão nomeia os fluxos de trabalho dos quais um prazo depende, e selecionar o conjunto responde a essa pergunta para todos eles de uma vez, em uma única lista de verificação que abre com a própria contagem:

11 de 13 prontos; 1 não pronto; 1 não foi possível verificar.

Cada fluxo de trabalho do conjunto recebe uma de três respostas, a pior de suas linhas. Ele fica Não pronto quando qualquer verificação encontrou um problema; o problema é listado abaixo dele com os mesmos botões Corrigir, Ir para e Como o Weave sabe da guia Weave. Caso contrário, fica Não foi possível verificar quando alguma verificação não teve como avaliá-lo, e o motivo é escrito por extenso. Fica Pronto somente quando toda verificação que o Weave pôde executar nele foi aprovada. Nada que o Weave não avaliou é mostrado como pronto, com uma exceção: uma última execução com pouco histórico anterior para comparar conta como habitual, como descrito abaixo.

Um problema que alguém marcou como esperado ainda deixa a linha dele Não pronto, e a linha diz que foi marcado como esperado. A guia Weave deixa de relatar esse problema; a lista de verificação continua dizendo o que é verdade.

As verificações são as regras que o Weave já executa (nenhuma IA é usada), então uma lista de verificação não tem custo, não importa quantas vezes você a peça. Para saber o que essas regras leem e o que suas respostas significam, veja O que o Weave verifica.

Crie um conjunto de prontidão

1. Abra a guia Weave do projeto e clique em Prontidão na barra de ferramentas em Constatações.
2. Clique em Novo. Dê um nome ao conjunto, como “Fechamento do mês”, e mova os fluxos de trabalho dos quais ele depende de Fluxos de trabalho no projeto para Fluxos de trabalho neste conjunto.
3. Opcionalmente, marque Tem prazo e informe quando o conjunto vence, como uma expressão cron e o fuso horário em que ela está escrita: as mesmas opções que um evento agendado oferece. 0 9 5 * * é 09:00 no dia 5 de todo mês, e 0 8 * * 1 é 08:00 toda segunda-feira, nesse fuso horário. Os deslocamentos são lidos como um evento agendado os lê: UTC +0 é o horário de Londres, inclusive o horário de verão britânico, e alguns outros deslocamentos seguem o horário de verão de um lugar nesse deslocamento, enquanto os demais são fixos. A página Agendador de eventos lista como cada deslocamento é lido.
4. Para um conjunto com prazo, em Avisar o responsável esta quantidade de horas antes do vencimento, informe com quanta antecedência do prazo o Weave deve enviar a mensagem, de 1 a 168 horas. O padrão é 24.
5. Clique em Salvar.

Um conjunto pertence ao projeto, e todos que têm Constatações na guia Weave do projeto podem verificá-lo. Somente um Arquiteto do projeto pode criar, editar ou excluir um conjunto, e todo fluxo de trabalho de um conjunto deve estar nesse projeto. Quem salvou um conjunto por último é o responsável por ele. Duas pessoas que editam o mesmo conjunto ao mesmo tempo são mantidas separadas: o segundo salvamento é recusado, o conjunto é lido de novo e o formulário mostra a cópia mais nova com o motivo.

O Weave só pode considerar atualizada uma tabela de entrada quando algo diz quando ela deveria ter sido gravada: um agendamento no fluxo de trabalho que a grava ou um limite de atualização na tabela. Defina-os primeiro, ou a primeira linha da maioria dos fluxos de trabalho dirá Não foi possível verificar.

Leia a lista de verificação

Selecione um conjunto à esquerda. O Weave lê o projeto inteiro (a mesma leitura que a guia Weave faz) e avalia cada fluxo de trabalho do conjunto. Clique em Verificar novamente depois de corrigir algo.

Cada item mostra o nome do fluxo de trabalho, seu veredito e uma linha para cada verificação que se aplica a ele. Quando uma linha diz Não foi possível verificar, o motivo é escrito por extenso ao lado; estes são os motivos que você mais provavelmente encontrará:

Linha	O que o Weave compara	Motivos comuns de dizer “não foi possível verificar”
As entradas estão atualizadas	Toda tabela que o fluxo de trabalho lê, em relação aos agendamentos dos fluxos de trabalho que a gravam, ou ao limite de atualização da própria tabela.	Sua função não pode ler tabelas; o Weave não conseguiu determinar quais tabelas ele lê, ou ele não lê nenhuma que o Weave consiga seguir; uma tabela que ele lê está oculta de você; uma etapa lê uma tabela que o Weave não consegue determinar, como uma escolhida com uma variável; uma tabela que ele lê não tem nem gravador agendado nem limite de atualização, então nada diz quando ela deveria ter sido gravada; o fluxo de trabalho que a grava está em execução, na fila ou acabou de terminar.
A última execução foi bem-sucedida	A execução mais recente do fluxo de trabalho, que deve ter terminado. Uma execução que falhou fica Não pronto.	Ele não tem execuções registradas, seu histórico de execuções não pôde ser lido, ou sua última execução foi interrompida ou ainda está em andamento.
A última execução pareceu habitual	Quanto tempo a última execução levou e quantas linhas suas tabelas continham depois, quantos valores vazios continham e como seus valores se distribuíam, em relação às execuções anteriores.	A última execução falhou, foi interrompida ou ainda está em andamento, então não há nada habitual para comparar; o acesso a linhas se aplica a uma tabela que ela gravou, então os valores dessa tabela não são comparados; a execução inclui etapas que sua função não pode ver.
Entradas inalteradas desde a última execução	Se uma tabela que ele lê foi gravada por outro fluxo de trabalho depois que ele a leu pela última vez.	Sua função não pode ler tabelas; o Weave não consegue acompanhar o que o fluxo de trabalho lê; ou o fluxo de trabalho não tem execuções para comparar.
O agendamento está íntegro	Seus eventos agendados: cronogramas válidos, em sincronia com o agendador, nenhuma execução vencida perdida, nenhum vencimento perdido por causa de uma execução ainda em andamento.	O agendador não pôde ser lido.
As reconciliações fecham	Cada reconciliação vinculada ao fluxo de trabalho, em sua versão aprovada, executada como você.	Uma ainda não foi aprovada; sua função não pode ler dados de tabelas; o acesso a linhas mostra a você apenas algumas das linhas de um lado; uma tabela ou coluna que ela usa mudou; a lista de verificação ficou sem tempo para elas.

Um fluxo de trabalho sem eventos agendados não tem a linha O agendamento está íntegro, e o item diz que ele não é agendado. Um fluxo de trabalho sem reconciliação vinculada não tem a linha As reconciliações fecham. Isso é um fato sobre o fluxo de trabalho, não algo que o Weave deixou de verificar.

Um fluxo de trabalho que foi excluído do projeto depois que o conjunto foi criado, ou que sua função não pode ver, ainda é contado. Ele aparece como Não foi possível verificar com o motivo, de modo que a contagem nunca diminui em silêncio.

Nota

Pronto significa que toda verificação que o Weave pôde executar foi aprovada. Não é uma afirmação de que os números do fluxo de trabalho estão corretos, de que seus painéis estão atualizados ou de que qualquer coisa fora do projeto está em ordem. As linhas nomeiam exatamente o que foi comparado, e Como o Weave sabe em uma constatação nomeia o que a verificação deixa de fora.

Um fluxo de trabalho com pouco histórico

Uma execução só pode parecer incomum em comparação com execuções anteriores. Quando o Weave tem pouco histórico anterior para comparar, A última execução pareceu habitual conta a execução como habitual e diz isso. Isso abrange um fluxo de trabalho ou etapa novo, um que é executado com pouca frequência para ter execuções suficientes nos últimos 30 dias, como um fluxo de trabalho semanal, e uma execução que foi a primeira a preencher uma tabela:

O Weave tem pouco histórico anterior para comparar com a última execução, então ela conta como habitual.

Quando parte da execução pôde ser comparada, a linha nomeia o que esteve em sua faixa habitual e acrescenta “Onde o Weave tem pouco histórico anterior para comparar, a execução conta como habitual.” A guia Weave ainda lista essas situações como verificações que o Weave não pôde fazer. Um fluxo de trabalho que nunca foi executado continua Não foi possível verificar nas linhas A última execução foi bem-sucedida e A última execução pareceu habitual, assim como um cuja última execução foi interrompida ou ainda está em andamento.

Seja avisado antes do prazo

Para um conjunto com prazo, o Weave executa a verificação por conta própria à medida que o prazo se aproxima e avisa o responsável pelo conjunto (quem o salvou por último), uma vez para cada vez que o conjunto vence, como uma mensagem no aplicativo:

“Fechamento do mês” vence em 3 dias (31 Oct 17:00 UTC): 11 de seus 13 fluxos de trabalho prontos, 1 não pronto, 1 que o Weave não pôde verificar.

Clique em Abrir Weave na mensagem para abrir a guia Weave do projeto e a lista de verificação desse conjunto. A mensagem traz apenas contagens; os nomes e os motivos estão na lista de verificação. Ela permanece na tela por 30 segundos e só é exibida se o responsável estiver conectado naquele momento; não é enviada de novo para o mesmo prazo, mas a lista de verificação sempre está disponível na janela. Se o responsável não puder mais abrir o projeto, nada é enviado.

O Weave verifica uma vez por hora, então a mensagem chega dentro de uma hora após o ponto de aviso: com 24 horas de antecedência, dentro de uma hora de 24 horas antes do prazo. Um conjunto salvo depois de seu ponto de aviso ter passado é avisado na verificação seguinte. Se uma verificação começar com atraso e o prazo passar antes de ela ser executada, essa verificação ainda avisa o responsável, como “venceu há 20 minutos”, a menos que o conjunto tenha sido salvo depois do prazo. A verificação é executada como o responsável e só lê tabelas se o responsável podia ler tabelas quando salvou o conjunto pela última vez.

Pela API

Os conjuntos de prontidão estão disponíveis pela API da plataforma em /analyze/weave/readiness: GET /sets lista os conjuntos de um projeto, GET /set, POST /set, PUT /set e DELETE /set leem, criam, substituem e excluem um, e GET /check retorna a lista de verificação como a janela a mostra, com as constatações de cada linha. Um conjunto lido pela API traz um etag; envie-o de volta como if_match em PUT para que uma edição sobre um salvamento mais novo seja recusada. Sem ele, a última gravação prevalece.