Skip to content

Commit

Permalink
Add info on LS/AU specs
Browse files Browse the repository at this point in the history
  • Loading branch information
mederly committed Nov 26, 2021
1 parent 32a21fa commit de116ba
Show file tree
Hide file tree
Showing 3 changed files with 12 additions and 9 deletions.
14 changes: 9 additions & 5 deletions docs/tasks/activities/resource-object-set-specification.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -60,15 +60,19 @@ or reconciliation activity:

=== Live Synchronization

#TODO#
For live synchronization, the object class is what is important. Currently, no kind/intent filtering is done,
nor custom query is supported.

=== Asynchronous Update
The object class is determined in a way similar to the import and reconciliation case:

#TODO#
1. If only `objectclass` is specified (i.e. both `kind` and `intent` are not present), then it is used.
2. If `kind` is specified (with or without object class), then the object class is found by looking at `kind` and `intent` values.
3. If `kind` is not specified but `objectclass` and `intent` are, then the `objectclass` is used.
4. If none of them is specified, all object classes are processed. (If the connector supports this mode of operation.)

=== Shadow Refresh
=== Asynchronous Update (Experimental Functionality)

#TODO#
Only the `resourceRef` is used. All other parameters are currently ignored.

== Query Application Mode

Expand Down
5 changes: 2 additions & 3 deletions docs/tasks/synchronization-tasks/asynchronous-update.adoc
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
= Asynchronous Update
:toc:
:experimental:
:page-experimental: true

The asynchronous update activity/task processes a stream of so-called _change events_ coming from a resource.
These events represent changes related to _resource objects_: their creation, modification, or deletion.
Expand All @@ -13,8 +13,7 @@ i.e. the transfer is driven by the resource, not by midPoint.
== Basic Configuration

The heart of the configuration is the specification of what xref:/midpoint/reference/tasks/activities/resource-object-set-specification/[resource objects]
we want to process updates for. The `resourceRef` is obligatory, all the other properties are optional. The `query` property
of the object set specification is not applicable for Asynchronous update tasks.
we want to process updates for. The `resourceRef` is obligatory, all the other properties are ignored (for now).

=== An example

Expand Down
2 changes: 1 addition & 1 deletion docs/tasks/synchronization-tasks/index.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -29,7 +29,7 @@ Main synchronization tasks are:

* xref:import-and-reconciliation.adoc[import and reconciliation],
* xref:live-synchronization.adoc[live synchronization],
* asynchronous update (experimental).
* xref:asynchronous-update.adoc[asynchronous update] (experimental).

== Target Specification

Expand Down

0 comments on commit de116ba

Please sign in to comment.