Workiva サポートセンター

チェーンが故障したらどうなりますか？エンドユーザーには、潜在的な結果について十分な情報を提供することが不可欠である。この接続ラーニング・パスでは、プライマリ・チェーンを強化するために、特に障害を示唆するコントロール・シートと通信するブランチを追加します。この拡張されたチェーンは、透明性をさらに高め、ユーザーがコマンドの最終正常実行日を容易に特定できるようにする。さらに、チェーンが正常に運営されているか、問題が発生しているかをクリアに可視化することができる。この改善により、ユーザーは潜在的な障害を監視し、迅速に対処するために必要な情報を十分に備えることができる。

ステップ1：既存のチェーンを編集する

• チェーンビルダーに移動し、CLP｜Running Processes and Logging Results within a Control Sheet（コントロールシート内のプロセスの実行と結果の記録）を見つけます。
• 鉛筆ボタンをクリックしてチェーンを編集する。
• 右上のチェーン設定 をクリックする。 
  • チェーンの名前の変更：CLP｜コントロールシート内の失敗の記録
• チェーンの保存

ステップ2：アップロードデータプロセスの失敗ブランチの追加

アップロードデータプロセスが失敗したことを示すコントロールシートにフィードバックされる値の生成と入力に使用されるコマンドを追加します。そのための最初のステップは、ステータスと時間のファイルを作成することである。

• ファイル作成コマンドをファイルユーティリティコネクタからチェーンキャンバスに追加
• Run Chain - Upload Data チェーンイベントをCreate File コマンドに接続する。
• リンクをダブルクリックしてリンク条件を編集します。
  • 失敗オプションをクリックしてください
    
    失敗オプションを選択すると、リンクが赤くなり、"Run Chain - Upload Data "チェーンイベントが失敗した場合のみ、チェーンがこのブランチで続行されることを示します。
    
• ファイル作成 コマンドをダブルクリックして構成する。
  • コマンドの名称: データアップロードの失敗とタイムスタンプを入力
  • テキストフィールドで、以下の情報を入力します： 

データのアップロードに失敗しました,(*<System.DateTime>*)

• • • (*System.DateTime*) のプレースホルダーを、適切なランタイム変数に置換します。これにより日付と時刻がプログラムによりチェーンから引き出されます
      • 左側のSelect a Variableパネルから、Runtime を展開
      • System.DateTime の値を選択する。
• コマンドの保存

ステップ3：データのアップロード失敗をコントロールシートに書き戻す

シートデータ書き込みコマンドを使って、以前のコマンドに入力した情報をコントロールシートに再度書き込みます。これにより、エンドユーザーはデータアップロードの失敗と失敗した日付を可視化できる。

• シートデータの書き込みコマンドを、Workiva Connectorからチェーンキャンバスに追加します。  
• Populate Data Upload Failure & Time Stamp コマンドとWrite Sheet Dataコマンドのリンク
• コマンドをダブルクリックして構成する。
  • コマンドの名称シートデータの書き込み - データアップロードの失敗
  • スプレッドシートIDフィールドをクリック
    • Select a Variable パネル内で、下矢印をクリックしてチェーンを展開する。
    • cv-Control Spreadsheet ID チェーン変数を選択する。 
  • シートID/名称フィールドをクリックする。
    • Select a Variable パネル内で、下矢印をクリックしてチェーンを展開する。
    • cv-コントロールシート名チェーン変数を選択 
  • データファイルフィールドをクリック
    • Select a Variableパネル内で、下矢印をクリックしてPopulate Status & Time Stampを展開
    • 作成ファイル 出力の選択
  • Regionフィールドには、チェーン変数とJSON出力の結合が入力され、現在のイテレーションで書き込むコントロール・シートの特定のセルをチェーンに指示する：
    • Regionフィールドをクリックし、以下を母集団とする：
      
    • cv-Status Column Letter - VariablesパネルのChain Variablesで検索される変数。
    • JSONファイル イテレーション - データを書き込む領域を指定するために、イテレーションの行番号に1を加えたものを使用しています。ヘッダー行のアカウントとして1つ追加します。
      • Select a Variableパネルから、下矢印をクリックして Group Iterator を展開 
      • <> JSONファイル反復を選択
      • 緑色の JSON File Iteration ピルをクリックして、Variable を変換/トランスフォーメーションします。
        • Select a Transformationをクリックし、 Get Value from JSONを選択する。
        • 緑の + 記号を押す。
        • 値フィールドに「Row Number」とタイプし、Enterを押す。
        • 別の変換/トランスフォーメーションを選択し、 Parse Numberを選択する。
        • 緑色の+ 記号をクリックします。
        • 別の変換/トランスフォーメーションを選択し、追加を選択する。
        • 緑色の+ 記号をクリックします。
        • 値フィールドに 1 と入力。
        • 承認をクリックする。
          
    • 最初のJSON File Iteration の後にコロンを入力する：
    • cv-Time Stamp Column Letter -VariablesパネルのChain Variablesで検出される変数
    • JSONファイル イテレーション - データを書き込む領域を指定するために、イテレーションの行番号に1を加えたものを使用しています。ヘッダー行のアカウントとして1つ追加します。
      
      • 2つ目のJSONファイルの反復は、上記と同じステップに従う

• コマンドの保存

ステップ4：接続プロセスの更新に失敗ブランチを追加

次に、更新接続プロセスが失敗したことを示す値を生成・入力し、コントロールシートにフィードバックするために使用されるコマンドを追加します。今回は、すでに作成した2つのコマンドをコピーして、プロセスを効率化する。

• Populate Data Upload Failure & Time Stampコマンドをクリックし、Copy ボタンをクリックする。
  
• 実行チェーンを接続 - 接続を更新チェーンイベントを、先ほどコピーしたばかりのPopulate Data Upload Failure & Time Stamp - Copyコマンドに接続
• リンクをダブルクリックしてリンク条件を編集する。
  • 失敗オプションをクリックする。
    
• Populate Data Upload Failure & Time Stamp - Copy コマンドをダブルクリックして構成する。
  • コマンドの名称: Populate Refresh Connection Failure & Time Stamp
  • テキスト フィールドで、以下の情報を更新します：

    更新接続に失敗しました、(*<System.DateTime>*)

    • システム日付と時間変数は、更新または追加する必要がないことがわかります。
• コマンドの保存

ステップ5：接続障害の更新をコントロールシートに書き戻す

シートデータ書き込みコマンドを使って、以前のコマンドに入力した情報をコントロールシートに再度書き込みます。これによりエンドユーザーは、更新接続の失敗と失敗した日付を可視性で確認できるようになります。今回も時間保存のため、以前作成したコマンドをコピーします。

• Write Sheet Data - Data Upload Failureコマンドをクリックし、Copy ボタンをクリックする。
  
• Populate Refresh Connection Failure & Time Stampコマンドを、先ほどコピーしたばかりのWrite Sheet Data - Data Upload Failure - Copyコマンドに接続
• リンクをダブルクリックしてリンク条件を編集します。
  • 失敗オプションをクリックする。
    
• Write Sheet Data - Data Upload Failure - Copyコマンドをダブルクリックして構成する。
  • コマンドの名称シートデータの書き込み - 接続の更新 失敗
  • データファイルフィールドをクリックし、 変数を削除する。
    • Select a Variable パネル内で、下矢印をクリックしてPopulate Refresh Connection Failure & Time Stamp を展開する。
    • 作成ファイル 出力の選択
      • シートデータ書き込み-データアップロード失敗コマンドで記入されているものと同じ情報が、他のフィールドに同じまま入力されていることにお気づきになることでしょう。
• コマンドの保存

ステップ9：エクササイズのテスト

チェーンが完成したら、結果をテストする。

• チェーンを更新
• 新規コマンドをテストするために、コントロールシートを編集して強制的に失敗させる。
  • Workiva プラットフォームのCLP コントロールシート スプレッドシートにナビゲーションします。
  • いずれかの行のTableID値を削除
  • 別の行のSpreadsheetID値を削除
    
• CLP｜Logging Failures within a Control Sheet チェーンに戻り、Execute をクリックします。選択 実行チェーン
• チェーンが完了したら、ワークフローが完了したことを以下のチェックで確認する：

データのアップロードに失敗した場合の失敗ブランチ：

接続の更新失敗の場合にフォローする失敗ブランチ：

結果をコントロールシートに記入し、失敗と正常を示す：

おめでとうございます。データ集中化接続ラーニングパス・シリーズは終了しました！Transformation Connected Learning Paths で、さらにチャレンジしてみよう。