🧩

ソースを設定する(業務アセット)

この記事では、YESOD アカウントコントロールに登録されている業務アセットを書き出し元にする「ソース」の設定方法を説明します。 エクスポートのレシピで、YESOD 側のどのデータを書き出すかを設定します。
⚠️
前提
エクスポートを使うには、あらかじめ YESOD アカウントコントロール側で業務アセットと、その属性マッピングを用意しておく必要があります。データブリッジの「業務アセット」は、アカウントコントロールに登録されている業務アセットをそのまま参照しています。(プリセット業務アセット設定/オリジナル業務アセットの設定) アカウントコントロールを利用していない場合は、選べる業務アセットがなく、エクスポートのレシピは組めません。 また、ソースの種類はレシピの新規作成時に「業務アセット(メンバー)」または「業務アセット(グループ)」から選択します。(レシピを新規作成する)

Step 1 ソースタブを開く

  • レシピ詳細の「データ処理」タブをクリック
  • 「ソース」タブをクリック
  • 「ソース」見出しの右の「編集」をクリック

Step 2 各項目を設定する

設定できる項目は以下の通りです。
項目説明
業務アセット書き出す対象の業務アセットを選択(詳細は後述)
クエリ「基準日」で、どの時点のデータを書き出すかを指定(詳細は後述)
スキーマ選択した業務アセットの属性マッピングの一覧 編集中と、業務アセットが未選択のときは表示されません(詳細は後述)
💡
「業務アセット」と「クエリ」は同じ編集画面の中で設定し、「保存」をクリックするとまとめて反映されます。
⚠️
「業務アセット(グループ)」の「グループ種別」は、ソースタブでは変更できません。
「組織」「会社」「事業所」「プロジェクト」の選択は、レシピの新規作成時にのみ行えます。後から変更する場合は、レシピを新しく作成してください。(レシピを新規作成する)

業務アセット

どの業務アセットのデータを書き出すかを指定します。
  • 現在選択されている業務アセット名の右の「変更」をクリック
  • 一覧から書き出す対象の業務アセットを選択 業務アセットはカードで一覧表示されます。カードには名称とコードが表示されます。
  • 選択せずに元の表示に戻す場合は「戻る」をクリック
⚠️
業務アセットは最初に確定させてください。
「変更」をクリックすると、一覧の上に「業務アセットを変更すると、スキーマ(属性マッピング)の設定は選び直しになります。」と表示されます。 スキーマが入れ替わるため、変換タブでソース項目を指定していたマッピングも設定し直しになります。設定を進めたあとで変更すると、やり直しが発生します。
💡
  • 書き出したい業務アセットが一覧に見つからない場合や「利用可能な業務アセットがありません」と表示される場合は、アカウントコントロールの「業務アセット」に業務アセットが登録されているかを確認してください。 ※業務アセットの追加・編集はデータブリッジ側では行えません。
  • アカウントコントロールを利用していない場合は、この一覧は常に空になります。エクスポートのレシピを使うには、まずアカウントコントロール側で業務アセットを登録してください。 「業務アセットの取得に失敗しました」と表示された場合は、一覧の取得自体に失敗しています。時間をおいて画面を読み込み直してください。
⚠️
参照していた業務アセットが削除されると、「業務アセットが見つかりません」と表示され、あわせて「参照していた業務アセットが削除された可能性があります。「編集」から業務アセットを選び直してください。」と表示されます。 この状態のまま「保存」をクリックすると「業務アセットが削除されているため保存できません。業務アセットを再設定してください。」と表示されます。「編集」でソース設定の編集を開始し、「変更」から業務アセットを選び直してください。

クエリ

業務アセットのデータを、どの時点の状態で書き出すかを指定します。項目は「基準日」の1つだけです。
クエリの設定内容を変更する場合は、Step 1 と同じく「ソース」見出しの右の「編集」をクリックしてください。
項目説明
基準日 必須データを取得する基準となる日付 既定値は (実行日)
💡
基準日は実行パラメータとして扱われます。 は実行日が入る組み込みパラメータで、特に指定がなければこのままで問題ありません。 過去や未来の特定日で書き出す場合は、値を変更するか、実行パラメータを使って実行時に指定できます。(実行パラメータを設定する)
⚠️
基準日を空のまま保存することはできません。 空の状態で「保存」をクリックすると、「ソース」見出しの下に赤字で「asOf は必須です。」と表示されます(英字のまま表示されます)。 業務アセットを選択していない場合は、同じく赤字で「業務アセットを選択してください。」と表示されます。

スキーマ

選択した業務アセットの属性マッピングの一覧が表示されます。書き出せる項目がそろっているか確認します。 この一覧は、業務アセットに設定されている属性マッピングをそのまま表示しています。
一覧の列は以下の通りです。
列内容
キー属性マッピングのキー 変換タブでソース項目として表示される名前になります
型値の決まり方。(属性をそのまま使う)または (属性式で求める)
値 の場合は属性名、 の場合は属性式
  • 一覧を確認し、必要な属性が含まれているかを確認 含まれていない場合は、業務アセット側のご確認をお願いします。
💡
ここに表示される属性が、変換タブでソース項目として選べるようになります。 (変換を設定する(マッピングの基本))

Step 3 保存する

  • 「保存」をクリック 業務アセットと基準日の変更がまとめて保存され、「保存しました」と表示されます。
  • 編集を破棄する場合は「キャンセル」をクリック
💡
「保存」は、編集を開始した時点から内容が変わるまで押せません。 編集中は、「ソース」見出しの横に「ソース設定を編集中」と表示されます。
⚠️
保存しただけでは、実行される内容は変わりません。 変更を反映するには「デプロイ」が必要です。(レシピをデプロイする)