Data Fabric ユーザーガイド

デリバリー:

最終更新日時 2025年8月21日

エンティティレコードのファイルフィールドをダウンロードする

Studio を使用すると、エンティティレコードの特定のファイルを簡単に操作できます。これらのアクティビティにより、エンティティレコードの指定したフィールドの指定したファイルを、アップロード、ダウンロード、または削除することができます。

次の例では、Wikipedia のページから抽出したオリンピック大会に関する情報を含む特定のファイルを Data Fabric から自動的にダウンロードし、そのファイルを使用して他の操作に使用する方法を示します。

サンプルをダウンロードする

前提条件: Data Fabric でエンティティを作成する

「エンティティを作成する」ページに詳細に記載された手順に従って、オリンピック大会に関する情報を保存するためのエンティティを作成しました。

「Olympics」エンティティには、Name (テキスト)、Logo (ファイル) といったフィールドがあります。

次のページをご覧ください。

[ファイルをレコードのフィールドにアップロード] アクティビティのページ: このアクティビティを使用してロゴを簡単にアップロードする方法について詳しく説明しています。
「ファイル」のページ: プラットフォームからロゴをアップロードする方法について詳しく説明しています。

注: エンティティには、そのエンティティの作成に関する詳細情報を提供するために、システム組み込みフィールドが自動的に追加されます。

ステップ 1: ワークフローを構築する

クエリ関連のレコード

[エンティティレコードにクエリを実行] アクティビティを使用し、folder変数を設定することで、Data Fabric の「Olympics」エンティティからレコードのリストを抽出します。このアクティビティは、[ 名前 ] フィールドのすべてのレコードを順に olympicsRecords 変数に出力し、後続の [入力ダイアログ ] アクティビティで使用できるようにします。

入力ダイアログボックスを作成する

[入力ダイアログ] アクティビティを追加し、Select ラベルメッセージと入力の種類Multiple choice を含むダイアログボックスを表示します。入力の配列に、[エンティティレコードにクエリを実行] アクティビティ用に以前に作成した olympicsRecords 変数を追加し、これに関数 olympicsRecords.Select(Function (o as Olympics) o.Name).ToArray を適用して、選択オプションの配列を設定します。

出力結果を収集する selectedOlympics 変数を設定します。

ファイルに値を割り当てる

[入力ダイアログ] アクティビティで以前に作成した olympicsRecords.First(Function (o as Olympics) o.Name = selectedOlympics) 変数を、[代入] アクティビティを使用して新しい olympicEdition 変数に代入します。

[フォルダーを選択] ダイアログボックスを設定する

ダイアログボックスを開くための [フォルダーを選択] 変数を追加し、出力フォルダーパスに使用する folder 変数を作成します。この変数は、後で [ ファイルをレコードのフィールドからダウンロード ] アクティビティで使用します。

ファイルをレコードのフィールドからダウンロード (Download File from Record Field)

[ファイルをレコードのフィールドからダウンロード] アクティビティを使用して、olympicEdition.Id エンティティレコードの「Logo」ファイルからfolder ファイルをダウンロードします。

Power Shell コマンドを設定する

[ PowerShell を呼び出し]Path.Combine(folder, olympicEdition.Logo.Name) アクティビティを追加して、コマンドラインfolder olympicEditionを実行します。入力パラメーターおよび変数と、「 Olympics 」エンティティ内で作成した フィールド「Logo 」および 「Name 」を結合するためです。

このアクティビティの目的は、ファイルのフルパスを呼び出して、既定のフォトビューアーまたはエディターで開くことです。

[オプション] コメントアウト

オプションのステップとして、ファイルの削除の実行方法を示すサンプルを追加しましたが、実行時にファイルが削除されないようにコメントアウトしてあります。そのために [コメントアウト] アクティビティを追加しました。そこには、実行時に除外される下記のアクティビティが含まれています。

なお、コメントを解除して試すことができます。

子アクティビティの順序を設定します。

[シーケンス] アクティビティが、[無視されるアクティビティ] と名前を変更して追加されています。
指定したエンティティレコードフィールドからファイルを削除する [ファイルをレコードのフィールドから削除] アクティビティを含めます。
[ファイルをレコードのフィールドから削除] アクティビティで意図したとおりの動作が実行されるようにするために、以下のように設定します。
1. [レコード ID] に [ファイルをレコードのフィールドからダウンロード] アクティビティ内で作成した olympicEdition.Id 変数を設定します。
2. ファイルの削除元の[フィールド] は、この例の冒頭で作成した Data Fabric レコードで作成した Logo ファイルです。
3. [出力レコード] に、[代入] アクティビティ内で作成した olympicEdition 変数を設定します。