Verificar a prontidão antes de um fecho
Descrição
Seção intitulada “Descrição”Nos dias que mais contam — fecho do mês, entrega de uma previsão, um pacote para o conselho de administração — a pergunta não é «o que notou o Weave?», mas «estamos prontos?». Um conjunto de prontidão indica os fluxos de trabalho de que um prazo depende e, ao selecionar o conjunto, obtém-se a resposta a essa pergunta para todos de uma vez, numa única lista de verificação que abre com a sua 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 das suas linhas. É Não pronto quando qualquer verificação encontrou um problema; o problema é listado abaixo com os mesmos botões Corrigir, Ir para e Como o Weave sabe do separador Weave. Caso contrário, é Não foi possível verificar quando alguma verificação não teve forma de o avaliar, e o motivo é escrito por extenso. Só é Pronta quando todas as verificações que o Weave conseguiu executar passaram. Nada que o Weave não tenha avaliado é alguma vez apresentado como pronto, com uma exceção: uma última execução com histórico anterior insuficiente para a comparar conta como habitual, como descrito abaixo.
Um problema que alguém marcou como esperado continua a tornar a sua linha Não pronto, e a linha indica que foi marcado como esperado. O separador Weave deixa de comunicar esse problema; a lista de verificação continua a dizer 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 significam as suas respostas, consulte O que o Weave verifica.
Criar um conjunto de prontidão
Seção intitulada “Criar um conjunto de prontidão”- Abra o separador Weave do projeto e clique em Prontidão em Close checks na barra Monitor.
- Clique em Novo. Dê um nome ao conjunto, como «Fecho do mês», e assinale os fluxos de trabalho de que depende. Escreva na caixa de filtro para encontrar um fluxo de trabalho ou utilize Atribuídos para ver apenas os que já estão no conjunto.
- Opcionalmente, assinale Tem hora limite e indique quando o conjunto termina, como uma
expressão cron e o fuso horário em que está escrita — as mesmas opções que um evento
agendado oferece.
0 9 5 * *é às 09:00 do dia 5 de cada mês e0 8 * * 1é às 08:00 de todas as segundas-feiras, nesse fuso horário. Os desvios são lidos como um evento agendado os lê: UTC +0 é a hora de Londres, incluindo a hora de verão britânica, e alguns outros desvios seguem a hora de verão de um local com esse desvio, enquanto os restantes são fixos. A página Agendador de eventos indica como é lido cada desvio. - Para um conjunto com hora limite, em Tell the owner this many hours before it is due, indique com que antecedência em relação à hora limite o Weave deve enviar a sua mensagem, entre 1 e 168 horas. O valor predefinido é 24.
- Clique em Guardar.
Um conjunto pertence ao projeto, e todas as pessoas que tenham Monitor no separador Weave do projeto podem verificá-lo. Apenas um Arquiteto do projeto pode criar, editar ou eliminar um conjunto, e todos os fluxos de trabalho de um conjunto têm de estar nesse projeto. Quem guardou um conjunto em último lugar é o seu proprietário. Duas pessoas a editar o mesmo conjunto em simultâneo são mantidas separadas: a segunda gravação é recusada, o conjunto é lido novamente e o formulário mostra a cópia mais recente com o motivo.
Quando um projeto não tem nenhum conjunto de prontidão e os respetivos fluxos de trabalho são executados segundo um agendamento mensal, Descobertas sugere um conjunto criado a partir desses agendamentos. Um Arquiteto do projeto pode clicar em Make this your month-end set nessa sugestão para o guardar.
O Weave só pode considerar uma tabela de entrada atual quando algo indicar quando deveria ter sido escrita: um agendamento no fluxo de trabalho que a escreve ou um limiar de atualidade na tabela. Defina-os primeiro, ou a primeira linha da maioria dos fluxos de trabalho indicará Não foi possível verificar.

Ler a lista de verificação
Seção intitulada “Ler a lista de verificação”Selecione um conjunto à esquerda. O Weave lê todo o projeto — a mesma leitura que o separador Weave faz — e avalia cada fluxo de trabalho do conjunto. Clique em Verificar de Novo depois de corrigir algo.
Cada item mostra o nome do fluxo de trabalho, o seu veredicto e uma linha por cada verificação que se lhe aplica. Quando uma linha indica Não foi possível verificar, o motivo é escrito por extenso ao lado; estes são os motivos que é mais provável encontrar:
| Linha | O que o Weave compara | Motivos comuns para indicar «não foi possível verificar» |
|---|---|---|
| Inputs are fresh | Todas as tabelas que o fluxo de trabalho lê, em relação aos agendamentos dos fluxos de trabalho que as escrevem ou ao limiar de atualidade da própria tabela. | A sua função não pode ler tabelas; o Weave não conseguiu determinar que tabelas lê ou não lê nenhuma que o Weave consiga seguir; uma tabela que lê está oculta para si; um passo lê uma tabela que o Weave não consegue determinar, como uma escolhida com uma variável; uma tabela que lê não tem nem um escritor agendado nem um limiar de atualidade, pelo que nada indica quando deveria ter sido escrita; o fluxo de trabalho que a escreve está em execução, em fila ou acabou de terminar. |
| Last run succeeded | A execução mais recente do fluxo de trabalho, que tem de ter terminado. Uma execução que falhou é Não pronto. | Não tem execuções registadas, o seu histórico de execuções não pôde ser lido ou a sua última execução foi parada ou ainda está em curso. |
| Last run looked usual | Quanto tempo demorou a última execução e quantas linhas as suas tabelas continham depois, quantos valores vazios continham e como se distribuem os seus valores, em comparação com as execuções anteriores. | A última execução falhou, foi parada ou ainda está em curso, pelo que não há nada habitual com que comparar; o acesso a linhas aplica-se a uma tabela que escreveu, pelo que os valores dessa tabela não são comparados; a execução inclui passos que a sua função não pode ver. |
| Inputs unchanged since it last ran | Se uma tabela que lê foi escrita por outro fluxo de trabalho depois de este a ter lido pela última vez. | A sua função não pode ler tabelas; o Weave não consegue seguir o que o fluxo de trabalho lê; ou o fluxo de trabalho não tem execuções com que comparar. |
| Schedule is healthy | Os seus eventos agendados: calendários válidos, em sintonia com o agendador, nenhuma execução prevista falhada, nenhuma hora limite perdida devido a uma execução ainda em curso. | Não foi possível ler o agendador. |
| Reconciliations tie out | Cada reconciliação associada ao fluxo de trabalho, na sua versão aprovada, executada como você. | Uma ainda não foi aprovada; a sua função não pode ler dados de tabelas; o acesso a linhas mostra-lhe apenas algumas linhas de um dos lados; uma tabela ou coluna que utiliza foi alterada; 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 indica que não está agendado. Um fluxo de trabalho sem reconciliação associada não tem a linha Reconciliations tie out. Isso é um facto sobre o fluxo de trabalho, não algo que o Weave não conseguiu verificar.
Um fluxo de trabalho que foi eliminado do projeto depois de o conjunto ter sido criado, ou que a sua função não pode ver, continua a ser contado. Aparece como Não foi possível verificar com o motivo, para que a contagem nunca diminua silenciosamente.
Um fluxo de trabalho com pouco histórico
Seção intitulada “Um fluxo de trabalho com pouco histórico”Uma execução só pode parecer invulgar em comparação com execuções anteriores. Quando o Weave tem histórico anterior insuficiente para comparar, Last run looked usual conta a execução como habitual e indica-o. Isto abrange um fluxo de trabalho ou passo novo, um que é executado com tão pouca frequência que não tem 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 sua última execução, pelo que a conta como habitual.
Quando parte da execução pôde ser comparada, a linha indica o que estava no seu intervalo habitual e acrescenta «Quando o Weave tem histórico anterior insuficiente para comparar, conta como habitual.» O separador Weave continua a listá-las como verificações que o Weave não conseguiu fazer. Um fluxo de trabalho que nunca foi executado continua a indicar Não foi possível verificar nas linhas Last run succeeded e Last run looked usual, tal como um cuja última execução foi parada ou ainda está em curso.
Ser avisado antes da hora limite
Seção intitulada “Ser avisado antes da hora limite”Para um conjunto com hora limite, o Weave executa a verificação por si próprio à medida que a hora limite se aproxima e avisa o proprietário do conjunto — quem o guardou em último lugar — uma vez por cada vez que o conjunto atinge o prazo, através de uma mensagem na aplicação:
«Fecho do mês» termina em 3 dias (31 out 17:00 UTC): 11 dos seus 13 fluxos de trabalho prontos, 1 não pronto, 1 que o Weave não conseguiu verificar.
Clique em Abrir Weave na mensagem para abrir o separador Weave do projeto e a lista de verificação desse conjunto. A mensagem contém apenas contagens; os nomes e os motivos estão na lista de verificação. Permanece no ecrã durante 30 segundos e é apresentada apenas se o proprietário tiver sessão iniciada nesse momento; não é enviada novamente para essa hora limite, mas a lista de verificação está sempre disponível na janela. Se o proprietário já não puder abrir o projeto, não é enviado nada.
O Weave verifica uma vez por hora, pelo que a mensagem chega no espaço de uma hora após o ponto de aviso: com 24 horas de antecedência, no espaço de uma hora após as 24 horas anteriores à hora limite. Um conjunto guardado depois de o seu ponto de aviso ter passado é avisado na verificação seguinte. Se uma verificação começar tarde e a hora limite passar antes de ser executada, essa verificação avisa mesmo assim o proprietário, como «terminou há 20 minutos», a menos que o conjunto tenha sido guardado depois da hora limite. A verificação é executada como o proprietário e só lê tabelas se o proprietário pudesse ler tabelas quando guardou o conjunto pela última vez.
O fecho preparado durante a noite
Seção intitulada “O fecho preparado durante a noite”Para um conjunto guardado com hora limite, o Weave mantém uma verificação de fecho: trata o conjunto por si próprio, prepara o que pode e deixa-lhe apenas as decisões. Verifica o conjunto:
- uma vez por dia, à hora do dia correspondente à hora limite do conjunto;
- quando termina uma execução que escreveu uma tabela que o conjunto lê;
- quando termina uma alteração que aprovou a partir do fecho; e
- quando o proprietário do conjunto clica em Check now.
Enquanto o conjunto estiver dentro do prazo de aviso da hora limite, um cartão acima de Descobertas apresenta a verificação mais recente, como O fecho de fim de mês está 92% concluído. Duas coisas precisam de si., com a hora a que verificou. O valor é a proporção de linhas do conjunto que estão prontas, pelo que só chega a 100% quando todas as linhas estiverem prontas. Por baixo, cada decisão é numerada:
- Uma execução falhada tem a correção que o Weave preparou para ela.
- Uma entrada que não está atual, ou que mudou, tem um plano para executar de novo o fluxo de trabalho que a escreve e, a seguir, o que a lê, como Executar de novo «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 valor fora do intervalo habitual, ou uma reconciliação que não bate certo, é uma pergunta para si, com Ask Weave about this e Isto é esperado, uma vez que o Weave não tem nenhuma correção pronta para isso.
Clique em Abrir numa decisão para ver o respetivo cartão no local, e Aprovar aí, na Web. Cada cartão abrange um plano, e todas as execuções que inicia têm o lançamento no ERP desativado. Não existe a opção de aprovar tudo. Um fluxo de trabalho que está à espera da sua execução agendada é listado sem número. Porquê lista o que o Weave não conseguiu 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 em espera ou o conjunto termina nesse dia, o proprietário é avisado no PlaidCloud e no telemóvel, por exemplo O Weave precisa de si: O fecho de fim de mês está 92% concluído. Duas coisas precisam de si. A verificação aparece também nas tarefas do painel lateral 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 fecho pertence a quem guardou o conjunto em último lugar, e é executada como essa pessoa. Para se essa pessoa deixar de poder abrir o projeto.
- Apenas o proprietário pode clicar em Check now.
- Todos os que podem ler a lista de verificação veem o progresso do fecho. As respetivas decisões são mostradas ao proprietário e a qualquer pessoa cuja função possa executar os fluxos de trabalho.
- A verificação em si não altera nada, e nunca executa um passo que escreva fora do PlaidCloud.
Através da API
Seção intitulada “Através da API”Os conjuntos de prontidão estão disponíveis através da 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 eliminam um conjunto,
e GET /check devolve a lista de verificação tal como a janela a mostra, com as
constatações de cada linha. Um conjunto lido através da API traz um etag; envie-o de volta como
if_match em PUT para que uma edição sobre uma gravação mais recente seja recusada. Sem ele, a
última gravação prevalece.