ブックを作成

UiPath.MicrosoftOffice365.Activities.Excel.CreateWorkbook

説明

Microsoft Graph の Upload item API を使用して、新しいブック ([名前]) を作成し、指定した場所 ([親]) にアップロードします。

ブックのアップロード後、アクティビティは DriveItem オブジェクト ([ブック]) と URL String ([ブック URL]) を返します。これらは、後続のアクティビティ内で入力変数として使用できます。

スコープ

このアクティビティには、次のスコープが必要です。

• Sites.ReadWrite.All

プロジェクトの対応 OS

Windows - レガシ |Windows

構成

プロパティ

共通

• 表示名 - アクティビティの表示名です。 このプロパティは、String 型変数と文字列形式の値をサポートします。

入力

• 競合の解決方法 - 同じ名前のブックが既に存在する場合の競合の解決方法を指定します。[置換]、[失敗]、[名前を変更] の 3 つのオプションのいずれかを選択します。既定値は [置換] です。
• 名前 - 新しく作成されるブックの名前です。 このプロパティは、String 型変数と文字列形式の値をサポートします。
• 親 - ブックが作成される親ディレクトリの DriveItem です。[ファイルやフォルダーを探す] アクティビティの出力プロパティ変数 ([最初] または [結果]) を使用します。[ファイルやフォルダーを探す] アクティビティの [結果] 出力プロパティを使用する場合、配列内の使用する項目を指定します (例: myWorkbooks(0))。

その他

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

出力

• ブック - 新しく作成されるブックの DriveItem です。後続のアクティビティで出力データを使用する予定がある場合は必須です。[親] プロパティで使用したものとは異なる DriveItem 型変数を入力します。
• ブックの URL - 新しく作成されるブックの URL です。後続のアクティビティで出力データを使用する予定がある場合は必須です。このプロパティは、String 型変数と文字列形式の値をサポートします。

動作のしくみ

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

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

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

   • 入力したプロパティ値は、UploadDriveItem API に渡されます。
   • API は、出力プロパティ変数に DriveItem と String の値を返します。