{"id":19504458,"url":"https://github.com/tools4everbv/helloid-conn-prov-target-medicore","last_synced_at":"2025-07-11T04:39:59.175Z","repository":{"id":243220809,"uuid":"811791972","full_name":"Tools4everBV/HelloID-Conn-Prov-Target-Medicore","owner":"Tools4everBV","description":"Medicore - Target","archived":false,"fork":false,"pushed_at":"2025-01-31T13:13:44.000Z","size":52,"stargazers_count":0,"open_issues_count":1,"forks_count":0,"subscribers_count":5,"default_branch":"main","last_synced_at":"2025-01-31T14:23:51.711Z","etag":null,"topics":["hcs","provisioning","target"],"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":"CHANGELOG.md","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":"2024-06-07T10:04:37.000Z","updated_at":"2025-01-31T13:13:48.000Z","dependencies_parsed_at":"2024-11-10T22:28:11.565Z","dependency_job_id":"67dae3ce-97f1-480b-95ab-c79209f65df2","html_url":"https://github.com/Tools4everBV/HelloID-Conn-Prov-Target-Medicore","commit_stats":null,"previous_names":["tools4everbv/helloid-conn-prov-target-medicore"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Tools4everBV%2FHelloID-Conn-Prov-Target-Medicore","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Tools4everBV%2FHelloID-Conn-Prov-Target-Medicore/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Tools4everBV%2FHelloID-Conn-Prov-Target-Medicore/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Tools4everBV%2FHelloID-Conn-Prov-Target-Medicore/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Tools4everBV","download_url":"https://codeload.github.com/Tools4everBV/HelloID-Conn-Prov-Target-Medicore/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":["hcs","provisioning","target"],"created_at":"2024-11-10T22:25:53.451Z","updated_at":"2025-02-25T22:10:57.902Z","avatar_url":"https://github.com/Tools4everBV.png","language":"PowerShell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# HelloID-Conn-Prov-Target-Medicore\r\n\r\n\u003e [!IMPORTANT]\r\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.\r\n\r\n\u003cp align=\"center\"\u003e\r\n  \u003cimg src=\"\"\u003e\r\n\u003c/p\u003e\r\n\r\n## Table of contents\r\n\r\n- [HelloID-Conn-Prov-Target-Medicore](#helloid-conn-prov-target-Medicore)\r\n  - [Table of contents](#table-of-contents)\r\n  - [Introduction](#introduction)\r\n  - [Getting started](#getting-started)\r\n    - [Provisioning PowerShell V2 connector](#provisioning-powershell-connector)\r\n      - [Correlation configuration](#correlation-configuration)\r\n      - [Field mapping](#field-mapping)\r\n    - [Connection settings](#connection-settings)\r\n    - [Prerequisites](#prerequisites)\r\n    - [Remarks](#remarks)\r\n  - [Setup the connector](#setup-the-connector)\r\n  - [Getting help](#getting-help)\r\n  - [HelloID docs](#helloid-docs)\r\n\r\n## Introduction\r\n\r\n_HelloID-Conn-Prov-Target-Medicore_ is a _target_ connector. _Medicore_ provides a set of REST API's that allow you to programmatically interact with its data.\r\nThis connector manages users in Medicore, including templates and locations.\r\n\r\nThe following lifecycle actions are available:\r\n\r\n| Action                     | Description                                                                             |\r\n| -------------------------- | --------------------------------------------------------------------------------------- |\r\n| create.ps1                 | Default PowerShell _create_ lifecycle action, including location and template mapping   |\r\n| disable.ps1                | Default PowerShell _disable_ lifecycle action                                           |\r\n| enable.ps1                 | Default PowerShell _enable_ lifecycle action                                            |\r\n| update.ps1                 | Default PowerShell _update_ lifecycle action, including updating locations and template |\r\n| configuration.json         | Default _configuration.json_                                                            |\r\n| fieldMapping.json          | Default _fieldMapping.json_                                                             |\r\n| Assets/LocationMapping.csv | Default example _LocationMapping.json_                                                  |\r\n| Assets/TemplateMapping.csv | Default example _TemplateMapping.json_                                                  |\r\n\r\n## Getting started\r\n\r\n### Provisioning PowerShell V2 connector\r\n\r\n#### Correlation configuration\r\n\r\nThe correlation configuration is used to specify which properties will be used to match an existing account within _Medicore_ to a person in _HelloID_.\r\n\r\nTo properly setup the correlation:\r\n\r\n1. Open the `Correlation` tab.\r\n\r\n2. Specify the following configuration:\r\n\r\n   | Setting                   | Value                             |\r\n   | ------------------------- | --------------------------------- |\r\n   | Enable correlation        | `True`                            |\r\n   | Person correlation field  | `PersonContext.Person.ExternalId` |\r\n   | Account correlation field | `hrNumber`                        |\r\n\r\n\u003e [!TIP] \u003e _For more information on correlation, please refer to our correlation [documentation](https://docs.helloid.com/en/provisioning/target-systems/powershell-target-systems/correlation.html) pages_.\r\n\r\n#### Field mapping\r\n\r\nThe field mapping can be imported by using the _fieldMapping.json_ file.\r\n\r\n### Connection settings\r\n\r\nThe following settings are required to connect to the API.\r\n\r\n| Setting                | Description                                | Mandatory |\r\n| ---------------------- | ------------------------------------------ | --------- |\r\n| UserName               | The UserName to connect to the API         | Yes       |\r\n| Password               | The Password to connect to the API         | Yes       |\r\n| client_id              | The client ID to connect to the API        | Yes       |\r\n| client_secret          | The client secret to connect to the API    | Yes       |\r\n| OcpApimSubscriptionKey | The subscription key to connect to the API | Yes       |\r\n| BaseUrl                | The URL to the API                         | Yes       |\r\n| TokenUrl               | The URL to generate the bearer token       | Yes       |\r\n\r\n### Prerequisites\r\n\r\n### Remarks\r\n\r\n\u003e Due to the limitations of the field mapping, which can only return strings or an array of strings, it is necessary to perform type conversions for the properties: 'gender', 'isAttendingPhysician' and 'isPatientBound' to correctly send them to the API.\r\n\r\n\u003e The comparison process during updates has a different approach for the 'locations' property because it is an array.\r\n\r\n\r\n### Remarks CSV Mapping\r\n\r\n\u003e To prevent having a large number of business rules, the connector comes with two csv mapping files. One for the template (templatemapping.csv) and one for locations (locationMapping.csv), these can be found in the Assets folder. Each person can be linked to one template but multiple locations, allowing for flexible and efficient management of user access.\r\n\r\nIn the mapping files, you will find the properties HelloIdDepartment and HelloIdTitle. The values of these properties should match the values in your HelloID contract. The last two properties, LocationName and LocationId (or the corresponding properties for the template), refer to the MediCore location or template needed for that specific department or title.\r\n\r\n\u003e The connector is designed with the assumption that the fields 'abbreviations' and 'username' are populated with the User Principal Name (UPN) from Active Directory (AD). This ensures uniqueness for each entry, eliminating the need for an additional uniqueness script. If you want to populate these properties with different values, remember to also create a uniqueness script.\r\n\r\n\u003e In the create and update scripts, you will find the following two lines of code:\r\n\r\n```\r\n$locationLookupField1 = { $_.Department.ExternalId } # Mandatory\r\n$locationLookupField2 = { $_.Title.ExternalId }      # Not mandatory\r\n```\r\n\r\nThese lines are used to select the properties on which we loop through for every single contract that falls within the scope of the business rules. This process results in a list of departments and titles, which need to exist in the `LocationMapping.csv` file to obtain the corresponding MediCore location ID.\r\n\r\n\r\n\r\n## Setup the connector\r\n\r\n\u003e _How to setup the connector in HelloID._ Are special settings required. Like the _primary manager_ settings for a source connector.\r\n\r\n## Getting help\r\n\r\n\u003e [!TIP] \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-target-systems.html) pages_.\r\n\r\n\u003e [!TIP] \u003e _If you need help, feel free to ask questions on our [forum](https://forum.helloid.com)_.\r\n\r\n## HelloID docs\r\n\r\nThe official HelloID documentation can be found at: https://docs.helloid.com/\r\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftools4everbv%2Fhelloid-conn-prov-target-medicore","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftools4everbv%2Fhelloid-conn-prov-target-medicore","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftools4everbv%2Fhelloid-conn-prov-target-medicore/lists"}