使用 NetSuite® Token Authentication 连接器,您可以 使用链式命令 与 NetSuite 进行交互。例如,使用此连接器,您可以:
- 从 NetSuite 下载文件
- NetSuite 中已保存的搜索列表
- 检索有关标准 NetSuite 记录或已保存搜索的数据
注: 此连接器由 Workiva 构建,并连接到第三方系统。虽然我们的支持团队可以帮助您在工作区内配置此连接器,但我们无法对源自 Workiva 平台之外的任何问题进行故障排除或提供其他帮助。
先决条件
为了实现连接,连接器使用 NetSuite REST API。要设置连接器,您需要:
- NetSuite,已启用基于 令牌的身份验证( 待定)
- 要连接的 NetSuite 帐户 ID
注意: 要在 NetSuite 中查看您的帐户 ID,请选择 设置、 集成、 Web 服务首选项。该 ID 通常也出现在 URL 的第一行,就在
之前。app.netsuite.com - 在 NetSuite 中为连接器创建了一个 集成记录 和 访问令牌 。
- 集成记录的消费者密钥和密钥
注意: 如果您没有消费者密钥或密钥,请编辑集成记录并重置其凭据。
- 访问令牌的 ID 和密钥。如果您没有访问令牌的 ID 或密码,则需要创建一个新令牌。
注意:要使用 OAuth 2.0
身份验证与 NetSuite RESTlet 交互,请改用 HTTP请求连接器 。启用 NetSuite 集成
要使连接器能够与 NetSuite 交互,它需要 基于令牌的身份验证 (TBA) 和它自己的集成记录。
步骤 1. 启用 SOAP Web 服务和基于令牌的身份验证
为 NetSuite 启用 SOAP Web 服务和 TBA:
- 在 NetSuite 中,选择 设置、 公司、 启用功能。
- 在 SuiteCloud 选项卡上的 SuiteScript下,选择 Client SuiteScript 和 Server SuiteScript。
- 在 SuiteTalk(Web 服务)下,选择 SOAP Web 服务。
- 在 管理身份验证下,选择 基于令牌的身份验证。
- 点击 保存。
步骤 2. 创建集成记录
启用 TBA 后,为连接器创建 集成记录 :
- 在 NetSuite 中,选择 设置、 集成、 管理集成、 新建。
- 为了帮助识别集成,请输入唯一的名称和描述,例如 Workiva 集成。
- 在 身份验证下,选择 基于令牌的身份验证,并清除TBA:授权流程。
- 点击 保存,并记录确认页面上的消费者密钥和密钥。
注: 消费者密钥和密钥 仅显示在集成记录的确认页面上。务必记录连接器属性中的这些值,并像对待密码一样对待它们。
步骤 3:创建集成角色
出于安全考虑,请在 NetSuite 中创建一个专用角色来管理您的集成:
- 选择 设置、 用户/角色、 管理角色、 新建。
- 在 常规下,输入一个唯一的名称以帮助识别角色,例如 Workiva/NetSuite 集成。
- 在 身份验证下,选择 仅限 Web 服务角色 以允许该角色仅连接到 NetSuite API,而不 直接登录到 NetSuite。
- 在 权限下, 添加权限 以启用集成,例如对 NetSuite 中所有相关的 交易、 报告和 列表 拥有完全权限。
- 在 “设置 ”选项卡下的 “权限”中,添加以下权限:
- SOAP Web 服务
- 成立公司
- 基于令牌的身份验证:
- 要使该角色仅通过访问令牌进行身份验证,请执行以下操作: 使用访问令牌登录
- 为了使该角色能够创建和撤销自己的访问令牌, 用户访问令牌
- 点击 保存。
步骤 4. 将角色分配给集成用户
创建集成角色后,将其分配给连接器的集成用户:
- 在 NetSuite 中,选择 设置、 用户/角色、 管理用户。
- 选择或创建连接器的集成用户。
注: 我们建议每个连接器或集成都使用单独的用户。
- 在 角色下,将集成角色分配给用户。
步骤 5. 创建集成用户的访问令牌
要为集成用户创建 访问 令牌:
- 在 NetSuite 中,选择 设置、 用户/角色、 访问令牌、 新建。
- 点击 新建访问令牌。
- 在 应用程序名称中,选择集成记录。
- 在 用户中,选择集成用户。
- 在 角色中,选择集成角色。
- 点击 保存。
- 记下为令牌创建的 ID 和密钥;连接器的属性需要用到它们。
注: 出于安全考虑,ID 和密钥仅在创建访问令牌时显示。像对待密码一样对待它们。如果您没有连接器属性的令牌 ID 或密钥,请为集成用户创建一个新令牌。
设置 NetSuite 令牌身份验证连接器
注: 要使连接器可在您组织的链中使用, 组织安全管理员首先需要在配置中启用它。
- 从 链构建器中,单击 连接,然后单击右上角的 创建 。
- 在 连接器连接下,选择 NetSuite Token 身份验证和默认的 CloudRunner。
- 输入唯一的名称和描述,以帮助识别连接。
- 在 属性下,输入连接的详细信息:
摘要信息 详细信息 账户 ID 请输入要连接的NetSuite帐户ID。 消费者密钥 输入连接器集成记录的消费者密钥。 消费者秘密 输入 Consumer Key 属性的密钥。 权杖 ID 输入连接器访问令牌的 ID。 令牌密钥 输入 Token ID 属性的密钥。 沙盒 要连接到沙盒 NetSuite 帐户,请选中此框。 注意:所有敏感凭证均会自动加密,并以高级加密标准 (AES ) -256 加密方式存储
。 - 选择要使用连接的环境,然后单击 保存。
- 要测试连接, 创建并运行一个链 使用 连接器的 列出已保存的搜索命令,并验证它是否返回有效输出。
疑难解答
自订栏位
请注意,NetSuite API 无法返回自定义字段。作为替代方案, Data Prep 可以创建模拟 Netsuite 自定义字段逻辑的转换。
连线
如果与 NetSuite 的连接失败:
- 检查连接器中输入的帐户 ID。要查看 NetSuite 中的帐户 ID,请选择 设置、 集成、 Web 服务首选项。ID 通常也出现在 URL 中的
app.netsuite.com之前。 - 验证连接器集成记录的消费者密钥和密钥。如有必要,编辑集成记录并重置其凭据,以创建新的消费者密钥和密钥。
- 验证连接器访问令牌的 ID 和密钥。如有必要,请为连接器创建一个新令牌。