Read

Entries are part of the Atom feed. You can also access them individually using the URL from the entry's link element.

GET /atomservlet/employee/empupdate/EMP300100305842893

Entry Context

Each entry includes the Context section which contains the JSON representation of specific attributes that are common for the feed.

"Context" : [ {
    "PrimaryPhoneNumber" : "",
    "PersonId" : "300100305838925",
    "PersonName" : "Scott Ballard",
    "EffectiveStartDate" : "2017-06-17",
    "EffectiveDate" : "2017-06-27",
    "WorkerType" : "EMP",
    "PeriodType" : "E",
    "PersonNumber" : "960000001002730",
    "WorkEmail" : "[e-mail]"
  } ]

In addition to the standard attributes with information about the subject entity, the DMLOperation attribute denotes the low level data model operation for the given event. It has one of these values:

• INSERT: if a new record is created
• UPDATE: if a record is updated
• DELETE: if a record is deleted

For more information, see the sections about individual feeds.

Changed Attributes

Change-related feeds such as employee/empupdate and employee/empassignment include the Changed Attributes section which contains the change information. The format of this section depends on the type of underlying event and provides old and new values for updates and new or actual values only for other types of events.

Changed Attributes with Old and New Values

"Changed Attributes" : [ {
    "MaritalStatus" : {
      "old" : "S",
      "new" : "M"
    }
  }, {
    "MiddleNames" : {
      "old" : null,
      "new" : "Robert"
    }
  } ]

Changed Attributes with New Values Only

"Changed Attributes" : [ {
      "ActiveStatus" : "A"
  }, {
      "EffectiveEndDate" : "4712-12-31"
  }, {
      "EffectiveStartDate" : "2018-09-04"
  }, {
      "MedCheckupReq" : "N"
  }, {
      "JobId" : "300100174339513"
  }, {
      "JobCode" : "LIUJC01"
  } ]

Flexfields

Entries for feeds that support flexfields also include the FlexFields section, which contains flexfield information and change information about specific flexfield segments. Both descriptive flexfields and extensible flexfields are supported. Changes to descriptive flexfields may be combined with other attributes changes in a single entry. Changes to extensible flexfields always appear as a separate entry. Flexfield information includes flexfield code, optional context code, and additional category code for extensible flexfields.

Similar to the Changed Attribtues section, the change information format of the FlexFields section varies depending on the underlying event and contains either old and new values for updates or actual values only for other types of events. This applies to both descriptive and extensible flexfields.

FlexFields with Old and New Values

"FlexFields" : [ {
  "FlexFieldCode" : "PER_ASG_DF",
  "ContextCode" : null,
  "Changed Attributes" : [ {
    "CustomCategory" : {
      "old" : "10034",
      "new" : "20003"
    }
  }, {
    "JL1Allowance" : {
      "old" : "N",
      "new" : "Y"
    }
  } ]
} ]

FlexFields with New Values Only

"FlexFields" : [ {
  "FlexFieldCode" : "PER_ASSIGNMENT_EIT_EFF",
  "CategoryCode" : "PER_ASG_EIT",
  "ContextCode" : "HDL1",
  "Changed Attributes" : [ {
    "InformationType" : "HDL1"
    }, {
      "EffectiveSequence" : "1"
    }, {
      "AssignmentId" : "300100078739531"
    }, {
      "EffectiveLatestChange" : "Y"
    }, {
      "hdl1" : "active"
    }, {
      "AeiInformationCategory" : "HDL1"
    }, {
      "AssignmentExtraInfoId" : "300100181590279"
    }, {
      "hdl1Num" : "23"
  } ]
} ]

Resource Links

If applicable, the feed entry also contains a link to the related REST resource to which the entry pertains. You can follow this link to get more information about the business object in the entry.

<link href="https://<host>:<port>/hcmRestApi/resources/11.13.18.05/locations?q=LocationId=300100234235270&effectiveDate=2020-05-12" rel="related"></link>

In certain cases, multiple links can be provided. You can distinguish between the links by examining their reltype attribute.

<link href="https://<host>:<port>/hcmRestApi/resources/11.13.18.05/emps?q=PersonId=300100305838925&effectiveDate=2020-05-12" rel="related" reltype="emps"></link>
<link href="https://<host>:<port>/hcmRestApi/resources/11.13.18.05/workers?q=PersonId=300100305838925&effectiveDate=2020-05-12" rel="related" reltype="workers"></link>

Character Data Support

You can view special characters in the Oracle HCM Cloud Atom feeds title, summary, and content. The Character DATA or CDATA tag is used to encode special characters in the feed attributes. This tag allows the feeds to display special characters including multi-byte characters and language characters that can be handled by XML parsers, without any parser errors in your integrations.