- 基本情報
- セットアップと構成
- オートメーション プロジェクト
- 依存関係
- ワークフローの種類
- 制御フロー
- ファイルの比較
- オートメーションのベスト プラクティス
- ソース管理との連携
- デバッグ
- ログ
- 診断ツール
- ワークフロー アナライザー
- ワークフロー アナライザーについて
- ST-DBP-002 - 多数の引数
- ST-DBP-003 - 空の catch ブロック
- ST-DBP-007 - 複数のフローチャートレイヤー
- ST-DPB-010 - [ワークフロー] または [テスト ケース] の複数のインスタンス
- ST-DBP-020 - 未定義の出力プロパティ
- ST-DBP-021 - ハードコードされたタイムアウト
- ST-DBP-023 - 空のワークフロー
- ST-DBP-024 - 永続性アクティビティの確認
- ST-DBP-025 - 変数のシリアル化の前提条件
- ST-DBP-027 - Persistence のベスト プラクティス
- ST-DBP-028 - 引数のシリアル化の前提条件
- ST-USG-005 - ハードコードされたアクティビティのプロパティ
- ST-USG-009 - 未使用の変数
- ST-USG-010 - 未使用の依存関係
- ST-USG-014 - パッケージの制限
- ST-USG-017 - パラメーターの修飾子が無効
- ST-USG-020 - 最小ログ メッセージ
- ST-USG-024 - 未使用で保存されたままの値
- ST-USG-025 - 保存した値の誤用
- ST-USG-026 - アクティビティの制限
- ST-USG-027 - 必要なパッケージ
- ST-USG-028 - ファイル テンプレートの呼び出しの制限
- ST-USG-027 - 必須のタグ
- ST-USG-034 - Automation Hub URL
- 変数
- 引数
- インポートされた名前空間
- コード化されたオートメーション
- トリガーベースの有人オートメーション
- オブジェクト リポジトリ
- ScreenScrapeJavaSupport ツール
- 拡張機能
- Studio でのテスト
- トラブルシューティング
Studio のオートメーション プロジェクトを移行する際にアクティビティ移行ツールでサポートされる GSuite アクティビティ。
アクティビティ移行ツールを使用する際にサポートされる GSuite アクティビティについては、以下の表をご覧ください。各行には、移行元のクラシック アクティビティ、移行先のモダン アクティビティ、および移行ツールが実行する最も重要な変換が一覧表示されます。
スコープ
| 移行前のアクティビティ | 移行後のアクティビティ | 備考 |
|---|---|---|
Google Workspace スコープ (GSuiteApplicationScope) | GSuiteApplicationScope | そのままのままです。内部アクティビティがその場で移行されました。 |
Google ドライブを使用 (GoogleDriveApplicationScope) | Sequence ( UseConnectionService=trueの場合) または GSuiteApplicationScope (OAuth) | 認証専用スコープスコープ コンテキストを介して子アクティビティに ConnectionId を挿入します。OAuth パスは、CredentialID と CredentialSecret の両方がバインドされている場合は OAuthClient = Custom を設定し、それ以外の場合は UiPathを設定します。 |
Google ドキュメントを使用 (GoogleDocsApplicationScope) | Sequence / GSuiteApplicationScope (+ CreateNew / CreateIfNotExistsの先頭にオプションのCreateDocumentConnectionsを追加) | ドキュメント ライフサイクル スコープAction列挙型では、[作成] アクティビティの先頭に追加するかどうかを指定します。新しいドキュメントの ID は、事前に割り当てられた newDocument 変数を介して子アクティビティにワイヤリングされます。 |
Google スプレッドシートを使用 (GoogleSheetsApplicationScope) | Sequence / GSuiteApplicationScope (+ CreateNew / CreateIfNotExistsの先頭にオプションのCreateSpreadsheetConnectionsを追加) | [ドキュメントのスコープ] と同じ形状です。 newSpreadsheetを事前に割り当てます。 |
Gmail
| 移行前のアクティビティ | 移行後のアクティビティ |
|---|---|
メールを送信 (SendEmail) | SendEmailConnections |
メール メッセージを取得 (GetMailMessages) | GetEmailListConnections (既定)または GetEmailByIdConnections (+ オプションの MarkAsReadUnreadConnections(EmailId設定されている場合)。リスト パス クラシック GmailMessage[]に戻すためにList<GmailMessage>Assignを追加します。 |
ラベルを変更 (ChangeLabels) | RemoveEmailLabelsConnections + ApplyEmailLabelsConnections削除するラベルは として計算されます email.LabelIds.Except(["SEND","DRAFT"])。適用するラベル [ビルダー + 変数] の入力を結合し、重複を削除して予約済みラベルを除外します。 |
予定表/カレンダー
| 移行前のアクティビティ | 移行後のアクティビティ |
|---|---|
出席者を追加 (AddAttendee) | GetEventByIdConnections + ModifyEventConnections ( を設定し ChangeRequiredAttendees=AddRemove、1 つのメールを配列に折り返します)。 |
予定を作成 (CreateEvent) | CreateEventConnections (EventId、EventUrl の出力の場合は + Assign)。 |
イベントを削除 (DeleteEvent) | GetEventByIdConnections + DeleteEventConnectionsマップ InstancesOption → DeleteType 列挙型 (THIS_EVENT/THIS_AND_FOLLOWING_EVENTS/ALL → SingleEvent/FutureOnly/PastAndFuture)。 |
イベントを変更 (ModifyEvent) | GetEventByIdConnections + ModifyEventConnections (EventId出力の場合は + Assign)。を設定します ChangeRequiredAttendees=Overwrite。 |
イベントを検索 (SearchEvents) | GetEventByIdConnections (設定 EventId 場合) または GetEventListConnectionsを指定します。クラシック Result (生の Event[]) がバインドされると、HTTP ブリッジが生の Event JSON を再取得します。以下の 「HTTP ブリッジ」 をご覧ください。 |
ドライブ
| 移行前のアクティビティ | 移行後のアクティビティ |
|---|---|
ファイルをコピー (CopyDriveFile) | CopyFileConnections (+ NewParentId が null の場合の先頭に追加されたGetFileFolderConnections。ファイルの現在の親を解決します。)(Result ID の場合は + Assign)。 |
ファイルを移動 (MoveDriveFile) | MoveFileConnections (+ NewParentId が null の場合は先頭に追加されるGetFileFolderConnections)。 |
フォルダーを作成 (CreateFolder) | CreateFolderConnections (Result ID の場合は + Assign)。ConflictResolution AddSeparateにハードコードされます。 |
ドキュメントを作成 (CreateDocument) | CreateDocumentConnections (Result ID の場合は + Assign)。 |
新しいスプレッドシートを作成 (CreateNewSpreadsheet) | CreateSpreadsheetConnections (+ 2 つの Assign アクティビティ: FileURL ← item.Url、 SpreadsheetId ← item.ID)。 |
ファイルを削除 (DeleteFile) | DeleteFileOrFolderConnections. PermanentlyDelete クラシックな動作に合わせて true にハードコードされています。 |
ファイルを共有 (CreateFilePermission) | ShareFileFolderConnections. |
ファイルのアクセス許可を削除 (DeleteFilePermission) | DeleteFileFolderPermissionConnections. |
ファイルのアクセス許可を更新 (UpdateFilePermission) | UpdateFileFolderPermissionConnections (+ Result 出力用の HTTP ブリッジ、以下を参照)。 |
ファイルのアクセス許可を取得 (GetFilePermissions) | GetFileFolderPermissionsConnections (+ Result 出力用の HTTP ブリッジ)。 |
ファイルをダウンロード (DownloadFile) | DownloadFileConnections. ConflictResolution 、常に上書きされる従来の動作を維持するために、 Replace にハードコードされています。 |
ファイルをアップロード (UploadFile) | UploadFilesConnections (Result ID の場合は + Assign)。FilesInputMode Singleにハードコードされています。 LocalFilePath で囲まれ LocalResource.FromPath(...)。 |
ファイルやフォルダーを探す (FindFiles) | GetFileListConnections (+ FirstResultIdの任意のAssign)(+ Result出力用の HTTP ブリッジForEach)。検索場所を [ "root" (マイ ドライブ)] にハードコードします。以下のアクション アイテムをご覧ください。 |
ファイルの情報を取得 (GetFileInfo) | GetFileFolderConnections (+ Result 出力用の HTTP ブリッジ)。 |
ドキュメント
| 移行前のアクティビティ | 移行後のアクティビティ |
|---|---|
すべてのテキストを読み込み (ReadAllText) | ReadTextConnections. ReadTextMode AllTextにハードコードされます。 |
テキストを挿入 (InsertText) | WriteTextConnections.マップ Position (START/END) → WriteTextMode (BeginningOfDocument/EndOfDocument)。AT_INDEX サポートされていません (対応が必要です)。 |
テキストを置換 (ReplaceText) | FindAndReplaceTextConnections. ReplaceBehavior AllReccurencesにハードコードされます。 |
ドキュメントを取得 (GetDocument) | GetDocumentConnections (+ Result 出力用の HTTP ブリッジ)。 |
シート
| 移行前のアクティビティ | 移行後のアクティビティ |
|---|---|
新しいシートを追加 (AddNewSheet) | AddSheetConnections. ConflictResolution Failにハードコードされます。 |
読み込み範囲 (ReadRange)/書き込み範囲 (WriteRange) | ReadRangeConnections<DataTable> / WriteRangeConnectionsです。SheetName + セル/範囲参照を 1 つの"Sheet!Range"文字列に連結します。WriteRange.WriteMode Overwriteにハードコードされます。 |
セルを読み込み (ReadCell)/セルに書き込み (WriteCell) | ReadCellConnections<object> / WriteCellConnectionsです。WriteCell.Value キャスト string → object。 |
列を読み込み (ReadColumn)/行を読み込み (ReadRow) | ReadColumnConnections / ReadRowConnections (ReadRowの場合は DataRow.ItemArray をブリッジする + Assign)。 |
行を追加 (AppendRow) | WriteRowConnections. WriteMode Appendにハードコードされます。 |
セルの色を取得 (GetCellColor) | GetCellColorConnections (+ Color 出力用の HTTP ブリッジ)。 |
シートを削除 (DeleteSheet) / (RenameSheet) | DeleteSheetConnections / RenameSheetConnectionsです。 |
範囲を削除 (DeleteRange) | DeleteRangeConnections.マップ Shift (UP/LEFT) → DeleteMode (Rows/Columns)。 |
範囲をクリア (ClearRange) | DeleteRangeConnections DeleteMode は にハードコードされていますNone。 |
範囲をオートフィル (AutoFillRange) | AutoFillRangeConnections. |
範囲をコピー/貼り付け (CopyPasteRange) | CopyPasteRangeConnections. |
列を追加、列を削除 (AddDeleteColumns) | DeleteColumnConnections (削除) または ForEach<int> + WriteColumnConnections (挿入) します。 |
行を追加 (AddDeleteRows) | DeleteRowsConnections (削除) または ForEach<int> + WriteRowConnections (挿入) します。 |
Apps Script
| 移行前のアクティビティ | 移行後のアクティビティ |
|---|---|
スクリプトを実行 (RunScript) | RunScriptConnections (+ Assign をResult出力のIDictionary<string, object> → Dictionary<string, object>に変換します)。SelectMany().ToArray()を介してRequiredScopesをフラット化します (IEnumerable<IEnumerable<string>>) → string[]。 |
ヘルパー アクティビティ
一部のクラシック アクティビティでは、生の Google API 型 (Google.Apis.Drive.v3.Data.File、 Permission、 Calendar.v3.Data.Event、 Sheets.v4.Data.Color、 Docs.v1.Data.Document) として型指定された出力が公開されます。同等のモダン ラッパー型は、UiPath ラッパー型 (GDriveRemoteItem、 GDriveItemPermission、 GSuiteEventItem、 System.Drawing.Color、 など) を返します。これらの種類は割り当てに対応していないため、下流で生の出力を使用するワークフローが移行後に中断していました。
HTTP ブリッジはこのギャップを埋めます。移行ツールが、バインドされたクラシック出力を検出し、ソースから関連する識別子をリテラル式として解決できると、 HttpRequestConnections + Assign のペアを追加します。
- 割り当て (
System.Activities.Statements.Assign) - Google Workspace の HTTP 要求 (
UiPath.GSuite.Activities.HttpRequestConnections)
ブリッジは、 SearchEvents、 UpdateFilePermission、 GetFilePermissions、 FindFiles、 GetFileInfo、 GetDocument、 GetCellColorで使用されます。