← 返回教程首页 | 视频图文笔记 第 16 / 18 期

Workday 核心连接器实操:先把 Location 跑通,再来配 Worker

Core Connector Worker in Workday HCM | ZaranTech

频道:Workday Learner Community(ZaranTech) 时长 1:23:47 发布于 2024-08-27 34 段对照 · 全片覆盖 原视频 ↗
⏱ 每节的 时间点 对应视频画面,点开原视频拖到该时间即可对照。
标题只说 Core Connector Worker,实际按内容分三段:0–18 分钟是集成架构与连接器的概念幻灯片,18–61 分钟完整实操的是 Core Connector: Locations(地点连接器,页面里模板名就是复数 Locations),到 01:01:50 之后才轮到标题里的 Core Connector: Worker,且只做到跑通与看输出,Document Transformation 留到下节课。议程页(01:55)承诺的 CHANGE DETECTION、TRANSACTION LOG、SEQUENCE GENERATORS 三块没有独立章节,只在概念口播和服务列表的 Optional 勾选里露过一次——所以本页面标题按实际内容拟。与已上线的 workday-open-enrollment-notes.html 的关系:那期结尾演示的是把数据投给供应商的另一条路(自定义报表 + 出向 EIB),本期讲的是连接器这条路:报表类集成用 EIB、核心连接器配 Document Transformation(10:00–10:25 口播把这条分界线说得很直白),本片的增量在连接器的作用域(模板→服务→属性→字段属性四层各管什么)、Worker 交付(27 个服务、按区块选字段、Eligibility 必须给覆盖值)以及与 EIB 的差异(标准 XML、变更检测只送差异、Full Extract 开关、Determine Value at Runtime 的排程参数、集成用户 + 集成安全组 + Get 权限这一整套授权动作)。字幕是 YouTube 自动生成,误识别不少:full extract 常被写成 full expect、Complete Hire 写成 complete to hide、Logan McNeely 画面实为 Logan McNeil、地址字段末位念成 UDC(画面地址块里只有 Country/Address_Line_Data/Municipality/Postal_Code/Is_Primary_Address/Address_Usage,未见 UDC,待核对)、payroll 那个最有名的连接器字幕记作 PEAKY, payroll effective chain interface(画面没出现该专有名词,疑为 PECI/Payroll Effective Change Interface,待核对)。正文用正确术语,quote_en 一律照字幕原样不改。集成专有名词按画面逐字抄,包括页面里的拼写异常:Core Connector: Locations 的模板说明末句写成 The output file is stored in the WD's blobhtory(疑为 blobstore,画面拼写如此)。画面里的演示租户日期是 2020-07-26(GMS 租户,账号 Logan McNeil / lmcneil),与本频道 2024 年上传的时间不同,属讲师复用旧录屏。Worker 输出 Header 的 <ws:Version> 画面显示 34.0,而口播说新建集成要选最新版本,两者谁对应哪一版没有画面证据,只记画面值。
1:55

本课目录:核心连接器

本课目录:核心连接器
  • 左侧议程条八个板块逐字为:INTEGRATION ARCHITECTURE、WORKDAY CONNECTORS、INTEGRATION BUILDING BLOCKS、CORE CONNECTOR、LAUNCHING INTEGRATION SYSTEM、CHANGE DETECTION、TRANSACTION LOG、SEQUENCE GENERATORS。
  • 高亮停在 INTEGRATION ARCHITECTURE,右侧标题写 Let's see, Integration Architecture Overview。
  • 口播给定位:核心连接器是 Workday 内置功能,顾问只做配置;同一套连接器既能只取增量变化,也能出全文件。
  • 实际交付与议程有落差:CHANGE DETECTION、TRANSACTION LOG、SEQUENCE GENERATORS 没有单独成章,序列生成器只以 Location 服务列表里的一个 Optional 勾选出现过一次。

"Uh Workday connectors, integration building blocks, core connectors, what are they launching an integration system? What are the change detection? What are the transaction logs and integration sequence generator? We are going to touch these things."— Workday 连接器、集成构件、核心连接器是什么、怎么启动集成系统、什么是变更检测、事务日志和集成序列生成器——这些我们都要讲到。

2:40

架构分工:Workday 定规则

架构分工:Workday 定规则
  • 幻灯片 Integration Architecture Overview,小标题 Common Outbound Design Patterns / Delivered Solution – Workday Connector。
  • 左边白框 Configure Integration 列出顾问要配的四样:Services、Attributes、Maps、Transaction Log。
  • 右上蓝框画面原文:Workday defines the rules and the output. Workday builds the integration using the Soap API.(取数规则与实现由 Workday 负责)
  • 右下绿框:Delivery Service delivers output to Endpoint. ——文件投递也是连接器自带的,不必自己写搬运。
  • 口播补一句:怎么取数、从哪取,客户看不到也不用管,Everything is responsibility of Workday。

"When it's come to the Workday connectors, we are going to configure the service attributes, services, maps, and transaction logs. And Workday defines the rules and how they are going to extract it."— 讲到 Workday 连接器时,我们要配的是服务属性、服务、映射和事务日志;规则和怎么取数是 Workday 定好的。

3:20

交付方案的五条要点

交付方案的五条要点
  • 同一标题页换成五条要点:连接器是 a configurable delivered solution;这套设计模式在需要变更检测时最有用,但同一连接器也能出 full file output。
  • 第三条明确警告:Reasonable if only a restricted number of field overrides are required avoid overrides that use calculated field prompts——字段覆盖用得越少越好,别拿带计算字段提示的覆盖去顶。
  • 另外两条是 Provides a standardized Workday XML output 与 Delivery service supports the file delivery requirements,即输出格式统一、投递由服务负责。
  • 口播给变更检测四个例子:new hire、change of manager、promotion(换到新 position)、salary change——只送这些差异,不整库搬。
  • 连接器缺字段时的补救就是事务日志过滤 + field override(例如请假数据不在连接器里,就用计算字段挂进来)。

"First scenario is we have a new hire. Second, we have a change of manager. Third, we have a promotion where a person has a new position. Fourth, we have a salary change."— 第一个场景是新员工,第二个是换经理,第三个是晋升到一个新职位,第四个是调薪。

6:25

中间加一层文档转换

中间加一层文档转换
  • 幻灯片标题:Delivered, Custom Solution – Workday Connector with document transformation.,与上一页的差异只在流程里多了一个绿框。
  • 绿框画面原文:Document Transformation Integration System transforms the output of the Workday Connector.,末段随之变成 Delivery Service Delivers Transformed Output to Endpoint.。
  • 口播列了三种改格式的路线:document transformation、Workday Studio、或公司自建的 middleware 平台(连映射都能在中间件里做)。
  • 旁听补充的两个例子:Workday 侧受抚养人值显示 child、供应商只要 C,就在转换里做值映射;另一例是反过来调外部费用系统取金额、与 Workday 数据合并成一个输出文件,这叫 enrichment。

"If your end party does not want a Workday standard output, we can transform for them. Here it we can use document transformation, we can use Workday Studio or we can use any middleware platform."— 如果对方系统不要 Workday 的标准输出,我们可以替它转:可以用文档转换、用 Workday Studio,或者用任何中间件平台。

8:25

文档转换的三条约束

文档转换的三条约束
  • 幻灯片三条原文:Reasonable if restricted to three or less transformations / Runs in two hours or less / Document Transformation was specifically designed to work with Connectors。
  • 最后一句是本片与 EIB 的分界线索:转换层是专门为核心连接器设计的;报表类集成走的是另一套(EIB)。
  • 口播给了两个真实约束:一层输出可以投任意多个目标系统,但转换层级建议三层以内、再多改用 Workday Studio;单个集成超过 2 小时会被系统自动丢弃,5 万人租户就得先拆数据。
  • 转换能覆盖的需求包括:对方要 CSV/JSON、把 full name 标签改成 F name、把一对多关系压成一行。

"We may deliver uh files from one to any number of uh uh target system, but the best is like restricted to three or less transformations. Uh like we That is recommended to use uh document transformation for three transformation, not more than that."— 一个文件可以发给任意多个目标系统,但最好限制在三层转换以内;文档转换用到三层为止,再多就不建议了。

13:35

两类连接器:端到端与预置

两类连接器:端到端与预置
  • 幻灯片:Workday provides two types of Connectors——End-to-end Connectors 对应某个具名的第三方应用或服务,两系统间的业务功能已经配好、no additional coding required。
  • 第二类是 pre-built integrations,覆盖对接第三方端点所需的多数集成工作量,还要自己做一部分工作。
  • 上一页(未收进本笔记)写明连接器是扩展 HCM、Payroll、Payroll Interface、Financial Management、Spend Management 的预置集成模板,且 All integrations are hosted and maintained by Workday。
  • 口播两个补充:核心连接器属于 Workday 自带、不额外收费,自建中间件则成本明显;ServiceNow 这类新系统提供的是预置连接器,只需配置不需编码。
  • 口播还提到 payroll 里最有名的那个连接器,字幕记作 PEAKY, payroll effective chain interface——画面没出现该专有名词,疑为 PECI(Payroll Effective Change Interface),待核对。

"when we say end-to-end connector, it means that everything from business function, everything are configured automatically. We just need to configure it, and there is no coding added in it."— 所谓端到端连接器,就是从业务功能往下都已经自动配好了,我们只需要做配置,里面不用加代码。

16:25

集成模板与业务域分类

集成模板与业务域分类
  • 画面 Integration Template 定义:An integration template is a collection of integration services that enables communication between Workday and an external system.(模板 = 一组集成服务)。
  • 画面分类清单逐字:Benefits, Financials, HCM, Payroll, Payroll Interface, Procurement, Recruiting, Security, and Settlement。
  • 第三条:Many of the delivered templates contain default values for attributes, as well as prompt values for attributes and maps, to define the integration further——预置模板既带默认值,也留了提示值给属性和映射。
  • 口播把构件归纳成四样:attributes、maps、XSLTs、XMLs,并说 XSLT 才是把 XML 变成对方看得懂的格式的那一步。

"An integration template is a is a collection of integration services that enables communication between Workday and the third-party system or external system."— 集成模板就是一组集成服务的集合,用来打通 Workday 和第三方系统、或外部系统之间的通信。

19:40

建集成系统:命名与选模板

建集成系统:命名与选模板
  • 页面 Create Integration System,可见字段:System Name(画面已键入 [AS])、System ID、Comment、Integration Tags、Contacts,以及 Template 区的 New using Template(红星必填)。
  • 模板选择框走 By Integration Template Category,画面逐字列出:Cloud Connect for Benefits、Cloud Connect for Financials、Cloud Connect for HCM、Cloud Connect for Payroll、Cloud Connect for Spend Management、Cloud Connect for Student、Cloud Connect for Student Admissions、Cloud Connect for Student Financial Aid、Cloud Connect for Student Financials、Cloud Connect for Student Records,底部还有一个 Search 框可按名字搜。
  • 两条找模板的路:不知道名字就按域一层层点进去,知道名字就直接搜。
  • 命名规范是讲师自己的写法:[AS] 前缀 + 连接器 + outbound;他说多数公司会用 INT001 这类带编号的方式,再补定义说明。

"That's the naming convention I use. Uh it is always depends on your company which naming convention they use. In most of the companies, they use INT001 or something like with their IDs."— 这是我用的命名规范;具体要看公司习惯,多数公司会用 INT001 这类带编号的写法。

21:40

Location 的七个集成服务

Location 的七个集成服务
  • 页面 Configure Integration Services,实例 [AS] Location Core Connector Outbound IntSys,Integration Template = Core Connector: Locations(注意画面是复数 Locations)。
  • Integration Services 7 items 逐字:Core Connector: Locations Init Svc*(Initial Service to Invoke 已勾)、Core Connector: Date Launch Parameters、Core Connector: Locations Integration Configuration、Core Connector: Location Data Section Fields、Core Connector: Locations Filename Sequence Generator、Core Connector: Integration Maps - Foundation、Integration Document Retention。
  • 只有第 5 行 Locations Filename Sequence Generator 的 Optional 被勾上、Enabled 留空——序列生成器在这个连接器里是可选项,从名字看是给输出文件名做序号用的。
  • 顶部 Enable All Services 复选框可一键全开;底部 Custom Integration Services 显示 0 items,说明还没挂自定义服务。

"Services have a launch parameter, integration configurations, data section, sequence generator, mapping, and document retention."— 服务里包含启动参数、集成配置、数据段、序列生成器、映射和文档保留这几块。

23:40

属性页:国家码与隐私字段

属性页:国家码与隐私字段
  • 属性表列名逐字:Attribute、Description、Options、Override Default Values、Value、Restricted to Environment;Provider 一栏是 Core Connector: Locations Integration Configuration。
  • Country Code Type 画面原文:Configure your preference for 2 or 3 character Country code, eg: US or USA. The value confirms to ISO-3166-1. Default is 3 characters.(确认位数就写在这一格)
  • Include Private Address / Include Private Phone / Include Private Email 三条描述同构:若为 true 则在输出中包含 Workday 里被标记为私有的地址/电话/邮箱,Default is false——隐私数据必须手动打开才会出。
  • Output Document Tags 描述:These values are tagged to the document output by the integration system,即给输出文件打的标签,后面建文档转换时按标签取文件。
  • Required Field Validation 描述里给了取值后果:选 Omit - Report Error 时,校验不过的那条记录会被整条剔出输出。

"Default is three characters, but few uh few of the vendors, they want just two characters. Normally, private address is hidden and it's not available. But, if you need the private address to be enabled, you have to select it by by force."— 默认是三位国家码,但有供应商只要两位;私密地址默认是隐藏的、拿不到,要输出就必须强制勾开。

25:10

字段属性:能输出哪些列

字段属性:能输出哪些列
  • 页面 Configure Integration Field Attributes([AS] Location Core Connector Outbound IntSys),Field Configuration 23 items,列名为 Field(s)、Description、Override Default Values、Include in Output、Required Field、Maximum Length。
  • 画面可见字段与释义:Location(Unique Identifier for the Location,Required Field 已勾)、Location Name、Location Usage(Business Asset, Business Site, Warehouse etc.,一个地点可有多个用途并都会反映到输出)、Location Type、Inactive、Time Zone、Default Currency、Default Currency Code(ISO 4217 数字码,如 840)、Country。
  • Maximum Length 这一列是给旧系统设的闸门:Workday 侧字段本身不限长,遗留系统往往读不了 50 或 250 字符以上,就在这里截。
  • Location 行的 Include in Output 与 Required Field 两格都已勾、Override Default Values 一格是灰的,它的画面描述就是 Unique Identifier for the Location。

"what fields are available in core connector worker are these fields: location, location name, country, address line, regions, and all these things. And with each field, there's a description available."— 核心连接器里能用的字段就是这些:location、location name、country、address line、region 之类,每个字段都带一段说明。(注:此处口播说 worker,画面其实是 Location 连接器的字段页)

26:55

模板说明:输出落在哪里

模板说明:输出落在哪里
  • View Integration System:System Name [AS] Location Core Connector Outbound IntSys,Integration Template Core Connector: Locations,Integration Services 6 items 全部 Enabled = Yes(少掉的就是没启用的序列生成器)。
  • Template Description 被高亮,画面原文:Use this Integration Template to extract Locations in Workday. The output is a normalized message conforming to the XSD. The output / extract could further be used in a business process definition for further transformations or delivery to a specific end point. The output file is stored in the WD's blobhtory(画面拼写如此,疑为 blobstore,待核对)。
  • 这一页说明两件事:输出是符合 XSD 的规范化报文;文件先存在 Workday 自己的存储里,投递要另配。
  • 口播给用途场景:把地点和地址交给管场地租赁、供应商合同的第三方;或在对方系统里先建好地点,再去控制用户访问权限。

"This core connector location will able to extract location from Workday. And send it to the third party."— 这个核心连接器 Location 能从 Workday 抽出地点数据,然后发给第三方。

30:20

全量抽取与增量抽取

全量抽取与增量抽取
  • Schedule an Integration:Run Frequency 是 Run Now;Integration Criteria 两个 Provider——Core Connector: Date Launch Parameters 与 Core Connector: Locations Integration Configuration。
  • 日期四件套逐字:As Of Entry Moment、Effective Date、Last Successful As Of Entry Moment、Last Successful Effective Date;本帧前两项已由系统填成 07/26/2020 的当次时间,讲师正把 Last Successful As Of Entry Moment 手工改成 01/01/2020。
  • Full Extract 的画面释义:Extracts Locations as of the As Of Entry Moment and Effective Date, regardless of whether or not they have changed.——勾上就是当前快照全量,不勾只给变化;Location(s) 那行则用于只抽指定地点。
  • 口播给经验:多数目标系统只要变化,老收全量就得自己写比对逻辑;只有数仓那种每天删表重灌的场景,或刚上线 Workday 首次铺数据,才需要全量。

"If you select on the full extract this file, this means that it will pick all the changes, everything not all the changes, it will pick the the current snapshot for the whole data. It will pick everything which is in Workday."— 勾了 Full Extract,意思就是把当前整份数据的快照都取出来,不是只取变化,Workday 里有什么就出什么。

33:20

后台进程页看哪几栏

后台进程页看哪几栏
  • 页签六个:Integration Details、Process Info、Process History、Output Files、Messages、Child Processes。
  • Integration Process 区字段:Parent Event、Integration Event、Event Type、Integration System、Initiated By、Initiated at、Ran As;本次 Initiated By 与 Ran As 都是 Logan McNeil / lmcneil,因为此刻还没换集成用户。
  • Date Parameters 区回显本次真正用到的范围:As of Effective Date 07/26/2020 12:00:00.000 AM、As Of Entry DateTime 07/26/2020 08:46:26.447 AM、Begin Effective Date 01/01/2020、Begin Entry DateTime 01/01/2020。
  • Child Processes 2 items:Integration Event Trigger(Completed)与 ESB 的 Integration ESB Invocation(Processing,进度条约 15%)。
  • 口播强调定位:集成顾问真正看的是 Integration Details 和 Output Files,Process Info 讲耗时、Process History 讲谁跑的。

"We have always a person who is initiated this uh integration. We have the name of that person. We have a person who ran this ran as this like normally. This is not Logan McNeely. It will be a some integration user."— 总有一个发起集成的人,页面上会留名字;还有以谁的身份跑这一栏——正常情况下那不该是 Logan,而应该是某个集成用户。

35:05

XML 头部的七个字段

XML 头部的七个字段
  • 根节点画面原文:<locc:Locations xmlns:locc="urn:workday.com/connector/locations" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">,全部数据都在这一个标签里。
  • <locc:Header> 内可见字段逐字:Prior_Entry_Time、Current_Entry_Time、Prior_Effective_Time、Current_Effective_Time、Full_File>false、Document_Retention_Policy>30、Record_Count>67。
  • Full_File 为 false 直接说明这份是增量;Record_Count 67 与口播说的 67 条地点一致,Document_Retention_Policy 30 即输出文件保留 30 天。
  • 口播解释 header 的用途:第三方比对自己的 effective date 变化、并用条数与校验信息判断文件是否完整;对不上就丢弃文件、回话让 Workday 团队重发。
  • Header 之后才是可折叠的 <locc:Location> 明细,画面上第一条为 LOCATION-2-330 / Coca Cola Sheffield_NA,地址块含 Country>GBR、Address_Line_Data>Bellhouse Road、Municipality>Sheffield、Postal_Code>S9 6HX、Is_Primary_Address>true、Address_Usage>BUSINESS。

"This information for all the the connector, no matter which connector you are going to use, it has this header tag. Header tag informs us few things."— 不管你用哪个连接器,输出里一定会有这个 header 标签,它会告诉你几件事。

38:10

一条地点记录的结构

一条地点记录的结构
  • 画面第一条记录:Location>LOCATION-2-331、Location_Name>Chennai、Location_Usage>BUSINESS SITE、Location_Type>LOCATION_TYPE-4-9、Time_Zone>US/Pacific、Default_Currency>INR、Default_Currency_Code>356。
  • 其下 <locc:Address> 块:Country>IND、Address_Line_Data>123、Municipality>Chennai、Postal_Code>600100、Is_Primary_Address>true、Address_Usage>BUSINESS——地址是独立一块,不并进地点主体。
  • 结构上一对一与一对多分得很清:地点主体信息只有一份,地址块可以重复出现多次。
  • 口播拿这份数据举转换例子:把门牌 123、Chennai、600100、India 拼成一行,或者用竖线分隔,都靠 XSLT 做;标准输出文件本身一个字都不能改。
  • 字幕里末位念成的 UDC 在画面地址块里找不到对应字段,待核对。

"This is specifically one location has always this one area. There will be no way that they have a multiple uh one location has a multiple information. This will be always one-to-one. And then their address, they may have more than one address. So, this column or this header will repeat."— 一个地点的主体信息永远只有一份,不可能一对多;但地址可能有多个,所以这个地址块会重复出现。

43:00

上次成功时间自动回填

上次成功时间自动回填
  • 还是那张 Schedule an Integration 页,第二次打开时 Last Successful As Of Entry Moment 已自动填成 07/26/2020 08:46:26 AM、Last Successful Effective Date 填成 07/26/2020,而第一次跑时这两格是空的。
  • As Of Entry Moment 变成 07/26/2020 08:59:30 AM,说明系统按上一次成功的时间点自己续上了,这就是变更检测能只送差异的落地机制。
  • 讲师为了让第二次运行真能出东西,把 Last Successful Effective Date 改回 07/26/2020、并把 Begin 值往前设到 01/01,否则这段时间里什么都没变。
  • Value Type 列仍是 Specify Value,提醒手工值只适合排障,长期跑要换成运行时取值。

"If you remember in when we ran the integration first time, this information was empty. The last successful entry moment and the effective date. Now this is auto populated."— 还记得第一次跑的时候这两个格子是空的吗——上次成功的 entry moment 和 effective date,现在系统已经自动填好了。

44:40

先前值属性进了输出

先前值属性进了输出
  • 勾上 Include Prior Values 再跑一次,输出里每个字段都多出 locc:PriorValue 属性,例如 <locc:Location_Name locc:PriorValue="">Chennai</locc:Location_Name>、<locc:Default_Currency locc:PriorValue="">INR</locc:Default_Currency>。
  • 本帧所有 PriorValue 都是空串:这批地点全是本次新增,没有前后值差异;一旦某字段被改过,旧值就会写在这个属性上。
  • Header 的 Prior_Entry_Time 已回填为 2020-01-01T00:00:00.000-08:00,Current_Entry_Time 变成 2020-07-26T08:59:30.281,Full_File 仍为 false。
  • 口播点出方法论:属性、服务、字段这三块配置里的任何一处改动,都会直接改变输出结果,所以调属性也算改集成。

"did you realize that we have a prior values, too? It is an attribute. ... And if it is empty, it means that it's a new uh location. It created in this area."— 你发现输出里也带了 prior value 吗?它是个属性;如果为空,就说明这条地点是这次新建的。

46:40

国家码从三位改两位

国家码从三位改两位
  • 页面 Configure Integration Attributes for Integration System,Country Code Type 那行的 Value 被填成 ISO 3166-1-Alpha-2(画面右上角可见该选项文本),行右侧还有 Restricted to Environment 一列可以把设置锁定到特定环境。
  • 描述格仍写着默认三位,前面几帧输出里看到的正是 IND / GBR / USA 这类三字母码;换成 Alpha-2 后国家会写成 IN / GB / US。
  • 讲师给这件事定性:这是 configurations mapping(按供应商要求换写法),属于配置层面的事,不要和 document transformation 混为一谈。
  • Attribute Provider 列显示这些属性都挂在 Core Connector: Locations Integration Configuration 这个服务下,也就是服务决定属性分组。

"So, for now, we are using ISO three, right? Three digits country code. So, if I change it to ISO two, my output will change. ... it's more like a uh configurations mapping. Like we are transforming data as per uh vendor requirement or the third-party system requirement."— 现在我们用的是 ISO 三位国家码,我改成两位,输出就会变。这更像配置层面的映射:按供应商要求改写法,但不算真正的转换。

48:20

创建集成系统用户

创建集成系统用户
  • 任务 Create Integration System User,Account Information 区字段逐字:User Name(画面键入 [AS]…)、Generate Random Password、New Password、Password Rules、New Password Verify、Require New Password at Next Sign In、Session Timeout Minutes Enforced(30)、Session Timeout Minutes、Do Not Allow UI Sessions。
  • 画面 Password Rules 原文要求:新密码不得与当前密码或用户名相同,最少 8 位,且必须同时包含字母、大小写、阿拉伯数字 0-9 与特殊字符。
  • 集成用户的三个关键动作:不勾 Require New Password at Next Sign In、勾上 Do Not Allow UI Sessions——它只跑集成,不给人登录。
  • 口播两条经验:命名跟着它服务的集成走、后缀加 user;每个集成都要单独建一个用户,复用是安全隐患。

"So, normally we mention with the with the same name of integration where it's used along with the name user. We enter anything, it doesn't matter. It does not require new password to sign in and do not allow user interface sessions."— 命名一般跟它服务的集成同名、再加 user 后缀;关键是勾上登录时不需要改密码,并且不允许界面会话。

50:20

换成集成用户就跑挂了

换成集成用户就跑挂了
  • View Background Process 顶部 Status = Failed,Current Processing Time 00:00:05,Number of Errors 1,页签上写着 Output Files (1)、Messages (3)、Child Processes (2)。
  • Ran As 一栏已经是 [AS] Location Int User,而 Initiated By 仍是 Logan McNeil——身份切换生效了,权限没跟上。
  • 右侧 Consolidated Report and Logs 4 items,能看到一份 Cloud Request 加两份 Log File(文件名形如 request-dd07fb249b7012869d9d7984f010437.log)。
  • 错误正文(口播念作 the task submitted is not authorized)在 Messages 页签里,本帧没有展开,只以口播为据。
  • 口播解释原因:没给这个用户任何角色或职责,它默认只能取公开数据,所以整条集成直接失败。

"See, it fails. Now, if you look at the the error message, the following expected error and the error is the task submitted is not authorized. That means the user is not authorized."— 看,跑失败了。打开错误信息,是意料之中的那条:the task submitted is not authorized,意思是这个用户没被授权。

53:15

把安全组挂到集成权限

把安全组挂到集成权限
  • 在权限行的搜索提示框里键入 [AS],弹出 Search Results (50),第一行就是刚建的 [AS] Location Core Connector Outbound Sec Group——组名与集成同名,便于审计追溯。
  • 挂进去之后的权限行右侧只有两列可勾:Get 与 Put;画面里 Supplier Integration System、ISU_BHAV_SG 两行只勾 Get,讲师说只要能抽数据就够、不需要 Put。
  • 同屏的 Security Groups 列里还挂着 Finance Administrator、HR Administrator、HR System、Implementers、Information Administrator(MORE (2))等既有组,另有 Supplier Integration System、ISU_BHAV_SG 两行——集成权限是按行往安全策略里加组的。
  • 口播点出与报表的差别:做报表和任务用的是域与任务权限,集成要用 Integration Permissions 这一块;集成系统安全组可按需选 constrained 或 unconstrained,走文档转换且不针对特定地点时一般用 unconstrained。

"Remember you are you probably you have been working on the report and task area. So in case of integrations, we need to use this integration permission. Not on location and task, but towards this area."— 你们以前做报表和任务用的是那套权限;做集成得用这个 integration permission,不是 location、也不是 task。

54:05

改动要激活才生效

改动要激活才生效
  • 页面 Activate Pending Security Policy Changes,说明文字写着所有待生效的安全策略改动确认后才会生效;Current 与 Proposed Security Evaluation Moment 分别是 07/26/2020 04:31:53.118 AM 和 07/26/2020 09:22:14.902 AM。
  • Comment 填的是 Enable integration user for Location Sec Group,Confirm 复选框是红星必勾。
  • Domain Security Policies 2 items 逐字:Location: View 与 Manage: Location,各带 Last Changed 时间与 By User(lmcdell / Logan McNeil)。
  • 口播提醒 Relaunch 的性质:Relaunch 按钮会沿用同一套参数,不用重新填日期,权限激活后直接再跑一次即可。

"Now I have to activate the security policies. So I am going to enable integration user for the location security group. And it I provide access for the view for the location and manage locations."— 现在得激活安全策略:给 location 安全组启用集成用户,开的是 Location 的查看权和 Manage Locations。

55:30

变化报告用颜色说话

变化报告用颜色说话
  • 这份 HTML 报告把 XML 原样搬成可读表格:Extract Summary 的 Selection Criteria 列出 Prior Data Entry Time、Current Data Entry Time、Effective From Date、Effective To Date,Changes Included 说明只算 Current Data Entry Time 之前录入、且在生效区间内发生变化的记录。
  • 明细标题是 Location Details (67),与 XML header 的 Record_Count 67 对得上;右上角还有 Show / Hide All 折叠控件。
  • 每条地点一个灰底标题条,如 Chennai (LOCATION-2-331) [Location Data],表头固定两列 Current Value 与 Prior Value (if different)。
  • 本帧整块浅绿并弹出 Value Added 提示:绿 = 新增;口播给全三色——黄是改动、红是删除。
  • 口播的理由:他调试时不先看 XML,先看这份彩色报告,一眼能确认这次只有新增、没有任何地点被更新。

"And if you see, it is in the green color. Green color means new or addition. If it is yellow, it means change. If it is red, it means deletion."— 你看它是绿色的:绿色代表新增;如果是黄色就是改动,红色就是删除。

57:15

集成事件是运维入口

集成事件是运维入口
  • 页面 Integration Events,上方按 Integration Systems 过滤为 [AS] Location Core Connector Outbound IntSys,共 4 items。
  • 列名逐字:Workday Integration Cloud Platform (ESB) Process Ids、Event Type、Integration Event、Integration System、by Person、Created From Trigger、Sent on、Integration Event Status、Response Message。
  • 状态列把 09:17:57.014 那次标成 Failed,其余三次 Completed,Response Message 一律是 Integration Completed.;by Person 全是 Logan McNeil。
  • 口播定位:日常运维最常用这个视图,失败的要修要重跑,成功的如果已设好自动投递可以不看;从事件页可以直接跳到输出文件。

"you go on the integration systems and integration events. Click here. And okay, and you will find all the integration events ran till today. So, for any operational activities, you may need to use this integration events more often."— 到 integration systems 里点 integration events,就能看到今天为止跑过的所有集成事件;做运维时用得最多的就是它。

58:25

运行时取值的三种参数

运行时取值的三种参数
  • 把 Last Successful Effective Date 那行的 Value Type 从 Specify Value 切成 Determine Value at Runtime,弹出 Search Results (3),三个选项逐字:As Of Effective Date of Last Completed Integration Event、Begin Effective Date of Last Completed Integration Event、Current Effective Date Minus 12 Months / Plus 1 Day (use in conjunction with determining period of last 12 months)。
  • 这就是排程跑的正确做法:不要硬编码日期,让 Workday 在每次触发时自己算起点。
  • 同页下方 Concurrent Integration Scheduling 被勾上,说明文字为:当这个排程还有未跑完的集成事件时,允许再触发新事件,另有一行 Except when the integration event has all the same 未勾。
  • 口播解释第一类参数的含义:它是 Workday 提供的信息,指上一次已完成集成事件的 effective date,所以每次跑都自动从上次成功处接上。

"The thing is like this is what I'm hard coding it. It does not make sense for uh, schedule integration, right? So, I need to use a determined value at run time. I want to to set some data and parameter at run time."— 我这样是把它硬编码了,对排程跑的集成来说没意义;所以要用 Determine Value at Runtime,让参数在跑的时候再算。

1:04:30

Worker 有二十七个服务

Worker 有二十七个服务
  • Configure Integration Services 显示 Integration Services 27 items,列头与 Location 一致:Integration Template Service、Initial Service to Invoke、Optional、Enabled。
  • 本帧服务名逐字:Core Connector: Worker / Worker Profile Photo、Worker Personal Data Section Fields、Worker Status Data Section Fields、Worker Position Data Section Fields、Worker Contract Data Section Fields、Worker Leave of Absence Data Section Fields、Worker Compensation Data Section Fields、Worker Identification Data Section Fields、Worker Related Person Data Section Fields、Worker Qualification Data Section Fields、Worker Transaction Log Data Section Fields。
  • Enabled 只勾了 Photo、Personal Data、Status 三项,其余 Optional 项全留空——Worker 的复杂度就体现在这一串可选数据区块上。
  • 底部 Custom Integration Services 0 items,和 Location 一样,自定义服务是另挂的。

"I'm not sure about others for for now for few minutes so I'll just keep only three enabled for now. And then I will enable all and I will show you what happens then."— 其他几项我现在不确定,先只开这三项;然后我全打开,给你看会发生什么。

1:04:50

保存即报错:缺强制项

保存即报错:缺强制项
  • 页顶红条 1 Error / View All:只勾三项服务是存不下去的,Worker 的强制项比 Location 多。
  • View Integration System:System Name [AS] Worker Core Connector IntSys,Integration Template Core Connector: Worker,Integration Services 11 items 且 Enabled 全为 Yes。
  • 画面服务名逐字:Core Connector: Worker ESB Service*(Initial Service to Invoke = Yes)、Core Connector: Date Launch Parameters、Core Connector: Integration Maps - Worker、Core Connector: Worker Integration Configuration、Core Connector: Integration Maps - Foundation、Core Connector: Integration Maps - Job、Core Connector: Define Eligibility、Core Connector: Integration Maps - Talent,其后才是 Profile Photo 与 Personal Data Section Fields。
  • 画面上这 11 行的 Optional 一格全空、Enabled 一律 Yes;口播说 data launch parameters 这类是强制的,连开关都不给。Worker 天生带资格判定(Define Eligibility)和三张集成映射,这是它与 Location 在作用域上的第一个实质差别。
  • 口播指出报错来源是 launch parameters 里的必填项没给值,典型就是 Version:新建集成要用最新版本,旧版本是历史遗留升级上来的。

"As soon as I completed this this shows an error and error means there are some mandatory parameters which I have I haven't make it as enabled on the launch parameters."— 我一保存就报错,意思是 launch parameters 里有几个强制项我没启用、没给值。

1:07:50

字段区块与全含开关

字段区块与全含开关
  • 服务全开后,Configure Integration Field Attributes 左栏从 3 个区块变成 11 个,画面逐字:Worker Profile Photo、Worker Personal Data Section Fields、Worker Status Data Section Fields D…、Worker Position Data Section Fields …、Worker Contract Data Section Fields …、Worker Leave of Absence Data Secti…、Worker Compensation Data Section …、Worker Identification Data Section Fi…、Worker Related Person Data Section …、Worker Qualification Data Section Fi…、Worker Transaction Log Data Sectio…。
  • 顶部 Include All Fields in Output 复选框(本帧已勾)是一把梭:不知道要什么就全出,知道就只勾需要的;两列开关分别是 Include in Output 与 Required Field。
  • 本帧选中的是 Worker Profile Photo,Field Configuration 2 items:Filename 与 Image,Image 的画面释义为 The image file content in base64 binary format. The Maximum Length option for this field will have no affect.(照片这列限长无效)。
  • 口播解释 Required Field 的后果:勾了它而某人没有照片,整个集成会直接抛错失败,而不是跳过这条。

"You can click include all fields output in uh, include all fields in output. Or if you know what you are actually looking for, you can only enable those things. Required fields are means that if this field does not exist in output, it will fail."— 可以点 include all fields in output 一把全开;清楚自己要什么就只勾那些。勾了 Required Field 就意味着:输出里缺这个字段,集成会直接失败。

1:08:40

Operation 字段的四种值

Operation 字段的四种值
  • 选中 Worker Position Data Section Fields,Field Configuration 50 items;可见字段逐字:Operation、Position ID、Effective Date、Primary Position、Position Title、Business Title、Worker Type、Position Time Type、Job Exempt、Scheduled Weekly Hours。
  • Operation 一行的画面释义(原文):This field is used to indicate the change made between extracts. Supported values include ADD, REMOVE, MODIFY and NONE. 并说明 Include in Output 对它不适用、只要该数据段存在且不是全文件抽取,它一定会出现在输出里。
  • 本帧只有 Effective Date 的 Include in Output 被打勾,与口播说的 position 段先只给 effective date 一致。
  • Worker Type 与 Position Time Type 的描述都写着 The field is mapped using the Integration Map called Worker Type / Position Time Type——码值换算是由集成映射完成的,不是连接器自己翻译。
  • 口播最后决定只保留 person、status、position、photo 四个区块,其余关掉让集成跑得快一点。

"In position section, I will just add effective date for now. ... To make it simple and make it more clear, I will just use these four areas only."— position 段我先只加 effective date。为了简单清楚,就只用这四个区块。

1:14:40

资格条件必须给覆盖值

资格条件必须给覆盖值
  • 页面 Configure Integration Field Overrides,左栏只有 Define Eligibility 一项;Integration Service = [AS] Worker Core Connector IntSys / Define Eligibility*,Business Object = Integration System Worker。
  • Field Overrides 1 item:Field(s) 为 Eligibility criterion,画面释义 Used to determine whether a worker is eligible for inclusion in the integration output. The field should return a boolean value.——它必须返回布尔值。
  • Field Details 用 Override External Field 挂了 Is True(画面标签逐字),也就是先让所有人都有资格进输出。
  • 口播补上生产口径:真实项目要按公司要求圈人(某个组、某个公司),Is True 只是教学用的临时值。
  • 这就是 Worker 与 Location 的第二个差别:Location 没有资格闸门,Worker 不给这一项就跑不起来。

"And this is a mandatory field. And for now, I'm just mentioning it any is true. Or just true. So, whatever is there, it will come. This will pick all the information from Workday."— 这是个强制字段。我现在先随便给一个 Is True,那样有什么就出什么,等于把 Workday 里的信息全取出来。

1:18:50

Worker 的变化报告

Worker 的变化报告
  • HTML 报告里每个员工一个灰底标题条,例如 …is Álvarez Ortiz (21138) [Personal, Status, Position, Photo],方括号里的顺序就是勾选的四个区块。
  • 每段两张列头 Current Value 与 Prior Value (if different):本帧 First Name 一行是黄色(现值 Inés、旧值 Ines),Middle Name 一行是绿色(Maria)——黄改绿增,与前面三色约定完全对上。
  • Eligibility 段的 Current Value 是 true,正是上一步把覆盖值设成 Is True 的结果;Status 段 Hire Date 2000-01-01,Position 段 Effective Date 2011-01-01。
  • Photo 段 Filename 显示 demo_0081.png,而 Image 在这份可读报告里被渲染成 (Binary image data),不在 HTML 里展开。
  • 口播:这份彩色报告在排障时非常省事,一眼就能看出谁改了 middle name;这次没有任何红色行,说明没有删除。

"someone has added the middle name with the yellow with the green color. Someone changed the first name and it's a yellow color."— 有人新增了 middle name,显示成绿色;有人改了 first name,就是黄色。

1:20:45

Worker 输出头部

Worker 输出头部
  • 根节点画面原文:<ws:Worker_Sync xmlns:ws="urn:com.workday/workersync" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">,命名空间与 Location 的 urn:workday.com/connector/locations 不同。
  • <ws:Header> 内可见:<ws:Version>34.0、Prior_Entry_Time、Current_Entry_Time、Prior_Effective_Time、Current_Effective_Time、<ws:Full_File>false、<ws:Document_Retention_Policy>30、<ws:Worker_Count>31。
  • 一个 <ws:Worker> 里依次是 Summary(本帧折叠)、Eligibility>true、Personal>Name_Data>Name_Type/First_Name/Middle_Name、Status>Hire_Date、Position>Operation+Effective_Date、Photo>Filename+Image。
  • Image 的内容直接是一串 base64(画面开头 iVBORw0KGgoAAAANSUhEUg…,即 PNG 的 base64 文本),文件名 demo_m093.png。
  • 口播:文件比 Location 大得多,只有 31 个人但数据量很高;base64 的编解码是在两端做的,Workday 只负责把这串数据给出去。

"It's a bigger file. It's like if you see that uh there are 31 employees, but the data is quite high. And if If see uh on the top, it's always like a header. And then the worker information."— 这个文件大得多:31 名员工,但数据量相当高。顶上永远是一段 header,然后才是 worker 信息。

1:22:50

摘要段与变化标签

摘要段与变化标签
  • Summary 段展开后画面是 <ws:Employee_ID>21136</ws:Employee_ID> 与 <ws:Name>Enrique Castillo Pérez</ws:Name>——工号和姓名在顶部 Summary 先给一份,Personal 段里再按字段拆开给一遍。
  • 本帧被高亮的是 Position 段里的 <ws:Operation>NONE,与 01:08:40 那页 Operation 的释义(ADD / REMOVE / MODIFY / NONE)正好对上,说明这个人这个段这次没有变化。
  • 口播补充规律:position、status、compensation 或 allowance 这些数据段里都会带一个 operation 标签,新增、修改、删除分别对应不同取值,靠它告诉对方怎么处理。
  • 画面上后续还有多个折叠的 <ws:Worker> 与 Summary(如 21137 Villanueva),证明整个文件是 header + 一组 Worker 的扁平结构。
  • 本课收在 Worker 的 summary、personal、status、position,Document Transformation 与 Worker 的投递部分留到下节课。

"In all of the in in the different sections, like a position, uh status section, uh in the compensation or allowance section, you will always find one tag with operation. Operation tag will tell us that either it's a change, it's a modification, it's a new or not."— 在 position、status、compensation 或 allowance 这些不同的段里,你都会看到一个 operation 标签,它告诉你这条是变化、修改、新增,还是没有变化。