締め処理前の準備状況をチェックする

説明

月末、予測の提出、取締役会資料など、最も重要な日には、問うべきは「Weaveは何に気付いたか」ではなく、「準備はできているか」です。準備状況セットは、期限が依存するワークフローを指定するもので、セットを選択すると、そのすべてについてこの問いに一度に答えます。答えは、次のような件数から始まるひとつのチェックリストで示されます。

13件中11件が準備完了、1件が準備未完了、1件がチェックできませんでした。

セット内の各ワークフローには、その行のうち最も悪いものに基づいて、3つの答えのどれかが付きます。チェックで問題が見つかった場合は準備未完了となり、問題はその下に一覧表示され、Weaveタブと同じ修正、移動、Weaveが把握する方法ボタンが表示されます。そうでなく、判定する方法がなかったチェックがある場合はチェックできませんでしたとなり、理由が書かれます。準備完了になるのは、Weaveが実行できたすべてのチェックに合格した場合のみです。Weaveが判定しなかったものが準備完了として表示されることはありません。ただし例外が1つあります。比較できる過去の履歴が少なすぎる最終実行は、通常どおりとして数えられます。詳しくは後述します。

誰かが想定内としてマークした問題も、その行は準備未完了のままで、行には想定内としてマークされたことが表示されます。Weaveタブはそのような問題を報告しなくなりますが、チェックリストは事実をそのまま伝えます。

チェックはWeaveがすでに実行しているルールであり、AIは使用しないため、チェックリストを何度依頼しても費用はかかりません。これらのルールが何を読み取り、その答えが何を意味するかについては、Weaveがチェックする内容を参照してください。

準備状況セットを作成する

プロジェクトのWeaveタブを開き、検出事項のツールバーで準備状況をクリックします。
新規をクリックします。セットに「月末締め」などの名前を付け、依存するワークフローをプロジェクト内のワークフローからこのセット内のワークフローに移動します。
必要に応じて、期限ありにチェックを入れ、セットの期限を、cron式と、それが書かれているタイムゾーンで指定します。スケジュール済みイベントと同じ選択肢です。0 9 5 * *は毎月5日の09:00、0 8 * * 1は毎週月曜日の08:00を、そのタイムゾーンで表します。オフセットは、スケジュール済みイベントの場合と同じ方法で解釈されます。UTC +0はロンドン時間で、英国夏時間も含まれます。ほかのオフセットには、そのオフセットにある地域の夏時間に従うものと、固定のものがあります。各オフセットがどう解釈されるかは、イベントスケジューラーのページに一覧があります。
期限があるセットでは、Tell the owner this many hours before it is dueで、期限の何時間前にWeaveがメッセージを送信するかを、1〜168時間の範囲で指定します。デフォルトは24です。
保存をクリックします。

セットはプロジェクトに属し、プロジェクトのWeaveタブで検出事項を使用できるユーザーなら誰でもチェックできます。セットを作成、編集、削除できるのはプロジェクトのアーキテクトのみで、セット内のすべてのワークフローは、そのプロジェクトに含まれている必要があります。セットを最後に保存したユーザーが、そのセットの担当者になります。同じセットを2人が同時に編集した場合は、競合しないように扱われます。2回目の保存は拒否され、セットが再度読み込まれて、フォームに新しいほうのコピーと理由が表示されます。

Weaveが入力テーブルを最新と判断できるのは、そのテーブルがいつ書き込まれているはずかを示すものがある場合だけです。つまり、それを書き込むワークフローのスケジュール、またはテーブルの鮮度のしきい値です。先にこれらを設定しておかないと、ほとんどのワークフローの最初の行がチェックできませんでしたと表示されます。

チェックリストを読む

左側でセットを選択します。Weaveはプロジェクト全体を読み取り（Weaveタブが行うのと同じ読み取りです）、セット内の各ワークフローを判定します。何かを修正したら、再チェックをクリックします。

各項目には、ワークフローの名前、その判定、およびそれに適用される各チェックの行が1行ずつ表示されます。行にチェックできませんでしたと表示された場合は、その横に理由が書かれます。よく目にする理由は次のとおりです。

行	Weaveが比較するもの	「チェックできませんでした」になる主な理由
入力が最新である	ワークフローが読み取るすべてのテーブルを、それを書き込むワークフローのスケジュール、またはテーブル自身の鮮度のしきい値と比較します。	ロールでテーブルを読み取れない。Weaveがワークフローの読み取るテーブルを判断できない、またはWeaveが追跡できるテーブルを読み取らない。読み取るテーブルがあなたに対して非表示になっている。変数で選択されたテーブルなど、ステップが読み取るテーブルをWeaveが判断できない。読み取るテーブルに、スケジュールされた書き込み元も鮮度のしきい値もなく、いつ書き込まれているはずかを示すものがない。それを書き込むワークフローが実行中、キュー待ち、または完了したばかりである。
最終実行が成功した	ワークフローの直近の実行です。完了している必要があります。失敗した実行は準備未完了になります。	記録された実行がない、実行履歴を読み取れなかった、または最終実行が停止された、もしくはまだ実行中である。
最終実行が通常どおりだった	最終実行にかかった時間、実行後にテーブルが保持していた行数、空の値の数、値のばらつきを、以前の実行と比較します。	最終実行が失敗した、停止された、またはまだ実行中で、通常と比較するものがない。行アクセスが、書き込んだテーブルに適用されているため、そのテーブルの値は比較されない。実行に、ロールで見られないステップが含まれている。
前回の実行以降、入力が変更されていない	読み取るテーブルが、ワークフローが最後に読み取った後に別のワークフローによって書き込まれたかどうか。	ロールでテーブルを読み取れない。Weaveがワークフローの読み取る対象を追跡できない。または、比較対象となる実行がない。
スケジュールが正常である	スケジュール済みイベントです。有効なタイムテーブルであること、スケジューラーと同期していること、実行予定の実行が漏れていないこと、実行中のために失われた実行予定がないこと。	スケジューラーを読み取れなかった。
照合が一致している	ワークフローにリンクされた各照合を、承認済みのバージョンで、あなたとして実行します。	まだ承認されていないものがある。ロールでテーブルデータを読み取れない。行アクセスにより、片側の行の一部しか見えない。使用しているテーブルまたは列が変更された。チェックリストの時間切れになった。

スケジュール済みイベントがないワークフローにはスケジュールが正常であるの行はなく、項目にはスケジュールされていないことが表示されます。リンクされた照合がないワークフローには、照合が一致しているの行はありません。これはワークフローについての事実であり、Weaveがチェックに失敗したわけではありません。

セットの作成後にプロジェクトから削除されたワークフローや、ロールで見られないワークフローも、引き続き数えられます。理由とともにチェックできませんでしたと表示されるため、件数が気付かないうちに減ることはありません。

履歴が少ないワークフロー

実行が異常かどうかは、以前の実行と比べて初めてわかります。比較できる過去の履歴がWeaveに少なすぎる場合、最終実行が通常どおりだったは、その実行を通常どおりとして数え、そのことを表示します。新しいワークフローやステップ、週1回のワークフローのように実行頻度が低く、過去30日間の実行が足りないもの、およびテーブルに初めてデータを書き込んだ実行が該当します。

Weaveには最終実行と比較できる過去の履歴が少なすぎるため、通常どおりとして数えます。

実行の一部を比較できた場合、行には通常の範囲内だったものが示され、「Weaveが比較できる過去の履歴が少なすぎる項目は、通常どおりとして数えます。」と追記されます。Weaveタブは、これらを引き続きWeaveがチェックできなかった項目として一覧表示します。一度も実行されたことがないワークフローは、最終実行が成功したと最終実行が通常どおりだったの両方の行で引き続きチェックできませんでしたとなります。最終実行が停止された、またはまだ実行中のワークフローも同様です。

期限前に通知を受け取る

期限があるセットでは、Weaveは期限が近づくと自動的にチェックを実行し、セットの担当者（最後に保存したユーザー）に、セットの期限が来るたびに1回、アプリ内メッセージで通知します。

「月末締め」の期限まであと3日です（10月31日 17:00 UTC）。13件のワークフローのうち、11件が準備完了、1件が準備未完了、1件はWeaveがチェックできませんでした。

メッセージのWeaveを開くをクリックすると、プロジェクトのWeaveタブと、そのセットのチェックリストが開きます。メッセージに含まれるのは件数のみで、名前と理由はチェックリストにあります。メッセージは30秒間表示され、担当者がその時点でサインインしている場合にのみ表示されます。その期限に対して再送信されることはありませんが、チェックリストはウィンドウでいつでも確認できます。担当者がプロジェクトを開けなくなった場合は、何も送信されません。

Weaveは1時間に1回チェックを行うため、メッセージは通知時点から1時間以内に届きます。24時間前の通知であれば、期限の24時間前から1時間以内です。通知時点を過ぎてから保存されたセットは、次のチェックで通知されます。チェックの開始が遅れ、実行前に期限が過ぎた場合でも、セットが期限後に保存されていなければ、そのチェックは「20分前が期限でした」という形で担当者に通知します。チェックは担当者として実行され、担当者が最後にセットを保存したときにテーブルを読み取れた場合にのみ、テーブルを読み取ります。

APIを使う

準備状況セットは、プラットフォームAPIの/analyze/weave/readinessから利用できます。GET /setsはプロジェクトのセットを一覧表示し、GET /set、POST /set、PUT /set、DELETE /setは、それぞれ1つのセットの読み取り、作成、置換、削除を行います。GET /checkは、各行の検出事項を含め、ウィンドウに表示されるとおりのチェックリストを返します。APIで読み取ったセットにはetagが含まれます。これをif_matchとしてPUTで送り返すと、より新しい保存を上書きする編集は拒否されます。送らない場合は、最後の書き込みが優先されます。