Pular para o conteúdo

Verificar a prontidão antes de um fechamento

Nos dias que mais importam — fim do 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 começa 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 entre as 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. Ele só fica Pronto quando todas as verificações que o Weave pôde executar nele foram aprovadas. Nada que o Weave não avaliou é exibido como pronto, com uma exceção: uma última execução com histórico anterior insuficiente para comparação é considerada normal, como descrito abaixo.

Um problema que alguém marcou como esperado ainda deixa a sua linha como Não pronto, e a linha informa 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. Para saber o que essas regras leem e o que suas respostas significam, consulte O que o Weave verifica.

  1. Abra a guia Weave do projeto e clique em Prontidão em Close checks na barra Monitor.
  2. Clique em Novo. Dê um nome ao conjunto, como “Fechamento do mês”, e marque os fluxos de trabalho dos quais ele depende. Digite na caixa de filtro para encontrar um fluxo de trabalho ou use Atribuídos para ver apenas os que já estão no 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 é escrita — as mesmas opções que um evento agendado oferece. 0 9 5 * * é 09:00 do dia 5 de cada mês, e 0 8 * * 1 é 08:00 de 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, incluindo o horário de verão britânico, e alguns outros deslocamentos seguem o horário de verão de um local com esse 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 Tell the owner this many hours before it is due, 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 Monitor na guia Weave do projeto podem verificá-lo. Somente um Arquiteto do projeto pode criar, editar ou excluir um conjunto, e todos os fluxos de trabalho de um conjunto devem estar nesse projeto. Quem salvou o conjunto por último é o seu proprietário. Duas pessoas que editam o mesmo conjunto ao mesmo tempo são mantidas separadas: o segundo salvamento é recusado, o conjunto é lido novamente e o formulário mostra a cópia mais recente com o motivo.

Quando um projeto não tem conjunto de prontidão e seus fluxos de trabalho são executados em um agendamento mensal, Constatações sugere um conjunto criado a partir desses agendamentos. Um Arquiteto do projeto pode clicar em Make this your month-end set nele para salvá-lo.

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

A janela Prontidão com um conjunto de fechamento do mês, um fluxo de trabalho pronto e um não pronto

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, o 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 para “não foi possível verificar”
Inputs are fresh Cada 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 acompanhar; uma tabela que ele lê está oculta para você; uma etapa lê uma tabela que o Weave não consegue determinar, como uma escolhida por uma variável; uma tabela que ele lê não tem nem um gravador agendado nem um limite de atualização, então nada indica quando ela deveria ter sido gravada; o fluxo de trabalho que a grava está em execução, na fila ou acabou de terminar.
Last run succeeded A execução mais recente do fluxo de trabalho, que deve ter terminado. Uma execução que falhou é Não pronto. Não há execuções registradas, o histórico de execuções não pôde ser lido ou a última execução foi interrompida ou ainda está em andamento.
Last run looked usual 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 comparação com as 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.
Inputs unchanged since it last ran Se uma tabela que ele lê foi gravada por outro fluxo de trabalho depois da última leitura. 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.
Schedule is healthy Seus eventos agendados: cronogramas válidos, em sincronia com o agendador, nenhuma execução prevista perdida, nenhum prazo perdido por uma execução ainda em andamento. Não foi possível ler o agendador.
Reconciliations tie out Cada reconciliação vinculada ao fluxo de trabalho, em sua versão aprovada, executada como você. Alguma 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 Schedule is healthy, e o item informa que ele não está agendado. Um fluxo de trabalho sem reconciliação vinculada não tem a linha Reconciliations tie out. 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 silenciosamente.

Uma execução só pode parecer incomum em comparação com as anteriores. Onde o Weave tem histórico anterior insuficiente para comparar, Last run looked usual considera a execução normal e informa isso. Isso abrange um fluxo de trabalho ou etapa novos, um que é executado raramente demais 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 histórico anterior insuficiente para comparar a última execução, então ela é considerada normal.

Quando parte da execução pôde ser comparada, a linha nomeia o que estava dentro do intervalo habitual e acrescenta “Onde o Weave tem histórico anterior insuficiente para comparar, a execução é considerada normal.” A guia Weave ainda lista essas verificaçõ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 Last run succeeded e Last run looked usual, assim como aquele cuja última execução foi interrompida ou ainda está em andamento.

Para um conjunto com prazo, o Weave executa a verificação por conta própria à medida que o prazo se aproxima e avisa o proprietário do conjunto — quem o salvou por último — uma vez para cada vez que o conjunto vence, por meio de uma mensagem no aplicativo:

“Fechamento do mês” vence em 3 dias (31 out 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 proprietário estiver conectado no momento; ela não é enviada novamente para esse prazo, mas a lista de verificação está sempre disponível na janela. Se o proprietário não puder mais abrir o projeto, nada é enviado.

O Weave verifica uma vez por hora, então a mensagem chega em até uma hora do ponto de aviso: com 24 horas de antecedência, em até uma hora após 24 horas antes do prazo. Um conjunto salvo depois que o ponto de aviso passou é avisado na próxima verificação. Se uma verificação começa tarde e o prazo passa antes que ela execute, essa verificação ainda avisa o proprietário, como “venceu há 20 minutos”, a menos que o conjunto tenha sido salvo depois do prazo. A verificação é executada como o proprietário e só lê tabelas se o proprietário podia ler tabelas quando salvou o conjunto pela última vez.

Para um conjunto salvo com prazo, o Weave mantém uma verificação de fechamento: ele percorre o conjunto sozinho, prepara o que puder e deixa para você apenas as decisões. Ele verifica o conjunto:

  • uma vez por dia, no horário do prazo do conjunto;
  • depois que termina uma execução que gravou uma tabela lida pelo conjunto;
  • depois que termina uma alteração que você aprovou a partir do fechamento; e
  • quando o proprietário do conjunto clica em Check now.

Enquanto o conjunto está dentro do seu tempo de aviso antes do prazo, um cartão acima de Constatações mostra a verificação mais recente, como O fechamento do mês está 92% concluído. Duas coisas precisam de você., com o horário em que verificou. O número é a parcela das linhas do conjunto que estão prontas, então só chega a 100% quando todas as linhas estão prontas. Abaixo dele, cada decisão é numerada:

  • Uma execução com falha tem a correção que o Weave preparou para ela.
  • Uma entrada que não está atualizada, ou que mudou, tem um plano para executar novamente o fluxo de trabalho que a grava e depois o que a lê, como Executar novamente “Load GL” e depois “Allocate Costs”, com o alcance das novas execuções.
  • Uma execução agendada que não começou tem Executar “Load GL” agora.
  • Um número fora do intervalo habitual, ou uma reconciliação que não bate, é uma pergunta para você, com Ask Weave about this e Isto é esperado, já que o Weave não tem uma correção pronta para isso.

Clique em Abrir em uma decisão para ver o cartão dela no local e Aprovar ali, na web. Cada cartão cobre um plano, e toda execução que ele inicia tem o lançamento no ERP desativado. Não há aprovar tudo. Um fluxo de trabalho que está aguardando sua execução agendada é listado sem número. Por quê lista o que o Weave não pôde verificar, e as decisões que cabem a outra pessoa são contadas, não listadas.

Na verificação diária, quando há decisões aguardando ou o conjunto vence naquele dia, o proprietário é avisado no PlaidCloud e no celular, como O Weave precisa de você: o fechamento do mês está 92% concluído. Duas coisas precisam de você. A verificação também aparece nas tarefas do dock como Close check: e o nome do conjunto. As verificações após uma execução atualizam o cartão sem avisar ninguém.

  • Uma verificação de fechamento pertence a quem salvou o conjunto por último e é executada como essa pessoa. Ela para se essa pessoa não puder mais abrir o projeto.
  • Somente o proprietário pode clicar em Check now.
  • Todos que podem ler a lista de verificação veem o andamento do fechamento. As decisões são mostradas ao proprietário e a qualquer pessoa cujo perfil possa executar os fluxos de trabalho.
  • A verificação em si não altera nada e nunca executa uma etapa que grava fora do PlaidCloud.

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 recente seja recusada. Sem ele, a última gravação prevalece.