Oracle NetSuite 应用程序作用域

UiPath.OracleNetSuite.Activities.OracleNetSuiteScopeActivity

每个 NetSuite 活动都使用您在活动的输入属性中输入的请求参数调用 SOAP 操作 。 为了成功调用 SOAP 操作，这些活动依赖于 NetSuite 作用域活动，以使用 基于令牌 （首选）或 用户凭据 的 身份验证 来连接到新的或现有的 NetSuite 集成记录。

NetSuite 作用域活动使用您的 Oracle 帐户 (帐户 ID) 和基于令牌的身份验证（ConsumerKey、 ConsumerSecret、 TokenId和 TokenSecret ）与集成记录建立经过身份验证的连接。

重要提示：

NetSuite 已弃用 RLC（请求级凭据身份验证，例如标准身份验证），并在 2021.1 版本中完全删除了对它的支持。 对于管理员角色的 2020.2 版本，SOAP API 调用以前不支持此功能。

因此，从 Oracle NetSuite 活动包 1.2 版开始，已删除标准身份验证选项。

建立连接后，该活动将返回一个 OracleNetSuiteConnection 对象 (OracleNetSuiteConnection)，您可以在后续使用“ NetSuite 应用程序作用域 ”活动时使用该对象进行身份验证。

注意： 使用此活动包时，请务必阅读并遵循 NetSuite 的 SuiteApp 架构基础知识和示例 (SAFE) 指南和 并发监管备忘单中记录的最佳实践。

工作方式

以下步骤和消息序列图是活动从设计时（即活动依赖项和输入/输出属性）到运行时如何工作的示例。

1. 完成 设置 步骤。
2. 为每个 SecureString 输入属性添加一个活动。

   • 添加两个 “获取凭据” 活动。

     *有关更多信息，请参阅设置指南中的 “ 创建凭据资产 ”部分。

3. 为“令牌身份验证”属性输入值。
4. 为“输出”属性创建并输入 IConnection 变量。

   • 您可以在后续使用 NetSuite 作用域 活动时使用此变量。

     
     

     

     
     

在活动正文中

要构建项目并在其他活动中启用“ 对象向导 ”，您必须通过单击“ 配置 ”按钮来使用“连接向导”。

要了解更多信息，请参阅 “关于”页面中的 “ 向导 ”部分。

属性

身份验证

注意： 标准凭据已被视为已弃用，并已在版本 1.2 及更高版本中删除。 现有项目将继续运行，但应更新为使用基于令牌的身份验证。

• “帐户 ID” - 分配给您的NetSuite 帐户的标识符。 此字段仅支持 Strings 或 String 变量。 您可以在 NetSuite URL 的开头找到您的 NetSuite 帐户 ID。
  • 例如，如果 URL 为 https://<span>1234567.app.netsuite.com</span>/，则您的帐户 ID 为 1234567。
• “身份验证类型 ” - 连接到集成记录时要使用的身份验证类型。 自活动包 1.2 版起，唯一受支持的选项是令牌。
• 使用者 密钥 - 分配给集成记录的自动生成密钥。 此字段仅支持 Strings 或 String 变量。 要查找“ 使用者 密钥”值，请参阅《 设置 指南》的“ 创建集成记录” 部分的“ 基于令牌的身份验证 ”项目符号。
• ConsumerSecret - SecureString ，用于授权 UiPath 与您的集成记录之间的通信。
  • 要查找 使用者密码 值，请参阅 设置 指南的 创建集成记录 部分的 基于令牌的身份验证 项目符号。
  • 要输入 SecureString 变量，请使用活动。
• 令牌 ID - 分配给用户的自动生成的标识符。 此字段仅支持 Strings 或 String 变量。 要查找 令牌 ID 值，请参阅设置指南中的 创建用户访问令牌 。
• TokenSecret - SecureString 用于授权 TokenID 访问集成记录。
  • 要查找 TokenSecret 值，请参阅设置指南中的 创建用户访问令牌 。
  • 要输入 SecureString 变量，请使用活动。

常见

• “显示名称”- 活动的显示名称。此字段仅支持 Strings 和 String 变量。

其他

• “私有”- 选中后将不再以“Verbose”级别记录变量和参数的值。

选项

• “ReportApiErrorAsException” - 选中后，使用此应用程序作用域的所有子活动都会在 BusinessActivityExecutionException 中报告 API 错误响应。 清除后，子活动将在“响应状态”输出属性中填充 API 错误消息，并继续执行工作流。 检查 ResponseStatus 属性以确认成功执行。

输出

• Oracle NetSuite 连接 - 已建立连接的记录，可在后续的 NetSuite 应用程序作用域 活动中使用。 输入 IConnection 变量 (UiPath.BAF.Models.Connection.IConnection)。

使用现有连接

• 现有 连接 - 来自父 NetSuite 应用程序作用域 活动的连接记录，您可以使用它来代替建立新连接。 输入 IConnection 变量。
  • IConnection 变量必须来自先前运行的 NetSuite 应用程序作用域 活动（父级），该活动仍具有活动连接。
  • 如果您无法使用此属性建立连接，请尝试重新运行父级 NetSuite 作用域 活动。