Deprecated items

Last modified 06 Sep 2023 10:49 +02:00
Since 4.8
This functionality is available since version 4.8.
Table of Contents

Following table lists deprecated elements and types that currently exist in midPoint XSD schemas. Table data from upgrade fields will be used as input for upgrade process.

Table 1. Deprecated items
File Element owner Element name Element type Planned removal Implementation priority [1 (low) - 5 (high)] Notes Automatic migration ideas Responsible Schema change identifier Upgrade phase Upgrade type Upgrade priority Analysis done (Prepared for implementation. Yes/No)

capabilities-3.xsd

CapabilityCollectionType

addRemoveAttributeValues

AddRemoveAttributeValuesCapabilityType

Removed.

Deprecated in 4.0 by fab755d8. Removed in 4.8 by 8038b70f.

The element was replaced by addRemoveAttributeValues property of update capability.

For configured capabilities, the update capability has to be modified according to the addRemoveAttributeValues content.

For native capabilities, the situation is most probably OK (as the old-style capability stopped to be produced in 4.0), but for sure, one should refresh the capabilities. Or, the migration tool can do the same operation as for configured capabilities.

Pavol

  • AddRemoveAttributeValues 4.4

  • AddRemoveAttributeValues 4.7

  • AddRemoveAttributeValues 4.8

Before upgrade

Automatic if implemented.

Critical

Analyzed and removed from the schema. Done.

common-case-management-3.xsd

CaseType

taskRef

tns:ObjectReferenceType

Removed (not used anymore).

This item was used to bind approval cases and their execution tasks. It was maintained by midPoint only, never set manually. It is no longer used. So, it was now simply dropped from the schema, without any replacement.

Introduced in 4.0. Marked as deprecated in 4.0.3/4.1. See e1b6fb81. Removed in 4.8 by 861b6d9a.

Any data in that item can be safely discarded.

Pavol

  • CaseTaskRef 4.4

  • CaseTaskRef 4.7

  • CaseTaskRef 4.8

N/A

Automatic.

N/A

Analyzed and removed from the schema. Done.

common-core-3.xsd

OtherPrivilegesLimitationType

approvalWorkItems

c:WorkItemSelectorType

Used to limit delegated privileges related to approval work items. In both 4.4 and 4.7, it is incorrectly used in the code: Although only caseManagementWorkItems should be used, both caseManagementWorkItems and approvalWorkItems are used by mistake. (At different places, with caseManagementWorkItems mostly ignored.)

Introduced in 3.6. Marked as deprecated in 4.0 by 6326a7cb.

The new style is consistently used only after c9f3fec9 (4.8). So, I think that we cannot remove the old style, because if the user switched to the new style in 4.4 and 4.7, things would break for him.

Processor in 4.4/4.7 does nothing, just reports a warning. Processor in 4.8 does the migration.

The migrator should treat approvalWorkItems as a default value for caseManagementWorkItems.

Pavol

  • ApprovalWorkItems 4.4

  • ApprovalWorkItems 4.7

  • ApprovalWorkItems 4.8

After upgrade.

Automated if implemented.

Optional.

common-core-3.xsd

ReportDataType

data

xsd:string

Full data of the report.

Still needed, so I un-deprecated it.

N/A

Pavol

  • ReportData 4.4

  • ReportData 4.7

  • N/A 4.8

N/A

N/A

N/A

common-core-3.xsd

defaultAssignmentConstraints

tns:AssignmentConstraintsType

4.8

It was deprecated with new request access UI. Is this still needed? There’s currently no replacement for this? Deprecation was removed

Vilo

  • N/A 4.4

  • N/A 4.7

  • N/A 4.8

common-core-3.xsd

RoleManagementConfigurationType

defaultCollection

tns:ObjectCollectionUseType

4.8

Configuration was moved to adminGuiConfiguration/accessRequest/roleCatalog/collection. Eg. systemConfiguration/roleManagement/defaultCollection/collectionUri → systemConfiguration/adminGuiConfiguration/accessRequest/roleCatalog/collection/identifier RoleCollectionViewType.default should be set to true.

code/schema cleanup commit 0e7a0554 KINDA PROBLEM: this is not deprecated in 4.4, objet validator/upgrade before not possible, only afterwards - meaning user will not know before upgrade that this has to be upgraded.

Kate

  • TODO in 4.4

  • RoleManagementDefaultCollection 4.7

  • RoleManagementDefaultCollection 4.8

  • After 4.4

  • Before 4.7

  • Before 4.8

Automatic

Necessary

Analyzed and removed from the schema.

common-core-3.xsd

CleanupPoliciesType

objectResults

tns:CleanupPolicyType

Removed.

Deprecated in 4.3 by 26044356. Removed in 4.8 by df9d41d4.

The value of objectResults served as a default for both simpleOperationExecutions and complexOperationExecutions. See the code.

Take the value. If simpleOperationExecutions is not specified, set it to the value. If complexOperationExecutions is not specified, set it to the value.

Pavol

  • CleanupPolicy 4.4

  • CleanupPolicy 4.7

  • CleanupPolicy 4.8

Before upgrade

Automatic if implemented.

Not critical.

If not done, the information will disappear and system-wide default value of keeping 5 records is applied. See the code.

Yes

common-core-3.xsd

oidBound

xsd:boolean

4.9

This property was introduced in 2014 by 2d71af12. It was marked as deprecated in that very commit. The discussion with Radovan revealed that this is just a workaround for not knowing focus OID when mappings are evaluated. (For new objects, i.e. ADD operations.) Since 4.8, midPoint generates focus OID before the operation, so that it can be used in the mappings like any other focus item. There is no need to use oidBound configuration property any more.

See MID-8867.

No automation possible.

Pavol

  • OidBound 4.4

  • OidBound 4.7

  • OidBound 4.8

N/A

N/A

N/A

Done.

common-core-3.xsd

ArchetypePolicyType

propertyConstraint

tns:ItemConstraintType

Removed.

Deprecated in 4.1 by 940c62e6. Removed in 4.8 by 551ab3fd.

Take all values of propertyConstraint and add them to (multivalued) itemConstraint.

Pavol

  • PropertyConstraint 4.4

  • PropertyConstraint 4.7

  • PropertyConstraint 4.8

Before upgrade

Automatic if implemented.

May be critical. If not done, that part of configuration will disappear.

common-core-3.xsd

ModelExecuteOptionsType

reconcileAffected

xsd:boolean

Removed (not used anymore).

Deprecated in 4.2 by 9c6a5ba5. Removed in 4.8 by 5e83b64e.

The functionality controlled by this option was removed somewhere between 4.2 and 4.4. (It is not present in 4.4 for sure.) Hence, the option can be safely removed from the schema.

Not needed.

Pavol

  • ReconcileAffected 4.4

  • ReconcileAffected 4.7

  • ReconcileAffected 4.8

N/A

Automatic.

N/A

Analyzed and removed from the schema. Done.

common-core-3.xsd

RoleManagementConfigurationType

roleCatalogCollections

tns:ObjectCollectionsUseType

4.8

Configuration was moved to adminGuiConfiguration/accessRequest/roleCatalog/collection Eg. for each systemConfiguration/roleManagement/roleCatalogCollections/collection/collectionUri → systemConfiguration/adminGuiConfiguration/accessRequest/roleCatalog/collection/identifier

code/schema cleanup commit 0e7a0554

Kate

  • N/A in 4.8

  • RoleCatalogCollections 4.7

  • RoleCatalogCollections 4.8

Analyzed and removed from the schema.

common-core-3.xsd

RoleManagementConfigurationType

roleCatalogRef

c:ObjectReferenceType

4.8

Configuration was moved to adminGuiConfiguration/accessRequest/roleCatalog/roleCatalogRef

Just copy the value from the old element to the new one

code/schema cleanup commit 0e7a0554

Kate

  • N/A in 4.8

  • RoleCatalogRef 4.7

  • RoleCatalogRef 4.8

Analyzed and removed from the schema.

common-core-3.xsd

subtype

xsd:string

Only manual fix. Archetypes should be used.

Vilo

  • Subtype 4.4

  • Subtype 4.7

  • Subtype 4.8

Before

Manual

Optional

common-core-3.xsd

PersonaConstructionType

targetSubtype

xsd:string

Removed.

Deprecated in 4.4 by f423dc30. Removed in 4.8 by 9e02d004.

Matching of personas by subtype values is not supported anymore. Any such use should be migrated to the use of archetypes. An example of doing this (for tests) is presented in 9e02d004.

Not possible.

Pavol

  • PersonaTargetSubtype 4.4

  • PersonaTargetSubtype 4.7

  • PersonaTargetSubtype 4.8

Before upgrade

Manual

Critical (if the feature is used)

Analyzed and removed from the schema. Done.

common-correlation-3.xsd

IdMatchCorrelatorType

followOn

tns:CompositeCorrelatorType

Removed.

Introduced in 4.5 by 107d6bbe. Deprecated in 4.6 by eb3e8dbb. Removed in 4.8 by df69d0cb.

Related to ID Match correlator. Instead of followOn item, the referenceIdProperty should be used. An example of doing this (for a test) is presented in df69d0cb.

Not possible.

Pavol

  • N/A 4.4

  • FollowOn 4.7

  • FollowOn 4.8

Before upgrade

Manual

Critical (if ID Match correlator is used)

Analyzed and removed from the schema. Done.

common-gui-3.xsd

additionalPanels

tns:GuiObjectListViewAdditionalPanelsType

4.8 - copying between classes, 4.4 - used only for member panel additionalPanels.memberPanel and we can use ContainerPanelConfigurationType.listView instead

Possible for additionalPanels.memberPanel.

Lukas

  • AdditionalPanels 4.4

  • AdditionalPanels 4.7

  • AdditionalPanels 4.8

N/A

Automatic if implemented.

N/A

Analyzed and removed from the schema. Done.

common-gui-3.xsd

container

tns:VirtualContainersSpecificationType

Use panel.container instead.

Probably not possible, we need panel identifier. Maybe we can use 'basic' panel.

Lukas

  • Container 4.4

  • Container 4.7

  • Container 4.8

Before

Manual

Necessary

Analyzed and removed from the schema. Done.

common-gui-3.xsd

SearchBoxConfigurationType

defaultObjectType

xsd:QName

use objectTypeConfiguration → defaultValue instead.

Before removal, copy the value from defaultObjectType element to objectTypeConfiguration → defaultValue element.

Removed in 4.8 by a6f75c79.

Kate

  • DefaultObjectType 4.4

  • DefaultObjectType 4.7

  • DefaultObjectType 4.8

Before. Old mp version running (described steps should be produced)

Seamless

Necessary

Analyzed and removed from the schema.

common-gui-3.xsd

SearchBoxConfigurationType

defaultScope

tns:SearchBoxScopeType

use scopeConfiguration → defaultValue instead.

Before removal, copy the value from defaultScope element to scopeConfiguration → defaultValue element.

Removed in 4.8 by 510c3027.

Kate

  • DefaultScope 4.4

  • DefaultScope 4.7

  • DefaultScope 4.8

Before. Old mp version running (described steps should be produced)

Seamless

Necessary

Analyzed and removed from the schema.

common-gui-3.xsd

SearchItemType

displayName

t:PolyStringType

SearchItemType

Use display/label instead.

Before removal copy the value of the displayName element to SearchItemType/display/label

code cleanup commit 315f30a6

Kate

  • SearchItemDisplayName 4.4

  • SearchItemDisplayName 4.7

  • SearchItemDisplayName 4.8

  • After 4.4

  • Before 4.7

  • Before 4.8

Seamless

Necessary

Analyzed and removed from the schema.

common-gui-3.xsd

forms

tns:ObjectFormType

Just remove this? XML update probably needed (admin gui configuration objects), Used only for copying between classes.

We can just remove it.

Lukas

  • ObjectForms 4.4

  • ObjectForms 4.7

  • ObjectForms 4.8

N/A

Automatic

N/A

Analyzed and removed from the schema. Done.

common-gui-3.xsd

name

xsd:string

4.8

Used in GuiActionType, identifier should be used.

We can copy name value to identifier. PROBLEM: name not deprecated in 4.4, identifier not available. Validation in 4.4 (pre-upgrade will not show any issue). We can mark it deprecated maybe and verify/updated after midpoint is upgraded to 4.8?

Lukas

  • TODO 4.4

  • GuiActionName 4.7

  • GuiActionName 4.8

N/A

Automatic if implemented

N/A

Analyzed and removed from the schema. Done.

common-gui-3.xsd

objectForms

tns:ObjectFormsType

4.8

This has to be moved to objectDetails/objectDetailsPage/forms. Located in AdminGuiConfigurationType, meaning AbstractRoleType and SystemConfigurationType has to be updated if necessary. Used only for copying between classes.

We can convert it to configuration for panels.

Lukas

  • ObjectForms 4.4

  • ObjectForms 4.7

  • ObjectForms 4.8

  • After 4.4

  • Before 4.7

  • Before 4.8

Probably manual.

Necessary

Analyzed and removed from the schema. Done.

common-gui-3.xsd

AdminGuiConfigurationType

userDashboard

tns:DashboardLayoutType

4.8

Use homePage configuration instead.

userDashboard/widget/identifier → homePage/widget/identifier (identifier value should be also reviewed; earlier the identifier looked like "http://midpoint.evolveum.com/xml/ns/public/gui/component-3/dashboard/widget#myWorkItems", now it’s simplified to "myWorkItems")

userDashboard/widget/visibility → homePage/widget/visibility

Important: homePage/type is to be set to UserType (homePage is multivalue and can be defined for different types of logged in focus)

Note: Before 4.6 self dashboard views (such as My accounts, All assignments etc.) were not much configurable. The only configurable thing was visibility. For that purpose identifier and visibility elements from DashboardLayoutType type were used. Probably, it was a mistake in the schema and WidgetType was enough to be used there, anyhow, no other data from DashboardLayoutType shouldn’t be processed while userDashboard/widget → homePage/widget migration

code cleanup commit 819d69f4

PROBLEM: not deprecated in 4.4, removed in 4.7

Kate

  • TODO 4.4

  • UserDashboard 4.7

  • UserDashboard 4.8

Analyzed and removed from the schema.

common-gui-3.xsd

userDashboardLink

tns:RichHyperlinkType

4.8

Use homePage instead.

userDashboardLink elements should be transformed to homePage/widget elements. Many properties moved to homePage/widget/display, e.g. userDashboardLink/label → homePage/widget/display/label userDashboardLink/description → homePage/widget/display/help userDashboardLink/icon/cssClass → homePage/widget/display/icon/cssClass userDashboardLink/color value is added to homePage/widget/display/icon/cssClass

userDashboardLink/targetUrl is presented as an action element in homePage/widget, e.g. <targetUrl>/self/profile</targetUrl>

<action> <identifier>credentials-widget-action</identifier> <target> <targetUrl>/self/profile</targetUrl> </target> </action>

userDashboardLink/authorization is not implemented. The visibility of the widget can be solved through widget/visibility (even though it’s not the same mechanism as we had in userDashboardLink/authorization)

New elements in the homePage/widget which should be defined: identifier is a free form identifier panelType is to be set to "linkWidget" value, in this way user dashboard link widgets are distinguished from another dashboard widgets

Important: homePage/type is to be set to UserType (homePage is multivalue and can be defined for different types of logged in focus)

PROBLEM: not deprecated in 4.4. Maybe OK, not yet removed

Kate

  • TODO 4.4

  • UserDashboardLink 4.7

  • UserDashboardLink 4.8

common-model-context-3.xsd

LensProjectionContextType

accountPasswordPolicy

c:ValuePolicyType

Removed (not used anymore).

Deprecated in 4.0 by c1088e0a. Removed in 4.8 by 1adf09dc.

This property was maintained by midPoint and is not used for a long time. It can be safely dropped from the schema.

Not needed.

Pavol

  • AccountPasswordPolicy 4.4

  • AccountPasswordPolicy 4.7

  • AccountPasswordPolicy 4.8

N/A

Automatic.

N/A

Analyzed and removed from the schema. Done.

common-model-context-3.xsd

accountPasswordPolicyRef

c:ObjectReferenceType

Removed (not used anymore).

Deprecated in 4.0 by c1088e0a. Removed in 4.8 by 1adf09dc.

This property was maintained by midPoint and is not used for a long time. It can be safely dropped from the schema.

Not needed.

Pavol

  • AccountPasswordPolicy 4.4

  • AccountPasswordPolicy 4.7

  • AccountPasswordPolicy 4.8

N/A

Automatic.

N/A

Analyzed and removed from the schema. Done.

common-notifications-3.xsd

FileConfigurationType

4.7

MessageTransportConfigurationType/file should be used.

TODO: Was not deprecated yet because it breaks old GUI, see comments in NotificationConfigTabPanel. Now deprecated, notification config panel has to be fixed in master and support-4.7 proably. WARNING: sysconfig/notificationConfiguration/file was marked deprecated on master and support-4.7. Is it ok? Not deprecated in 4.4, configuration can be updated after upgrade.

Tony

  • N/A 4.4

  • FileTransport 4.7

  • FileTransport 4.8

common-notifications-3.xsd

LegacyCustomTransportConfigurationType

4.7

TODO

Not deprecated in 4.4, configuration can be updated after upgrade.

Tony

  • N/A 4.4

  • CustomTransport 4.7

  • CustomTransport 4.8

common-notifications-3.xsd

MailConfigurationType

4.7

MessageTransportConfigurationType/mail should be used.

TODO: Was not deprecated yet because it breaks old GUI, see comments in NotificationConfigTabPanel. Now deprecated, notification config panel has to be fixed in master and support-4.7 proably. WARNING: sysconfig/notificationConfiguration/mail was marked deprecated on master and support-4.7. Is it ok? Not deprecated in 4.4, configuration can be updated after upgrade.

Tony

  • N/A 4.4

  • MailTransport 4.7

  • MailTransport 4.8

common-notifications-3.xsd

NotificationTransportConfigurationType

4.7

Use new messageTransportConfiguration instead.

This is parent type for notification configuration types (sms, file, …​). Should be marked abstract, can’t be used directly, therefore no validation item will be ever created for this type.

Tony

  • N/A 4.4

  • N/A 4.7

  • N/A 4.8

common-notifications-3.xsd

SmsConfigurationType

4.7

MessageTransportConfigurationType/sms should be used.

Not deprecated in 4.4, configuration can be updated after upgrade.

Tony

  • N/A 4.4

  • SmsTransport 4.7

  • SmsTransport 4.8

common-notifications-3.xsd

customTransport

tns:LegacyCustomTransportConfigurationType

4.7

MessageTransportConfigurationType/customTransport should be used.

Not deprecated in 4.4, configuration can be updated after upgrade.

Tony

  • N/A 4.4

  • CustomTransport 4.7

  • CustomTransport 4.8

common-notifications-3.xsd

sms

tns:SmsConfigurationType

4.7

MessageTransportConfigurationType/sms should be used.

Not deprecated in 4.4, configuration can be updated after upgrade.

Tony

  • N/A 4.4

  • SmsTransport 4.7

  • SmsTransport 4.8

common-provisioning-3.xsd

SynchronizationType

objectSynchronization

ObjectSynchronizationType

3 (currently). Later we should do something with this, probably in similar to how tasks were migrated to activities.

In 4.6, we improved the style of configuration of the resource objects synchronization. It was moved into schemaHandling/objectType definitions and modernized. The legacy style (synchronization/objectSynchronization) was marked as deprecated in the same midPoint version by 0a58e992.

To migrate, use the new format. See the documentation for more information.

To be analyzed (most probably quite complex).

Pavol

  • N/A 4.4

  • ResourceSynchronization 4.7

  • ResourceSynchronization 4.8

Before

Manual

Optional but strongly recommended.

common-provisioning-3.xsd

ObjectSynchronizationType

reaction

LegacySynchronizationReactionType

This is a part of deprecated objectSynchronization item (of ObjectSynchronizationType).

Pavol

  • N/A 4.4

  • ResourceSynchronization 4.7

  • ResourceSynchronization 4.8

see objectSynchronization above

common-provisioning-3.xsd

ResourceObjectTypeDefinitionType

auxiliaryObjectClass

xsd:QName

3

This property was moved to newly-introduced delineation item and deprecated (in its original place) in 4.6 by 1f3cb147.

Just like objectSynchronization item above, we decided not to remove it in 4.8.

Move (or merge?) the values if they do not exist in delineation.

Pavol

  • N/A 4.4

  • ResourceSynchronization 4.7

  • ResourceSynchronization 4.8

Before

Manual

Optional but strongly recommended.

common-provisioning-3.xsd

ResourceObjectTypeDefinitionType

baseContext

tns:ResourceObjectReferenceType

3

Just like auxiliaryObjectClass property above, this item was moved to newly-introduced delineation item and deprecated (in its original place) in 4.6 by 29c0a6ee. We decided not to remove it in 4.8.

Move the value to delineation (what about conflicts?)

Pavol

  • N/A 4.4

  • ResourceSynchronization 4.7

  • ResourceSynchronization 4.8

Before

Manual

Optional but strongly recommended.

common-provisioning-3.xsd

searchHierarchyScope

tns:SearchHierarchyScopeType

3

Just like baseContext property above, this item was moved to newly-introduced delineation item and deprecated (in its original place) in 4.6 by 29c0a6ee. We decided not to remove it in 4.8.

Move the value to delineation (what about conflicts?)

Pavol

  • N/A 4.4

  • ResourceSynchronization 4.7

  • ResourceSynchronization 4.8

Before

Manual

Optional but strongly recommended.

common-security-3.xsd

AbstractAuthenticationModuleType

name

xsd:string

Use identifier instead.

The usage was removed but then returned back due to mp damage in case of wrong update process.

4.4 → 4.8 : AbstractAuthenticationModuleType.identifier element should be added. The value of the name attribute is to be copied to the identifier. Then name can be removed.

4.7 → 4.8 : In case name value exists but identifier doesn’t, the same steps as for 4.4. If both values exist, just remove name value (starting from 4.7 identifier appeared and was used with a higher priority than name). If no of these 2 elements values present, it’s considered to be a wrong configuration. Identifier element is set to be mandatory.

code cleanup commit c36ef0f0 removed from schema in commit 27cc3ca3 reverted in commit 2e3df132

PROBLEM: name not deprecated in 4.4, will not be shown as validation issue. After MP upgrade it will be shown via newer ninja/schema.

Kate

  • N/A 4.4

  • AuthenticationName 4.7

  • AuthenticationName 4.8

old mp version running (described steps should be produced)

Won’t be removed for now

common-security-3.xsd

AuthenticationSequenceType

name

xsd:string

Use identifier instead.

The usage was removed but then returned back due to mp damage in case of wrong update process.

4.4 → 4.8 : AuthenticationSequenceType.identifier element should be added. The value of the name attribute is to be copied to the identifier. Then name can be removed.

4.7 → 4.8 : In case name value exists but identifier doesn’t, the same steps as for 4.4. If both values exist, just remove name value (starting from 4.7 identifier appeared and was used with a higher priority than name). If no of these 2 elements values present, it’s considered to be a wrong configuration. Identifier element is set to be mandatory.

code cleanup commit 8a888a0a removed from schema in commit 27cc3ca3 reverted in commit cecb2db4

PROBLEM: name not deprecated in 4.4, will not be shown as validation issue. After MP upgrade it will be shown via newer ninja/schema.

Kate

  • N/A 4.4

  • AuthenticationName 4.7

  • AuthenticationName 4.8

old mp version running (described steps should be produced)

Won’t be removed for now

common-security-3.xsd

AuthenticationSequenceModuleType

name

xsd:string

Use identifier instead.

The usage was removed but then returned back due to mp damage in case of wrong update process.

4.4 → 4.8 : AuthenticationSequenceModuleType.identifier element should be added. The value of the name attribute is to be copied to the identifier. Then name can be removed.

4.7 → 4.8 : In case name value exists but identifier doesn’t, the same steps as for 4.4. If both values exist, just remove name value (starting from 4.7 identifier appeared and was used with a higher priority than name). If no of these 2 elements values present, it’s considered to be a wrong configuration. Identifier element is set to be mandatory.

code cleanup commit 375d6f93 removed from schema in commit 27cc3ca3 reverted in commit c5d8c610

PROBLEM: name not deprecated in 4.4, will not be shown as validation issue. After MP upgrade it will be shown via newer ninja/schema.

Kate

  • N/A 4.4

  • AuthenticationName 4.7

  • AuthenticationName 4.8

old mp version running (described steps should be produced)

Won’t be removed for now

common-security-3.xsd

CredentialsResetPolicyType

name

xsd:string

4.8

Use identifier instead.

The usage was removed but then returned back due to mp damage in case of wrong update process.

4.4 → 4.8 : CredentialsResetPolicyType.identifier element should be added. The value of the name attribute is to be copied to the identifier. Then name can be removed.

4.7 → 4.8 : In case name value exists but identifier doesn’t, the same steps as for 4.4. If both values exist, just remove name value (starting from 4.7 identifier appeared and was used with a higher priority than name). If no of these 2 elements values present, it’s considered to be a wrong configuration. Identifier element is set to be mandatory.

code cleanup commit f78a430d removed from schema in commit 27cc3ca3 reverted in commit 8531a781

PROBLEM: name not deprecated in 4.4, will not be shown as validation issue. Identifier also not available here

Kate

  • TODO 4.4

  • CredentialsResetName 4.7

  • CredentialsResetName 4.8

old mp version running (described steps should be produced)

Won’t be removed for now

common-security-3.xsd

AbstractRegistrationPolicyType

name

xsd:string

Use identifier instead.

Kate

common-security-3.xsd

AbstractRegistrationPolicyType

displayName

xsd:string

Use display.label instead

Kate

common-tasks-3.xsd

ActivityStateType

workState (not deprecated)

PureCompositeWorkStateType (deprecated)

1

This is the work state created by custom composite activities. It is not a configuration, but a state maintained by the activity itself.

Most of the time, it is empty, like <workState xsi:type="c:CustomCompositeWorkStateType"/>.

In 4.4, the type was called PureCompositeWorkStateType, but since 4.4.4 and 4.7, it is deprecated and replaced by CustomCompositeWorkStateType (see bd840722 and 6a611801).

If we removed the type definition, the task objects of this type will be no longer readable. (AFAIK there is no schema migration mechanism for types.)

We could write a migration code that would swap the types, but is it worth the effort?

Note that these activities are marked experimental in the schema in ActivityCompositionType (but not in the docs). Moreover, there is no code bound to this type except for its definition. So, maybe the most reasonable is to postpone removal of this type to (e.g.) 5.0.

WARNING: Currently this deprecation is not even visible to ObjectValidator. Container item "workState" has according to debugger definition :PCD:{…​/common/common-3}workState {…​/common/common-3}AbstractActivityWorkStateType[0,1],RAM PCD:{…​/common/common-3}extension {…​/common/common-3}ExtensionType[0,1],RAM,runtime dynamic even though xml looks like this <workState xsi:type="PureCompositeWorkStateType" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"> <extension> </extension> </workState> and item.getRealValue() returns PureCompositeWorkStateType

TBD

Pavol

  • N/A 4.4

  • N/A 4.7

  • N/A 4.8

TBD

TBD

TBD

common-tasks-3.xsd

StringWorkSegmentationType

boundaryCharacters

xsd:string

This is a configuration property for bucketing, used primarily for multi-node tasks. It had problems with unordered nature of prism items, so it was replaced by sound boundary item and deprecated in 4.3 by 0d0a9dff.

Removed in 4.8 by 996326c9.

The migration consists of converting each boundaryCharacters value to boundary item with:

  • the position property, starting at 1 and increasing,

  • the characters property, containing original boundaryCharacters value.

For example, from

<boundaryCharacters>a</boundaryCharacters>
<boundaryCharacters>\0-\1\a-\c</boundaryCharacters>
<boundaryCharacters>01abc</boundaryCharacters>

to

<boundary>
    <position>1</position>
    <characters>a</characters>
</boundary>
<boundary>
    <position>2</position>
    <characters>\0-\1\a-\c</characters>
</boundary>
<boundary>
    <position>3</position>
    <characters>01abc</characters>
</boundary>

Pavol

  • Boundary 4.4

  • Boundary 4.7

  • Boundary 4.8

Before upgrade

Automatic if implemented.

Critical

Analyzed and removed from the schema. Done.

common-tasks-3.xsd

TaskType

category

xsd:string

(already removed in 4.8)

3

Deprecated in 4.4 by 5a9684d4. Removed in 4.8 by a5754af1.

The removal is safe, as this property was practically not used.

Not needed.

Pavol

  • TaskCategory 4.4

  • TaskCategory 4.7

  • TaskCategory 4.8

N/A

Automatic.

N/A

Analyzed and removed from the schema. Done.

common-tasks-3.xsd

TaskType

errorHandlingStrategy

tns:ActivityErrorHandlingStrategyType

(already removed in 4.8)

2 (experimental)

Removed.

Introduced in 4.3 by ab4ba1b7 as experimental feature. Deprecated in 4.4 by c2a17184. Removed in 4.8 by c0508aaf.

This feature was superseded by the activity definition format, which is the only one to be used in 4.8 and beyond.

Using existing XSLT convertor?

Pavol

  • TODO 4.4

  • TODO 4.7

  • TODO 4.8

Before upgrade

Automatic (TODO check the XSLT convertor if it does it correctly).

Critical?

Analyzed and removed from the schema. Done.

common-tasks-3.xsd

ActivityDefinitionType

executionMode

tns:ExecutionModeType

5.0

3

The executionMode property was generalized into execution container in 4.7 and marked as deprecated by 2e574125.

However, as the new item does not exist in 4.4, we will not remove the old property now. Marked with planned removal in 5.0 by da905f39.

The value can be stored as execution/mode.

Pavol

  • N/A 4.4

  • ExecutionMode 4.7

  • ExecutionMode 4.8

Before or after upgrade

Automatic if implemented

Optional

Done.

common-tasks-3.xsd

TaskType

expectedTotal

xsd:long

Currently, 0 - we will keep it as is.

This property is managed by midPoint. It contains the expected number of items to be processed by given task.

It is not used by standard (activity-based) tasks. But we must keep it for now, because not all tasks were migrated to activities yet.

N/A

Pavol

  • ExpectedTotal 4.4

  • ExpectedTotal 4.7

  • ExpectedTotal 4.8

Before

Manual

Optional

Done.

common-tasks-3.xsd

ActivityTracingDefinitionType

interval

xsd:int

5.0

1

The simple interval specification was replaced by more complex beforeItemCondition structure (containing interval itself). The whole tracing feature is experimental.

However, we are not ready to remove this property yet. First, it is still the only possibility how to specify tracing for asynchronous update tasks. Second, the profiling interval should be removed with it; and it was not deprecated until now.

Removal postponed to 5.0 by bb3a264f.

N/A

Pavol

  • ActivityTracing 4.4

  • ActivityTracing 4.7

  • ActivityTracing 4.8

Before or after upgrade

Manual

Optional. The property stays in the schema.

Done.

common-tasks-3.xsd

ActivityProfilingDefinitionType

interval

xsd:int

5.0

Some time ago, the simple interval specification was replaced by more complex beforeItemCondition structure (containing interval itself). However, the original place was not marked as deprecated.

So, it was marked as deprecated right now (4.8), with planned removal set to 5.0 by bb3a264f.

The whole feature is experimental.

N/A

Pavol

  • N/A 4.4

  • N/A 4.7

  • ActivityProfiling 4.8

Before or after upgrade

Manual

Optional. The property stays in the schema.

Done.

common-tasks-3.xsd

TaskType

modelOperationContext

tns:LensContextType

(removed in 4.8)

In the days of old, this item was used to keep the information about changes that are to be executed. It is no longer used, though.

Deprecated in 4.4 by 0faab13f. Removed in 4.8 by be10eb77.

Not needed.

Pavol

  • ModelOperationContext 4.4

  • ModelOperationContext 4.7

  • ModelOperationContext 4.8

N/A

Automatic.

N/A

Analyzed and removed from the schema. Done.

common-tasks-3.xsd

WorkDefinitionsType

nonIterativeChangeExecution

tns:ExplicitChangeExecutionWorkDefinitionType

5.0

The nonIterativeChangeExecution was improved and renamed to explicitChangeExecution in 4.6 by 0c85b470. However, as the new item does not exist in 4.4, we will not remove the old one now. Marked with planned removal in 5.0 by 4da1a29d.

Simple rename will do the trick.

Pavol

  • N/A 4.4

  • NonIterativeChangeExecution 4.7

  • NonIterativeChangeExecution 4.8

Before or after upgrade

Automatic if implemented

Optional

Done.

common-tasks-3.xsd

TaskType

policyRule

tns:PolicyRuleType

This was a part of an undocumented, untested, and experimental mechanism of providing custom timed notifications. There is a migration to the use of focusValidityScan.validityConstraint item, although not a complete one: even if the ability to recompute objects is retained, custom policy actions can no longer be defined.

However:

  1. this functionality was undocumented and experimental;

  2. since approx. 4.4 it didn’t work at all, due to an unrelated bug.

The replacement mechanism is still experimental, but at least the bug was fixed and a test was written.

Not needed due to experimental nature of the feature.

Pavol

  • TaskPolicy 4.4

  • TaskPolicy 4.7

  • TaskPolicy 4.8

Before update

Manual

Mandatory if the feature is to be used.

Analyzed and removed from the schema. Done.

common-tasks-3.xsd

TaskType

recurrence

tns:TaskRecurrenceType

This property was moved from the task root to schedule container (and deprecated in the original place) in 4.4 by 74280c5f. Removed in 4.8 by 15e18c2f.

Note that the property is no longer required. The default value is recurring for tasks that have interval or cronLikePattern set, and single otherwise.

The migration code can simply take the value of this property and put it into the schedule container.

Pavol

  • Recurrence 4.4

  • Recurrence 4.7

  • Recurrence 4.8

Before upgrade

Automatic if implemented.

Critical

Analyzed and removed from the schema. Done.

common-workflows-3.xsd

ApprovalStageExecutionInformationType

executionRecord

ApprovalStageExecutionRecordType

(removed in 4.8)

0 (nothing more is needed)

This structure is used as a return value by (internal) midPoint APIs when asking for information about planned or real execution of an approval case.

It was deprecated in 4.1 by 80a957c2 and is not filled-in since then.

Hence, no migration is needed. We simply removed this item from the schema in 4.8 by b0b4a379.

PROBLEM: not deprecated in 4.4. Upgrade processor will not catch this. Comment by PM: Not really. This value does not exist in the repo.

Not needed.

Pavol

  • TODO 4.4

  • ExecutionRecord 4.7

  • ExecutionRecord 4.8

N/A

Automatic.

N/A

Analyzed and removed from the schema. Done.

common-workflows-3.xsd

InformationType

title

xsd:string

0 (not deprecated anymore)

Deprecated in 3.7 by cc5e5dc9, when localizableTitle was added.

This object is part of the information passed by (customer-defined) ApprovalStageDefinitionType.additionalInformation expression. That information is to be displayed to the approver in addition to the standard approval information provided by midPoint. The title can be a useful shortcut for the engineer to avoid the complexity of creating a localizable message structure.

Un-deprecated in 4.8 by afbe82e5.

N/A

Pavol

  • N/A 4.4

  • N/A 4.7

  • N/A 4.8

N/A

N/A

N/A

common-workflows-3.xsd

InformationPartType

text

xsd:string

0 (not deprecated anymore)

Deprecated in 3.7 by cc5e5dc9, when localizableText was added.

This object is part of the information passed by (customer-defined) ApprovalStageDefinitionType.additionalInformation expression. That information is to be displayed to the approver in addition to the standard approval information provided by midPoint. The text can be a useful shortcut for the engineer to avoid the complexity of creating a localizable message structure.

Un-deprecated in 4.8 by afbe82e5.

N/A

Pavol

  • N/A 4.4

  • N/A 4.7

  • N/A 4.8

N/A

N/A

N/A

common-workflows-3.xsd

WfConfigurationType

useLegacyApproversSpecification

tns:LegacyApproversSpecificationUsageType

4.8

Removed (not used anymore).

Legacy approvers specification were removed back in 4.0.

The useLegacyApproversSpecification was removed in 4.8 by f1fcfce0.

There is nothing to migrate, it can be safely removed from the configuration.

WARNING: It’s not deprecated in 4.4. Shouldn’t be a problem as it’s not used.

Not needed.

Pavol

  • N/A 4.4

  • UseLegacyApprovers 4.7

  • UseLegacyApprovers 4.8

N/A

Automatic.

N/A

Analyzed and removed from the schema. Done.

extension-3.xsd

task extension

liveSyncErrorHandlingStrategy

c:ActivityErrorHandlingStrategyType

(removed in 4.8)

2 (experimental feature)

Removed.

Introduced in 4.3 by 7af6125a as experimental feature. Deprecated in 4.3 by ab4ba1b7. Removed in 4.8 by c0508aaf.

This feature was superseded by the activity definition format, which is the only one to be used in 4.8 and beyond.

In terms of implementation: copying extension/liveSyncErrorHandlingStrategy to activity/controlFlow/errorHandling.

XSLT convertor?

Pavol

  • TODO 4.4

  • LiveSyncErrorHandling 4.7

  • LiveSyncErrorHandling 4.8

Before upgrade

Automatic (TODO check the XSLT convertor if it does it correctly).

Analyzed and removed from the schema. Done.

extension-3.xsd

reportOutputOid

xsd:string

4.3

Still used at least in archetype for report task.

Convert to reference reportDataParam and copy value to reportDataParam.oid.

Lukas

  • ReportOutputOid 4.4

  • ReportOutputOid 4.7

  • ReportOutputOid 4.8

N/A

Automatic.

N/A

Analyzed and removed from the schema. Done.
Was this page helpful?
YES NO
Thanks for your feedback