跳至主要内容
Workday User Guide
上次更新时间 :2023-11-03
步骤:使用外部数据创建数据集(SFTP 服务器)

步骤:使用外部数据创建数据集(SFTP 服务器)

安全性:“Prism Analytics”功能区域中的
“Prism Datasets: Create
”域。
您可以通过 SFTP 服务器传输数据,使用外部数据来创建基础数据集。您可能希望创建一个基础数据集,以便在外部服务器定期收集或添加新数据时,从该服务器获取数据。您可以配置数据集从服务器获取新数据的频率。
如果您是 Workday 新用户,则无权创建或编辑基础数据集。
要成功从 SFTP 服务器传输数据,请执行以下操作:
  • 文件数量必须少于 5,000。
  • 数据传输时间必须少于 5 小时。
服务器中的每个文件压缩后应小于 1 GB(未压缩时约小于 10 GB)。
  1. 访问
    “数据目录”
    报告。
  2. 选择
    “创建”
    “通过 SFTP”
    “创建数据集检索 - 配置文件检索”
    任务中,您可以配置从 SFTP 服务器导入数据的方式。
  3. “文件”
    版块中,输入表示 1 个或多个文件的文件名或文件名模式。
    文件名区分大小写。您可以将星号 (*) 和问号 (?) 字符用作通配符,以指定文件名模式。使用星号 (*) 指定零个或多个字符,使用问号 (?) 正好指定 1 个字符。
  4. “传输”
    版块中,指定如何连接到 SFTP 服务器:
    选项 描述
    SFTP 地址
    使用以下格式:
    sftp://
    domain_name
    sftp://
    IP_address
    如要指定端口号,请将其添加到域名或 IP 地址的末尾。如果您未指定端口号,Workday 将使用端口 22。
    名录
    (可选)服务器上包含文件的目录。目录名称区分大小写。仅在完整路径(而非相对路径)中包含前导斜杠 (/)。
    使用临时文件
    使用随机生成的名称将导入的数据写入 Workday 中的临时文件。数据导入完成后,Workday 会自动将文件重命名为正确的名称。
    如果数据导入需要很长时间,并且可能无法在同一服务器的下一个导入数据的排定时间之前完成,则您可能需要启用此选项。
    身份验证方法和详细信息
    选择 SFTP 服务器使用的安全身份验证类型:
    • 用户名/密码
      :。
    • SSH 身份验证
      。此选项采用使用 X.509 证书的安全 Shell 密钥身份验证。
  5. (可选)在
    “文件工具”
    版块中,参考以下选项:
    选项 描述
    检索后删除
    将数据导入数据集后,删除 SFTP 服务器上的文件。如果 Workday 无法从 SFTP 服务器中删除文件,则数据检索将失败。
    解压缩
    不要为数据集启用此选项。
    您可以传输压缩或未压缩的文件。对于压缩文件,Workday 仅支持 gzip 压缩。
    解密时使用的密钥对
    如果要使用 Pretty Good Privacy (PGP) 对导入的文件进行解密,请选择 PGP 私钥对。
  6. (可选)在
    “环境限制”
    版块中,在
    “限制为”
    提示中,选择要使用
    “传输”
    版块中定义的设置的环境。
    如果您将此选项留空,Workday 会将传输设置应用于运行数据集集成的每个环境。当数据集集成在特定环境(例如实施或上线)中运行时,仅当
    “限制为”
    选项与当前环境匹配时,传输设置才有效。如果当前环境与配置的环境不匹配,则数据集集成将失败,并且不会从 SFTP 服务器检索任何文件。您可能希望将传输设置限制为仅用于特定环境,以避免意外将测试数据传输到非测试端点。
    示例:您在某个实施环境中创建数据集,并在
    “限定于”
    中选择“实施”。稍后,您将此数据集迁移到生产环境,并且下次运行该数据集集成时,集成将失败。要确保数据集集成在上线环境中成功运行,请编辑数据集集成详细信息,取消选中
    “限制为”
    选项或将其更改为上线环境选项。
  7. “创建数据集检索 - 为请求类型排定时间表
    ”任务中,在
    “运行频率”
    中,指定从 SFTP 服务器导入数据的频率。
    如果您是在将来导入一次数据,或者按时间表导入数据,请在
    “创建数据集检索 - 为集成排定时间表”
    任务中指定 的条件。
    创建数据集后,您可以运行集成,根据需要向数据集引入数据。从
    “查看数据集详细信息”
    报告的相关操作菜单中,选择
    “数据集”
    “立即运行集成”
    不能在相互重叠的时间将数据导入同一数据集。
  8. 为数据集指定唯一名称。
    数据集名称即为数据目录中的显示名称。您可以在创建、编辑或复制数据集时更改名称。
  9. (可选)更改数据集 API 名称。Workday 会根据您输入的数据集名称自动选择 API 名称,并对其进行修改以满足名称要求。数据集创建完成后,将无法更改此名称。
  10. (可选)创建或编辑一个或多个标记,用于组织数据目录中的数据集。
  11. (可选)添加描述,以帮助其他人了解此数据集中的数据。您可以在编辑数据集时更改描述。
  12. 选择在集成操作收到新数据时,您希望如何更新数据集“”。
    选项 描述
    替换
    Workday 会删除数据集中的现有数据,并将其替换为从 SFTP 服务器导入的数据。
    附加
    Workday 会保留数据集中的现有数据,并向其中添加从 SFTP 服务器导入的新数据。
    在每次运行集成时,Workday 都会导入所有文件中的所有数据。附加模式不同于以增量方式更新数据集中的数据。数据集中的数据是否以增量方式更新,取决于 SFTP 服务器是否自上次运行集成以来仅包含增量更新。
    文件架构必须满足以下要求:
    • 每次集成操作中的所有文件都必须使用与首次集成操作期间相同的解析选项(包括标题行配置)。
    • 在每次集成操作中,所有文件中的字段顺序都必须相同。
    • 如果后续集成操作中的架构包含新字段,则这些新字段必须位于所有先前字段的末尾。
    • 如果后续集成操作中的文件架构删除了一个或多个字段,则删除的字段必须位于末尾。
    • 确保将来的架构不会在架构删除字段的情况下添加新字段,否则集成操作将失败。为确保将来的所有集成都能成功运行,请始终保留架构中的现有字段,并且仅添加新字段。如有必要,可以在现有字段中包含空 (NULL) 值。
    • 单个集成中的所有文件必须使用相同的架构。
    如果新数据的架构中不包含数据集中当前存在的字段,且被移除的字段已用于数据集内的某个阶段,则集成将失败。示例:如果数据集包括“管理字段”阶段,并且集成引入的数据缺少该数据集中的某个字段,则集成会失败。这是因为“管理字段”阶段适用于数据集中的每个字段。
  13. 单击“保存”
    Workday 会创建该数据集,但在 Workday 在首次运行集成期间从 SFTP 服务器导入数据和字段之前,该数据集未包含任何数据。根据您排定的数据导入时间,数据集可能会在一段时间内为空。Workday 还添加了 2 个字段,用于提供有关每次集成操作的信息。请参见: 参考信息:WPA_Fields
  14. (可选)更改集成时间表的名称。请参见: 管理数据集的集成时间表
  15. 访问
    “数据目录”
    报告,右键单击您刚创建的数据集,然后选择
    “编辑”
  16. 配置如何解析来自 SFTP 服务器的文件中的数据。
  17. (可选) 向数据集添加阶段
    只能向基础数据集添加部分阶段类型。
  18. 您可以将 Prism 计算字段添加到任何阶段。