定义接口服务

若要定义接口服务，请进行下列操作：

注意：若要基于现有接口服务定义接口服务，或者编辑接口服务，请参阅“编辑接口服务”。
  1. 选择“配置”>“常用”>“接口服务”。
  2. 单击“新建”。
  3. 在“新建接口服务”窗口中，指定以下信息：
    接口类型
    选择接口类型。选项如下：
    • 高级计划
    • CSV
    • 数据库
    • EXCEL
    数据实体
    选择必须映射到接口的数据实体。数据实体的类型：
    • 日历
    • 代码列表
    • 方案视图
      注意：如果选择此选项，则必须指定“导入行为”。
    • 业务数据
    接口方向
    根据之前的选择，请根据需要指定“导出”、“导入”或“导入或导出”。
    每个度量的列
    如果选中了此复选框，则每个度量显示在接口上的新列中。可以在“映射”选项卡中添加包含这些维度的新行和度量。
    • 项目
    • 库位
    • 日历周期

    如果清除了此复选框，则“映射”选项卡中维度的列表固定为包含以下维度的五个列：

    • 项目
    • 库位
    • 日历周期
    • 度量
    • 值
    注意：仅当所有接口类型的“数据实体”都设置为“方案值”时，才能看到此字段。
  4. 单击“确定”。列表会替换为“详情”表单，在该表单中，“接口类型”和“数据实体”字段是基于您的选择。
  5. 根据选择的数据实体，指定以下信息：
    模块
    接口服务链接到的模块。选择适当的模块。
    目标代码列表
    用作接口服务一部分的数据源的名称。
  6. 指定以下信息：
    名称
    指定内插接口服务的名称。
    显示名称
    指定在应用程序中显示的名称。这是可选字段。
    系统
    此为只读字段。
    数据源
    用作接口服务一部分的数据源的名称。
  7. 根据选择的接口类型，指定必需信息：
    如果选择 CSV：
    选项 说明
    文件 用作接口服务一部分的 CSV 文件的名称。
    标题行中的字段名

    选中此复选框可指明以下两种情况之一：

    • 导入文件的第一行包含字段标签并且可以跳过。
    • 导出文件的第一行必须包含字段标题。
    日历期段定义 指明是使用时段开始日期、时段结束日期还是以日历格式定义的时段名称（例如 FY10 M03）导出日历期段。
    如果选择数据库，并且对“来源”使用了默认的“表”选择，请指定以下信息：
    选项 说明
    表 用作接口服务一部分的表的名称。
    导入筛选

    指定对通过接口服务传递的数据的筛选，否则选定源表的所有记录都适用。文本必须是标准 SQL WHERE 子句的格式，尽管 WHERE 关键字是隐式的。

    若要使用维度筛选数据，也可以使用下列变量：

    • %cycle%：循环名
    • %cycleperiod%：循环周期标签
    • %cycleperiod-Startdate%：当前循环周期时间段（按 Cycle.Periodicity）的开始日期，采用规定的日期格式。这不是循环周期的开始日期。
    • %cycleperiod-Enddate%：当前循环周期时间段（按 Cycle.Periodicity）的结束日期（采用规定的日期格式）。这不是循环周期的完成日期或循环周期范围的结束日期。
    • %horizon-start%：循环周期范围的开始日期（采用规定的日期格式）；也就是当前循环周期中的第一个（最早的）基本周期。
    • %horizon-end%：循环周期范围的结束日期（采用规定的日期格式）；也就是当前循环周期中的最后一个（最新的）基本周期。
    • %scenario%：方案名称

    示例：

    CHAN_ID <> 'TOTAL' AND End_date > %CyclePeriod-StartDate% or PROD_GROUP = %scenario% AND PERIOD >= %horizon-start% AND PERIOD <= %horizon-end%
    如果选择“数据库”>“源”>“查询”：
    选项 说明
    查询 指定 SQL 语句，然后单击“验证”以验证查询文本。
    注意： 如果成功验证了查询，则会存储返回的字段，以便在“映射”和“导入/导出度量”选项卡中使用，从中可以选择要映射的字段。

    否则，必须在此接口的数据源中手动添加字段。

  8. 对于任何接口类型，请指定以下信息：
    日历期段定义
    指明是使用时段开始日期、时段结束日期还是以日历格式定义的时段名称（例如 FY10 M03）导出日历期段。
  9. 选中“清除未更改的方案值”复选框可重置在基于度量过滤器导入数据之后未修改的方案值。
    注意： 如果未指定度量筛选器，则将重置筛选器中度量的所有未更改值。如果未指定，则将重置在导入期间更新的度量的所有未更改值。
  10. “映射”标签包含将映射的维度列表和模块设置（如果适用）。在此标签上，根据需要更改相关的字段标签。
  11. “导入/导出度量”选项卡包含将作为传输的源或目标的度量列表（行），以及接口服务中对应的标识符。在此选项卡上，使用“新建”可输入将作为接口服务筛选的度量，从而仅导入或导出此处定义的度量。
  12. 对于接口类型“数据库”，附加“导出常量”选项卡列出了将导出的适用常量数据。在此标签上，根据需要更改相关的字段标签和值。此选项卡上指定的导出常量可用于通过“导入筛选”变量来导出含单个接口定义的多个方案。例如，如果导出常量使用 %scenario% 变量，那么此变量可以使用单个接口定义来导出多个方案。

    若要使用维度筛选数据，也可以使用下列变量：

    • %cycle%：循环名
    • %cycleperiod%：循环周期标签
    • %cycleperiod-Startdate%：当前循环周期时间段（按 Cycle.Periodicity）的开始日期，采用规定的日期格式。这不是循环周期的开始日期。
    • %cycleperiod-Enddate%：当前循环周期时间段（按 Cycle.Periodicity）的结束日期（采用规定的日期格式）。这不是循环周期的完成日期或循环周期范围的结束日期。
    • %horizon-start%：循环周期范围的开始日期（采用规定的日期格式）；也就是当前循环周期中的第一个（最早的）基本周期。
    • %horizon-end%：循环周期范围的结束日期（采用规定的日期格式）；也就是当前循环周期中的最后一个（最新的）基本周期。
    • %scenario%：方案名
  13. 单击“提交”。
相关主题