Version: 1.6
Category: Process
Extended Category: Files
Action Package: Standard Actions
Description
Find object in file data source by matching a session attribute to a file object attribute.
| Parameter | Description | Example |
| Target Data Source | [Mandatory] Select a file data source. | CSV-file |
| Match Session Attribute | [Optional] The session object attributes to match against file. If this parameter is not specified, Match Value will be used. Both parameters must not be set. | sAMAccountName |
| Match Value | [Optional] The value derived from the session object to match against file. This parameter will be used if Match Session Attribute is blank. Both parameters must not be set. Supports SESSION() and GLOBAL(). | SESSION(first name)-SESSION(last name) |
| Match File Attribute | [Mandatory] The file object attributes to match against the session object. | ObjectID |
| Matched DN Session Attribute | [Optional] The attribute where the matched file object name or selected (next parameter) should be inserted should be placed. Default: the session object name | MatchedObject |
| Use File Session Attribute | [Optional] The file session value to insert into the matched DN session attribute. Default: The match file attribute value. | sAMAccountName |
| Name for New Objects | [Optional] The DN for new objects. Supports SESSION() and GLOBAL(). | SESSION(WorkforceID) |
| Remove Session Object if No Match (false/true) | [Optional] true=If no match, remove the session object. false=Keep object when no match. Default: false | true |
| Remove Session Object if Match (false/true) | [Optional] true=If match, remove the session object. false=Remove object when no match. Default: false | true |
| Support Multivalue Match (false/true) | [Optional] If the session attribute is multivalue, match each of the values individual. Default: false | true |
| Additional Attributes | [Optional] Additional attributes to get from the matched file object. The attributes can be mapped to new names using |. | fileAttribute1|MyAttribute1, fileAttribute2|MyAttribute2 |
| Replace Additional Attributes | [Optional] If Additional Attributes are being mapped, and this is true, the existing values will be replaced instead of added. Default: false. | true |
Use Cases
Example 1: Match user from CSV file
The CSV is exported from an HR system. If an employee from the export doesn’t exist in the AD an account should be created, otherwise the session object should be removed. The matching attribute will be IDnumber from CSV and carLicense from AD. Please note that the csv file have to be added as a data source which will be referenced from this action.
| Parameter | Value |
| Target Data Source | HR-EXPORT |
| Match Session Attribute | carLicense |
| Match File Attribute | IDnumber |
| Matched DN Session Attribute | [BLANK] |
| Use File Session Attribute | [BLANK] |
| Name for New Objects | SESSION(objectName) |
| Remove Session Object if No Match (false/true) | false |
| Remove Session Object if Match (false/true) | true |
| Support Multivalue Match (false/true) | false |
| Additional Attributes | [BLANK] |
DISCLAIMER
Information provided in this document is for your information only. PhenixID makes no explicit or implied claims to the validity of this information. Any trademarks referenced in this document are the property of their respective owners.The origin of this information may be internal or external to PhenixID. PhenixID makes all reasonable efforts to verify this information.
PhenixID - support.phenixid.se