如何获取工作日工人/员工网络资料 URL？

Posted 2023-02-16

【中文标题】如何获取工作日工人/员工网络资料 URL？

【英文标题】：How to get a Workday worker / employee web profile URL?

【发布时间】：2021-10-01 01:06:23

【问题描述】：

我希望通过 Workday API 检索 Workday 工作人员（又名员工）的 Web 配置文件 URL。用例是我正在构建一个聊天机器人来检索用户信息，并且我希望能够深度链接到工作人员（员工）的网络配置文件。

问题是我不能执行以下任一操作：

从 API 获取网络配置文件 URL 根据 API 中的数据创建网络配置文件 URL

网络配置文件 URL 如下所示。 userId 在 .htmld 扩展名之前看起来像 1234，因为这是员工资料之间唯一变化的数字。

https://www.myworkday.com/myCompany/d/inst/1$715/247$1234.htmld

webUI 中的搜索 URL 返回一个稍微不同的 URL，但最后具有相同的数字 userId，例如1234 之前的 .htmld 在这里：

https://www.myworkday.com/myCompany/d/inst/autocompletesearch/247$1234.htmld

worker API 调用如下所示，带有一个 32 字节的十六进制 workerId，如 deadbeefdeadbeefdeadbeefdeadbeef。在 Web UI 中搜索 API workerId 不会返回任何结果。

https://services1.myworkday.com/ccx/api/api/v1/myCompany/workers/workerId

API 结果没有网络配置文件userId，例如1234，其中任何位置，或可以呈现网页的 URL。

  "id":"deadbeefdeadbeefdeadbeefdeadbeef",
  "descriptor":"Joe Cool",
  "href":"https://services1.myworkday.com/ccx/api/api/v1/myCompany/workers/deadbeefdeadbeefdeadbeefdeadbeef",
  "supervisoryOrganizationsManaged":"https://services1.myworkday.com/ccx/api/api/v1/myCompany/workers/deadbeefdeadbeefdeadbeefdeadbeef/supervisoryOrganizationsManaged",
  "yearsOfService":"1",
  "primaryWorkEmail":"[e-mail]",
  "isManager":false,
  "location":
    "descriptor":"Santa Rosa, California",
    "id":"deadbeefdeadbeefdeadbeefdeadbeef"
  ,
  "primarySupervisoryOrganization":
    "descriptor":"Peanuts (Charles 'Sparky' Schulz)",
    "id":"deadbeefdeadbeefdeadbeefdeadbeef",
    "href":"https://services1.myworkday.com/ccx/api/api/v1/myCompany/supervisoryOrganizations/deadbeefdeadbeefdeadbeefdeadbeef"
  ,
  "businessTitle":"beagle"

谁能帮助提供有关如何从 Workday API 获取网络配置文件 URL 的信息？

【参考方案1】：

它不是一个交付的 REST API，但您可以使用业务对象“来自 Prompt 的工作人员”创建一个 RaaS。有一个名为“Worker Instance URL”的字段。当您调用端点时，您可以使用 WID（工作日 ID）、Employee_ID 或 Contingent_Worker_ID 作为过滤器。

https://wd2-impl-services1.workday.com/ccx/service/customreport2/tenant/reportowner/报告名称?Worker!WID=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx 要么 https://wd2-impl-services1.workday.com/ccx/service/customreport2/tenant/reportowner/report name?Worker!Employee_ID=x

【参考方案2】：

workday API 返回的 ID 实际上是 Workday ID，而不是 Worker ID。 Workday ID 或 WID 是对 Workday 中任何对象的直接引用。这通常称为“集成 ID”。 Workday 没有很好地记录这一点，但是 workday 的 URL 确实有一个有趣的东西，您可以利用它来深度链接到任何 Workday 对象：

https://www.myworkday.com/myCompany/d/inst/sourceReferenceWID/WID.htmld

只要您拥有对象的 Workday ID (WID)，就可以直接进行深度链接。 sourceReferenceWID 仅用于记录目的，因此您可以输入任何您想要的文本。我在自己的租户中对此进行了测试，只是为了好玩，用文本“deeplink”替换了 sourceReferenceWID。对于您的示例，以下 URL 应该适用于 Joe Cool：

https://www.myworkday.com/myCompany/d/inst/deeplink/deadbeefdeadbeefdeadbeefdeadbeef.htmld

这没有正式记录，因此 Workday 可能会改变它的工作方式，您的里程可能会有所不同。