{"id":19504724,"url":"https://github.com/tools4everbv/helloid-conn-prov-target-planon-order","last_synced_at":"2026-06-13T03:03:18.121Z","repository":{"id":94206323,"uuid":"585945944","full_name":"Tools4everBV/HelloID-Conn-Prov-Target-Planon-Order","owner":"Tools4everBV","description":"Planon - Target","archived":false,"fork":false,"pushed_at":"2024-01-15T14:07:03.000Z","size":83,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":4,"default_branch":"main","last_synced_at":"2025-02-25T22:12:09.957Z","etag":null,"topics":["css","fmis","itm","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":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":"2023-01-06T14:17:51.000Z","updated_at":"2023-06-13T15:39:20.000Z","dependencies_parsed_at":null,"dependency_job_id":"418e66d0-8b7f-4151-bc65-16a722a72db2","html_url":"https://github.com/Tools4everBV/HelloID-Conn-Prov-Target-Planon-Order","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/Tools4everBV/HelloID-Conn-Prov-Target-Planon-Order","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Tools4everBV%2FHelloID-Conn-Prov-Target-Planon-Order","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Tools4everBV%2FHelloID-Conn-Prov-Target-Planon-Order/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Tools4everBV%2FHelloID-Conn-Prov-Target-Planon-Order/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Tools4everBV%2FHelloID-Conn-Prov-Target-Planon-Order/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Tools4everBV","download_url":"https://codeload.github.com/Tools4everBV/HelloID-Conn-Prov-Target-Planon-Order/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Tools4everBV%2FHelloID-Conn-Prov-Target-Planon-Order/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34270417,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-13T02:00:06.617Z","response_time":62,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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":["css","fmis","itm","provisioning","target"],"created_at":"2024-11-10T22:26:56.211Z","updated_at":"2026-06-13T03:03:18.099Z","avatar_url":"https://github.com/Tools4everBV.png","language":"PowerShell","funding_links":[],"categories":[],"sub_categories":[],"readme":"\n# HelloID-Conn-Prov-Target-Planon-Order\n\n| :warning: Warning |\n|:---------------------------|\n| Note that this connector is \"a work in progress\" and therefore not ready to use in your production environment. |\n\n| :warning: Warning |\n|:---------------------------|\n| This connector has not been tested on a Planon environment. Therefore, changes might have to be made according to your environment. |\n\n| :warning: Warning |\n|:---------------------------|\n|Before using this connector, make sure the necessary Planon WSDL's are available. See: [WSDL specifications](#wsdl-specifications) |\n\n| :information_source: Information |\n|:---------------------------|\n| 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\u003cbr /\u003e\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"https://www.tools4ever.nl/connector-logos/planon-logo.png\" width=\"500\"\u003e\n\u003c/p\u003e \n\n## Table of contents\n\n- [HelloID-Conn-Prov-Target-Planon-Order](#helloid-conn-prov-target-planon-order)\n  - [Table of contents](#table-of-contents)\n  - [Introduction](#introduction)\n  - [Getting started](#getting-started)\n    - [Connection settings](#connection-settings)\n    - [LifeCycle events](#lifecycle-events)\n    - [Prerequisites](#prerequisites)\n    - [Remarks](#remarks)\n      - [No user provisioning](#no-user-provisioning)\n      - [`GetPerson` not yet available](#getperson-not-yet-available)\n      - [Pre-Emptive authentication](#pre-emptive-authentication)\n      - [WSDL specifications](#wsdl-specifications)\n  - [Getting help](#getting-help)\n  - [HelloID docs](#helloid-docs)\n\n## Introduction\n\n_HelloID-Conn-Prov-Target-Planon_ is a _target_ connector. Planon offers web services APIs that allow developers to access and integrate the functionality with other applications and systems.\n\nThe Planon API uses a WSDL / SOAP architecture. A WSDL (Web Services Description Language) is an XML-based language that is used for describing the functionality of a web service. A WSDL file defines the methods that are exposed by the web service, along with the data types that are used by those methods and the messages that are exchanged between the web service and its clients.\n\n## Getting started\n\n### Connection settings\n\nThe following settings are required to connect to the API.\n\n| Setting| Description| Mandatory |\n| --- | --- | --- |\n| UserName| The UserName to connect to the Planon webservice| Yes|\n| Password| The Password to connect to the Planon webservice| Yes|\n| BaseUrl| The URL to the Planon webservice \u003cbr\u003e Example: *https://{environment}/nyx/services*| Yes       |\n| OrderCodesJSONFile | The path to a file with StandardOrderCode the required permissions\u003cbr\u003e And example can be found in the asset folder| Yes|\n\n### LifeCycle events\n\nThe following lifecycle events are available:\n\n| Event  | Description| Notes |\n|---|---|---|\n| create.ps1| Correlates an account| *ws:GetPerson* |\n| grant.ps1| Creates an order| *umr:MaakOrder* |\n| permissions.ps1 | Retrieves a list of order codes | Requires a file in JSON format containing standard user codes |\n\n### Prerequisites\n\n\u003e :exclamation: Note that, this connector has not been tested on a Planon environment. Changes might have to be made according to your environment.\n\n\u003e :exclamation: **Contact your Planon consultant to verify that the necessary WSDL's are available.**\n\n- [ ] A JSON file containing the standard order Codes.\n- [ ] URL to the Planon webservice\n- [ ] The `UmraOrders` and `SDWWebServices` [WSDL's](#multiple-wsdl-specifications) available.\n\n### Remarks\n\n#### No user provisioning\n\nThe sole purpose of this connector is to automatically create Planon orders. It cannot be used for user provisioning.\n\n#### `GetPerson` not yet available\n\nBoth the `create.ps1` and `grant.ps1` will need to retrieve the user account from Planon. The `create.ps1` for account correlation, the `grant.ps1` because the order send to Planon must contain the `EmployeeId` or `PersonnelNumber`.\n\nBecause the connector is based on documentation, the XML response for a `GetPerson` call to Planon is unclear. Therefore, this part is currently not developed and not available in the connector.\n\nThe PowerShell code below can be used to retrieve a person from Planon.\n\n```powershell\n$UserName   = ''\n$Password   = ''\n$BaseUrl    = ''\n$ExternalId = ''\n\n$pair = \"$($UserName):$($Password)\"\n$b64Encoded = [System.Convert]::ToBase64String([System.Text.Encoding]::ASCII.GetBytes($pair))\n$headers = [system.collections.generic.dictionary[string, string]]::new()\n$headers.add('Authorization', \"Basic $b64Encoded\")\n\n$body = @\"\n\u003csoapenv:Envelope xmlns:soapenv=\"http://schemas.xmlsoap.org/soap/envelope/\" xmlns:ws=\"http://www.tempsdw.org/SDWWebServices/v1/ws\"\u003e\n    \u003csoapenv:Body\u003e\n        \u003cws:GetPerson\u003e\n            \u003ccode\u003e$ExternalId\u003c/code\u003e\n        \u003c/ws:GetPerson\u003e\n    \u003c/soapenv:Body\u003e\n\u003c/soapenv:Envelope\u003e\n\"@\n\n$splatParams = @{\n    Uri         = \"$($BaseUrl)/SDWWebServices.SDWWebServicesSOAP\"\n    Method      = 'POST'\n    Headers     = $headers\n    Body        = $body\n    ContentType = 'application/text+xml; charset=utf-8'\n}\nInvoke-RestMethod @splatParams\n```\n\n#### Pre-Emptive authentication\n\nPlanon requires _Pre-Emptive_ authentication. Which means that, the outgoing request must contain the `authorization` header with the username:password in a base64 encoded string.\n\n#### WSDL specifications\n\nThe connector uses the following WSDL specifications:\n\n| WSDL  | Description |\n|---|---|\n| UmraOrders | To create, update and retrieves order(s) |\n| SDWWebServices | To retrieve and correlate a user account |\n\nBefore using this connector, contact your Planon consultant to verify the WSDL's listed above are available.\n\n## Getting help\n\n\u003e _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_\n\n\u003e _If you need help, feel free to ask questions on our [forum](https://forum.helloid.com)_\n\n## HelloID docs\n\nThe official HelloID documentation can be found at: https://docs.helloid.com/\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftools4everbv%2Fhelloid-conn-prov-target-planon-order","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftools4everbv%2Fhelloid-conn-prov-target-planon-order","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftools4everbv%2Fhelloid-conn-prov-target-planon-order/lists"}