# ShadowCorrelationStateType (Complex Type)

### Namespace: http://midpoint.evolveum.com/xml/ns/public/common/common-3

Current state of the correlation process. This container is reset when a correlation starts, so data from (any) previous correlations are not mixed with the data about the current one.

Item Summary
Name | Type | Multiplicity | Description
--- | --- | --- | ---
correlationStartTimestamp | property dateTime | [0,1] | When did the (last) correlation of this shadow start.
correlationEndTimestamp | property dateTime | [0,1] | When did the (last) correlation of this shadow end.
correlationCaseOpenTimestamp | property dateTime | [0,1] | When was the correlation case opened.
correlationCaseCloseTimestamp | property dateTime | [0,1] | When was the correlation case closed.
performerRef | reference ObjectReferenceType | [0,-1] | Reference to the user(s) that performed the correlation - if known.
performerComment | property string | [0,-1] | Comments of the user(s) during the correlation of the data.
situation | property CorrelationSituationType | [0,1] | What was the resulting situation of the correlation? (uncertain, ownerFound, noOwner)
ownerOptions | container ResourceObjectOwnerOptionsType | [0,1] | Options for object owner, if any were found.
resultingOwner | reference ObjectReferenceType | [0,1] | The owner as determined by the correlation.
correlatorState | container AbstractCorrelatorStateType | [0,1] | State of the specific correlator that has been used.

- ### Items

  - #### correlationStartTimestamp

    Flags: RAM,runtime

    Multiplicity: [0,1]

    When did the (last) correlation of this shadow start.

  - #### correlationEndTimestamp

    Flags: RAM,runtime

    Multiplicity: [0,1]

    When did the (last) correlation of this shadow end. The "end" means that the correlation came to a definite conclusion: it either found an owner or determined that there is none. (I.e. coming to the state of "disputed" is not considered to be the end of a correlation.)

  - #### correlationCaseOpenTimestamp

    Flags: RAM,runtime

    Multiplicity: [0,1]

    When was the correlation case opened. (If any.)

  - #### correlationCaseCloseTimestamp

    Flags: RAM,runtime

    Multiplicity: [0,1]

    When was the correlation case closed. (If any case is present, and if it was closed.)

  - #### performerRef

    Flags: RAM

    Multiplicity: [0,-1]

    Reference to the user(s) that performed the correlation - if known. Currently, we include only performers that have provided the same outcome as was the final one. (TODO: is this ok?)

  - #### performerComment

    Flags: RAM,runtime

    Multiplicity: [0,-1]

    Comments of the user(s) during the correlation of the data. Note that these comments are in no particular order, so basically it is not known who entered which comment.

  - #### situation

    Flags: RAM,runtime,AVals:4

    Multiplicity: [0,1]

    What was the resulting situation of the correlation? (uncertain, ownerFound, noOwner)

  - #### ownerOptions

    Flags: RAM,runtime

    Multiplicity: [0,1]

    Options for object owner, if any were found. If present, the correlation is not complete.

  - #### resultingOwner

    Flags: RAM

    Multiplicity: [0,1]

    The owner as determined by the correlation. Null if the correlation is not yet complete, or if it concluded that no owner exists.

  - #### correlatorState

    Flags: RAM,runtime

    Multiplicity: [0,1]

    State of the specific correlator that has been used.