Differences
This shows you the differences between two versions of the page.
Both sides previous revision Previous revision Next revision | Previous revision Next revision Both sides next revision | ||
devel:documentation:systems:dev:system-mapping [2019/05/06 10:28] svandav [Connector pool configuration] |
devel:documentation:systems:dev:system-mapping [2019/08/28 08:58] svandav [MERGE (Merge)] |
||
---|---|---|---|
Line 1: | Line 1: | ||
====== Connector configuration and attribute mapping ====== | ====== Connector configuration and attribute mapping ====== | ||
- | {{tag> | + | {{tag> |
===== Connector configuration ===== | ===== Connector configuration ===== | ||
+ | {{tag> | ||
Creation of a newly connected system will be demonstrated on a database connector (ConnIdDBBundle). | Creation of a newly connected system will be demonstrated on a database connector (ConnIdDBBundle). | ||
Firstly, we will create a new system named **Table** and choose the database connector. | Firstly, we will create a new system named **Table** and choose the database connector. | ||
Line 12: | Line 13: | ||
==== Connector pool configuration ==== | ==== Connector pool configuration ==== | ||
+ | {{tag> | ||
**The connector pool** is a very useful feature that avoids unnecessarily creating a new connector instance each time a connector is called. Typically, each connector instance also creates a connection to that target system. It is effective to maintain these connections for **longer periods and for multiple calls**. | **The connector pool** is a very useful feature that avoids unnecessarily creating a new connector instance each time a connector is called. Typically, each connector instance also creates a connection to that target system. It is effective to maintain these connections for **longer periods and for multiple calls**. | ||
Line 29: | Line 31: | ||
<note important> | <note important> | ||
- | Pool configuration is persisted in EAV attributes and use form definition with code " | + | <note tip>Pool configuration is persisted in EAV attributes and use form definition with code " |
Line 37: | Line 39: | ||
===== System scheme ===== | ===== System scheme ===== | ||
+ | {{tag> | ||
When the connector is configured correctly, we can move on to the **System scheme** tab. There, we will create the scheme either manually or we will use the scheme which will be returned by the connector itself (according to the filled-in configuration). | When the connector is configured correctly, we can move on to the **System scheme** tab. There, we will create the scheme either manually or we will use the scheme which will be returned by the connector itself (according to the filled-in configuration). | ||
Line 52: | Line 55: | ||
===== Attribute mapping ===== | ===== Attribute mapping ===== | ||
+ | {{tag> | ||
When the system scheme is created, we can move on to attribute mapping in the **Attribute mapping** tab. Mapping serves two basic purposes: | When the system scheme is created, we can move on to attribute mapping in the **Attribute mapping** tab. Mapping serves two basic purposes: | ||
Line 121: | Line 125: | ||
====== Mapped attribute strategy ====== | ====== Mapped attribute strategy ====== | ||
+ | {{tag> | ||
The attribute strategy defines how will the attribute and primarily its value be dealt with during provisioning and synchronization. | The attribute strategy defines how will the attribute and primarily its value be dealt with during provisioning and synchronization. | ||
Line 152: | Line 157: | ||
==== AUTHORITATIVE_MERGE (Authoritative merge) ==== | ==== AUTHORITATIVE_MERGE (Authoritative merge) ==== | ||
+ | {{tag> | ||
This strategy (identically to MERGE) alters the logic of calculating attributes and their values. With the other strategies applies the following: if there are more occurrences of the same strategy for the same attribute (more overloaded attributes in more roles), the one with the highest priority is found (according to role priorities or their names). The resulting value going into provisioning is calculated on the basis of this one attribute only. | This strategy (identically to MERGE) alters the logic of calculating attributes and their values. With the other strategies applies the following: if there are more occurrences of the same strategy for the same attribute (more overloaded attributes in more roles), the one with the highest priority is found (according to role priorities or their names). The resulting value going into provisioning is calculated on the basis of this one attribute only. | ||
Line 166: | Line 172: | ||
==== MERGE (Merge) ==== | ==== MERGE (Merge) ==== | ||
+ | {{tag> | ||
<note warning> | <note warning> | ||
Line 192: | Line 199: | ||
That persisted ' | That persisted ' | ||
- | The evicted cache is **recalculated** by using the **AttributeControlledValuesRecalculationTaskExecutor** task, which is run after each save of attribute mapping on a role. In this case, this task recalculates the cache for all evicted attributes of the provisioning mapping. | + | The evicted cache is **recalculated** by using the **AttributeControlledValuesRecalculationTaskExecutor** task. This task recalculates the cache for all evicted attributes of the provisioning mapping. |
+ | |||
+ | <note important> | ||
{{ : | {{ : | ||
Line 216: | Line 225: | ||
<note important> | <note important> | ||
+ | |||
+ | ==== Skip merged value if contract is excluded ==== | ||
+ | |||
+ | {{tag> | ||
+ | |||
+ | Since version **9.7.0** was added new feature enabling skip of value defined in merge attribute, if contract (on witch is role assigned) will be excluded. | ||
+ | |||
+ | For enable this feature you need to check the option **' | ||
+ | |||
+ | **Value will be skipped only if**: | ||
+ | - Attribute has strategy type sets to **MERGE** or **AUTHORITATIVE_MERGE** (only for this options will checkbox shows). | ||
+ | - Feature is **enabled** on the role mapping. | ||
+ | - Identity has assigned this role/s to the **excluded contract/ | ||
+ | |||
+ | <note important> | ||
+ | |||
+ | {{ : | ||
==== Additional characteristics of strategies ==== | ==== Additional characteristics of strategies ==== |