Workiva サポートセンター

このConnected Learning Pathでは、うるう年を動的に考慮する方法を説明するChainを作成します。

ステップ1：チェーンを作る

• ワークスペース内の Chains モジュールから、DEV Environment を選択します。
• 新しいチェーンを追加する
  • CLP | 変数変換 | 日時の解析.
  • 説明を追加Connected Learning Path Chain テンプレートは、月と年のランタイム入力が、さまざまな期間キー形式を動的に生成し、うるう年を考慮する方法を説明します。このテンプレートは変数変換を使用して、日付を再フォーマットし、うるう年を動的に考慮しながら終了期間キーを計算します。
• セーブ・ザ・チェーン

ステップ2：ランタイム入力を追加する

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

• コマンドの作成
  • 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形式で入力する。
    既定値	<空白のまま
    最小値（チェック済み）	2000
    最大値（チェック済み）	2050

• ランタイム入力を保存する

ステップ3：ピリオドキーを作成するコマンドの追加

Handlebars Connector を使用して、Runtime Inputs で指定された値を取得し、YYYY-MM-DD 形式のピリオド・キーを作成します。

• Render Text Template Command fromHandlebars Connector to Chain を追加する。
• Start Node (Runtime Input) をRender Text Template Command に接続します。
• コマンドの編集
  • コマンドの名前テキストテンプレートのレンダリング - ピリオドキーの作成
  • Templateパラメータに以下を入力する：
    

    {年}}-{{期間}}。

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

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

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

• Render Text Template Handlebars ConnectorからChainへのコマンドを追加。
• Render Text Template - Create Period Key コマンドを Render Text Template コマンドに接続する。
• コマンドの編集
  • コマンドの名前テキストテンプレートのレンダリング - 日付の解析
  • Template パラメータに以下を入力：

選択した期間

月{月名}}

年だ：

ピリオドキー{ピリオドキー}}。

月末期間キー：{EOM_Key}}。

• • テンプレートパラメーターセクション
    • 年後のクリック
    • 次に、Trigger➡ Runtime Input を展開し、Year を選択します。

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

• 変数セクションの追加ボタンをクリックして、3つの変数を追加する。
  • 最初の変数について：
    • 最初の変数名をMonth_Name とする。
      • 値フィールドをクリック
        • 変数ペインで、Trigger ➡ Runtime Inputs を展開し、Month を選択する。
      • Value フィールドのMonth 変数のバブルをクリックする。
        • Select transformation ドロップダウンをクリックする。
          • Parse text as JSON を選択し、プラス (+) 記号をクリックします。
        • Select transformation ドロップダウンをもう一度クリックする。
          • Get Value from JSON を選択し、プラス（+）記号をクリックします。
            • Get Value from JSON行で、OutputドロップダウンからT を選択する。
            • 同じ Get Value from JSON 行で、Value フィールドにdisplay と入力し、Enter キーを押す。
            • Accept をクリックする。

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

• 第3の変数について：
  • 変数名をEOM_Key とする。
    • Value フィールドをクリックする。変数ペインで、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キーを押してください。
        • Operation（操作）ドロップダウンで、Subtract（減算）を選択する。
        • 金額」の欄に「1」と入力する。
        • 単位」ドロップダウンで、「Day」を選択。
      • 出力日付タイムゾーンフィールド
      • Accept をクリックする。
• コマンドを保存する

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

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

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

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

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