如何通过Kronos Workforce Central XML API向组织集添加职位？

我之前也踩过这个坑！Kronos的API文档有时候确实容易让人混淆，UpdateEntryList和AddEntries的组合确实不被支持，得换个正确的调用方式才行。

正确的API调用方式 #

要向组织集添加职位，你需要把<OrgSet>的Action设置为AddEntryList，而不是UpdateEntryList。AddEntryList是Kronos专门用于批量向组织集添加新条目的操作，完美匹配你的需求。

示例XML请求代码 #

<Kronos_WFC version="1.0">
  <Request Action="Submit">
    <!-- 替换成你的目标组织集名称 -->
    <OrgSet OrgSetName="Sales Team Positions" Action="AddEntryList">
      <!-- 第一个要添加的职位 -->
      <OrgSetEntry>
        <Position>
          <PositionName>Senior Sales Rep</PositionName>
          <!-- 可选：关联职位所属部门 -->
          <Department>
            <DepartmentName>North America Sales</DepartmentName>
          </Department>
        </Position>
      </OrgSetEntry>
      <!-- 第二个要添加的职位（支持批量添加） -->
      <OrgSetEntry>
        <Position>
          <PositionName>Sales Coordinator</PositionName>
        </Position>
      </OrgSetEntry>
    </OrgSet>
  </Request>
</Kronos_WFC>

几个关键注意事项 #

• 权限验证：确保你的API调用账号拥有组织集编辑、职位管理的相关权限，否则会返回权限不足的错误。
• 名称准确性：<OrgSetName>和<PositionName>必须和Kronos系统内的名称完全一致，Kronos对大小写和空格是敏感的。
• 单条添加可选：如果只需要添加单个职位，也可以把Action改成AddEntry，并去掉多余的<OrgSetEntry>节点。
• 扩展属性支持：如果职位需要关联成本中心、地点等属性，直接在<Position>节点下添加对应的子元素即可（比如<CostCenter><CostCenterName>US-East-Cost</CostCenterName></CostCenter>）。

之前你用UpdateEntryList报错，是因为这个操作是用来修改组织集里已有的条目（比如更新职位的关联信息），而不是添加新条目，所以和AddEntries的逻辑冲突了。换成AddEntryList就能解决问题啦！

内容的提问来源于stack exchange，提问作者Stevoisiak