Workiva サポートセンター

この接続ラーニングパスでは、うるう年を動的に説明する方法を描写するチェーンを作成します。

ステップ1：チェーンの作成

• ワークスペース内のチェーン・モジュールから、DEV Environment を選択する。
• 新規チェーンを追加
  • チェーンの名称、CLP | 変数変換/トランスフォーメーション | 日時の解析.
  • 説明を追加: Connected Learning Path Chainテンプレートは、月と年のランタイム入力が、どのように様々な期間キー書式を動的に生成し、うるう年を考慮するかを説明します。このテンプレートでは、変数トランスフォーメーションを使用して日付を再フォーマットし、うるう年を動的に考慮しながら期間キーを計算します。
• チェーンの保存

ステップ2：ランタイム入力の追加

Runtime Inputs チェーンが実行時に値を要求する方法を説明します。これは、チェーンを複数のプロセスで使用できるようにする貴重な方法である。

• コマンドの作成
  • Start nodeにRuntime Inputsを追加
    検索棒グラフを使って "runtime "を検索します。次にダブルクリックすると、コマンドが自動的にスタートサークルに読み込まれます。
  • Add Input をクリックし、DropdownField を選択する。
  • DropdownField を以下のように構成する：
    

    表示名	月
    必須	チェック済み
    説明	当月を選択

  • オプション追加をクリック
  • オプションで以下のように構成します：
    

    値	{"display":"January","value":"01-01"}
    表示名	1 月
    デフォルト	未確認

• ドロップダウン・フィールドを完成させる
  • 残り11ヶ月のオプションを追加。値および表示名称を適宜更新する。
    • 例: {"display":"February","value":"02-01"}
• NumberField ランタイム入力の追加
  • ドロップダウン・フィールドの入力が完了したら、NumberField Input を追加
  • NumberField を以下のように構成する：
    

    表示名	年
    必須	チェック済み
    説明	現在の年をYYYY書式設定で入力する。
    既定値	<leave blank>
    最小値（チェック済み）	2000
    最大値（チェック済み）	2050

• ランタイム入力の保存

ステップ3：期間キー作成コマンドを追加

Handlebars Connectorを使用して、Runtime Inputsで指定された値を受け取り、YYYY-MM-DD書式設定の期間キーを作成します。

• レンダーテキストテンプレート コマンドを追加ハンドルバーコネクターからチェーンへ
• Start Node (Runtime Inputs) をRender Text Template コマンドに接続する。
• コマンドの編集
  • コマンドの名称テキストテンプレートのレンダリング - 報告期間キーの作成
  • テンプレートパラメータに以下を入力する：
    

    {{Year}}-{{Period}}

  • 変数セクションで、変数 セクションの追加 ボタンを2回クリックして、2つの変数を追加する。
  • 最初の変数には、変数名称をYearと指定
    • メモ：変数名称は大文字と小文字を区別する。
  • 値フィールドをクリック
    • 変数ペインで、Trigger ➡ Runtime Inputs を展開し、Year を選択する。
  • 2つ目の変数には名称をPeriodと指定
  • 値フィールドをクリック
    • 変数ペインで、Trigger ➡ Runtime Inputs を展開し、Month を選択する。
    • 値に割り当てられたMonth変数（バブルで示される）をクリック
    • トランスフォーメーション選択 ドロップダウンをクリックする。
      • JSONとしてテキストを解析を選択
      • プラス（＋）記号をクリックします。
      • 変換選択 ドロップダウンを再度クリック
        • JSONからの値取得を選択
        • プラス記号をクリックする
      • JSONから値を取得において
        • 出力列のドロップダウンから、"T "を選択します。
          • メモ：T は、前のステップで設定された月変数である。
        • Value列のフィールドに「value」と入力し、Enterキーを押うします。
          • メモ：テキスト値は小文字でなければならず、Enterキーを押した後にグレーのバブルとして表示されます。
      • 承認をクリック
• コマンドの保存

ステップ4：日付操作を行うコマンドの追加

私たちは、日付の計算と再フォーマットを含むいくつかの日付操作を実行するためにHandlebarsコネクターを使用しています。

• レンダーテキストテンプレート コマンドを追加ハンドルバーコネクターからチェーンへ
• Render Text Template - Create Period Key コマンドを Render Text Template コマンドに接続する。
• コマンドの編集
  • コマンドの名称テキストテンプレートの描画 - 日付の解析
  • Template パラメータに以下を入力：

選択した報告期間： 

  月：{{Month_Name}} 

年

  報告期間キー：{{Period_Key}} 

  報告期間終了キー：{{EOM_Key}}

• • テンプレートパラメータセクションで
    • 以下の年以降をクリック
    • 次に、Trigger➡ Runtime Inputs を展開し、Year を選択する。

ステップ5：変数セクション

• 変数セクションの追加ボタンをクリックして、3つの変数を追加する。
  • 最初の変数について：
    • 最初の変数名称をMonth_Nameとします。
      • 値フィールドをクリック
        • 変数ペインで、Trigger ➡ Runtime Inputsを展開し、月を選択します。
      • 値フィールドのMonth 変数のバブルをクリックする。
        • トランスフォーメーション選択 ドロップダウンをクリックする。
          • トランスフォーメーション選択 ドロップダウンをクリックする。
        • 変換選択 ドロップダウンを再度クリック
          • Get Value from JSONを選択し、プラス（+）記号をクリックします。
            • JSONラインから値を取得する場合に、出力ドロップダウンからTを選択します。
            • 同じ Get Value from JSON 行で、Value フィールドにdisplayと入力し、Enter キーを押します。
            • 承認をクリック

• 2番目の変数について：
  • 変数名称をPeriod_Keyと設定
    • 値フィールドをクリック
      • 変数ペインで、Render Text Template - Create Period Keyを展開します。
        • テキストのレンダリングを選択
    • 値フィールドのRendered Text 変数のバブルをクリック
      • Select transformation ドロップダウンをクリックし、Parse Date / Time を選択し、プラス（+）ボタンをクリック
      • 最初のドロップダウン・ボックスに「%Y-%m-%d 」と入力し、必ずEnterキーを押す。
      • 出力書式設定欄に、%m/%d/%Y と入力する。
      • Input date timezone ドロップダウンで、UTC とタイプし、(UTC) Dublin, Edinburgh, Lisbon, London タイムゾーンを選択する。
      • 出力日のタイムゾーンフィールドのUTC選択を繰り返す。
      • 承認をクリック

• 3番目の変数について：
  • 変数名称をEOM_Key とする。
    • 値フィールドをクリックする。変数ペインで、Render Text Template - Create Period Keyを展開し、Rendered Textを選択
    • 値に割り当てられているRendered Text 変数をクリックする。
      • Select transformation ドロップダウンをクリックし、Add / Subtract Date and Time を選択し、プラス（+）記号をクリックします。
        • 書式設定のドロップダウン・ボックスに、%Y-%m-%d と入力し、必ずEnterキーを押す。
        • Operationのドロップダウンで、Addを選択する。
        • 金額フィールドに1 と入力。
        • 単位」のドロップダウンで、「月」を選択。
      • 追加の日付の追加/減算と時間のトランスフォーメーションを追加
        • 書式設定のドロップダウン・ボックスに、%Y-%m-%d と入力し、必ずEnterキーを押す。
        • 操作のドロップダウンで、引き算を選択する。
        • 金額フィールドに1 と入力。
        • 単位」のドロップダウンで、「Day」を選択。
      • 出力日付タイムゾーンフィールド
      • 承認をクリック
• コマンドの保存

ステップ6：チェーンのテスト

チェーンが完成したので、結果をテストしよう。

• チェーンを更新
• Executeをクリックして、Run With Inputを選択
• 月 ドロップダウンから、2月 を選択。年としては、2024を入力
• Start をクリックします。Render Text Template - Create Period Key Command のLog タブで、チェーンの結果をレビューする。
  • 月末期間 キー（うるう年）を確認する。

• 2月を使って再度チェーンを実行するが、この実行のために「年」に2025 を入力する。
  • 月の終わりが正しい日、すなわちうるう年でないことを確認する。

チェーンを使ったデータ変換の詳細は、Connected Learning Paths - Transformation Introduction をご覧ください！