Skip to content

Commit 1d75d5b

Browse files
rhouthuijzenrhouthuijzen
authored
new powershell connector (#10)
* new powershell connector * Fix: implemented fixes after review Added finally to all the scripts * Fix: dryRun in create * Feat: improved mapping and removed comment
1 parent c066048 commit 1d75d5b

File tree

6 files changed

+404
-588
lines changed

6 files changed

+404
-588
lines changed

‎Mapping/EmAd.js‎

Lines changed: 11 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,11 @@
1+
function getEmAd() {
2+
let mail = '';
3+
4+
if (typeof Person.Accounts.MicrosoftActiveDirectory.mail !== 'undefined' && Person.Accounts.MicrosoftActiveDirectory.mail) {
5+
mail = Person.Accounts.MicrosoftActiveDirectory.mail;
6+
}
7+
8+
return mail;
9+
}
10+
11+
getEmAd()

‎README.md‎

Lines changed: 34 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -6,6 +6,10 @@ Repository for HelloID Provisioning Target Connector to AFAS Employees
66
<a href="https://github.com/Tools4everBV/HelloID-Conn-Prov-Target-AFAS-Profit-Employees/issues"><img src="https://img.shields.io/github/issues/Tools4everBV/HelloID-Conn-Prov-Target-AFAS-Profit-Employees" alt="Issues Badge"/></a>
77
<a href="https://github.com/Tools4everBV/HelloID-Conn-Prov-Target-AFAS-Profit-Employees/graphs/contributors"><img alt="GitHub contributors" src="https://img.shields.io/github/contributors/Tools4everBV/HelloID-Conn-Prov-Target-AFAS-Profit-Employees?color=2b9348"></a>
88

9+
| :warning: Warning |
10+
| :---------------- |
11+
| This script is for the new powershell connector. Make sure to use the mapping and correlation keys like mentionded in this readme. For more information, please read our [documentation](https://docs.helloid.com/en/provisioning/target-systems/powershell-v2-target-systems.html) |
12+
913

1014
| :information_source: Information |
1115
|:---------------------------|
@@ -27,6 +31,8 @@ Repository for HelloID Provisioning Target Connector to AFAS Employees
2731
- [Remarks](#remarks)
2832
- [Scope](#scope)
2933
- [UpdateConnector](#updateconnector)
34+
- [Mapping](#mapping)
35+
- [Correlation](#correlation)
3036
- [Getting help](#getting-help)
3137
- [HelloID docs](#helloid-docs)
3238

@@ -39,9 +45,9 @@ The HelloID connector consists of the template scripts shown in the following ta
3945

4046
| Action | Action(s) Performed | Comment |
4147
| ------------------------------- | --------------------- | --------- |
42-
| create.ps1 | Update AFAS employee | |
43-
| update.ps1 | Update AFAS employee | |
44-
| delete.ps1 | Update AFAS employee | Clear the unique fields, since the values have to be unique over all AFAS environments |
48+
| create.ps1 | Update AFAS employee | Correlates AFAS employee |
49+
| update.ps1 | Update AFAS employee | Update on correlate and update on update |
50+
| delete.ps1 | Update AFAS employee | Clear the unique fields, since the values have to be unique over all AFAS environments |
4551

4652
<!-- GETTING STARTED -->
4753
## Getting Started
@@ -67,7 +73,7 @@ The following settings are required to connect to the API.
6773
| Token in XML format | The AppConnector token to connect to AFAS | Yes |
6874
| Get Connector | The GetConnector in AFAS to query the user with | Yes |
6975
| Update Connector | The UpdateConnector in AFAS to update the user with | Yes |
70-
| Update on correlate | When toggled, if the mapped data differs from data in AFAS, the AFAS employee will be updated in the create action (not just correlated). | No |
76+
| Update on update | When toggled, if the mapped data differs from data in AFAS, the AFAS user will be updated when a update is triggerd. | No |
7177
| Toggle debug logging | When toggled, extra logging is shown. Note that this is only meant for debugging, please switch this off when in production. | No |
7278

7379
### Prerequisites
@@ -80,7 +86,7 @@ The following settings are required to connect to the API.
8086
### GetConnector
8187
When the connector is defined as target system, only the following GetConnector is used by HelloID:
8288

83-
* Tools4ever - HelloID - T4E_HelloID_Users_v2
89+
* Tools4ever - HelloID - T4E_HelloID_Users_v2
8490

8591
#### Remarks
8692
- In view of GDPR, the persons private data, such as private email address and birthdate are not in the data collection by default. When needed for the implementation (e.g. set emailaddress with private email address on delete), these properties will have to be added.
@@ -97,7 +103,29 @@ The data collection can be changed by the customer itself to meet their requirem
97103
### UpdateConnector
98104
In addition to use to the above get-connector, the connector also uses the following build-in Profit update-connectors:
99105

100-
* knEmployee
106+
* knEmployee
107+
108+
### Mapping
109+
The mandatory and recommended field mapping is listed below.
110+
111+
| Name | Create | Enable | Update | Disable | Delete | Store in account data | Default mapping | Mandatory | Comment |
112+
| -------------- | ------ | ------ | ------ | ------- | ------ | --------------------- | ------------------------------------------ | --------- | ---------------------------------------------- |
113+
| Medewerker | X | | X | | | Yes | Field: ExternalId | Yes | Used for Correlation and to store account data |
114+
| Persoonsnummer | X | | X | | | Yes | None | Yes | Used to store account data |
115+
| EmAd | | | X | | X | Yes | Update: Complex EmAd.js Delete Fixed empty | | E-Mail werk |
116+
117+
The fields listed below are examples of available fields for mapping but are typically not used.
118+
119+
| Name | Create | Enable | Update | Disable | Delete | Store in account data | Default mapping | Mandatory | Comment |
120+
| ----------- | ------ | ------ | ------ | ------- | ------ | --------------------- | -------------------------------------- | --------- | ---------------------------------------------------------------------- |
121+
| EmailPortal | | | X | | X | Yes | <Your preferred value> for example UPN | | E-mail toegang - Check with AFAS Administrator if this needs to be set |
122+
| TeNr | | | X | | X | Yes | <Your preferred value> | | Telefoonnr. werk |
123+
| MbNr | | | X | | X | Yes | <Your preferred value> | | Mobiel werk |
124+
125+
126+
### Correlation
127+
It is mandatory to enable the correlation in the correlation tab. The default value for "person correlation field" is " ExternalId". The default value for "Account Correlation field" is "Medewerker".
128+
101129

102130
## Getting help
103131
> _For more information on how to configure a HelloID PowerShell connector, please refer to our [documentation](https://docs.helloid.com/hc/en-us/articles/360012558020-Configure-a-custom-PowerShell-target-system) pages_

‎configuration.json‎

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -42,13 +42,13 @@
4242
}
4343
},
4444
{
45-
"key": "updateOnCorrelate",
45+
"key": "updateOnUpdate",
4646
"type": "checkbox",
4747
"defaultValue": false,
4848
"templateOptions": {
49-
"label": "Update on correlate",
49+
"label": "Update on update",
5050
"required": false,
51-
"description": "When toggled, if the mapped data differs from data in AFAS, the AFAS employee will be updated in the create action (not just correlated)."
51+
"description": "When toggled, if the mapped data differs from data in AFAS, the AFAS user will be updated when a update is triggerd"
5252
}
5353
},
5454
{

0 commit comments

Comments
 (0)