チェーン・テンプレートは、チェーン環境内のチェーンとチェーン・ランに関する包括的な情報を提供するように設計されている。これはモニター・ログを補完する貴重なものであり、チェイン・アクティビティに関するさらなる洞察を提供する。
- 在庫と追跡: インベントリ・プロセスを簡素化し、使用されていないチェーンや需要の高いチェーンを素早く特定することができます。これは、より良い資源配分と効率化を助ける。
- 詳細レポート :ユーザーは、ID、日付、名前など、文書化や分析に重要なメタデータの詳細なレポートを作成することができます。
- クリーンアッププロセス :このテンプレートは、システムを乱雑にしているテストチェーンや古くなったチェーンを特定し、削除するのに非常に便利です。
- 複数のChainビルダーのための最適化 :複数のChain開発者がいる環境では、このテンプレートはChainの使用状況を明確に表示し、不要なChainを排除するための調整と最適化の取り組みを容易にします。
全体として、このテンプレートはチェーンとチェーン・ランの監視を強化し、ユーザーがその管理とメンテナンスに関して十分な情報に基づいた決定を下せるようにする。
〔はじめに〕
Chain Templateは、実行されるWorkspace内の1つまたは複数のChain EnvironmentsのChainとChain Run(実行)のリストを取得します。実行時に、レポートスプレッドシートは、分析のための環境、チェーン、およびチェーンランを選択するために指定されます。
注: このテンプレートは、配置されたワークスペースに存在するチェーン環境でのみ実行可能です。
Template はChains のデータを収集し、指定された環境ごとに Chain List Wdata Table にロードする。チェーンごとに収集される情報は以下の通り:
- チェーンID
- チェーン名
- 作成日
- 更新日
- チェーンURL
- ワークスペースID
- ワークスペース名
- 環境ID
- 環境名
さらに、環境内のチェーンラン に関するデータを収集し、チェーンランWdataテーブルにロードする。各チェーン・ランで収集される情報は以下の通り:
- チェーンID
- ワークスペースID
- 環境ID
- 実行者
- スタート
- 終了
- 状態
- 打ち上げタイプ
- ランID
すべてのチェーンデータが収集され、Wdata Tablesにロードされると、テンプレートは、Days Since Query のSelect Listに、前回の実行以降に新しいEnvironmentsがないことを確認します。新しいエンバイロメントが特定された場合、セレクトリストはそれに応じて更新されます。
テンプレートの最後のステップでは、Refresh Connection を実行し、テンプレートによって収集された最新の情報でコネクテッド・シートを更新する。接続されたシートは、使用開始からの日数クエリによって生成された出力で更新される。
要件
- ワークスペースでは、以下のテンプレートを有効にして構成する必要があります:
- ワークスペースでは、以下のコネクタを有効にして構成する必要があります:
チェーンの展開
Chain Usage Tracker テンプレートは、Templates 画面の Workiva Chains セクションにあります。
探し方はこうだ:
- チェーンビルダーで、Templates タブを開きます。
- 上部のメニューからWorkiva Chains を選択する。
- 右上のChain Usage Tracker を検索し、テンプレートを開く。
-
テンプレートを見つけたら、New Chain をクリックして、ワークスペースに配置します。
- 以下の「テンプレートの設定」セクションの手順に従って、テンプレートを設定します。
テンプレートの設定
- Chain User Tracker.cb をダウンロードし、それをワークスペースにインポートする。
- このインポートによって、テンプレートに必要なWdataテーブルとクエリが作成されます。
注: テーブルID チェーン変数を設定する際に後で使用する各テーブルのID。
- OpenDays Since Use クエリをWdataで編集する。
- 右側のメニューからParameters をクリックする。
- Environments パラメータをクリックする。
注: 詳細はクエリ・パラメータの編集 を参照のこと。
- List Options を変更し、1つ以上のチェーン環境を含める。大文字と小文字の区別を含め、各名称が対応するチェーン環境とまったく同じ であることを確認する。
- デフォルト値 を必要に応じて変更する。
- をクリック
- 保存をクリック
- このインポートによって、テンプレートに必要なWdataテーブルとクエリが作成されます。
- Chain Usage Tracker.tar.gz をダウンロードし、 それをワークスペース にインポートする。このインポートにより、必要なChain Usage Tracker スプレッドシートが作成される。
- ファイルが正常にインポートされたら、Chain Usage Tracker Spreadsheetを見つけて開く。
- Parameters シートで、セルB1 のDays Since Use しきい値を-1 以上の値に更新する。
注: -1 を指定すると、すべてのデータが検索されます。
- Process Tracking Sheet を使用して、テンプレートの実行状況を監視する。
- 特定のChain Environments を処理できるようにするには、Environments シートの下に1つ以上の子シートを追加します。チェーン環境シート プレースホルダーシートの削除または名前の変更
- 各子シートの名前が、対応するチェーン環境 と全く同じであることを確認する。
- Days Since Use Wdata Query からincoming connection を作成し、Days_Since_Use とEnvironments パラメータを設定する。
注: DEV、Demo、SSCはチェーン環境名の一例です。これらの環境は、あなたの環境名と一致しないかもしれません。必要に応じて、Days Since UseQuery Parameter を編集する。このテンプレートは、Maintain Wdata Parameters を使用して、次の値を維持する。
変数
可変タイプ | 変数名 | 可変目的 |
チェーン変数 | チェーン一覧表 ID | チェーンに関するデータを格納するWdataテーブル |
チェーン変数 | チェーン・ラン テーブルID | チェーン・ランに関するデータを格納するために使用されるWdataテーブル |
チェーン変数 | クエリ・パラメータ名 | Days Since Use Queryで設定したEnvironmentsパラメータの名前。 |
チェーン変数 | ステータスシート名 | レポート・スプレッドシート内のステータス・シートの名前またはID |
チェーン変数 | パラメーターシート名 | レポート・スプレッドシート内のパラメータ・シートの名前またはID |
注: ID の検索については、Workiva ファイルと項目の ID を検索する を参照のこと。
ランタイム入力
入力タイプ | 名称 | 目的 |
テキストフィールド | 報告スプレッドシートID | 報告用スプレッドシートのIDを入力する |
注: ID の検索については、Workiva ファイルと項目の ID を検索する を参照のこと。
テンプレートの実行
- 実行 ボタンをクリックする。
- Run With Input ボタンをクリックする。
- Chain Usage Tracker Spreadsheet ID をReporting Spreadsheet ID runtime inputフィールドに入力する。
- Start ボタンをクリック
- テンプレートが実行されると、Chain Usage Tracker Spreadsheet に移動し、Process Tracking Sheet を表示し、実行ステータスを監視する。
- テンプレートが完了すると、子シートの「エンバイロメンツ」にデータが表示されます。
実行結果
以下は、Chain Usage Tracker Spreadsheetへの出力例です:
完成したチェーン
トラブルシューティング
- サブチェーンUpdate Status 、Load Data to Wdata 、Maintain Wdata Parameters がすべてパブリッシュされていることを確認する。
- 正しいIDが指定されていることを確認する。Workiva 内で ID を特定する方法については、Find IDs for Workiva files and items を参照してください。
- Chain User Tracker.cb とChain User Tracker.tar.gz ファイルが正常にインポートされたことを確認します。Wdata ファイルのインポート およびWorkiva ファイルのインポート ヘルプ記事を参照してください。
- Days Since Use Queryに、Chain ListテーブルとChain Runsテーブルの正しいテーブルIDがあることを確認する。
- Parameters Sheet のDays Since Use の値が -1 以上であることを確認する。
- レポートスプレッドシートに環境シートが存在し、チェーン環境子シートに正しい名前が付けられていることを確認します。
- 環境シートの名前を変更した場合は、「使用開始からの日数」クエリを調整し、シートのカスタム名を使用してください。
- ステータス・シートやパラメータ・シートの名前を変更し、Chain 変数でその名前で参照する場合は、そのカスタム名が Chain 変数の値に反映されていることを確認してください。
- 使用開始からの日数(Days Since Use)クエリでEnvironmentsパラメータの名前を変更した場合は、クエリパラメータチェイン変数がパラメータのカスタム名を使用するように更新されていることを確認してください。
- Workiva Connector が、選択した環境でコマンドを実行するために必要な権限を持っていることを確認する。