跳至主要内容
文档
文档
Adaptive Planning
上次更新时间 ：2024-08-23
步骤：设置 NetSuite 数据源

步骤：设置 NetSuite 数据源

您可以使用集成从 NetSuite 实例中提取信息。
Adaptive Planning
 用户可以通过 NetSuite 适配器访问 NetSuite 实例中的数据。
如要设置 NetSuite 数据源，请执行以下步骤：
  1. 转至“集成”>“设计集成”
    。
  2. 在“组件库”
    中展开“数据源”
    文件夹。
    NetSuite 数据源需要单独获得许可。如果数据源列表中未显示此适配器，请前往 Workday Customer Center 提交个案来获取支持。
  3. 单击 NetSuite 数据源
    。
    页面的中心区域会显示新数据源的设置及其他信息。
  4. 输入数据源的信息：
    • 启用基于令牌的身份验证 (TBA)：
      更新到最新 NetSuite 版本后，默认选中此选项。您需要选择一个 NetSuite 凭据，此凭据需包含 NetSuite 管理员在 NetSuite 用户界面中生成的使用者密钥、使用者密码、令牌编号
      和令牌密码
      。
    • 凭据
      ：选择 NetSuite 凭据，此凭据包含 NetSuite 管理员在 NetSuite 用户界面中生成的使用者密钥、使用者密码、令牌编号
      和令牌密码
      。有关如何设置 NetSuite 凭据的信息，请转至 此处。
    • 账户时区
      ：从下拉列表中为账户选择适当的时区。在此处选择的时区必须与该用户账户的 NetSuite 用户界面中使用的时区相同。在 NetSuite 中，转至“Home”>“Set Preferences”>“Localization”
      。
    • 回填批次持续时间
      ：选择回填批次的持续时间。默认值为 1 周（168 小时）。此值指在以差异化方式导入的 NetSuite 表格上单次更新过程中，提取数据的小时数。此值使您可以为时间表排定程序设置分块，以在大批次作业和小批次作业之间保持平衡。如果您存在大量 NetSuite 数据，请降低此值。此值越小，给定日历期间所需的向后填充循环就越多。
      您输入的特定值在很大程度上取决于许多特定于地点的变量，例如作业大小、小规模作业与大规模作业的比率、周转时间和系统资源。
    • 日志级别：
      从下拉列表中选择日志级别，以指定此数据源的日志记录详细级别。可用选项包括：
      • 错误
        ：仅记录严重错误。
      • 信息
        ：记录所有基本信息，例如数据源的更新时间。
      • 详细
        ：提供有关所有阶段和操作的详细信息。此级别主要用于调试或审核，因为其产生的日志信息量可能超出一般用途的实际所需。
  5. 在“操作”菜单中，单击“保存”
    。
您可以通过单击“操作”菜单中的“测试连接”
，来测试新代理中的连接信息。系统会尝试使用数据源字段中的信息连接到 NetSuite。如果系统可以连接到 NetSuite，请单击“确定”
。如果存在连接问题，请前往 Workday Customer Center 提交个案来获取支持。
当您可以连接到 NetSuite 时，即可导入数据结构。此时系统会显示 NetSuite 中的表格和列。

从 NetSuite 数据源导入结构

  1. 在“操作”
    菜单中，单击“导入结构”
    。表格和列将显示在“数据组件”
    菜单中。
系统将按如下所示同步 NetSuite 用户账户的数据：
  • 集成模块会选择最佳同步方法。
  • 集成模块最初会尝试以增量方式获取数据。
  • 如果基础数据源不支持以增量方式获取数据，集成将对暂存区中的数据执行完全刷新。
NetSuite 的导入结构和 Adaptive 过账交易汇总表格
集成模块为 NetSuite 提供了一个起始表格，名为“AdaptivePostingTransactionSummary”
。
在使用“导入结构”
期间，系统会默认显示“AdaptivePostingTransactionSummary”
表格及与其关联的表格。该表格显示了最常从 NetSuite 源系统请求的数据元素。该表格会自动在“PostingTransactionSummary”
表格及与其关联的表格之间创建联接。因此，该操作会针对以下最常请求的 NetSuite 表格种类，显示它们在商业上常用的名称：
  • 账户
  • 分类
  • 条目
  • 部门
  • 位置
  • 子公司
  • 客户
每个表格都包含“名称”列。系统会自动从“账户”
选项卡中启用“账户类型”
列。运行“导入结构”
时，系统会自动导入种类表格。
如“创建 SQL 筛选器”中所述，您可能需要在 Planning 加载器中使用 SQL 筛选器来筛选掉不需要的账户类型。
您还可以选择移除联接表中可用的一个或多个默认维度。由于表中只需包含模型所需的种类，因此您应移除联接中的所有其他种类，并且应从“PostingTransactionsSummary”的导入中排除基础列。

向 NetSuite 数据源添加表格

导入数据结构后，即可指定要导入的信息。此时一组标准的 NetSuite 表格便已启用。如果想要导入其他表格，请使用页面上的“要导入的表格”版块来配置导入的 NetSuite 数据。
如要指定从用户账户导入的表格，请执行以下步骤：
  1. 在“数据组件”
    菜单中展开数据源对应的条目。
    每个表格都显示为一个单独条目。
  2. 将要导入的表格拖放到页面中央的“要导入的表格”版块中。
    当您将每个表格拖动到“要导入的表格”版块时，系统将为相应的表格显示一个选项卡并且信息会显示在“要导入的表”版块中，使您能够查看已添加信息的类型。每个表格的选项卡还具有一个下拉菜单，您可以通过单击名称旁边的箭头来访问该下拉菜单。

管理列

如果您正在使用的表格包含大量列，可以使用“管理列”来快速编辑要导入的列。“管理列”对话框会显示表格中的列，以便您选中要导入的列或取消选中不想导入的列。
如要管理要导入的列，请执行以下步骤：
  1. 单击表格名称右侧选项卡上的箭头。
  2. 单击浮动菜单中的“管理列”。
  3. 在要导入的列旁边，选择相应的复选框。
    选中某列并保存弹出窗口内容后，该列还会显示在预览窗口中。取消选中某列后，系统会将该列从预览窗口中移除。
    您无法为系统生成的字段（例如 isDeleted）更改导入状态。
    您可以通过以下方式更改各个列的导入状态：
    • 选择列属性并设置属性。
    • 将列拖放到设计器中。

自定义表格

对于每个表格，您可以自定义数据的导入方式。
如要自定义表格设置，请执行以下步骤：
  1. 单击表格名称右侧选项卡上的箭头。
  2. 单击浮动菜单中的“表格设置”
    。
  3. 输入表格设置：
    • 数据导入模式
      ：下拉列表中只有下列一个选项：
      • 数据源自动选择最佳同步方法
        ：这是默认模式。数据源会检查 NetSuite，并自动使用最佳方法将暂存区中的数据与 NetSuite 中的信息同步。系统每次都会完整读取部分表格，而对其他表格则使用差异化更新。
    • 数据导入筛选器
      ：您可使用此字段来输入 SQL 表达式，用于对要导入的信息进行筛选或格式设置。从 NetSuite 中提取数据之前，系统会应用 SQL 筛选器，以减少需要导入的数据量，从而让您更好地控制将哪些数据导入暂存区中。单击此字段可显示“编辑 SQL 表达式”对话框（在此处输入的筛选器将应用于 NetSuite 中的实际数据，而不是暂存区中的预览数据）。并非所有数据源都支持相同级别的 SQL 筛选功能。
    • 期间参数：
      NetSuite 表格
      PostingTransactionBalance
       和
      PostingTransactionSummary
       默认情况下会导入，并要求在导入前配置期间参数。如果您选择导入
      ConsolidatedExchangeRate
      或
      BudgetExchangeRate
       表，它们也需要配置期间参数。如果没有为这两个表格配置期间参数，导入将失败并显示以下消息：
      Required parameter is not configured
      NetSuite 的非 SQL 筛选功能非常有限，仅支持非常简单的表达式。
  4. 单击“应用”
    以应用设置。
  5. 对每个表格重复步骤 1 到步骤 3。
  6. 单击“保存”
    以保存数据源中的设置。

设置列选项

使用“要导入的表格”版块时，您可以预览数据在数据源中的呈现方式，或导入后在暂存区中的呈现方式。要更改每列的选项，你可以将鼠标指针悬停在列标题上，然后单击列名称旁边的下拉菜单。这些选项包括：
  • 升序排序
    ：根据此列按升序对整个表格进行排序。
  • 降序排序
    ：根据此列按降序对整个表格进行排序。
  • 列设置
    ：此对话框用于更改暂存表中列的属性。
    • 名称
      ：列名称，显示在标题中。
    • 列类型
      ：在列中使用的数据类型。
    • 转换列类型
      ：从此下拉菜单中选择新类型。
  • 从导入中排除列
    ：选择此选项可从要导入的数据中移除该列。
  • 删除自定义列
    ：选择此选项可删除列。此选项仅适用于自定义列。

创建子查询列

您可以通过子查询列，根据另一个相关表格的条件筛选 NetSuite 行。例如，您可以根据一个或多个报价单记录是否存在来筛选 NetSuite 机会记录。
您可以使用子查询列执行以下操作：
  • 选择主表格/列和相关表格/列。
  • 检查相关表格是否满足特定条件。
  • 根据这些检查的结果，在驱动表中插入适当的值。
您可以针对每个表格，自定义数据的导入方式。
如要创建子查询列，请执行以下操作：
  1. 在“数据组件”菜单中，展开数据源中的“自定义列”文件夹。
  2. 将“子查询列”组件拖放到页面中央的“要导入的表格”版块中。
  3. 输入列设置：
    • 名称：输入子查询列的名称。
    • 列类型：属于仅显示字段，会将其标识为布尔值列。
    • 相关表：选择要用于比较的相关表。
    • 联接表达式：单击此字段可输入联接条件。此时系统将显示“编辑 SQL 联接表达式”对话框。（有关创建 SQL 联接的更多信息，请参见 步骤：添加 SQL 联接表和列。）
    • 联接值规则：从下拉列表中选择以下 SQL 联接值选项之一：存在、不存在、总和、计数、最小值、最大值。
  4. 单击“应用”
    以应用设置。
  5. 单击“保存”
    以保存数据源中的设置。

从暂存表中下载数据

您可以从单个暂存表中下载数据。
如要从单个暂存表中下载数据，请执行以下步骤：
  1. 在“要导入的表格”版块中，单击表格标题中的向下箭头。
  2. 选择“下载数据”
    。
  3. 出现“此操作将发送一封包含数据下载 URL 的电子邮件”
    提示时，单击“发送”
    。
    Adaptive Integration 将向与数据设计者关联的电子邮件账户发送一封包含 URL 的电子邮件。
  4. 打开电子邮件，然后单击该 URL。系统将以 .csv 文件格式下载数据。

使用高级筛选器

在“源”下拉菜单下方，您可以单击“高级筛选器”，以显示用于在“要导入的表格”预览区域中筛选数据的选项。“高级筛选器”中提供了一些工具，便于您查看和浏览暂存表内的一部分数据，或直接从远程源中查看和浏览这些数据（当您在“源”下拉菜单中选择了“NetSuite”时适用）。
预览区域专用于预览暂存区（或 NetSuite）中的一小部分数据。您可以浏览电子表格账户中的可用数据，并通过检查暂存区来验证获得的数据是否符合预期。您还可以使用此功能来优化要使用的数据导入筛选器。在预览功能中设置的筛选器不会影响暂存区中的实际数据。
高级筛选器的选项包括：
  • 隐藏重复行
    ：选中此复选框可隐藏重复行。
  • 最大行数
    ：在文本框中输入一个数字来限制预览区域中显示的行数。
  • 列
    ：选中此下拉菜单中的列可显示相应的列，取消选中此下拉菜单中的列可相应隐藏所显示的列。
从此列表中移除某列不会将该列从导入列表中移除。
  • SQL 筛选器
    ：单击大文本框可显示“编辑 SQL 表达式”对话框，您可以在其中对 SQL 筛选器输入相关内容来限制将要预览的行数。单击“应用”可自动检查筛选器的 SQL 语法。如果存在任何错误，系统会在表达式中指示相应的错误。所输入的表达式将显示在“数据导入筛选器”字段中。有关详细的 SQL 语法帮助，您可以在“注释”版块中单击此处 。NetSuite 的非 SQL 筛选功能非常有限，仅支持非常简单的表达式。
单击“移除筛选器”
（“源”下拉菜单旁）可清除预览窗口中的设置。
NetSuite 会将部分列指定为键列。此信息将引入到暂存表中。您不应修改此信息。

从 NetSuite 导入数据

设置并保存 NetSuite 数据源后，您便可以开始导入数据。
如要从 NetSuite 导入数据，请执行以下操作：
  1. 在“操作”菜单中选择“导入数据”
    。所选数据将由任何 SQL 表达式进行筛选，然后加载到暂存区中。您可以预览暂存区中的数据。
系统会将信息一直保留在暂存区中，直到您将这些信息清除为止。
如要从暂存区中清除数据，请执行以下操作：
  1. 单击“操作”菜单中的“清除暂存表”
    。系统会对数据源中所有表格的暂存区进行清除。
最佳做法：
 导入 NetSuite 交易类型时，请确保仅使用受支持的 NetSuite 交易类型。

导入 NetSuite 保存的搜索

仅当您在 2024 年 8 月 12 日之前设置 NetSuite 集成时，才能从 NetSuite 保存的搜索导入数据。
您只能从 NetSuite 适配器导入保存的搜索。您还必须为此数据源配置单点登录 (SSO) 身份验证。
如要导入保存的搜索，您需要在数据设计器中配置 NetSuite 保存的搜索，然后导入其结构。集成模块下，保存的搜索支持 NetSuite 自定义记录、自定义字段和自定义段。
在数据设计器中配置保存的搜索
  1. 在“操作”菜单中，单击“管理保存的搜索”
    。
  2. 在“管理保存的搜索”
    对话框中，单击导航树下方的操作按钮并选择“添加保存的搜索”，或者右键单击保存的搜索文件夹并选择“添加保存的搜索”。为保存的搜索命名。
  3. 在“NetSuite 记录类型”中进行选择
    。
  4. 在“NetSuite 保存的搜索”中进行选择
    。
  5. 单击“应用”
    。
导入保存的搜索结构
  1. 在“管理保存的搜索”对话框中，单击先前创建的保存的搜索以将其选定。
  2. 单击导航树下方的操作按钮并在“操作”菜单中选择“导入结构”
    ，或者右键单击保存的搜索并选择“导入结构”
    。
  3. 成功导入保存的搜索结构后，关闭“管理保存的搜索”对话框。
  4. 暂存区将针对导入的每个保存的搜索结构显示一个选项卡。
请注意，如果您单击“操作”窗格中的“导入结构”，则会导入“数据组件”面板中的所有保存的搜索。
最佳做法：
由于 NetSuite Web 服务 API 的限制，请确保保存的搜索结构的导入结果不包含 NetSuite 汇总结果列。
最多可导入 1000 个 NetSuite 保存的搜索。
为 NetSuite 保存的搜索选择数据导入模式
  1. 在暂存区中，在 NetSuite 保存的搜索表格的选项卡中单击箭头图标。
  2. 在下拉列表中选择“表格设置”
    。
    此下拉列表存在两个可用选项：
    • 每次运行数据导入时替换的所有记录
      ：这是默认模式。此选项将在系统运行导入时替换所有数据。
    • 期间范围内所有已传输的记录
      ：通过此选项，您可使用参数来选择期间范围，然后选择适用于该参数的保存的搜索表格的日期时间列。您可以单击此对话框中的“编辑参数”
      ，以创建要使用的期间范围参数。如果您选择导入期间范围，则必须设置期间参数，否则导入将失败。
  3. 单击“应用”
    。
  4. 在“操作”面板中，单击“保存”
    。
从保存的搜索导入数据
  1. 在“操作”面板中，单击“导入数据”
    。
  2. 系统会从 NetSuite 保存的搜索将数据导入暂存区中。
删除 NetSuite 保存的搜索
  1. 在“操作”窗格中，单击“管理保存的搜索”
    。
  2. 在“管理保存的搜索”中右键单击某个保存的搜索，然后选择“删除”
    。系统会将该保存的搜索从“管理保存的搜索”对话框列表中移除，但其结构将保留在“数据组件”窗格和暂存区中，直至再次运行“导入结构”为止。
如果在 NetSuite 中删除了某个 NetSuite 保存的搜索，则在执行“导入结构”操作时，系统将显示一条消息，指明该保存的搜索不再可用。如果某条保存的搜索已在集成模块中用于数据导入但在 NetSuite 中又被修改，则在这之后的数据导入可能会失败。
最佳做法：
在 NetSuite 中，创建专用于集成的保存的搜索，并为其命名，以免其他 NetSuite 用户修改或删除它们。
最佳做法：
确保您在 NetSuite 中有权限查看保存的搜索结果返回的内容。如果您无权查看这些内容，则搜索将返回零记录，且不会显示错误消息。这是 NetSuite 的限制，在其在线帮助中指出：
If you reference a saved search for which you do not have the permission, the exception is ignored and fields have no value (are not in the SOAP response at all).

选择要导入的 NetSuite 文件柜文件

您可以管理并选择 NetSuite 文件柜中的 CSV 文件，以将它们作为暂存表导入。

关联式挖掘
Adaptive Planning
 返回到 NetSuite

仅当您在 2024 年 8 月 12 日之前设置 NetSuite 集成时，才能使用 NetSuite 关联式挖掘。
您可以对从 NetSuite 导入的数据启用关联式挖掘。对于从 NetSuite 导入的实际值，Planning 工作表和报告中的相关链接提供关联式挖掘功能。要为 NetSuite 配置关联式挖掘，您应确保在 Planning 加载器中将内部标识符用作列映射的一部分。您需要配置 NetSuite 外部系统，并将其附加到 Planning 加载器使用的配置文件中。
如果您在 NetSuite 端配置多个列以映射到单个 Planning 维度，则需要使用元组 SQL 列在数据源中合并这些 NetSuite 列。
有关更多详细信息，请参见 创建 Planning 数据加载器的“了解映射配置文件”版块。
允许从 Planning 关联到 NetSuite 进行挖掘的简要步骤
开始之前，请确保在 Planning 的“集成”>“NetSuite 设置”菜单中选中“基于捆绑包的增强关联式挖掘”
复选框。
配置 NetSuite 外部系统，用于定义维度映射。
对定义的维度映射进行所需的数据源调整。
  1. 如果您将多个 NetSuite 种类映射到同一个 Planning 维度，请重新访问 NetSuite 数据源，为列的多对一映射添加元组 SQL 列。
  2. 在“要导入的表格”中，单击“Adaptive 过账交易汇总”
    表格。
  3. 在“Adaptive 过账交易汇总”
    表格的下拉列表中，选择“管理列”
    。
  4. 启用
    AccountInternalId
    。
  5. 启用
    InternalIds
     计划作为挖掘依据的其他维度。
  6. 保存数据源。
使用维度映射对应的数据源调整，进行所需的加载器调整。
  1. 完成上述 NetSuite 数据源设置后，配置 Planning 数据加载器 以导入 NetSuite 实际值数据。
    • 将配置文件与已在“配置 NetSuite 外部系统”步骤中配置的外部系统相关联。
    • 将该配置文件附加到 Planning 加载器。
  2. 单击“列映射”
    选项卡。
  3. 对于账户行：
    • 在
      “源编号”
      列中，选择
      accountInternalId
       源表格中的列
    • 在“源显示名称”
      列中，选择显示名称。
  4. 对要用作挖掘依据的所有其他标准维度重复上述步骤。
  5. 保存加载器
完成上述所有步骤后，您现在应该可以进行挖掘。