アクティビティを設定する

アクティビティはデータを入力として受け取って、出力データを生成します。この出力データは、他のアクティビティの入力として使用できます。アクティビティの重要なオプションまたはプロパティは、既定でアクティビティ カードに表示されます。他にもプロパティがある場合は、[追加プロパティを表示] を選択して設定できます。

[プロパティ] パネルでは、アクティビティのプロパティの表示方法を制御できます。このパネルを使用して、 プロジェクト エクスプローラーで選択したプロジェクトの名前やワークフローの名前を変更することもできます。

パネルにアクセスするには、プロジェクト ページの右上隅にある対応するアイコンを選択します。 [プロパティ] パネルでは、以下の 2 つのビューをいつでも切り替えることができます。

• キャンバス ビュー - 選択したアクティビティのすべてのプロパティがアクティビティ カードに表示されます。

• パネル ビュー - 選択したアクティビティのすべてのプロパティ (詳細プロパティを含む) は [プロパティ] パネルにのみ表示され、アクティビティ カードは折りたたまれます。

  

アクティビティ フィールドの横にある [その他を表示] を選択すると、そのフィールドのオプションが表示されます。ほとんどのフィールドのオプションは次のとおりです。

• 変数を使用
• テキスト ビルダー
• 変数を作成
• 式エディターを開く
  注:

  利用可能なオプションは、フィールドに関連付けられているデータ型によって異なる場合があります。

アクティビティの設定は、データ型に応じて、専用の入力コントロール、エディター、およびビルダーを利用して行えます。プロジェクト デザイナーのアクティビティから直接行うか、エディターまたはビルダーから設定できます。

一部のアクティビティでは、それらのアクティビティ内に追加された他のアクティビティを実行する場合のスコープまたは満たすべき条件を定義します。これらはコンテナー アクティビティと呼ばれ、たとえば以下のようなアクティビティがあります。

• [繰り返し (コレクションの各要素)] アクティビティ
  • 項目のコレクションを定義し、その項目ごとに、項目内に追加されたアクティビティを 1 回ずつ繰り返します。
• 条件分岐 (if) - 条件を評価し、オートメーションのフローを決定します。条件が満たされているかどうかに基づいて特定のアクティビティを実行します。
• ブラウザーを使用 - ブラウザーのページにアタッチして、アクティビティ内のすべての UI Automation アクティビティをそのページで実行します。

以降のセクションでは、利用可能な一部のエディターとビルダーを使用する方法について説明します。

式エディター

アクティビティのプロパティを設定するための複雑な式を記述します。式エディターは、ほとんどのアクティビティのプロパティで利用でき、変数、引数、メソッド、プロパティ、クラス、キーワードに対応したインテリジェントなコード補完機能を備えています。複数の行にまたがって式を記述したり、Ctrl + Space キーを使用して利用可能なオプションのリストを表示したりできます。[変数を挿入] を選択して変数を選択するウィンドウを開き、変数、引数、プロパティを選択することもできます。

エディター内で Ctrl + F キーを押すと、検索および置換機能が起動します。エラー アイコンは、式と、アクティビティのプロパティの型との間に不一致があることを示します (たとえば、String 型の式を Boolean 型のプロパティで使用した場合など)。

[ テスト] を選択すると、有効な式の値をテストできます。現在、複雑な値を使用する式のテストはサポートされていません。

Autopilot™ を使用して式を生成する

また、Autopilot™ の生成 AI 機能を利用して、自然言語を使用して式を記述することもできます。式エディターで式を手動で記述する代わりに、[式を生成] フィールドを使用して目的のアクションを記述できます (例: 「売上レポートから総収益を抽出」)。

AI モデルにより、入力された説明に基づいて式が生成され、エディターに表示されます。生成された式は、変更することも、そのまま受け入れることもできます。AI モデルは、入力された説明から継続的に学習するため、時間の経過と共にパフォーマンスが洗練され改善されていきます。このモデルは、ユーザー定義の変数と引数を使用することもでき、すでに使用されている式を認識します。

エラー アイコンの横にある [修正] ボタンを選択すると、Autopilot は、不一致を修正して有効な式を提供しようと試みます。式を自動的に修正できない場合は、エラー メッセージで通知されます。

式エディターでの Autopilot 機能の使用例

Autopilot の機能をテストする簡単な方法は、変数を小文字から大文字に変換することです。このためには、以下を実行します。

1. 手動トリガーを使用する新しいプロジェクトを作成し、新しい変数を作成します (例: MyVariable)。

2. 変数の型を [テキスト] に設定し、[既定値] を「example」に設定します。

3. [変数の値を設定] アクティビティを追加します。

4. [設定する値] フィールドで、[その他を表示] > [[式エディター] を開く] を選択します。

5. [式を生成] フィールドに、自然言語で指示を入力します (例: 「MyVariable を大文字に変換します」)。

6. [式を生成] を選択して式を生成します。必要に応じて、[式エディター] で [テスト] を選択して、変数の新しい値をテストします。

7. [保存] を選択し、Autopilot によって生成された式を使用します。

8. [変数] 出力フィールドで [MyVariable] を選択します。

   

9. [メッセージをログ] アクティビティを追加します。

10. [ メッセージ ] フィールドで、ログに記録するメッセージ (例: 「変数 の MyVariableが大文字になりました」) を作成し、ログ レベルを選択します。

11. デザイナーの上部にある [ クラウドでデバッグ ] を選択してオートメーションをテストし、[実行結果] パネルで変数が小文字 ("example") から大文字 ("EXAMPLE") に変更されたことを確認します。

    

フィルター ビルダー

1 つ以上の条件を持つ複雑なフィルターを作成します。フィルターを使用すると、使用すべき項目をオートメーションで正確に特定できます。たとえば、ほとんどのイベント トリガーにはフィルターが含まれており、これを使用して、オートメーションを開始するためにイベントが満たす必要がある条件を正確に指定できます。

フィルターを構築するには、以下の手順を実行します。

1. フィルター処理する項目を左側のフィールドから選択します。たとえば、メールをフィルター処理する場合は、[送信元] や [本文] などのメール フィールドを選択できます。
2. 中央のドロップダウンから、項目を比較するために使用する演算子を選択します。データ型に応じて、選択できる演算子は複数あります。たとえば、メールを送信者でフィルター処理する場合、[送信元] フィールドに対して、演算子 [次の値を含む] または [次を含まない] を選択できます。
3. 右側にあるフィールドから、選択した項目と比較する値を選択します。

複数の条件を持つフィルターを作成するには、フィルター ビルダーで [ 条件を追加 ] をクリックして、追加する各条件を同様の方法で構築します。複数の条件を追加すると、ウィンドウの上部にドロップダウン メニューが表示されます。このメニューから、フィルターが適用される条件を選択する必要があります。すべての条件を満たすとフィルターが適用される場合は [ All (AND) ] を選択し、いずれかの条件を満たすとフィルターが適用される場合は [ Any (OR) ] を選択します。

フィルターの構築例

OneDrive または Google ドライブの [ファイルの作成時] イベントによってトリガーされるオートメーションを設計します。拡張子が pdf、tif、jpg、png、jpeg のファイルが作成された場合にのみオートメーションが実行される設定にします。

1. トリガー アクティビティで [追加フィルター] を選択し、フィルター ビルダーを開きます。

2. フィルターに含めるファイル拡張子ごとに条件を追加します。1 つ目のフィールドから [拡張子] を選択し、2 つ目のフィールドから [次の値を含む] を選択し、3 つ目のフィールドに拡張子を入力します。

3. ウィンドウ上部のドロップダウンから [いずれかの条件に一致 (OR)] を選択し、いずれかの拡張子を持つファイルが作成されるとオートメーションがトリガーされるように指定します。

   

条件ビルダー

True または False のステートメントを定義します。アクティビティは、このステートメントを評価してオートメーションの続行方法を決定します。

条件を構築するには、以下の手順を実行します。

1. たとえば、プロジェクトの変数など、比較する 1 つ目の値を左側のフィールドから選択します。
2. 中央のドロップダウンから、1 つ目の値を比較するために使用する演算子を選択します。データ型に応じて、 greater than、 greater than or equal、 less than、 less than or equal、 equals、 not equals、 is empty text、 is not empty text、 is true、 is false、 starts with、 does not start with、 ends with、 does not end with、 contains、 does not contain、 has value、 has no value、 list is empty、 list is not empty。
3. 演算子によっては、右側のフィールドから、1 つ目の値と比較する 2 つ目の値も選択する必要があります。

複数の条件を持つステートメントを作成するには、条件ビルダーで [追加] をクリックして、追加するステートメントごとに同じ情報を指定します。複数のステートメントを追加すると、ウィンドウの上部にドロップダウン メニューが表示されます。このメニューから、ステートメントが True になる条件を選択する必要があります。すべての条件を満たすとステートメントが True になる場合は [すべての条件に一致 (AND)] を、いずれかの条件を満たすとステートメントが True になる場合は [いずれかの条件に一致 (OR)] を選択します。

条件の構築例

お使いの Google ドライブまたは OneDrive の特定のフォルダー内に作成されたすべてのファイルを、各ファイルのサイズに基づいて 2 つのフォルダーのいずれかに移動するオートメーションを設計しています。1 MB 以上のファイルは Big files フォルダーに移動し、1 MB 未満のファイルは Small files フォルダーに移動します。

1. [ファイルの作成時] トリガーを設定します。

2. [条件分岐 (if)] アクティビティを追加し、[条件] フィールドをクリックして条件ビルダーを開きます。

3. 条件ビルダーで「ファイル サイズが 1 MB 未満である」という条件を追加します。作成されるファイルの SizeInBytes プロパティと 1 MB = 1000000 バイトを使用します。

   1. 1 つ目のフィールドをクリックし、[ファイルの作成時] > [その他を表示] > [ファイル] > [SizeInBytes] を選択します。
   2. 中央のフィールドから [次の値より小さい] を選択します。
   3. 3 つ目のフィールドに「1,000,000」と入力して [保存] をクリックします。

   

4. 続いて、作成されるファイルを移動するために、以下のように [ファイルを移動] アクティビティを 2 つ追加します。

   • 1 つのアクティビティを [条件分岐 (if)] アクティビティの [Then] 分岐に追加します。これは条件が満たされた場合 (ファイル サイズが 1 MB 未満の場合) に実行されるアクティビティであるため、移動先フォルダーとして [Small files] を選択します。
   • もう 1 つのアクティビティを [条件分岐 (if)] アクティビティの [Else] 分岐に追加します。これは条件が満たされない場合 (ファイル サイズが 1 MB 以上の場合) に実行されるアクティビティであるため、移動先フォルダーとして [Big files] を選択します。

   

コレクション ビルダー

同じ型の項目のコレクションを作成します。

コレクションを構築するには、項目を選択してから、追加するエントリごとに [エントリを追加] を選択します。

コレクションの構築例

2 つの異なるダウンロード アクティビティでファイルを取得した後に、1 つの [ファイルをアップロード] アクティビティを使用して、OneDrive または Google ドライブにファイルをアップロードするオートメーションを設計します。

1. [ファイルをアップロード] アクティビティで、[その他を表示] を選択します > [ファイル] フィールドの横にある [ファイルのコレクションを構築] を選択します。

2. [クリックしてコレクション ビルダーを開く] を選択します。

3. [ 追加] を選択してから 1 つ目のフィールドをクリックし、1 つ目の [ファイルをダウンロード] アクティビティの出力を選択します。2 番目のアクティビティの出力についても繰り返して、[ 保存] をクリックします。

   

日時セレクター

カレンダーで日付と時刻 (時と分) を選択します。日付と時刻の値が必要なフィールドで利用できます。

日付と時刻の値を使用できるフィールドで変数を使用する場合、スニペットを使用することもできます。スニペットを使用すると、一般的な日付および時刻の変数をすばやく追加できます。

• 今日
• 昨日
• 明日
• 2 日前
• 先週の最初の稼働日の始め
• 先週の最後の稼働日の終わり
• 来週の始め
• 来月の始め
• 今週の始め
• 今月の始め
• 先月の始め
• 今年の始め
• 3 か月前
• 6 か月前
• Now

データ マッピング エディター

データ マッピング エディターは、複雑なデータ構造を含むエンドツーエンドの業務プロセスの自動化を簡素化します。データ マッピングを使用すると、複雑なデータ オブジェクトを 1 つの Integration Service アクティビティ内のシステム間でマッピングできます。

データ マッピング エディターにアクセスするには、以下の手順を実行します。

1. ワークフローに Integration Service アクティビティを追加します。

2. アクティビティの本体にある [オブジェクト ビューに切り替え] ボタンを選択します。

3. 編集するアクティビティ フィールドを選択します。データ マッピング エディターが開きます。

   

または、アクティビティ フィールドの横にある [データ マッピング > [その他を表示] を選択して、データ マッピング エディターにアクセスすることもできます。

エディターには次の 2 つのモードがあります。

1. エディターにアクセスするたびに開く標準モードです。これは既定のモードです。
2. 詳細モードです。エディターの右上隅にある [ 詳細モード ] トグルから有効化できます。

標準モードでは、以下の操作を実行できます。

• [すべて展開] ボタンと [すべて折りたたみ] ボタンを使用して、入れ子になったすべてのオブジェクトのプロパティを展開するか折りたたむ。
• 検索アイコンを選択して、特定のプロパティまたは変数を検索します。
• [ ターゲットのプロパティ] 列にオブジェクトのすべてのプロパティを表示する。一部のプロパティを展開して、追加の入れ子になったプロパティ (list 型のプロパティなど) を表示できます。各プロパティには、リスト内で簡単に区別できるように表示名と、サードパーティ アプリケーションによって定義された正確な API 名があります。
• オブジェクトのプロパティを [マッピング] 列のアクティビティの出力にマッピング します 。各プロパティの横にあるフィールドを選択し、[ 変数を使用 ] セレクターから変数を選択します。[ その他を表示] ボタンを選択して 次の操作を行うこともできます。
  • [変数を使用] セレクターを開きます。
  • [式エディター] を開く
  • アクティビティの出力フィールドの値をすべてクリアする
• [ 利用可能な変数 ] 列から、ワークフローで利用可能な変数を選択します。変数は、[ マッピング] 列の下に表示されているアクティビティの出力内にドラッグ アンド ドロップできます。
• 詳細モードを有効または無効にします。詳細モードでは、式を入力するか、[ 変数を使用 ] セレクターを使用してのみプロパティをマッピングできます。[利用可能な変数] 列から変数をドラッグ アンド ドロップすることはできません。
  注:

  Studio では、データ マッピング エディターは詳細モードでのみ使用できます。

アクティビティの出力フィールドのエラー アイコンは、変数と、アクティビティの出力の型が非対応であるかどうかを示します。

オブジェクトのプロパティをアクティビティの出力にマッピングしたら、[保存] ボタンを選択して変更を記録します。

注:

入れ子になったプロパティまたは親プロパティが既にマップされている場合、もう一方をマップすることはできません。

アクティビティ フィールドのインラインでの更新に戻るには、アクティビティの本体で [フィールド ビューに切り替え] を選択します。

重要:

データ マッピング エディターで作成した出力を使用するには、そのアクティビティを オブジェクト ビューで使用していることを確認してください。このアクティビティを フィールド ビューで使用する場合、ワークフローの実行時にデータ マッピング エディターで作成されたマッピングは考慮されません。