Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Data Source:  Workday (roles) / People Hub (identifiers/name)

This service will query for an organization or multiple organizations and provide you with the roles associated. The XML/JSON response will be by person, not by role or org. For each distinct role+employee match, there will be 1 <Role> loop. For example, employee 10780 has 3 roles in the same Cost Center, so he will come as 3 <Role> nodes, 1 for each role he has.


GetRoles Service Contract: GetRoles_v1.xlsx

...

https://gw.its.yale.edu/soa-gateway/COAHub/v1/GetRoles

...


Parameters: These can be added in any amount, all can be used, just one, or any combination of them. However, at least 1 parameter value must be used for this service. To use multiple parameters place "&" in between the parameter names. If you are restricted to which Roles you may see you must pass the "Role" value. If you are restricted to a role type Ex. SUPERVISORY, you must pass type value.

...

You may send this parameter with any set of options to receive the response in json instead of XML:

outputformat=json

...


Examples:

Batch for Cost Center (limit by org type)-

...

https://gw-dev.its.yale.edu/soa-gateway/COAHub/v1/GetRoles?role=Cost Center Manager&netid=cf394

...


Example XML:

Code Block
languagexml
titleExample Response
<Roles>
   <Header>
      <Version>1.0</Version>
      <Count>134</Count>
   </Header>
   <Role>
      <Cd>CC0501</Cd>
      <Nm>FASPHY Physics Research Unit</Nm>
      <Inactive>0</Inactive>
      <Type>COST_CENTER</Type>
      <RoleID>Cost_Center_Financial_Analyst</RoleID>
      <RoleNm>Cost Center Financial Analyst</RoleNm>
      <WorkerNm>Fagan, Pauline A</WorkerNm>
      <EmpID>4504</EmpID>
      <NETID>pfagan</NETID>
      <UPI>10075276</UPI>
      <Email>pauline.fagan@yale.edu</Email>
      <LoadDt>2017-05-18</LoadDt>
   </Role>
</Roles>

...