About Entity ID in Events

The Entity ID field in all Events is generated automatically, but the fields that are used to generate the values are different for Primary Events and Contributing Events.

The value in the Entity ID field for each Primary Event is unique to all Primary Events that are linked to a given Generation Unit. The Entity ID in Primary Events is generated automatically using the following format:

<Event ID> ~ <Cause Code Description> ~ <Capacity Event Type>

...where:
- <Event ID> is the value in the Event ID field.
- <Cause Code Description> is the value in the Cause Code field.
- <Capacity Event Type> is the value in the Capacity Event Type field.
  
  The value in the Event ID field in Primary Events is generated using the following format:
  
  <Unit ID> ~ <Reporting Year> ~ <Event Number>
  
  ...where:
  - <Unit ID> is the value in the Unit ID field.
  - <Reporting Year> is the value in the Reporting Year field.
  - <Event Number> is the value in the Event Number field. If the value in the Event Number field is fewer than four digits, zeros will be added in front of the value so that the event number in the Event ID field will be four digits.
The value in the Entity ID field in Contributing Events identifies the Primary Event to which the Contributing Event is linked. The values in the Entity ID field in all Contributing Events that are linked to a given Primary Event will match one another. The Entity ID in Contributing Events is generated using the following format:

<Primary Incident ID> ~ <Capacity Event Type> <Cause Code>

...where:
- <Primary Incident ID> is the value in the Primary Incident ID field.
- <Capacity Event Type> is the value in the Capacity Event Type field.

The Primary Incident ID field is populated automatically with the value in the Event ID field in the Primary Event for which the Contributing Event exists. The value in the Primary Incident ID field for all Contributing Events will match the value in the Event ID field in the Primary Event to which they are linked.

For example, suppose the following diagram.

Contributing Event Entity ID

The Entity ID of the first Primary Event begins with GAA Unit ~ 2016 ~ 0001. You can identify the Contributing Event that is linked to this Primary Event because its Entity ID also begins with GAA Unit ~ 2016 ~ 0001.

The Entity ID of the second Primary Event begins with GAA Unit ~ 2016 ~ 0002. This event is linked to two Contributing Events, both of which begin with GAA Unit ~ 2016 ~ 0002, which allows you to determine that both Contributing Events are linked to the second Primary Event.