Item Summary
Name	Type	Multiplicity	Description
name	property PolyStringType	[0,1]	Human-readable, mutable name of the object.
description	property string	[0,1]	Free-form textual description of the object.
documentation	property string	[0,1]	AsciiDoc-formatted technical documentation of the object.
subtype	property string	[0,-1]	Type of the object.
fetchResult	property OperationResultType	[0,1]	Result of the operation that fetched this instance of the object.
extension	container ExtensionType	[0,1]	Extension container that provides generic extensibility mechanism.
parentOrgRef	reference ObjectReferenceType	[0,-1]	Set of the orgs (organizational units, projects, teams) that the object relates to.
trigger	container TriggerType	[0,-1]	Triggers for this object.
metadata	container MetadataType	[0,1]	Meta-data about object creation, modification, etc.
tenantRef	reference ObjectReferenceType	[0,1]	Reference to the tenant to which this object belongs.
lifecycleState	property string	[0,1]	Lifecycle state of the object.
operationExecution	container OperationExecutionType	[0,-1]	Description of recent operations executed on this object (or related objects in special cases).
lensContext	container LensContextType	[0,1]	Model context describing executed operation
policySituation	property anyURI	[0,-1]	The policy situation(s) of this object.
triggeredPolicyRule	property EvaluatedPolicyRuleType	[0,-1]	Triggered policy rules for this object.
policyException	container PolicyExceptionType	[0,-1]	Recorded exception from a policy rule.
diagnosticInformation	property DiagnosticInformationType	[0,-1]	Diagnostic information attached to this object.
indestructible	property boolean	[0,1]	Protection against accidental deletion.
effectiveMarkRef	reference ObjectReferenceType	[0,-1]	Object marks assigned to the shadow.
policyStatement	container PolicyStatementType	[0,-1]	Policy statements to manually add or exclude effective marks of shadow.
effectiveOperationPolicy	container ObjectOperationPolicyType	[0,1]	Effective provisioning policy derived from Shadow marks and resource configuration.
resourceRef	reference ObjectReferenceType	[0,1]	Reference to a resource that this resource object shadow belongs to.
shadowLifecycleState	property ShadowLifecycleStateType	[0,1]	The state in the shadow lifecycle.
purpose	property ShadowPurposeType	[0,1]	Purpose for existence (or non-existence) of a resource object referenced by the shadow.
dead	property boolean	[0,1]	Description of operation during the processing of account failed.
deathTimestamp	property dateTime	[0,1]	When we learned about the fact that the shadow is dead? The reason behind this property is to be able to distinguish "freshly dead" shadows so that full synchronization may be invoked if this timestamp is after fullSynchronizationTimestamp.
pendingOperation	container PendingOperationType	[0,-1]	Description of an operation which execution is pending for this shadow.
synchronizationSituation	property SynchronizationSituationType	[0,1]	The most recent synchronization situation.
synchronizationTimestamp	property dateTime	[0,1]	The timestamp of the most recent synchronization.
fullSynchronizationTimestamp	property dateTime	[0,1]	The timestamp of the most recent full synchronization.
synchronizationSituationDescription	property SynchronizationSituationDescriptionType	[0,-1]	Complex description of synchronization situations.
correlation	container ShadowCorrelationStateType	[0,1]	State of the shadow correlation process.
objectClass	property QName	[0,1]	The reference to a type definition for this object.
primaryIdentifierValue	property string	[0,1]	Value of the primary (unique) identifier; converted to a string if it's of a different type.
auxiliaryObjectClass	property QName	[0,-1]	The reference to additional type definitions for this object.
kind	property ShadowKindType	[0,1]	Kind of a shadow.
intent	property string	[0,1]	The intended usage type or purpose of the object.
tag	property string	[0,1]	Tag value used to discriminate multiple accounts that have the same resource+kind+intent combination.
protectedObject	property boolean	[0,1]	Protected shadows cannot be changed.
ignored	property boolean	[0,1]	Ignored shadows will not be processed during synchronization.
assigned	property boolean	[0,1]	Set to true if the object is "legally" assigned, i.
exists	property boolean	[0,1]	Set to true if the object is known to exist on the resource.
iteration	property int	[0,1]
iterationToken	property string	[0,1]
attributes	container ShadowAttributesType	[0,1]	Attributes of this shadow.
referenceAttributes	container ShadowReferenceAttributesType	[0,1]	Reference attributes.
associations	container ShadowAssociationsType	[0,1]	Associations of this shadow.
association	container ShadowAssociationType	[0,-1]	Legacy associations of this shadow.
activation	container ActivationType	[0,1]	TODO For more details see the ActivationType documentation.
credentials	container CredentialsType	[0,1]	The set of account credentials (such as passwords).
cachingMetadata	property CachingMetadataType	[0,1]	The shadow is essentially a bunch of metadata and cached data about the actual resource object.
contentDescription	property ShadowContentDescriptionType	[0,1]	Describes the content of the shadow, mainly regarding the source (repository / resource), plus other limitations.
behavior	container ShadowBehaviorType	[0,1]	Shadow behavioral data.

Items
- name
  
  Flags: RAM,runtime
  
  Multiplicity: [0,1]
  
  Human-readable, mutable name of the object. It may also be an identifier (login name, group name). It is usually unique in the respective context of interpretation. E.g. the name of the UserType subtype is usually unique in the whole system. The name of the ShadowType subtype is usually unique in the scope of resource (target system) that it belongs to.
  
  The name may not be human-readable in a sense to display to a common end-user. It is intended to be displayed to IDM system administrator. Therefore it may contain quite a "ugly" structures such as LDAP DN or URL.
  
  Name is mutable. It is considered to be ordinary property of the object. Therefore it can be changed by invoking usual modifyObject operations. However, change of the name may have side effects (rename process).
  
  Although name is specified as optional by this schema, it is in fact mandatory for most object types. The reason for specifying the name as optional is that the name may be generated by the system instead of supplied by the clients. However, all objects stored in the repository must have a name.
- description
  
  Flags: RAM,runtime
  
  Multiplicity: [0,1]
  
  Free-form textual description of the object. This is meant to be displayed in the user interface.
- documentation
  
  Flags: RAM,runtime
  
  Multiplicity: [0,1]
  
  AsciiDoc-formatted technical documentation of the object.
- subtype
  
  Flags: RAM,runtime
  
  Multiplicity: [0,-1]
  
  Type of the object. It is used to distinguish what a specific object represents. Whether it is a different kind of organizational unit, project, team, or different kind of user, etc.
- fetchResult
  
  Flags: RAM,runtime,oper
  
  Multiplicity: [0,1]
  
  Result of the operation that fetched this instance of the object. It is mostly used to indicate that the object is not complete or there is some problem with the object. This is used instead of exception if the object is part of larger structures (lists as in list/search operations or composite objects). If not present then the "SUCCESS" state is assumed.
  
  This field is TRANSIENT. It must only be used in runtime. It should never be stored in the repository.
- extension
  
  Flags: RAM,runtime
  
  Multiplicity: [0,1]
  
  Extension container that provides generic extensibility mechanism. Almost any extension property can be placed in this container. This mechanism is used to extend objects with new properties. The extension is treated exactly the same as other object properties by the code (storage, modifications, etc), except that the system may not be able to understand their meaning.
- parentOrgRef
  
  Flags: RAM,oper
  
  Multiplicity: [0,-1]
  
  Set of the orgs (organizational units, projects, teams) that the object relates to. This usually means that the object belongs to them but it may have other meanings as well (e.g. user manages an organizational unit).
- trigger
  
  Flags: RAM,runtime,oper
  
  Multiplicity: [0,-1]
  
  Triggers for this object. They drive invocations of corresponding trigger handlers at specified time.
- metadata
  
  Flags: RAM,runtime,oper
  
  Multiplicity: [0,1]
  
  Meta-data about object creation, modification, etc.
- tenantRef
  
  Flags: RAM,oper
  
  Multiplicity: [0,1]
  
  Reference to the tenant to which this object belongs. It is a computed value set automatically by midPoint. It is determined from the organizational structure. Even though this value is computed it is also stored in the repository due to performance reasons.
- lifecycleState
  
  Flags: RAM,runtime
  
  Multiplicity: [0,1]
  
  Lifecycle state of the object. This property defines whether the object represents a draft, proposed definition, whether it is active, deprecated, archived, and so on. See "Object Lifecycle" in the documentation.
- operationExecution
  
  Flags: RAM,runtime,oper
  
  Multiplicity: [0,-1]
  
  Description of recent operations executed on this object (or related objects in special cases). The number of operations to be kept here is configurable.
- lensContext
  
  Flags: RAM,runtime
  
  Multiplicity: [0,1]
  
  Model context describing executed operation
- policySituation
  
  Flags: RAM,runtime,oper
  
  Multiplicity: [0,-1]
  
  The policy situation(s) of this object. The situations are result of evaluation of the policy rules. This property is recorded for each object and can be used for reporting, diagnostics, target selection in certification campaigns, etc.
- triggeredPolicyRule
  
  Flags: RAM,runtime,oper
  
  Multiplicity: [0,-1]
  
  Triggered policy rules for this object. (Not necessarily complete; subject to specified storage strategy.) This is EXPERIMENTAL functionality. It is possibly to change in the near future.
- policyException
  
  Flags: RAM,runtime
  
  Multiplicity: [0,-1]
  
  Recorded exception from a policy rule. The exceptions that are approved are recoded here to avoid re-evaluating and re-approving them all the time. This is EXPERIMENTAL functionality. It is likely to change in the near future.
- diagnosticInformation
  
  Flags: RAM,runtime
  
  Multiplicity: [0,-1]
  
  Diagnostic information attached to this object.
- indestructible
  
  Flags: RAM,runtime
  
  Multiplicity: [0,1]
  
  Protection against accidental deletion. If set to true then this object cannot be deleted. If the object needs to be deleted then it has to be modified first to reset this flag.
- effectiveMarkRef
  
  Flags: RAM
  
  Multiplicity: [0,-1]
  
  Object marks assigned to the shadow. When stored in the repository, this includes appied policy statements.
- policyStatement
  
  Flags: RAM,runtime
  
  Multiplicity: [0,-1]
  
  Policy statements to manually add or exclude effective marks of shadow.
- effectiveOperationPolicy
  
  Flags: RAM,runtime
  
  Multiplicity: [0,1]
  
  Effective provisioning policy derived from Shadow marks and resource configuration. Currently supported for shadows only. Transient: not stored in the repository.
- resourceRef
  
  Flags: RAM
  
  Multiplicity: [0,1]
  
  Reference to a resource that this resource object shadow belongs to.
- shadowLifecycleState
  
  Flags: RAM,runtime,AVals:7
  
  Multiplicity: [0,1]
  
  The state in the shadow lifecycle. Always related to the current point of time, regardless of the point-in-time setting in get/search operation options. (E.g. an account retrieved with the point-in-time = future that has a pending DELETE operation will be returned with dead=true, but shadowLifecycleState will be reaping.) Currently TRANSIENT, i.e. it is not stored in the repository.
- purpose
  
  Flags: RAM,runtime,AVals:2
  
  Multiplicity: [0,1]
  
  Purpose for existence (or non-existence) of a resource object referenced by the shadow. E.g. it specifies whether the resource object is fully operational, whether it is not completely prepared yet, it may indicate why we are keeping the resource object instead of deleting it, and so on. It can be thought of as a "business lifecycle", specifying the reason for this object or shadow. This information is maintained by midPoint, it is not directly projected to the resource. This information supplements the resource object data, it keeps additional information that the resource does not have. It is different from shadowLifecycleState, as shadowLifecycleState specifies the technical state in which resource object is (e.g. not created yet, not deleted yet). On the other hand, purpose represents the business information, the reason or intention that we have with the object. For example, "incomplete" purpose describes an account that is technically in a perfect shape, technically fully operation, yet user is not able to use that account yet. This is also different from the regular lifecycleState. The lifecycleState of a shadow is meant to be reflected directly to resource object. E.g. lifecycleState of a shadow should be taken from lifecycle state of account, from one of its attributes (similarly to administrativeStatus). On the other hand, "purpose" is an information kept only by midPoint, not directly synchronized to the resource. The "purpose" will work for all resources, regardless of whether they support lifecycle state (and its fidelity), activation or any other details.
- dead
  
  Flags: RAM,runtime
  
  Multiplicity: [0,1]
  
  Description of operation during the processing of account failed.
- deathTimestamp
  
  Flags: RAM,runtime
  
  Multiplicity: [0,1]
  
  When we learned about the fact that the shadow is dead? The reason behind this property is to be able to distinguish "freshly dead" shadows so that full synchronization may be invoked if this timestamp is after fullSynchronizationTimestamp. (In the future, though, we should make synchronization reactions more "declarative" so that all dead shadows could be synchronized. But that is a longer-term plan.)
- pendingOperation
  
  Flags: RAM,runtime
  
  Multiplicity: [0,-1]
  
  Description of an operation which execution is pending for this shadow. This may be asynchronous operation in progress. E.g. operation that has to be manually completed by human operator. It may also be operation that could not be completed because there was a temporary error while communicating with the resource. There may be also operations that are in fact already executed, but we have not yet received the feedback. Or operations that are executed but are still kept in the shadow for review by midPoint administrator.
- synchronizationSituation
  
  Flags: RAM,runtime,AVals:5
  
  Multiplicity: [0,1]
  
  The most recent synchronization situation. Regardless of the channel. This simple enumeration property is used for (indexed) search of shadows in certain situation. It does not provide any further details. More details can be found in the "synchronizationSituationDescription" property.
- synchronizationTimestamp
  
  Flags: RAM,runtime
  
  Multiplicity: [0,1]
  
  The timestamp of the most recent synchronization. Regardless of the channel or result. It does not provide any further details. More details can be found in the "synchronizationSituationDescription" property.
- fullSynchronizationTimestamp
  
  Flags: RAM,runtime
  
  Multiplicity: [0,1]
  
  The timestamp of the most recent full synchronization. Regardless of the channel or result. It does not provide any further details. More details can be found in the "synchronizationSituationDescription" property.
- synchronizationSituationDescription
  
  Flags: RAM,runtime
  
  Multiplicity: [0,-1]
  
  Complex description of synchronization situations. This is multi-valued property and it should store only a single value for each channel (the most recent one). All the older values should be removed on each update.
- correlation
  
  Flags: RAM,runtime
  
  Multiplicity: [0,1]
  
  State of the shadow correlation process. It contains statistical data (e.g. start/end timestamps), result of the (last) correlation - determined situation, candidate owner(s), performer OIDs and their comments - as well as correlator-specific data, like ID Match request and reference IDs. Relevance of the data: The data are deleted when the new correlation process starts after the previous one ended. This fact is determined by checking that the correlationEndTimestamp (set by the previous correlation process) has a non-null value. However, until that time, we must keep the data intact. For example, ID Match correlation typically uses correlatorState/referenceId property as a kind of unique user identifier that is to be used in an inbound mapping.
- objectClass
  
  Flags: RAM,runtime
  
  Multiplicity: [0,1]
  
  The reference to a type definition for this object. The reference should point to the object class definition (complex type definition in resource schema). The attributes contained in the "attributes" element below are expected to comply with the type definition specified in this element (with addition of auxiliary object class definitions). Formally, minOccurs is 0 here but unless a reasonable default is provided, the value must be present.
- primaryIdentifierValue
  
  Flags: RAM,runtime
  
  Multiplicity: [0,1]
  
  Value of the primary (unique) identifier; converted to a string if it's of a different type.
- auxiliaryObjectClass
  
  Flags: RAM,runtime
  
  Multiplicity: [0,-1]
  
  The reference to additional type definitions for this object. The reference should point to object class definition (complex type definition in resource schema) and this definition should be marked as auxiliary. The attributes contained in the "attributes" element below are expected to comply with the type definition specified in the objectClass element merged with definitions specified in this element.
- kind
  
  Flags: RAM,runtime,AVals:5
  
  Multiplicity: [0,1]
  
  Kind of a shadow. This means the type of shadow use. E.g. an account, entitlement, etc.
- intent
  
  Flags: RAM,runtime
  
  Multiplicity: [0,1]
  
  The intended usage type or purpose of the object. E.g. for accounts it may be "user", "admin", "test".
- tag
  
  Flags: RAM,runtime
  
  Multiplicity: [0,1]
  
  Tag value used to discriminate multiple accounts that have the same resource+kind+intent combination.
- protectedObject
  
  Flags: RAM,runtime
  
  Multiplicity: [0,1]
  
  Protected shadows cannot be changed. They are out of IDM control. This is only informational property. Changing it will have no effect on whether object is protected or not. Object protection is a strict policy that cannot be easily overridden. This is "virtual" property. It is not stored in the repository.
- ignored
  
  Flags: RAM,runtime
  
  Multiplicity: [0,1]
  
  Ignored shadows will not be processed during synchronization.
- assigned
  
  Flags: RAM,runtime
  
  Multiplicity: [0,1]
  
  Set to true if the object is "legally" assigned, i.e. if there is a valid assignment for this object. It shows the value from the last recompute of the object.
- exists
  
  Flags: RAM,runtime
  
  Multiplicity: [0,1]
  
  Set to true if the object is known to exist on the resource. There may be shadows for objects that do not exist yet (e.g. create operations in progress) or shadows for objects that we know nothing about yet.
- iteration
  
  Flags: RAM,runtime
  
  Multiplicity: [0,1]
- iterationToken
  
  Flags: RAM,runtime
  
  Multiplicity: [0,1]
- attributes
  
  Flags: RAM,runtime
  
  Multiplicity: [0,1]
  
  Attributes of this shadow. The exact form depends on the context: 1. For resource-level shadows, both simple and reference attributes are here. 2. For model-level shadows, the simple attributes are here, and MAYBE the reference ones as well. (After they were converted into associations.) 3. For repository-level shadows, only the simple attributes are here. The reference ones are moved (at least for now) into "referenceAttributes" container.
- referenceAttributes
  
  Flags: RAM,runtime
  
  Multiplicity: [0,1]
  
  Reference attributes. Present only in the repository-level shadows.
- associations
  
  Flags: RAM,runtime
  
  Multiplicity: [0,1]
  
  Associations of this shadow. Present only in model-level shadows.
- association
  
  Flags: RAM,runtime
  
  Multiplicity: [0,-1]
  
  Legacy associations of this shadow. Not used anymore.
- activation
  
  Flags: RAM,runtime
  
  Multiplicity: [0,1]
  
  TODO For more details see the ActivationType documentation.
- credentials
  
  Flags: RAM,runtime
  
  Multiplicity: [0,1]
  
  The set of account credentials (such as passwords).
- cachingMetadata
  
  Flags: RAM,runtime
  
  Multiplicity: [0,1]
  
  The shadow is essentially a bunch of metadata and cached data about the actual resource object. This caching metadata structure describes when the cached data were retrieved - therefore how fresh they are.
- contentDescription
  
  Flags: RAM,runtime,oper,AVals:5
  
  Multiplicity: [0,1]
  
  Describes the content of the shadow, mainly regarding the source (repository / resource), plus other limitations. Transient property, not to be stored in the repository.
- behavior
  
  Flags: RAM,runtime
  
  Multiplicity: [0,1]
  
  Shadow behavioral data. In a more specific meaning: behavioral data of an agent (user or system), usually represented in midPoint by shadow. This data structure records informational data about the agent's behavior, such as authentications, interaction with external systems and so on. Such data are inherently _observed_, e.g. they are not configured by the user.

ShadowType (Object Definition)

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

Items