c# - 我如何与 Kronos API 通信？

Question

我有一个 Kronos入口点 http://kronos../wfc/XmlService我应该可以访问，但是当我在浏览器中打开它时，响应是:

<Kronos_WFC>
<Response Status="Failure" ErrorCode="1332" Message="WFP-01110 The MIME type of the request is invalid. Type Found: . Valid types: text/xml, application/xml."></Response>
</Kronos_WFC>

我应该如何使用网络服务？

顺便说一下，我正在使用 C# 与服务器通信。

Answer 1

您可以使用 XML POST 请求与 Kronos API 通信。

WFC v5.0 Developer's Toolkit Programmer's Guide ¹ 提供了使用各种语言与 Kronos API 进行通信的通用指南。第一章介绍 XML API，即所有 API 请求的发送方式。

Logon Request

Kronos WFC 的标准 XML 登录请求。这必须在任何其他请求之前首先发送。

<Kronos_WFC version="1.0">
  <Request Object="System" Action="Logon" Username="ValidUsername" Password="ValidPassword"/>
</Kronos_WFC>

响应:

<Kronos_WFC version="1.0" TimeStamp="11/15/2017 3:35PM GMT-05:00">
    <Response Status="Success" Timeout="1800" PersonKey="123456" Object="System" Username="ValidUsername" Action="Logon" PersonNumber="112233">
    </Response>
</Kronos_WFC>

注销请求

此注销请求将结束您的事件 Kronos session 。

<Kronos_WFC version="1.0">
  <Request Object="System" Action="Logoff"/>
</Kronos_WFC>

支付期总请求

此请求加载 2017 年 10 月 20 日至 2017 年 10 月 27 日期间员工 12345 的工资期总计。

<Kronos_WFC version="1.0">
  <Request Action="Load">
    <Timesheet>
      <Employee>
        <PersonIdentity PersonNumber="12345"/>
      </Employee>
      <Period>
        <TimeFramePeriod PeriodDateSpan="10/20/2017 - 10/27/2017"/>
      </Period>
    </Timesheet>
  </Request>
</Kronos_WFC>

可以在 Workforce Timekeeping Developer Toolkit Reference Guide 中找到完整的 Kronos API 标签列表(需要登录)。

---

您发送 POST 请求的方法可能因您使用的语言而异。但是，XML 请求格式和 API 入口点 ( <ServerName>/wfc/XmlService ) 应该适用于所有语言。

下面是一个用于发送 Kronos 登录请求的 Python 3 脚本示例:

import requests

url = "http://localhost/wfc/XmlService"
headers = {'Content-Type': 'text/xml'}
data = """<Kronos_WFC version = "1.0">
              <Request Object="System" Action="Logon" Username="SomeUsername" Password="SomePassword"/>
          </Kronos_WFC>"""

# Login to Kronos and print response
session = requests.Session()  # preserve login cookies across requests
response = session.post(url, data=data, headers=headers)
print(response.text)

WFC 开发人员工具包程序员指南的第 2 章包含使用 Java 和 Visual Basic 发送 XML 请求的示例。但是，我建议查看更新的 XML 或 HTTP 请求库，该库特定于您使用的任何语言。

---

有用的资源

• Workforce Timekeeper v8.0.16 Developer's Toolkit Reference Guide(需要登录)
• WFC v5.0 Developer's Toolkit Programmer's Guide
• Documentation and Service Packs for Kronos Products(需要登录)
• WFC-API.js - JavaScript for sending XML requests to WFC API
• TimeCardView - Open source web UI to the Kronos API
• Kronos Community Forums

脚注:

_{1:引用的文档最初是为 Kronos WFC 5.0 (API 1.0) 编写的。虽然以后的版本应该使用相同的 API，但我不能保证其他版本的准确性。 (参见 XML API version 6.3 to 8.0 upgrade)}