Info
Dit artikel behandelt activering door consultants. Zie dagelijks gebruik voor applicatiebeheerders: Module Maintenance Planning-integratie – Knowledge Base
1. Reikwijdte
Maintenance Planning volgt O-Prognose op en beheert meerjarenonderhoud (LTMP) van gebouwelementen en assets.
Per element ontstaat een langetermijnplan met periodieke taken, zoals schilderen elke 5 jaar.
De integratie houdt stamgegevens realtime gelijk en brengt taken naar Asset:
- Gebouwen en assets synchroniseren realtime.
- Onderhoudstaken worden werkactiviteiten in Asset.
- Koppel activiteiten aan LTMP-werkorders en stuur ze aan de voorkeursleverancier.
- Afgeronde activiteiten synchroniseren terug als gereed.
2. Doelgroep
Implementatieconsultants die de klantintegratie inrichten.
3. Vereisten
Benodigd:
- Een bestaande of nieuwe tenant in beide applicaties
- Activeer in Asset:
Stamgegevens: Gebouwen en terreinen
- Stamgegevens: Assets
- Het Maintenance Planning-ontwikkelteam levert client_id en client_secret. Configureer deze volgens hoofdstuk 5.2 Mappings in de API-connector hieronder.
4. Asset-configuratie
4.1 Moduleactivering
Gebruik Module activation voor niveau 2 en 3. Zie algemeen: Modules activeren
Info
Deze activering schakelt de Maintenance Planning-integratie in en activeert ook LTMP-werkorders standaard. Er is geen afzonderlijke activering voor LTMP-werkordersomdat deze altijd met de integratie worden gebruikt.
Bij v1 let je op 6.4 Asset en O-Prognose (v1)
Twee instellingen:
- Mandate approval LTMP work orders: voor goedkeuring door manager of groep vóór doorsturen.
- Plan LTMP work orders via planboard: voor toewijzing via kalender.
De API-connector wordt automatisch gemaakt en deels ingericht. Zie: API-connectoren
4.1.1 Workflow-e-mails
De workflow bevat:
- Een bericht aan de uitvoerder
- Een bericht aan de mandaatgoedkeurder, indien ingeschakeld
4.2 Mappings in de API-connector
Info
Zie uitleg: API-connectoren
Ga via startboard of menu naar Integrations → Maintenance Planning → Maintenance Planning API Connector:
Open Mappings :
Alle mappings worden toegevoegd; controleer automatische en handmatige waarden:
- client_id: Client ID uit de e-mail van het team, begint altijd met API_
- client_secret: Client Secret uit de team-e-mail
- environment: go voor productie of accept voor acceptatie
4.3 Geheime sleutel tonen
Open Trust relations en klik op Key password protected:
Info
Alleen partnergebruikers met G101 License editor kunnen sleutels tonen of genereren; het baselinebeheerprofiel heeft dit standaard.
Klik op ‘Reveal key’ bij een bestaande sleutel.
Klik op ‘Generate key’ als er nog geen is.
Kopieer de geheime sleutel en noteer deze voor Maintenance Planning.
4.4 Gegevens doorgeven
Geef het ontwikkelteam:
Naam |
Asset-waarde |
|---|---|
URL |
Omgevings-URL, bijvoorbeeld https://clientname.axxerion.com of https://axts08.axxerion.com) |
Client |
Client.reference |
App ID |
Referentie van de connector |
Access ID |
Naam van de gekoppelde ObjectTrustRelation |
Secret key |
Geheime sleutel van die TrustRelation |
Info
Het ontwikkelteam richt de Maintenance Planning-kant in. De consultant geeft alleen bovenstaande gegevens door.
5. Aan de slag
Na configuratie is de koppeling gereed. Afhankelijk van de huidige situatie gelden deze scenario’s:
- Alleen Asset zonder Maintenance Planning
- Alleen Maintenance Planning zonder Asset
- Bestaande Asset- en O-Prognose (v1)-integratie
- Bestaand Asset en Maintenance Planning zonder integratie
5.1 Asset zonder Maintenance Planning
Synchroniseer relevante LTMP-gebouwen en assets. Maak daarna onderhoudstaken voor de assets. Zie: Module Maintenance Planning-integratie – Knowledge Base
5.2 Maintenance Planning zonder Asset
Exporteer gebouwen en importeer met FMB-F-021. Zie Standaardimports .
Daarna terugsynchroniseren naar Maintenance Planning. Dit geeft twee records:
- Het bestaande gebouw
- Het vanuit Asset aangemaakte gebouw
Koppel het nieuwe record aan het bestaande. Het bestaande blijft gebruikt en wordt met Asset gesynchroniseerd.
De nieuw gesynchroniseerde, nu ontkoppelde records kunnen worden verwijderd.
5.3 Beide zonder integratie
Gebouwen bestaan al aan beide kanten. Volg de vorige aanpak zonder stappen 1 en 2 uit de afbeelding.
Begin bij stap 3 met Asset → Maintenance Planning-synchronisatie.
5.4 Asset en O-Prognose (v1)
Migreer eerst O-Prognose naar Maintenance Planning; neem contact op met Product/ontwikkeling.
Daarna gelden de stappen van 5.3.
Activering verbergt Elements voor de O-Prognose-categorie en toont Maintenance Planning Assets. Dat overzicht is eerst leeg: alleen via de nieuwe connector gekoppelde assets worden getoond, ongeacht categorie. Synchroniseer oude assets zodat key users ze weer zien.
Oude assets zijn te vinden via OPrognoseIntegration = true. Zie: Maintenance Planning-integratie | 1.2 Assets synchroniseren