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

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

The following example demonstrates how to automatically download from Data Fabric / Data Service a specified file containing information from the Olympics games extracted from Wikipedia pages in order to use it for other operations.

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

Prerequisite: Create entities in Data Fabric / Data Service

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

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

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

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

• 「ファイル」のページ: プラットフォームからロゴをアップロードする方法について詳しく説明しています。

  注:

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

  

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

クエリ関連のレコード

We use the Query Entity Records activity to pull up a list of records from the Olympics entity from Data Fabric / Data Service by setting up the folder variable. This goes through all records from the Name field and outputs them in the olympicsRecords variable to be used in the following Input Dialog activity.

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

[ 入力ダイアログ ] アクティビティを追加し、 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. 子アクティビティの順序を設定します。

   [シーケンス] アクティビティが、[無視されるアクティビティ] と名前を変更して追加されています。

2. 指定したエンティティ レコード フィールドからファイルを削除する [ファイルをレコードのフィールドから削除] アクティビティを含めます。

   

3. [ファイルをレコードのフィールドから削除] アクティビティで意図したとおりの動作が実行されるようにするために、以下のように設定します。

   1. [レコード ID] を [ファイルをレコードのフィールドからダウンロード] アクティビティ内に作成した olympicEdition.Id 変数に設定します。

   2. The Field from where you want to delete the file is the Logo file created in Data Fabric / Data Service record created at the beginning of this example.

   3. [出力レコード] に、[代入] アクティビティ内で作成した olympicEdition 変数を設定します。

      

以上の作業が完了すると、プロジェクトは次のように表示されます。