MS Office 365 One Drive 「ファイルまたはフォルダーのコピー (Copy Files or Folders)」アクティビティーの使用
「ファイルまたはフォルダーのコピー (Copy Files or Folders)」アクティビティーを使用して、MS Office 365 One Drive でファイルまたはフォルダーを宛先フォルダーにコピーします。
MS Office 365 One Drive インスタンスでファイルまたはフォルダーを宛先フォルダーにコピーするには、このタスクを使用します。 このアクティビティーの呼び出しは、同期呼び出しです。同期呼び出しでは、入力データが処理のためにアクティビティーに送信され、オーケストレーションに応答が返信されます。
- アクティブなオーケストレーションで、「アクティビティー」タブを開いて MS Office 365 One Drive フォルダーのコンテンツを展開します。
- 「ファイルまたはフォルダーのコピー (Copy Files or Folders)」アクティビティー・アイコンをオーケストレーション上にドラッグします。MS Office 365 One Drive ファイルまたはフォルダーのコピー「チェックリスト」が表示されます。
- 「チェックリスト」で、「要約」をクリックします。
- 「アクティビティー名」フィールドの内容を確認して、必要な変更を行います。
- 「チェックリスト」で、「エンドポイントの選出」をクリックします。
- 「参照」をクリックし、「プロジェクト・エクスプローラー」ダイアログ・ボックスを使用して、関連する MS Office 365 One Drive エンドポイントを選択します。
- 選択したエンドポイントの構成に対して必要な変更を行うには、「編集」をクリックして、別のウィンドウでオプションにアクセスします。 変更を行うと、アクティブなオーケストレーションにおけるエンドポイントのすべての使用に、グローバルに影響します。
- 追加構成はこのアクティビティーには不要です。
- 「チェックリスト」から「入力のマップ」を選択します。 「ファイルまたはフォルダーのコピー (Copy Files or Folders)」アクティビティーの選択済みオブジェクトから生成された XML スキーマが、「アクティビティーへ」パネルの request 入力パラメーターの下にノードとして表示されます。
- オーケストレーション変数とアクティビティーの入力パラメーターとの間のマップを作成します。
必須フィールド: このアクティビティーには、以下の必須フィールドがあります。
- requestType: この値で、コピー対象のリソースを見つけるために ID またはパスのいずれを使用するかが決まります。
- inputType: この値は、file または folder のどちらのリソースのメタデータをコピーするかを指定します。
- folder_id – フェッチするフォルダー・プロパティー。requestType が BY_ID の場合は必須です。
- file_id – フェッチするファイル・プロパティー。requestType が BY_ID の場合は必須です。
- path - ダウンロードするファイルのロケーション。requestType が BY_PATH の場合は必須です。
- new_name – ファイルまたはフォルダーに指定する新規名
- destination_folder_id – ファイルまたはフォルダーを別のロケーションに移動する必要がある場合は、宛先フォルダー ID が必要です。
- destination_folder_path - ファイルまたはフォルダーを別のロケーションに移動する必要がある場合は、宛先フォルダー・パスが必要です。
注: 入力構造の必須エレメントの値は、実行時に指定されている必要があります。 この値は、エレメントのデフォルト値を指定するか、エレメントを入力ノードにリンクすることによって指定できます。 実行時に必須エレメントの値が指定されていないと、アクティビティーは Web 管理コンソールから報告された例外をスローします。 実行時にオプションの入力パラメーターの値が指定されていなくても、実行時に例外はスローされません。
- 「チェックリスト」から「出力のマップ」を選択します。 アクティビティーの応答保持のために生成された XML スキーマが、「アクティビティーから」パネルの response 出力パラメーターの下にノードとして表示されます。
- 出力パラメーターとオーケストレーション変数との間のマップを作成します。
ユーザーは、MS Office 365 One Drive 「ファイルまたはフォルダーのコピー (Copy Files or Folders)」アクティビティーを構成しました。
注: このアクティビティーへの入力として、複数のオブジェクトを追加することができます。 入力として複数のオブジェクトを追加するには、「入力のマップ」の「アクティビティーへ」ペインでオブジェクトを右クリックし、「オカレンスの展開」を選択します。複数のオブジェクトを追加できるのは、オブジェクトのタイプが同じ場合のみです。