Overslaan en naar hoofdcontent gaan

Dialog integreert met Relatics

  • Bijgewerkt

In Dialog is het mogelijk om informatie uit te wisselen met Relatics. Doorloop de volgende stappen om de koppeling te configureren. 

Benodigdheden

check_circle_outlined Dialog gebruiker account met 'beheerder' rechten

check_circle_outlined Relatics gebruiker account met toegang tot Workspace Studio.

help_outlined Optioneel: Communicatie module (meldingen, middelen en activiteiten delen)

 

Heads up: Dialog gaat ervan uit dat er altijd één applicatie in de lead is voor het beheren van informatie. Zo behoud je 'één waarheid'. Voorbeeld: stakeholders worden beheerd in Dialog en gedeeld met Relatics, en klanteisen worden beheerd in Relatics en gedeeld met Dialog.

Instellingen

Volg de volgende stappen om de integratie in te stellen vanuit de projectomgeving. 

  1. Klik rechtsboven in de pagina in Dialog op het settings icoon.
  2. Klik vervolgens op Instellingen, op het tabblad Integraties en dan op Verbind project in de Relatics card.
  3. In het paneel dat opent vul je de Environment naam in (dit is de tekst die voor .relaticsonline.com staat in de adresbalk van jouw Relatics omgeving).
  4. Vul vervolgens de Workspace ID in en klik op Opslaan rechtsonder in het scherm.

Informatie uit Dialog delen met Relatics

  1. Om informatie uit Dialog te delen met Relatics maak je in Relatics per item (bijvoorbeeld 'stakeholders') een Import Definitie en Webservice (server for receiving data) aan. De voorbeeld XML bestanden met de juiste benaming van de kolommen vind je onder Informatiemodel. 
  2. In de XML bestanden zijn relaties met andere items opgenomen. Van beide items zijn de Foreignkeys opgenomen, inclusief een unieke Relationkey van die relatie. Op basis van deze Relationkey kan de relatie geüpdatet worden. De Relationkey kent ook een RelationDeleted status (0/1), waarbij 1 aangeeft dat de relatie verwijderd is.
  3. Elk item heeft een deleted="0" veld, waarbij 1 aangeeft dat het item verwijderd is.
  4. Zorg ervoor dat de Foreign Key is opgenomen als Identifying specifications in de Import Element Node van de Import Definitie .
  5. Na het instellen van de import definitie en webservice vul je in Dialog de bijbehorende Operation Name en Entry Code in. 
  6. Klik vervolgens op Opslaan.
  7. Controleer of de webservice correct is ingevuld en er geen validatiefouten zijn opgetreden.
  8. Informatie uit Dialog wordt nu automatisch bij elke relevante wijziging gedeeld met Relatics.
  9. Let op: informatie die voortkomt uit Dialog kan niet in Relatics worden aangepast. Wijzigingen in Relatics worden overschreven als nieuwe informatie uit Dialog beschikbaar is.

Informatie uit Relatics delen met Dialog

  1. Om informatie uit Relatics te delen met Dialog maak je in Relatics per item een Report en bijbehorende Webservice (server for providing data) aan. Een voorbeeld XML met de juiste benaming van de kolommen vind je onder Informatiemodel.
  2. Het is belangrijk dat alle relevante informatie, zoals Name, ID, etc. als property in de Report wordt opgenomen. Download hieronder een voorbeeld response van de webservice (example webservice response.xml).
  3. Ook belangrijk is dat de ID en ForeignKey op het hoogste niveau in de response zijn opgenomen. Voor de ID ondersteunen we zowel ID als GUID.
  4. Neem contact op met Support voor het aanmaken van een testomgeving om de webservices te testen.
  5. Na het instellen van de Report en Webservice vul je in Dialog de bijbehorende Operation Name en Entry Code in. 
  6. Klik vervolgens op '+ Kolommen' om het Relatics informatiemodel te mappen met het Dialog informatiemodel. Let erop dat attribute dezelfde naam heeft als het element. Houd er ook rekening mee dat een aantal velden verplicht zijn. Welke dat zijn vind je onder Informatiemodel.
  7. Klik vervolgens op Opslaan.
  8. Controleer of de webservice correct is ingevuld en er geen validatiefouten zijn opgetreden.
  9. Informatie uit Relatics wordt nu automatisch gedeeld met Dialog. Dit gebeurt automatisch, elke keer als een project gebruiker inlogt.
  10. Let op: informatie die voortkomt uit Relatics kan niet in Dialog worden aangepast. Dialog is zo ingesteld dat Dialog gebruikers die informatie niet kunnen aanpassen..

Troubleshooting

  • Melding 'Foreign key must be unique'. Check of de Foreign Key is opgenomen als Identifying specifications in de Import Element Node van de Import Definitie.

Informatiemodel

Download hier per item het informatiemodel van Dialog in XML vorm. Gebruik deze om de Report en Import Definitie in te stellen. Dialog maakt gebruik van Base64 XML via de SOAP 1.2 protocol.

Verplichte velden

Bij het delen van informatie uit Relatics met Dialog zijn de volgende velden verplicht:

  1. Activities : ['name' , 'date']
  2. Complaints : ['date' , 'text']
  3. Contact person : ['last_name']
  4. Customer requirements: ['title']
  5. Issues: ['name' , 'issues_date' , 'description']
  6. Middel: ['type' , 'sent_date', 'group']
  7. Stakeholders: ['name']
  8. Tasks: ['task/text' , 'timestamp']