创建接口服务

通过接口服务，用户可以将数据导入或导出到 CSV 或 Excel 文件的 SCV 表。本主题描述了创建接口服务的过程，并使其“数据实体”为“SCV 表”和“接口类型”为“CSV”。

若要创建接口服务，请进行下列操作：

  1. 选择“配置”>“常用”>“接口服务”>“接口服务”。
  2. 单击“新建”。将显示“新建接口服务”窗口。
  3. 指定以下信息：
    接口类型
    接口的类型。选择 CSV。
    数据实体
    要映射到接口的数据实体。选择 SCV 表。
    注意：如果“数据实体”字段设置为“方案值”，则会显示“每个度量的列”复选框。
    接口方向
    数据流的方向。可能的值：
    • 导入
    • 导出
  4. 单击“确定”。系统则会显示一个新的接口服务页面。
  5. 在“接口详情”选项卡上指定以下信息：
    名称
    接口服务的唯一名称。
    显示名称
    为接口服务显示的名称。如果未指定，则将“名称”字段中指定的值作为默认值。
    系统
    指示接口服务的状态。可能的值：
    • 开启（已启用）
    • 关闭（已禁用）
    注意：对于系统定义的实体，启用此选项。
    接口类型
    接口的类型。值默认来自“新建接口服务”窗口。
    数据实体
    要映射到接口的数据实体。值默认来自“新建接口服务”窗口。
    接口方向
    数据流的方向。值默认来自“新建接口服务”窗口。
  6. 在“数据源”选项卡上指定以下信息：
    数据源
    SCP 中定义的数据源（文件、FTP 或 Amazon S3）名称。用宏执行接口服务时，使用在数据源中定义的定义。
    注意：如果要使用文件接口服务手动导入或导出数据，请在本地计算机上浏览要使用的文件。
    使用文件名模式
    定义文件名的模式或表达式。这支持导入多个文件并对文件进行排序或分组，以便导入最新版本。具有匹配模式的文件名将会导入。
    注意：仅当“接口类型”字段设置为“导入”时，才会显示此选项。
    文件
    要用于接口服务的文件名称。显示的文件基于定义的数据源。如果未显示文件，单击“加号 (+)” 以添加所需文件。
    注意：如果“使用文件名模式”选项设置为“开启”，则该字段标签显示为“文件名模式”，而正则表达式可用作文件名。可接受这些变量以下划线作为变量之间的分隔符：
    • 任何字母字符 (A-Z)
    • 任何字母数字字符 (A-Z,0-9)
    • 任何数字字符
    标题行中的字段名
    指示导入或导出文件中的第一行内容。如果设置为“开启”，则有以下可能情况：
    • 导入文件时，导入文件中的第一行包含字段标签并且可以跳过。
    • 导出文件时，导出文件中的第一行包含字段标题。
  7. 在 “SCV 表”选项卡上选择所需的 SCV 表名。“映射”选项卡中的数据根据所选的 SCV 表进行显示。
    注意：
    • 文件导入时，将列出 SZ_REG_TABLE 中字段 table_area = Inbox 或 %_Import 的所有表。
    • 导出文件时，将列出所有 SCV 表和视图。
  8. 在“文件详情”选项卡上指定以下信息：
    文件分隔符
    文件分隔符类型。可能的选项：
    • 逗号
    • 选项卡
    • 竖线
    注意：默认情况下，该值设置为“逗号”。
    数字格式
    在向 SCV 数据库的数字字段导入数据时要验证的值数字格式。根据定义的格式导出数字值。
    日期格式
    在向 SCV 数据库的日期字段导入数据时要验证的值日期格式。根据此定义的格式导出日期值。
    注意：必须以大写指定“月”指示符和“小时”指示符。
  9. 单击“文件处理”选项卡。
    注意：仅当“接口方向”字段设置为“导入”时，才会显示此选项卡。
  10. 指定以下信息：
    文件排序依据
    根据指定值在目录中组织文件的顺序（升序）。可以使用下列变量：
    • %file_1 = 文件名中的第一个变量
    • %file_2 = 文件名中的第二个变量
    注意：只有当“数据源”选项卡中的“使用文件名模式”选项设置为“开启”时，才会启用此选项。
    导入最近的文件
    指示接口服务的导入模式。可能的方案：
    • 开启：根据文件时间戳或通过“文件排序依据”选项中指定的值，导入最新文件。
    • 关闭：按时间戳（保存文件时的系统时间）或“文件排序依据”选项中指定的值按顺序导入所有文件。
    注意：
    • 只有当“使用文件名模式”选项设置为“开启”时，才会启用此选项。
    • 时间戳基于源操作系统。
    文件分组依据
    在组内文件排序时所依据的标准。根据在“文件排序依据”选项中指定的值，在每个组中对文件进行排序。否则，文件会按最晚日期和时间排序。导入每个组中的最新文件。
    注意：只有当“使用文件名模式”选项设置为“开启”时，才会启用此选项。
    导入后重命名文件
    重命名成功导入文件所依据的变量。以下变量用于重命名：
    • %file = 完整的文件名
    • %file_0 = 没有扩展名的文件名

    示例：

    • %file_save：TAR_MD_BOM_20170705060012.csv 已重命名为 TAR_MD_BOM_20170705060012_save.csv。
    • %file_0_complete：文件 TAR_MD_BOM_20170705060012.csv 已重命名为 TAR_MD_BOM_20170705060012_complete
  11. 在“导入行为”选项卡上指定以下信息：
    在导入前清除目标表
    指示在执行接口和导入行之前是否必须先清除目标表的所有行，或数据必须添加到现有记录。可能的方案：
    • 开启：删除并插入
    • 关闭：附加
    根据源列/值清除
    从目标表中删除记录的条件。可能的方案：
    • 如果未在这些字段中指定值，则会从目标表中删除所有记录。
    • 如果指定，则仅会删除与“源列”和“值”字段中指定的值相同的记录。
    注意：只有当“在导入前清除目标表”选项设置为“开启”时，才会启用这些选项。
  12. 单击“导出筛选”选项卡。通过此选项卡可以定义筛选导出数据的条件。
  13. 指定以下信息：
    列
    SCV 表的列名。
    运算符
    用于设置筛选条件的运算符。可能的值：
    • 等于
    • 不等于
    • 依据
    • 不类似
    • 为空
    • 不为空
    值
    筛选条件适用的值。
  14. 单击“导出行为”选项卡。
    注意：仅当接口方向设置为“导入”时，才会显示此选项卡。
  15. 指定以下信息：
    将时间戳附加到文件名
    指示是否必须将时间戳添加到导出的文件名中。
    注意：
    • 必须以 UTC 格式指定时间戳，并添加到文件名扩展名前面，并在其前面添加下划线。例如，FileName_20171030135355.csv。
    • 默认情况下，该值设置为“关闭”。
    包含导出值的报价
    指示是否将导出的值包含在引号中。
    注意：默认情况下，该值设置为“开启”。
  16. 单击“映射”选项卡。“映射”选项卡显示属性列表。默认情况下，属性列表是基于所选的 SCV 表。
  17. 如果需要，添加新属性。请参阅“添加新属性”。
  18. 单击“导入常量”选项卡。此选项卡包含 SCV 表中的属性列表，在导入数据时必须将这些属性映射为常量值。
    注意：
    • 仅当“接口方向”字段设置为“导入”时，才会显示此选项卡。
    • 此选项卡上指定的值覆盖“映射”选项卡中映射的数据。
  19. 如果需要，添加新导入常量。请参阅“添加新的导入常量”。
  20. 单击“导出常量”选项卡。此选项卡包含来自 SCV 表的属性列表，用于在导出时映射常量值。
    注意：仅当“接口方向”字段设置为“导出”时，才会显示此选项卡。
  21. 如果需要，添加新导出常量。请参阅“添加新导出常量”。
  22. 单击“保存”。