{"id":19504521,"url":"https://github.com/tools4everbv/helloid-conn-prov-target-csv","last_synced_at":"2025-07-24T11:15:30.229Z","repository":{"id":113210086,"uuid":"329122808","full_name":"Tools4everBV/HelloID-Conn-Prov-Target-CSV","owner":"Tools4everBV","description":"CSV - Target","archived":false,"fork":false,"pushed_at":"2024-07-11T10:26:56.000Z","size":83,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":6,"default_branch":"main","last_synced_at":"2025-01-08T10:44:52.305Z","etag":null,"topics":["dei"],"latest_commit_sha":null,"homepage":"","language":"PowerShell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Tools4everBV.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2021-01-12T21:56:59.000Z","updated_at":"2024-07-11T10:26:26.000Z","dependencies_parsed_at":"2024-07-11T12:10:45.584Z","dependency_job_id":null,"html_url":"https://github.com/Tools4everBV/HelloID-Conn-Prov-Target-CSV","commit_stats":null,"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Tools4everBV%2FHelloID-Conn-Prov-Target-CSV","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Tools4everBV%2FHelloID-Conn-Prov-Target-CSV/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Tools4everBV%2FHelloID-Conn-Prov-Target-CSV/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Tools4everBV%2FHelloID-Conn-Prov-Target-CSV/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Tools4everBV","download_url":"https://codeload.github.com/Tools4everBV/HelloID-Conn-Prov-Target-CSV/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":240754371,"owners_count":19852189,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["dei"],"created_at":"2024-11-10T22:26:05.323Z","updated_at":"2025-02-25T22:11:12.152Z","avatar_url":"https://github.com/Tools4everBV.png","language":"PowerShell","funding_links":[],"categories":[],"sub_categories":[],"readme":"\n# HelloID-Conn-Prov-Target-CSV\n\n\u003e [!IMPORTANT]\n\u003e This repository contains the connector and configuration code only. The implementer is responsible to acquire the connection details such as username, password, certificate, etc. You might even need to sign a contract or agreement with the supplier before implementing this connector. Please contact the client's application manager to coordinate the connector requirements.\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"https://github.com/Tools4everBV/HelloID-Conn-Prov-Target-CSV/blob/main/Logo.png?raw=true\"\u003e\n\u003c/p\u003e\n\n## Table of contents\n\n- [HelloID-Conn-Prov-Target-CSV](#helloid-conn-prov-target-csv)\n  - [Table of contents](#table-of-contents)\n  - [Prerequisites](#prerequisites)\n  - [Remarks](#remarks)\n  - [Introduction](#introduction)\n  - [Getting started](#getting-started)\n    - [Provisioning PowerShell V2 connector](#provisioning-powershell-v2-connector)\n      - [Correlation configuration](#correlation-configuration)\n      - [Field mapping](#field-mapping)\n    - [Connection settings](#connection-settings)\n  - [Getting help](#getting-help)\n  - [HelloID docs](#helloid-docs)\n\n## Prerequisites\n- [ ] _HelloID_ on-prem Provisioning agent.\n- [ ] _HelloID_ environment.\n- [ ] Existing CSV file. HelloID **won't** create a new file if it doesn't exist.\n- [ ] **Concurrent sessions** in HelloID set to a **maximum of 1**! Exceeding this limit may result in file locking.\n\n## Remarks\n- This connector is designed to support only one object per person. If there's a need for more objects per person or per contract of a person, adjustments should be made accordingly.\n\n## Introduction\n_HelloID-Conn-Prov-Target-CSV_ is a _target_ connector. _Microsoft_ provides a the module _Microsoft.PowerShell.Utility_ by default in all PowerShell versions that allow you to programmatically interact with CSV data. This connector uses the cmdlets listed in the table below.\n\n| Cmdlet                                                                                                    | Description                                                                                              |\n| --------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------- |\n| [Import-CSV](https://learn.microsoft.com/en-us/powershell/module/microsoft.powershell.utility/import-csv) | Create table-like custom objects from the items in a character-separated value (CSV) file                |\n| [Export-CSV](https://learn.microsoft.com/en-us/powershell/module/microsoft.powershell.utility/export-csv) | Convert objects into a series of character-separated value (CSV) strings and saves the strings to a file |\n\n\nThe following lifecycle actions are available:\n\n| Action             | Description                       |\n| ------------------ | --------------------------------- |\n| create.ps1         | Create or correlate to row in CSV |\n| delete.ps1         | Delete row in CSV                 |\n| update.ps1         | Update row in CSV                 |\n| configuration.json | Default _configuration.json_      |\n| fieldMapping.json  | Default _fieldMapping.json_       |\n\n## Getting started\nBy using this connector you will have the ability to seamlessly create, update and delete rows in a CSV. \n\u003e Please ensure that you've created the CSV file beforehand, as HelloID **will not** generate a new file if it doesn't exist.\n\n### Provisioning PowerShell V2 connector\n\n#### Correlation configuration\nThe correlation configuration is used to specify which properties will be used to match an existing row within the _CSV_ to a person in _HelloID_.\n\nTo properly setup the correlation:\n\n1. Open the `Correlation` tab.\n\n2. Specify the following configuration:\n\n    | Setting                   | Value        |\n    | ------------------------- | ------------ |\n    | Enable correlation        | `True`       |\n    | Person correlation field  | ``           |\n    | Account correlation field | `EmployeeId` |\n\n\u003e [!TIP]\n\u003e _For more information on correlation, please refer to our correlation [documentation](https://docs.helloid.com/en/provisioning/target-systems/powershell-v2-target-systems/correlation.html) pages_.\n\n#### Field mapping\nThe field mapping can be imported by using the _fieldMapping.json_ file.\n\n### Connection settings\nThe following settings are required to connect to the API.\n\n| Setting       | Description                                                                                                                  | Mandatory |\n| ------------- | ---------------------------------------------------------------------------------------------------------------------------- | --------- |\n| CSV File Path | The path to the CSV file to export the data to.                                                                              | Yes       |\n| Delimiter     | The delimiter that separates the property values in the CSV file. The default is a comma (,).                                | Yes       |\n| Encoding      | The encoding for the imported CSV file. The default value is utf8.                                                           | No        |\n| IsDebug       | When toggled, extra logging is shown. Note that this is only meant for debugging, please switch this off when in production. | No        |\n\n## Getting help\n\u003e [!TIP]\n\u003e _For more information on how to configure a HelloID PowerShell connector, please refer to our [documentation](https://docs.helloid.com/en/provisioning/target-systems/powershell-v2-target-systems.html) pages_. \n\n\u003e [!TIP]\n\u003e  _If you need help, feel free to ask questions on our [forum](https://forum.helloid.com)_.\n\n## HelloID docs\nThe official HelloID documentation can be found at: https://docs.helloid.com/","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftools4everbv%2Fhelloid-conn-prov-target-csv","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftools4everbv%2Fhelloid-conn-prov-target-csv","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftools4everbv%2Fhelloid-conn-prov-target-csv/lists"}