TaskCentre Web Service Connector: Creëren van requests in Synergy Enterprise
Inhoudsopgave 1. Voorbereiding... 4 2. Web Service Connector tool configuratie... 5 3. TaskCentre taak voor het aanmaken van requests... 11 3.1 XML Document Import... 13 3.2 Web Service Connector... 16 4. Uitvoeren van de TaskCentre taak en controle... 23 15-3-2012 11:26 Taskcentre webservice connector Pagina 3 van 24
1. Voorbereiding In de volgende stappen gaan we een taak in TaskCentre creëren om via de Web Service Connector tool twee requests van type "Task" aan te maken in Synergy Enterprise. Systeemeisen TaskCentre 4.5.1171.0 Web Service Connector 1.0.482.0 Synergy Enterprise 242 Gebruikte versies: TaskCentre 4.5.1198.0 Web Service Connector 1.0.482.0 Synergy Enterprise 247 Aannames: Bovenstaande software is geïnstalleerd en geactiveerd. Synergy Enterprise is ingericht en de webservice voor Requests is aangezet. Er is een gebruiker in Synergy enterprise met rechten om de Requests aan te maken, en het ResouceID van deze gebruiker is bekend. NB. Zie de Synergy Enterprise documentatie voor het inrichten van de Synergy Enterprise webservices en gebruikers. Achtereenvolgens zullen we de Web Service Connector tool configureren, een taak creëren om de requests aan te maken, en deze testen. 15-3-2012 11:26 Taskcentre webservice connector Pagina 4 van 24
2. Web Service Connector tool configuratie Open in TaskCentre de configuratie voor de execute tools (onder TaskCentre->System->Tools->Execute) en open de configuratie voor de Web Service Connector Klik in het geopende "Web Service Configurations" venster op "Add" 15-3-2012 11:26 Taskcentre webservice connector Pagina 5 van 24
Geef in het New Configuration venster de configuratie een naam en geef de URL van de Synergy Enterprise request webservice Klik op "OK" NB. De ingegeven URL moet wijzen naar de server en IIS Application waar Synergy Enterprise geïnstalleerd staat. De webservice wordt nu benaderd en alle beschikbare methodes binnen deze webservice worden nu uitgelezen. 15-3-2012 11:26 Taskcentre webservice connector Pagina 6 van 24
Klik op de tab Endpoints. In dit tabblad is de service Request URLingevuld. TaskCentre heeft achter de Server in de URL het domein en local gezet. Vink "Override the Web Service URL" aan. Vul de URL opnieuw in zonder de domein en local toevoeging 15-3-2012 11:26 Taskcentre webservice connector Pagina 7 van 24
Klik op de tab Authentication Klik bij Authentication Details op Not required Klik op Test Authentication 15-3-2012 11:26 Taskcentre webservice connector Pagina 8 van 24
Selecteer de Create operation Klik op "Test". De create operatie van de Synergy Enterprise webservice wordt nu aangeroepen zonder parameters Controleer of de webservice onderstaande foutmelding teruggeeft. Deze foutmelding betekend dat de webservice beschikbaar is, maar de Create aanroep zonder parameters niet heeft kunnen verwerken. 15-3-2012 11:26 Taskcentre webservice connector Pagina 9 van 24
Klik op "Close" Sluit het venster en klik op "Yes" bij de opslaan dialoog Klik op "Close" 15-3-2012 11:26 Taskcentre webservice connector Pagina 10 van 24
3. TaskCentre taak voor het aanmaken van requests De webservice connector tool is nu geconfigureerd om requests te bewerken in Synergy Enterprise. Nu zullen we een TaskCentre taak maken om via deze webservice twee requests aan te maken. Rechts-klik in TaskCentre op het mapje tasks en klik op New Folder. Noem de folder Synergy Enterprise. Rechts-klik op de nieuwe folder en klik op New Task. Noem de task Synergy Enterprise - Create Request en Klik op "OK". In TaskCentre is nu onderstaande taak aangemaakt. We willen de taak draaien onder de gebruiker die rechten heeft om in Synergy Enterprise requests aan te maken. Voer daarvoor de volgende stappen uit: Open de taak en klik op de tab "General" Klik op "Options..." Klik op de tab "Impersonation" Selecteer Specify User en vul de User Name, Domain en Password in van de Synergy Enterprise gebruiker Klik op "OK" NB. De gebruiker moet rechten hebben om de webservices in Synergy Enterprise aan te spreken. Zie hiervoor de Synergy Enterprise documentatie. 15-3-2012 11:26 Taskcentre webservice connector Pagina 11 van 24
15-3-2012 11:26 Taskcentre webservice connector Pagina 12 van 24
3.1 XML Document Import In de taak maken we twee requests aan uit een XML bestand. Hiervoor zou ook een andere Input tool gebruikt kunnen worden, zoals Database Query (OLEDB). Het XML bestand welke we in deze oefening gebruiken heeft twee request, en bevind zich in het door u gedownloade ZIP bestand. De inhoud van dit document is als volgt: <Requests> <Request> <ResourceID>1</ResourceID> <Description>Pickup kids</description> <StartDate>2012-04-01T09:00:00</StartDate> <EndDate>2012-04-01T09:00:00</EndDate> </Request> <Request> <ResourceID>1</ResourceID> <Description>Visit grandmother</description> <StartDate>2012-04-01T09:00:00</StartDate> <EndDate>2012-04-01T09:00:00</EndDate> </Request> </Requests> NB. Het ResourceID is het ID van een medewerker in Synergy Enterprise die rechten heeft om webservices uit te voeren. Zie hiervoor de Synergy Enterprise documentatie. Voer de volgende stappen uit: Klik op de tab "Design" Rechts-klik in het design venster en selecteer New->Input->XML Document Import Voer de Path en File Name in van het bovenstaande XML bestand 15-3-2012 11:26 Taskcentre webservice connector Pagina 13 van 24
Klik op de tab "Main" Klik op "Browse" to XSD/XML File..., en selecteer het eerder aangemaakte XML bestand Klik op "Infer schema from XML" 15-3-2012 11:26 Taskcentre webservice connector Pagina 14 van 24
Klik op "Validate Schema" Klik na valideren op "OK", om het XML Document Import venster te sluiten. 15-3-2012 11:26 Taskcentre webservice connector Pagina 15 van 24
3.2 Web Service Connector We gaan de Web Service Connector step aanmaken: Rechts-klik in het design venster en selecteer New->Execute->Web Service Connector Selecteer in de tab General Use a recordset, XML, de XML Output van de XML Document Import is geselecteerd Klik op de tab Web service Selecteer de Synergy Enterprise Create Request webservice Selecteer bij Operations de operation Create 15-3-2012 11:26 Taskcentre webservice connector Pagina 16 van 24
De webservice en de input data voor de webservice zijn nu geselecteerd. We willen de input data mappen naar parameters voor de web service: Klik op de tab Mapping. Vul in "Seach" onder Tool Input de naam ResourceID in; deze wordt nu geselecteerd. Sleep bij Data Input het ResourceID veld op het Value veld onder ResourceID bij Tool Input, de velden worden gemapped. Herhaal deze laatste stap voor de Data Input velden "Description", "StartDate" en "EndDate". 15-3-2012 11:26 Taskcentre webservice connector Pagina 17 van 24
We willen een request van het Synergy Enterprise type Task aanmaken, deze heeft het RequestType 0. We willen hiervoor een statische waarde aan de webservice aanroep meegeven, door middel van een functie met een vaste waarde. Voer de volgende stappen uit: 15-3-2012 11:26 Taskcentre webservice connector Pagina 18 van 24
Klik op Functions (recht in het scherm) Sleep een Fixed/Dynamic element in het Functions and Mappings venster Dubbelklik op de functie Klik op het geopende venster op de tab Options Selecteer Output Value en vul 0 in Klik op OK in het Functions and Mappings venster 15-3-2012 11:26 Taskcentre webservice connector Pagina 19 van 24
Als laatste stap in het aanmaken van de Web Service Connector step willen we voor elke Request tag uit het invoer XML bestand een request van type Task aanmaken in Synergy Enterprise, hiervoor gaan we de Request tag aan de Create aanroep koppelen: Sleep onder data Input de Request map op de Create map bij Tool Input, er wordt een Transformation Function aangemaakt Klik op OK Klik op Yes in het bevestiging venster NB. Bij opslaan van de Web Service Connector step komt er een melding van verplichte velden onder Tool Input die niet gekoppeld zijn. Bij deze is het driehoekje rood gemarkeerd. Deze velden hoeven niet te worden gekoppeld. 15-3-2012 11:26 Taskcentre webservice connector Pagina 20 van 24
Sleep de XML Document Import step naar de Web Service Connector step, de twee steps worden gelinked Klik op OK, de taak kan nu worden uitgevoerd 15-3-2012 11:26 Taskcentre webservice connector Pagina 21 van 24
15-3-2012 11:26 Taskcentre webservice connector Pagina 22 van 24
4. Uitvoeren van de TaskCentre taak en controle We willen de taak uitvoeren om de twee requests aan te maken, en controleren of deze in Synergy Enterprise worden aangemaakt. Voer de volgende stappen uit: Rechts-klik op de Synergy Enterprise Create Request taak en selecteer Queue Now Controleer of de taak uitgevoerd wordt en de status Complete krijgt Open een browser venster naar Synergy Enterprise Klik onder My work op My requests Klik op Tasks Controleer of de twee Tasks zijn aangemaakt 15-3-2012 11:26 Taskcentre webservice connector Pagina 23 van 24
15-3-2012 11:26 Taskcentre webservice connector Pagina 24 van 24