studio
latest
false
Studio 用户指南
- 入门指南
- 设置和配置
- 自动化项目
- 依赖项
- 工作流类型
- 控制流程
- 文件比较
- 自动化最佳实践
- 源代码控件集成
- 调试
- 日志记录
- 诊断工具
- 工作流分析器
- 变量
- 参数
- 导入的命名空间
- 编码自动化
- 基于触发器的 Attended 自动化
- 对象存储库
- ScreenScrapeJavaSupport 工具
- 扩展程序
- Studio 测试
- 故障排除
重要 :
新发布内容的本地化可能需要 1-2 周的时间才能完成。
GSuite 支持的活动
迁移 Studio 自动化项目时,活动迁移器工具支持的 GSuite 活动。
请参阅下表,了解使用活动迁移器工具时支持的 GSuite 活动。每行都列出了“源”传统活动、“目标”新式活动以及迁移器执行的最显着的转换。
作用域
| 源活动 | 目标活动 | 注意 |
|---|---|---|
Google Workspace 作用域 (GSuiteApplicationScope) | GSuiteApplicationScope | 保持原样;内部活动已迁移就位。 |
使用 Google 云端硬盘 (GoogleDriveApplicationScope) | Sequence (当为UseConnectionService=true时)或GSuiteApplicationScope (OAuth) | 仅身份验证作用域;通过作用域上下文将 ConnectionId 注入子活动中。如果同时绑定 OAuthClient = Custom 和 CredentialSecret,则 OAuth 路径设置 CredentialID,否则设置为 UiPath。 |
使用 Google 文档 (GoogleDocsApplicationScope) | Sequence / GSuiteApplicationScope(+ 在 CreateDocumentConnections / CreateNew 前面添加可选的 CreateIfNotExists) | 文档生命周期作用域。Action 枚举决定是否在前面添加创建活动;新文档的 ID 通过预分配的 newDocument 变量连接到子活动。 |
使用 Google 电子表格 (GoogleSheetsApplicationScope) | Sequence / GSuiteApplicationScope(+ 在 CreateSpreadsheetConnections / CreateNew 前面添加可选的 CreateIfNotExists) | 形状与 Docs 范围相同;预分配 newSpreadsheet。 |
Gmail
| 源活动 | 目标活动 |
|---|---|
发送电子邮件 (SendEmail) | SendEmailConnections |
获取邮件消息 (GetMailMessages) | GetEmailListConnections (默认)或GetEmailByIdConnections (+ 可选的MarkAsReadUnreadConnections )(如果设置了EmailId )。列表路径会附加 Assign,以将 List<GmailMessage> 转换回传统 GmailMessage[]。 |
更改标签 (ChangeLabels) | RemoveEmailLabelsConnections + ApplyEmailLabelsConnections。要删除的标签计算为 email.LabelIds.Except(["SEND","DRAFT"]);要应用的标签会合并构建器和变量输入,删除重复数据,并排除保留的标签。 |
日历
| 源活动 | 目标活动 |
|---|---|
添加参加者 (AddAttendee) | GetEventByIdConnections + ModifyEventConnections(设置 ChangeRequiredAttendees=AddRemove,将单个电子邮件转换为数组)。 |
创建事件 (CreateEvent) | CreateEventConnections (+ Assign 表示 EventId、EventUrl 输出)。 |
删除活动 (DeleteEvent) | GetEventByIdConnections + DeleteEventConnections。映射 InstancesOption → DeleteType 枚举 (THIS_EVENT/THIS_AND_FOLLOWING_EVENTS/ALL → SingleEvent/FutureOnly/PastAndFuture)。 |
修改事件 (ModifyEvent) | GetEventByIdConnections + ModifyEventConnections(+ Assign对于 EventId 输出)。集 ChangeRequiredAttendees=Overwrite。 |
搜索事件 (SearchEvents) | GetEventByIdConnections (当设置了EventId时)或GetEventListConnections 。绑定传统Result (原始Event[] )时,HTTP 网桥将重新获取原始Event JSON;请参见下方的HTTP 网桥。 |
云端硬盘
| 源活动 | 目标活动 |
|---|---|
复制文件 (CopyDriveFile) | CopyFileConnections (当 GetFileFolderConnections 为 null 时,+ 当 NewParentId 为 null 时,解析文件的当前父项)(+ Assign 对于 Result ID)。 |
移动文件 (MoveDriveFile) | MoveFileConnections (当 GetFileFolderConnections 为 null 时,则+ 在前面加上 NewParentId)。 |
创建文件夹 (CreateFolder) | CreateFolderConnections (+ Assign ID 为 Result)。已将 ConflictResolution 硬编码为 AddSeparate。 |
创建文档 (CreateDocument) | CreateDocumentConnections (+ Assign ID 为 Result)。 |
新建电子表格 (CreateNewSpreadsheet) | CreateSpreadsheetConnections (+ 两个 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 (+ Assign ID 为 Result)。已将 FilesInputMode 硬编码为 Single;使用 LocalFilePath 将 LocalResource.FromPath(...) 括起。 |
查找文件和文件夹 (FindFiles) | GetFileListConnections (+ 用于 Assign 的可选 FirstResultId)(+ 用于 ForEach 输出的 HTTP 网桥 Result)。将搜索位置硬编码到 "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 + 单元格/范围引用连接到一个 "Sheet!Range" 字符串中。已将 WriteRange.WriteMode 硬编码为 Overwrite。 |
读取单元格 (ReadCell)/写入单元格 (WriteCell) | ReadCellConnections<object> /WriteCellConnections。WriteCell.Value 转换为 string → object。 |
读取列 (ReadColumn)/读取行 (ReadRow) | ReadColumnConnections /ReadRowConnections(+ Assign 为 DataRow.ItemArray 桥接 ReadRow)。 |
附加行 (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 (插入)。 |
AppsScript
| 源活动 | 目标活动 |
|---|---|
运行脚本 (RunScript) | RunScriptConnections (+Assign 以转换IDictionary<string, object> →Dictionary<string, object> Result输出)。通过 RequiredScopes 展平 IEnumerable<IEnumerable<string>> (string[]) → SelectMany().ToArray()。 |
帮助程序活动
几个传统活动将输出公开为原始 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 使用。