Systembeschreibung Masterplan Kommunikationsinterface ASEKO GmbH Version 1.0 Status: Final Masterplan Kommunikationsinterface 0 Inhaltsverzeichnis 1 Einleitung ....................................................................................................................................... 2 2 Architektur ...................................................................................................................................... 2 3 1 2.1 Anbindung an die MKI Lösung ........................................................................................... 2 2.2 Inbound Kommunikationsmethoden .................................................................................. 2 2.3 Outbound Kommunikationsmethoden ............................................................................... 3 2.4 Authentifizierungsmethode .................................................................................................. 3 2.5 Spezifikation und Implementierung des Workflow-Mapping .......................................... 3 2.6 Daten Transfer, Message Syntax und Field Mapping ..................................................... 3 2.7 Value Mapping ...................................................................................................................... 3 2.8 Attachment Handling ............................................................................................................ 4 2.9 Fehlerbehandlung ................................................................................................................. 4 2.10 Optionen ................................................................................................................................. 5 Masterplan BI Suite ...................................................................................................................... 6 ©by ASEKO GmbH Im Heidkampe 36, 30659 Hannover Telefon: 0511 – 220 626 0 www.aseko.de Masterplan Kommunikationsinterface 1 Einleitung Die MKI ist eine All-in-One Appliance für die Integration von Geschäftsprozessen und die Automatisierung von Arbeitsabläufen. Die MKI unterstützt die Kommunikation und Synchronisation von ITSM Daten, Applikationen und Systemen. 2 Architektur Das ITSM-System des Kunden/Partners wird direkt an das MKI mit Hilfe eines standardisierten Connectors angebunden. 2.1 Anbindung an die MKI Lösung Zur Herstellung der Verbindung der ITSM Applikation des Kunden mit der MKI werden ein Inbound Connector und ein Outbound Connector eingerichtet. Die Verbindung basiert auf dem Internet Protokoll (IP). Die MKI verwendet asynchrone Kommunikation. Im Folgenden werden die Kommunikationsmethoden für die Anbindung an die MKI beschrieben. Die ausgewählte Kommunikationsmethode wird eingerichtet und getestet. 2.2 Inbound Kommunikationsmethoden Methode Auswahl Simple Mail Transfer Protocol Simple Object Access Protocol SMTP SOAP Representational State Transfer File Transfer Protocol Secure File Transfer Protocol REST FTP SFTP Methode 2 Auswahl Structured Query Language Simple Object Access Protocol SQL SOAP Representational State Transfer File Transfer Protocol Secure File Transfer Protocol REST ©by ASEKO GmbH Im Heidkampe 36, 30659 Hannover FTP SFTP Telefon: 0511 – 220 626 0 www.aseko.de Masterplan Kommunikationsinterface 2.3 Outbound Kommunikationsmethoden Methode Auswahl Simple Mail Transfer Protocol Simple Object Access Protocol SMTP SOAP Representational State Transfer File Transfer Protocol Secure File Transfer Protocol Structured Query Language REST FTP SFTP SQL Methode Simple Object Access Protocol File Transfer Protocol Secure File Transfer Protocol Auswahl SOAP FTP SFTP 2.4 Authentifizierungsmethode Abhängig von den ausgewählten Kommunikationsmethoden gibt es unterschiedliche Authentifizierungsmöglichkeiten. Diese werden nach Auswahl der Kommunikationsmethoden definiert. 2.5 Spezifikation und Implementierung des Workflow-Mapping Die Status-Codes der Kunden-Workflows werden den Partner-Workflows zugeordnet (Mapping). Es gibt bis zu 20 mögliche Status-Codes. Das genaue Mapping wird gemeinsam mit dem Kunden spezifiziert. Erst nachdem die Spezifikation abgenommen ist, beginnt die Implementierung und das Testen der Kommunikation. 2.6 Daten Transfer, Message Syntax und Field Mapping Daten werden in Form von XML Dokumenten transferiert. Die Übersetzung der kundenspezifischen Syntax in die providerspezifische Syntax (Field Mapping) wird für bis zu 30 Felder im System eingerichtet. Andere Datenstrukturen (CSV, name value pair) sind nicht Teil des Projektes – wenn nicht an anderer Stelle im Dokument ausdrücklich spezifiziert. 2.7 Value Mapping Bei manchen Feldern ist ein Value Mapping notwendig. Dieses wird im Rahmen des Projektes definiert und entsprechend eingerichtet. 3 ©by ASEKO GmbH Im Heidkampe 36, 30659 Hannover Telefon: 0511 – 220 626 0 www.aseko.de Masterplan Kommunikationsinterface 2.8 Attachment Handling Abhängig vom definierten Projekt Umfang für Attachment Handling werden folgende Leistungen von MKI ausgeführt: Auswahl X Methode Beschreibung Keine Attachments Nur Senden von Attachments Nur Empfang von Attachments Senden und Empfang von Attachments Es wird kein Attachment Handling implementiert. Attachments werden vom angebundenen System an das MKI transferiert. Limitierung s.u. Alle eingehenden Attachments werden an das angebundene System gesendet. Attachement können vom angebundenen System sowohl gesendet als auch empfangen werden. Bei SOAP und HTTPS POST Verbindungen wird base64-coding verwendet. Mail Transfer nutzt multipart Messaging. Nachrichtengröße ist limitiert auf 10 Megabyte. Größere Nachrichten werden nicht angenommen. Zusätzliches Filtern (z.B. Anzahl an Attachments, Virus Check) wird nicht vorgenommen. 2.9 Fehlerbehandlung Abhängig von der Kommunikationsmethode gibt es verschiedene Einrichtungsmöglichkeiten für das Error Handling. SOAP: Fire and Forgot Retry and Move Retry and Stop Standardmäßig wird eine E-Mail Benachrichtigung eingerichtet. Bei 5 maligem Zustellversuch wird eine Warning E-Mail versendet, bei 10 maligem Zustellversuch eine Error E-Mail. Zusatzanforderungen ans Error Handling müssen spezifiziert werden und sind nicht Gegenstand des Standardsystems. 4 ©by ASEKO GmbH Im Heidkampe 36, 30659 Hannover Telefon: 0511 – 220 626 0 www.aseko.de Masterplan Kommunikationsinterface 2.10 Optionen Method 5 Description VPN Tunnel Securing the connection with VPN tunnel Eine verschlüsselte Virtual Private Network (VPN) Verbindung wird eingerichtet. In der Betriebsphase wird der VPN Server überwacht, nicht jedoch die VPN Verbindung selbst. Implementierung von kundenspezifischer Daten Anreicherung Transaktionsdaten können mit Daten aus ASEKO Datentabellen angereichert werden. Erweiterungen und zusätzliche Anforderungen für die Datenanreicherung erfordern eine detaillierte Analyse und Spezifikation. Implementierung von erweiterter Fehlerbehandlung Individuelle Fehlerbehandlung für Datenbank Transaktionen wird implementiert. Der Inhalt der Fehlermeldungen richtet sich nach den Kundenanforderungen. Fehlermeldungen werden durch eines der folgenden Transport Protokolle übermittelt: SMTP, SFTP, HTTPS POST, SOAP. Zusätzliche Anforderungen für die erweiterte Fehlerbehandlung erfordern eine detaillierte Analyse und Spezifikation. ©by ASEKO GmbH Im Heidkampe 36, 30659 Hannover Telefon: 0511 – 220 626 0 www.aseko.de Masterplan Kommunikationsinterface 3 Masterplan BI Suite Das Masterplan Kommunikationsinterface ist im Rahmen der Masterplan BI Suite die universelle Ticketdrehscheibe zu Kunden- und Partnersystemen. 6 ©by ASEKO GmbH Im Heidkampe 36, 30659 Hannover Telefon: 0511 – 220 626 0 www.aseko.de