ファイル/フォルダーをコピー

UiPath.MicrosoftOffice365.Activities.Files.CopyItem

説明

Microsoft Graph の Copy item API を使用して、ファイルまたはフォルダーのコピーを作成し、それを同じ親フォルダーまたは新しい親フォルダー ([コピー先フォルダー]) に追加します。

コピーするアイテムを [コピー先フォルダー] に追加すると、アクティビティは DriveItem オブジェクト (参照名) を返します。このオブジェクトは、後続のアクティビティ内で入力変数として使用できます。

プロジェクトの対応 OS

Windows - レガシ |Windows

構成

アクティビティの本体

• コピーするファイルまたはフォルダー - DriveItem としてコピーするファイルまたはフォルダーです。このオブジェクトは [ファイルやフォルダーを探す] アクティビティを使用して取得できます。[ファイルやフォルダーを探す] アクティビティの出力プロパティ変数 ([最初] または [結果]) を使用します。[ファイルやフォルダーを探す] アクティビティの [結果] 出力プロパティを使用する場合、配列内の使用する項目を指定します (例: myWorkbooks(0))。
• コピー先フォルダー - このアイテムが DriveItem としてコピーされる先のディレクトリです。このオブジェクトは [ファイルやフォルダーを探す] アクティビティを使用して取得できます。何も指定しない場合は、ユーザーのルート フォルダーが使用されます。[ファイルやフォルダーを探す] アクティビティの出力プロパティ変数 ([最初] または [結果]) を使用します。[ファイルやフォルダーを探す] アクティビティの [結果] 出力プロパティを使用する場合、配列内の使用する項目を指定します (例: myWorkbooks(0))。
• 新しい名前 (任意) - このアイテムのコピー後の名前です。ファイルをコピーする場合、コピーに適用するファイル拡張子を含めます (例: 「CopyExcelQuickstart.xlsx」)。 このプロパティは、String 型変数と文字列形式の値をサポートします。

プロパティ パネル

共通

• 表示名 - デザイナー パネルに表示されるアクティビティの名前です。このプロパティは、String 型変数と文字列形式の値をサポートします。

入力

• 「アクティビティの本体」のオプションをご覧ください。

その他

• プライベート - オンにした場合、変数および引数の値が Verbose レベルでログに出力されなくなります。 このフィールドでは、Boolean 値がサポートされています。

オプション

• アカウント - OneDrive を所有するユーザーの ID またはユーザー プリンシパル名です。認証の種類が ApplicationIdAndSecret と ApplicationIdAndCertificate の場合は、このパラメーターを設定する必要があります。

出力

参照名 - 他のアクティビティでこのフォルダーを参照するときに使用する名前です。

動作のしくみ

以下の手順とメッセージ シーケンス ダイアグラムは、設計時 (つまり、アクティビティの依存関係と入/出力プロパティ) から実行時に至るまでの、アクティビティの動作のしくみの例を示したものです。

1. 「セットアップ」の手順を完了します。
2. プロジェクトに [Microsoft Office 365 スコープ] アクティビティを追加します。
3. DriveItem オブジェクトを出力するアクティビティを追加するか外部プロセスを実行します (例 : [ファイルやフォルダーを探す]、[ブックを作成]、[アイテムをコピー])。
4. [Microsoft Office 365 スコープ] アクティビティ内に [ファイル/フォルダーをコピー] アクティビティを追加します。
5. [入力] セクションのプロパティに値を入力します。
6. [出力] セクションのプロパティのために DriveItem 型変数を作成し、入力します。

7. アクティビティを実行します。

   • 入力したプロパティ値は、CopyDriveItem API に渡されます。
   • API は、[出力] セクションのプロパティ変数に DriveItem の値を返します。