Differences

This shows you the differences between two versions of the page.

--- devel:documentation:modules_extras [2020/04/24 07:12]
kopro evaluator for orles
+++ devel:documentation:modules_extras [2021/05/27 11:59]
kopro [Get titles before and after] type and update header
@@ Line 2: / Line 2: @@
 CzechIdM - extras contains various features, which are not suited to be in any other module. List of the currently supported features is below.
-Currently supported CzechIdM version : 9.2.2
+Currently supported CzechIdM version : 11.0.x
 [[https://github.com/bcvsolutions/czechidm-extras]]
+===== Table of compatible versions =====
+^ Extras version  ^ Min dependency versions  ^ Max dependency versions  ^ Note                                                                               ^
+| 2.5.0           | idm-core-10.3.3          | UNKNOWN                  |                                                                                    |
+| 2.6.0           | idm-core-10.4.4          | UNKNOWN                  |                                                                                    |
+| 2.6.1           | idm-core-10.4.8          | UNKNOWN                  | This version is needed for [[tutorial:adm:import_automatic_roles_on_tree_nodes|]]  |
+| 2.7.0           | idm-core-10.4.9          | UNKNOWN                  |                                                                                    |
 ===== Developing and releasing =====
 How to develop a new feature in extras:
@@ Line 49: / Line 60: @@
 ===== Automatic role definitions - Import of data from CSV LRT =====
 Documentation is available here: [[tutorial:adm:automatic_role_definitions_-_import_of_data_from_csv|]]
+===== Automatic role definitions - Import all rules LRT =====
+Since module version **1.9.0**.
+Documentation is available here: [[tutorial:adm:automatic_role_definitions_-_import_all_rules|]]
 ===== Assign roles to contract EAV - Import of data from CSV LRT =====
@@ Line 94: / Line 109: @@
 Edit: Support for technical identities added for use in version 1.9.0
-===== Get titles before and after =====
+===== Script split titles before and after =====
 Almost every project receive all titles in one string and IdM allow separates titles before and after. For this case was created in *ExtrasUtils* two methods *getTitlesAfter* and *getTitlesBefore*. And transformation scripts *extrasGetTitlesBefore* and *extrasGetTitlesAfter*, transformation scripts calls method from utils.
-Dictionary with titles can be setup by configuration properties. Default values exists.
+Dictionary with titles can be setup by configuration properties. Default values exists in [[https://github.com/bcvsolutions/czechidm-extras/blob/2.6.1/Realization/backend/idm-extras/src/main/java/eu/bcvsolutions/idm/extras/util/ExtrasUtils.java#L62|BE]]
 <code>
-idm.sec.extras.configuration.titlesAfter="Ph.D.", "Th.D.", "CSc.", "DrSc.", "dr. h. c.","DiS.", "MBA"
+idm.sec.extras.configuration.titlesAfter=Ph.D.,Th.D.,CSc.,DrSc.,dr. h. c.,DiS.,MBA,LL.M.,FESC,MHA,FEBO,FESO,FEBU,FACC
-idm.sec.extras.configuration.titlesBefore="Bc.", "BcA.", "Ing.", "Ing. arch.", "MUDr.","MVDr.", "MgA.", "Mgr.", "JUDr.", "PhDr.", "RNDr.", "PharmDr.", "ThLic.", "ThDr.", "prof.", "doc.","PaedDr.", "Dr.", "PhMr."
+idm.sec.extras.configuration.titlesBefore=Bc.,BcA.,Ing.,Ing. arch.,MUDr.,MVDr.,MgA.,Mgr.,JUDr.,PhDr.,RNDr.,PharmDr.,ThLic.,ThDr.,prof.,doc.,PaedDr.,Dr.,PhMr.,MDDr.
+</code>
+in version 2.8.0 was added the option to select a separator for source string and for titles before and after values in IdM.
+<code>
+idm.sec.extras.configuration.titlesSourceSeparator - a character, that separates titles in the source. Default" "
+idm.sec.extras.configuration.titlesBeforeSeparator - titles before separator for IdM. Default", "
+idm.sec.extras.configuration.titlesAfterSeparator - titles before separator for IdM. Default", "
 </code>
@@ Line 108: / Line 129: @@
 ===== Groups synchronization workflow  =====
-Since module version **1.4.0** was exists better workflow for groups synchronization than in core. This workflow has same features as product. In product will be available same feature as this workflow but with configuration from GUI.
+Since module version **1.4.0** there exists improved workflow in the extras module for groups synchronization than in the core module. The workflow **Extras Synchronization - Roles from LDAP** (extrasSyncRoleLdap) has more features and some fixed bugs than the product workflow syncRoleLdap. The workflow in the product is not developed anymore, because we plan to add more user-friendly configuration of the feature in future versions of the product.
+Documentation for configuration is available in [[tutorial:dev:ad_groups_sync_workflow#set_aplication_properties|Group synchronization workflow - Application properties]].
+Note: the workflow extrasSyncRoleLdap depends on some services implemented in the extras module, so to use this workflow, you must deploy the whole module to CzechIdM.
-Documentation for configuration is available [[tutorial:dev:ad_groups_sync_workflow|]].
 ===== Workflow to disable contract on MISSING_ACCOUNT =====
 Setting this workflow (extrasDisableMissingContract) as workflow for action in contract reconciliation will disable contract, when its being synchronized. It can be used for example, in situations when contracts are being deleted from source data after expiration and they keep being stuck in MISSING_ACCOUNT state.
+Note: When using this workflow, please consider the possibility that the contracts may "reappear" in the source data. In such case, it would make sense to enable the contracts again, e.g. by mapping the attribute "state" and filling it by value ''null'' (= active contract).
 ===== Groups membership in multi domain (cross domain) AD environment =====
@@ Line 128: / Line 155: @@
 Since module version **1.9.0**. **Available only on LTS version!**
-Documentation is available
+Documentation is available [[devel:documentation:modules_extras:role_evaluator_by_role_catalogue|there]].
+===== Import code list and it's items =====
+Since module version **1.9.0** and **2.4.0**
+Documentation is available [[devel:documentation:modules_extras:import_code_list_an_it_s_items|there]]
+===== Evaluators (permissions) for Identities and Contracts which are both subordinate and have given projection =====
+Since module version **2.4.0**.
+Documentation is available [[devel:documentation:modules_extras:subordinate_projection_evaluators|there]].
+===== Workflows for approval of role assignment =====
+Since module version **2.3.0**
+Documentation is available [[tutorial:adm:modules_extras_wf|there]]
+===== Script for soft abbreviate strings (extrasAbbreviateString) =====
+Since module version **3.2.0**
+Script called **extrasAbbreviateString** abbreviate given string by default with maximum length 255. Maximum length can be defined by adding parameter **maximum**. For example:
+  * .addParameter('maximum', 60)
+Result examples:
+  * "Hi how are you" - maximum: 9 - "Hi how"
+  * "Ing. Mgr. at Mgr. MBA" - maximum: 20 - "Ing. Mgr. at Mgr."
+  * "Ing." - maximum: 20 - "Ing."