You are viewing the documentation for Blueriq 17. Documentation for other versions is available in our documentation directory.

What is it for?

AQ_DeleteInstance is used for removing instances from the profile

What does it do?

This delete instance service will remove instances from the profile depending on the parameters. The service can be used to delete the active instance of a certain type, or to delete all instances from a relation attribute.

The service honors the stop-on-errors flag set by previous service in the flow.

The type-scope parameter may be used to indicate if all instances in the profile matching the type should be processed (Global mode), or only the active instance of the specified type (Active mode). When the global mode is used as type-scope, the exact-type parameter may be used to specify if only instances that exactly match the type (default) should be deleted, or if also derived instances should be processed.

In case there are no instances available and the type-scope is Active, the service will return an error Unknown instance, or no active instance. In case the type-scope is Global no warning or error will be shown.

A condition expression may optionally be provided to restrict the number of instances that are deleted to only those instances for which the condition evaluates to true.

Parameters

NameDescriptionTypeRequired
attribute-path

The name of the relation from which all instances should be deleted. Dotted notation is permitted in the path.

When a relation is used that does not contain any instances, the service call does not have any effect (except a few log statements).

String

No1

type

The type of the entity of which the instance(s) should be removed

When the type parameter is used, but no active instance is found for the specified type, the service raises an exception.

String

No1

conditionA condition expression that will evaluate to either true of false. This condition, when specified, will be evaluated for each instance, and only instances for which the condition evaluates to true will be deleted.StringNo
type-scope

Can be Active or Global. Active will clear only the active instance of the specified type. Default is Active.

The type-scope parameter is only relevant when the type parameter is specified.

ActiveNo
exact-type

Boolean parameter that may be used to indicate if only instances that exactly match the specified type should be cleared, or when the value is false derived types are also processed.

The exact-type parameter is only relevant when the type-scope is set to global.

BooleanNo

1 Exactly one of the parameters attribute-path and type must be defined. When both or none of the parameters defined, the service raises an exception.