Home

inubit Suite: Systemkonnektor-Guide

1. lt CUSTOMER xlink href http www inubit com sqlrest CUSTOMER 1 gt 1 lt CUSTOMER gt lt CUSTOMER xlink href http www inubit com sqlrest CUSTOMER 2 gt 2 lt CUSTOMER gt lt CUSTOMER xlink href http www inubit com sqlrest CUSTOMER 3 gt 3 lt CUSTOMER gt lt CUSTOMER xlink href http www inubit com sqlrest CUSTOMER 4 gt 4 lt CUSTOMER gt lt CUSTOMER xlink href http www inubit com sqlrest CUSTOMER 29 gt 29 lt CUSTOMER gt lt CUSTOMERList gt Methoden Das REST Prinzip sieht vor dass auf Ressourcen mit den Standard HTTP Methoden GET POST PUT und DELETE zugegriffen wird Dadurch m ssen keine Protokoll Konventionen bekannt sein damit Client und Server kommunizieren k nnen Eine Anfrage Request z B nach einer bestimmten Bestellung besteht immer aus einer URL und einer HTTP Methode Die HTTP Methoden bilden dabei die grundlegenden Aktionen auf den Ressourcen ab Siehe HTTP Methoden verwenden Workbench Process Engine Systemkonnektor Guide Kap 27 3 S 292 inubit 6 1 Workbench Process Engine Systemkonnektor Guide 05 09 2013 292 REST Connector HTTP Methoden verwenden 27 3 HTTP Methoden verwenden Die in den REST Connectoren konfigurierbaren HTTP Methoden decken die Anwendungsf lle von REST Anwendungen ab HTTP Methode Bedeutung GET GET fragt die Repr sentation einer Ressource ab GET Requests k nnen beliebig oft abgeschickt werden
2. 44srnnnnnnnnnnnnnnnnnnennnnnnnnnennnnnnnnennennnnnnnnnennn an 233 23 6 Dialog Stati nen ann 236 23 6 1 Nachb rstationen 4 eek 237 23 6 1 1 Nachbarstation ber TCP IP ueuussssesennn nnnnsennnnnnnnsannnnnnnnennnnnnnanannnnnnnnnannnnnnnnennnnnnenennnneenn 241 23 6 1 2 Nachbarstation ber SNA LU 2 241 23 6 1 3 Nachbarstation ber ISDN 242 23614 Nachbarstation Uber reese Send ENNER en 242 23 6 1 5 Virtual Virtuelle Nachbarstation se ssscisaieriiserieeniirnn inni einni 243 23 6 1 6 Rouled Station le naeh 244 23 6 1 7 Verbindung aktivieren nn 245 23 6 1 8 EHffernen u a nk ee lea 245 KE E len EE 245 23 6 2 1 X 25 Empf nger KOnfigurieren nn 246 23 6 2 2 ISDN Empf nger konfigurieren 247 05 09 2013 inubit 6 1 Workbench Process Engine Systemkonnektor Guide Inhaltsverzeichnis 9 23 6 2 3 TCP IP Empf nger konfigurieren 24444444444nnnnnnnnennnnnnnennnnnnnnennnnnnnnennnnnnnennnnnnnnn nn 248 23 6 2 4 SNA LU6 2 Empf nger konfigurieren nn 248 24 OF Le E 251 24 1 Voraussetzungen anche a ala nHnaleaiealeiin 251 24 2 Funktionsprinzip 252 24 3 Daten bertragungsmodi a aeg 253 24 4 TVvsSEVO Monitoring ee eineinhalb enslay t 254 24 5 Dialog OFTP Datenaustausch Konfiguration 4usrnnnnnnnnnnnnnnnnnennnnnnnnnennnnnnnnennnnnnnnnnnnennnn an 255 24 6 Dialog Stationen nn ann 259 24 6 1 L6kale Station ee ins ls 259 24 6 2 Nachbarst tionen un ee ne seen 260
3. XMLQuery F r jedes SubSelect wird ein zus tzliches table Element mit den Attributen type subselect und alias NameDesSubselects erstellt Dieses table Element muss vor dem Haupt Select stehen Das Ergebnis des SubSelects wird in das Haupt Select in field und oder condition Elementen Uber das Attribut type subselect eingebunden dabei ist der Wert des field und oder condition Elements dann der Name des SubSelects ea lt tables gt lt table type subselect alias subFactory gt lt tableNames gt lt tableName gt SpeditionsTable lt tableName gt lt tableNames gt lt fields gt lt field gt lt fieldName gt factory lt fieldName gt lt field gt lt fields gt lt conditions gt lt condition type AND gt lt leftValue gt status lt leftValue gt lt operation gt lt operation gt inubit 6 1 Workbench Process Engine Systemkonnektor Guide 05 09 2013 80 Database Connector XML Querys Struktur und Beispiele lt rightValue gt X lt rightValue gt lt condition gt lt condition type AND gt lt leftValue gt TransportId lt leftValue gt lt operation gt lt operation gt lt rightValue gt lt xsl value of select FormPrepare Response Panel Transporte SLB Nr gt lt rightValue gt lt condition gt lt conditions gt lt table gt lt table type subselect alias subGate gt lt tableNames gt lt tableName gt SpeditionsTable lt tableName gt lt tableNames gt lt
4. r0000 teaser hen naar ENER dann a aE AEE E Ea 343 31 1 FU nktionsprinzip eroian iaaa ana a ren duane dha valve Dada DE nah und de anna eg 343 31 2 Beispiel WorktloW u rear eh ee ern een nee daaa aaia 344 31 3 M dulvariablen u ee landed evan vaddeevdslannecedauubddec A 345 31 4 Dialog Secrypt Connector Eigenschaften A 345 32 Security Token Service Connector uusuunsennennnnnnennnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnn nn 349 32 1 Funktionsprinzip des STS Connectors ccccccccceeceeeeeeeeceecnneaeeceeeeeeeeeeesecsecaaecaeeeeeeeeeeeeeseesesniaeeeeeees 350 32 2 Web Services Provider an STS Connector registrieren usssss444nennensnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnn ana 352 32 3 Dialog Security Token Service WS Trust usssrssnneeneennnnnnnnnennnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnn 355 33 Selem COMMECON eeeegeseeetie see Eege 357 KR IE MEET 358 33 2 Fehlerbeh ndlung suse arcu esst deeg LEHE Rs Helle 360 33 3 Dialog Selenium Connector Eigenschaften 361 34 SNMP Connector i cccccccicct cecvesecedecevvescdtenctenececeansteccedceevetccttteevtecedtenevancetteevvancdtienevsiddsdeenvancbeedeetelieeevarccieenveins 363 34 1 Funkti nsprinzip uncut een Bi eigen 363 34 2 Beispiel Medium Connector 00 2 2 22 cc ccc eeeeeeeeeeceeeeeeceeeeeee eects ee caaaaaaeaeeeeeeeeeeseesecaaaaaecaeseeeeeeeeeecscnsaaeeeseess 365 34 3 Beispiel Input Connector
5. Si http www openssl org docs apps reg html 2 Konvertieren Sie das im Schritt 1 generierte Schl sselpaar in das PKCS12 Format um es in den Java Keystore importieren zu k nnen Dabei m ssen Sie ein Passwort vergeben openssl pkcsl2 export in selfsigned crt inkey selfsigned key out selfsigned pl2 Si http www openssl org docs apps pkcs12 html 3 Importieren Sie die PKCS12 Datei in den Java Keystore keytool importkeystore srckeystore selfsigned pl2 srcstoretype pkcs1l2 srcalias 1 srcstorepass inubit destkeystore selfsigned keystore jks destalias tomcat deststorepass lt yourPassword gt 05 09 2013 inubit 6 1 Workbench Process Engine Systemkonnektor Guide Web Services Connector 435 Schl sselpaar f r WS Security erstellen Si http docs oracle com javase 6 docs technotes tools solaris keytool html 4 Generieren Sie einen JKS Truststore mit dem Service Zertifikat Als Passwort geben Sie das im Schritt 2 vergebenen Passwort an keytool importcert keystore selfsigned truststore jks file selfsigned crt alias tomcat storepass lt yourPassword gt Si http docs oracle com javase 6 docs technotes tools solaris keytool html 40 7 2 Extern signiertes Schl sselpaar erstellen So gehen Sie vor 1 Generieren Sie einen Keystore mit einem automatisch generierten Zertifikat Setzen Sie dazu die Optionen gem Ihren Anforderungen keytool genkey keyalg RSA dname CN myServerName O m
6. Im Objektmodus wird immer die Operation ausgef hrt die im Modulassistenten des BO Connectors definiert ist Siehe Option Operation Workbench Process Engine Systemkonnektor Guide Kap 5 S 58 inubit 6 1 Workbench Process Engine Systemkonnektor Guide Business Object Connector 49 Objektmodus verwenden 5 2 1 Create Update Delete Operationen Beispiel f r Eingangsnachricht Bei Create Update und Delete Operationen erwartet der BO Connector ein XML basiertes Gesch ftsobjekt als Eingangsnachricht und gibt die Daten des Objekts und Namensraum Angaben aus Standardm ig werden auch die Objekt IDs ausgegeben dieses Verhalten k nnen Sie abschalten Siehe Standard ID ausgeben Workbench Process Engine Systemkonnektor Guide Kap 5 S 58 Voraussetzungen Die Struktur des Gesch ftsobjekts ist konform zu dem XML Schema das im BO Connector definiert ist 41 EHI Q inubirepostory Root jh bestellung_october2010 xml Z Bestellung bestelldatum 20 10 10 26 E G Lieferadresse d i land DE amp 3 Name Alice Schmid G Stra e Walnussgasse 42 lt gt Ort Frankfurt Main Gah PLZ 60000 E G Rechnungsadresse dei land DE 4 Name Robert Schmid 3 Stra e Haselnussweg 3 Ort Frankfurt Main 3 PLZ 61240 E G Kommentar Bitte mit Geschenkverpackung F 3 Waren D Buch d i ISBN 3776622148 amp 3 Titel Vom Gl ck der Faulheit Lebensenergie rich
7. Authentifizierung HTTP Header Konfiguration RosettaNet HTTPS Connector 325 Dialogbeschreibungen Server URL URL und Port des Serviets welches auf RosettaNet Nachrichten wartet Authentifizierung erforderlich Markieren Sie diese Option wenn der Server eine Authentifizierung fordert Geben Sie dann den Account ein den der Connector fur die Authentifizierung verwenden soll Benutzername Benutzername f r die Authentifizierung Passwort Passwort f r die Authentifizierung ber den Header k nnen Informationen wie z B Dateigr e HTTP Server und User Agent Kennung oder MIME Typ zwischen Client und HTTP Server bertragen werden Der Button Header Liste ffnet einen Dialog in dem Sie Name Wert Paare als Header definieren k nnen Informationen ber zul ssige Header finden Sie in der HTTP Spezifikation siehe http www w3 org Protocols HTTP 1 1 rfc2616 pdf 29 5 5 Dialog Empfangsbest tigungen Versand der Empfangsbest tigung Output Connector Ein Output Connector zum Versand asynchroner Empfangsbest tigungen kann an einer beliebigen Stelle in dem Workflow platziert werden der die RosettaNet Nachrichten empf ngt Die n tigen Daten holt sich der Output Connector aus einer Variablen die von dem RosettaNet Input Listener am Anfang des Workflow gef llt wurde Siehe Beispiel Workflow Nachrichten empfangen und Best tigung senden Workbench Process Engine Systemk
8. Der OFTP Connector erteilt die Freigabe f r die OFTP Middleware selbst ndig es ist keine Interaktion eines Operators erforderlich HOLD IMMEDIATE F r die Empfangsbest tigung wird auf einen Freigabe gewartet Wenn diese erteilt wurde wird die Empfangsbest tigung sofort ber die noch bestehende Verbindung gesendet Wurde diese bereits beendet wird sofort eine neue Verbindung f r das Versenden der Empfangsbest tigung aufgebaut und die Best tigung wird versendet Der OFTP Connector erteilt die Freigabe f r die OFTP Middleware selbst ndig es ist keine Interaktion eines Operators erforderlich Neighbour Station Name Telefon Bemerkungen und Netzwerk sind optionale Felder Geben Sie hier Informationen dar ber an wer die Konfiguration der Nachbarstationen pflegt Line Type Unterbrochen Mit dieser Option k nnen Sie w hlen ob die Verbindung automatisch beendet werden soll suspended oder nicht Autodial Wenn diese Option ausgew hlt ist baut die OFTP Middleware automatisch eine Verbindung auf wenn eine Nachricht zu senden ist inubit 6 1 Workbench Process Engine Systemkonnektor Guide OFTP Connector 241 Dialog Stationen Parallele Session Der Standard ist 1 Mit dem Wert 1 wird der Wert aus der globalen Variablen MAXSESSIONS bernommen der in der OFTP Middleware gesetzt wird Verz gerung vor dem W hlen Geben Sie hier eine ganze Zahl an Die Zahl gibt die Sekunden an di
9. Nein Ja ger Zur ck tap Weiter X Abbrechen Markieren Sie die Checkboxen der Parameter die als Elemente in das XML Template bernommen werden sollen Wenn ein Parameter nicht im Template ber cksichtigt werden soll entfernen Sie die Markierung der Checkbox vor dem Parameter Geben Sie an ob die Werte aus den Spalten neben den Funktionen Parametern als Attribute in das XML Template bernommen werden sollen Klicken Sie auf Fertig stellen Der Dialog schlie t sich und das Template wird im Bereich XML Ziel angezeigt 8 F r die weitere Bearbeitung des XML Templates ziehen Sie den Wurzelknoten der Nachricht auf das Element xs1 template Danach sieht das Stylesheet folgenderma en aus 05 09 2013 inubit 6 1 Workbench Process Engine Systemkonnektor Guide SAP Connector 337 Dialog SAP Connector Eigenschaften Eigenschaften XSLT Converter 9 G IQ XSLT Skript BAPI_BANK_GETLIST Result L nderschl ssel der Bank dat description MAX_ROWS reg M type INT length unt teens en nft ae mn mann I bt DI oa BANK LST ikea t Lues TABLE desc ee a Que ze i amp xsl stylesheet http www w3 org 1999 xSL Transform iar xsl com msf xslt Formatter format 2 at msff http schemas xmisoap org soap envelopef iQ soapeny http www w3 org 2001 xMLSchema dar xsd http www w3 org 2001 xML5chema instance i GaP xsi http schemas xmlsoap org soap encoding
10. Timeout Zeit in Sekunden nach welcher der Versuch eine Verbindung aufzubauen abgebrochen wird Session Maximale Anzahl der parallel aktiven Empf nger Erfragen Sie den Wert von Ihrem Gesch ftspartner Der Standard ist 1 DBit Delivery Confirmation Bit Wenn ausgew hlt dann fordert die sendende Station eine Empfangsbest tigung an m Geschlossene Benutzergruppe Closed User Group CUG Wenn eine Station Mitglied in einer CUG ist dann werden Nachrichten nur zwischen Stationen gesendet und empfangen die in derselben CUG sind Virtuelle Schaltung Virtual circuits Dabei wird alles au er der bertragungsroute festgelegt Damit ist es m glich die Route bei Bedarf zu w hlen und ber mehrere Kan le durch Multiplexing die bertragungsrate zu erh hen Sie k nnen zwischen den inubit 6 1 Workbench Process Engine Systemkonnektor Guide OFTP Connector 247 Dialog Stationen Parametern S switched virtual circuit SVC und P permanent virtual circuit PVC w hlen PVC Verbindungen sind beispielsweise bei Banken g ngig SVC Verbindungen werden genutzt wo eine dauerhafte Verbindung nicht notwendig ist Ger tename Benennt das Ger t device name Geben Sie eine beliebige alphanumerische Zeichenkette ein Der hier angegebene Namen muss mit dem Namen bereinstimmen der in der Konfiguration des Gesch ftspartners steht Alias Wenn mehr als ein Router im Netzwerk existiert geben Sie den Namen oder I
11. inubit 6 1 Workbench Process Engine Systemkonnektor Guide 05 09 2013 58 Business Object Connector Dialog Business Object Connector Einstellungen Objektmodus Datenbankverbindung 05 09 2013 Geben Sie die HTTP URL ein unter der das XML Schema zu erreichen ist oder klicken Sie auf um ein XML Schema aus dem Repository zu laden Objekt Identifikatoren Die Spalte Identifikator dient zur Auswahl eines Elements im XML Schema mit dem die Gesch ftsobjekt eindeutig identifiziert werden k nnen Operation Zur Auswahl der Operation die der BO Connector im Objektmodus ausf hren soll Folgende Operationen sind verf gbar Create F gt ein Gesch ftsobjekt hinzu Read Liest ein Gesch ftsobjekt Update ndert Details eines Gesch ftsobjekt Delete L scht ein Gesch ftsobjekt Im Querymodus wird die ausgew hlte Operation ignoriert Siehe auch Objekt und Querymodus Workbench Process Engine Systemkonnektor Guide Kap 5 S 48 Standard ID ausgeben Die Standard ID ben tigen Sie im Objektmodus um auf ein bestimmtes Objekt zugreifen zu k nnen nur relevant im Objektmodus Wenn die Option nicht markiert ist werden keine IDs ausgegeben Voreinstellung W hlen Sie den Typ der vorkonfigurierten Datenbank um die Felder Dialekt Datenbank URL und Datenbanktreiber Klasse sinnvoll zu belegen Dialekt W hlen Sie den f r Ihre Datenbankversion geeigneten Hibe
12. C gt 5 lt Es wird dringend empfohlen bei Stored Procedures und Funktionen das optionale name Attribut zu verwenden Eine nderung der Parameterreihenfolge hat dann keine Auswirkungen auf den Workflow da dann die Parameterwerte anhand des Parameternamens an die Prozedur bergeben werden Beispiel mit optionalem name Attribut lt query type call gt lt method name TESTPROC_INOUT2 gt lt parameter direction IN name MyNumericParam type NUMERIC gt 5 lt parameter gt lt parameter direction IN name MyVarcharParam type VARCHAR gt 5 lt parameter gt lt parameter direction OUT type NUMERIC gt 5 lt parameter gt lt method gt lt query gt lt parameter direction OUT type NUMERIC gt 5 lt parameter gt lt method gt lt query gt inubit 6 1 Workbench Process Engine Systemkonnektor Guide 05 09 2013 84 Database Connector Dialogbeschreibungen 6 5 Dialogbeschreibungen Dieser Abschnitt erl utert die folgenden Themen Dialog Datenbankverbindungen und Query Typ S 84 Dialog Metadaten S 87 Dialog Statische SQL Query S 88 Dialog Ergebnis der Query S 88 Dialog Datenbank Connection Pooling S 90 6 5 1 Dialog Datenbankverbindungen und Query Typ 05 09 2013 Datenbankverbindung Dieser Dialog bietet folgende Optionen Voreinstellung Zur Auswah
13. Eintr ge verschieben nennen 114 8 3 4 Weitere Aktionen konfigurieren amade nannten 114 9 Execution Connector 2 4 2 25 22 Haaar HERE ate event DE Here Han nahe a Denn ee 115 9 1 Beispiel Verzeichnis ausgeben 2 ccceceeeneeeeeeeeeeeeeeeeeeaneeeeseneneeeeseeaeseeseeauseneseeaaaeeeeseeneneeeeneneneceetes 115 9 2 Beispiel iDatel k pieren u ein aka ahead areas nern 117 9 3 Beispiel Verzeichnis anlegen c cece eceeeeeeeeeeeeeeeeeeteceeeeeeeeeceeeeeeeteceeaeeeeseeeaaeeeeseeeaaeeeseeeaeeeesennaaeeees 117 9 4 Dialog Execution Connector Eigenschaften 118 10 File el ET 123 10 1 Modulvariablen des File Commectors cccccccccecceceeeeeeneneseeeceeeeeseeeneeseeeeeneneseessceneeseeesenseseenseeeeeeeetenes 123 10 2 Dialogbeschreib ngen es eine nein 124 10 2 1 Dialog Zu lesende Dateifen u ua lea 124 10 2 2 Dialog Datenwetergabel AAA 127 10 2 3 Dialog Zu schreibende Datei osiris Een aa AA ET EEEN AAEE 129 11EIRGonnecteor egegeEEKeEEAEEEEREEEAEEEEEENEAEASEEESEEEEEERENEEEEEEEEREEEAENEEEENEEENEERENAAAEEEEEEEEAEEEEEEEEEAEEEEREEEAENEEERNEEEEEEREEEEEAEEEEECN 133 11 1 Mod lvariablen eu 40 ee ee Be een 133 inubit 6 1 Workbench Process Engine Systemkonnektor Guide 05 09 2013 5 6 Inhaltsverzeichnis 11 2 Dialogbeschreib ngen eed eee an nee en dl el ne Hin 134 11 2 1 Dialog FTP Connector Eigenschaften senriskan AAAA Naa ne
14. Si Sie m ssen die Microsoft Exchange Server MAPI Client and Collaboration Data Objects CDO und J Integra for Exchange installieren um die Kommunikation mit dem Exchange Server herzustellen Diese Software erhalten Sie zusammen mit der Lizenz f r den Exchange Connector von der Bosch Software Innovations GmbH Detaillierte Installationsanleitungen finden Sie unter http j integra intrinsyc com support exchange doc Um einen stabilen Betrieb sicherzustellen empfiehlt die Bosch Software Innovations GmbH das CDO auf einem anderen Server als dem Exchange Server zu installieren jag iS DCOM MAPI aes CDO Server EEN Exchange Server MICROSOFT J Integra Product SDK Beachten Sie au erdem Der CDO Server und der Exchange Server m ssen in derselben Domain sein Auf dem CDO Server darf Outlook nicht installiert sein Outlook besitzt eine eigene CDO Installation die Konflikte verursachen kann Mehrere Exchange Konnektoren d rfen nicht parallel auf dieselbe CDO Installation zugreifen Das CDO ist nicht multithreading sicher 8 2 Exchange Connector verwenden 05 09 2013 Die von Ihnen konfigurierte Aktion bestimmt wie der Exchange Connector in einem Technical Workflow verwendet wird F r die meisten Aktionen ben tigt der Exchange Connector eine XML basierte Eingangsnachricht in der die auszuf hrende Aktion und deren Parameter definiert sind Die XML basierte Eingangsnachricht erstellen Sie mi
15. Systembackup Die gesamte Logging Datenbank wird gesichert inkl Status und Timeouts der Prozesse lt inubit installdir gt server ibis_root log Benutzer Benutzergruppen Backup Die Daten der ausgew hlten Benutzer der ausgew hlten Benutzergruppen werden gesichert Repository Systembackup Es werden alle Daten unterhalb von Global gesichert Benutzer Benutzergruppen Backup Die Daten der ausgew hlten Benutzer der ausgew hlten Benutzergruppen werden gesichert Tasks amp Waitings Nur bei Systembackup Sichert alle Tasks aller Benutzer aus der Task Datenbank und dem Task Verzeichnis lt inubit installdir gt server ibis_ root tasks sowie die Nachrichten und Variablen aus wartenden Prozessen die z B an Wait Modulen und Multiplexern anliegen F r Informationen ber das Wechseln der inubit Task Datenbank siehe inubit Task Datenbank austauschen Process Engine Administrator und Entwickler Guide Kap 8 3 S 126 Portal Sichert alle Organisationen und Communities des Portalservers die im Bereich Portal ausgew hlt sind 05 09 2013 inubit 6 1 Workbench Process Engine Systemkonnektor Guide Backup Connector 45 Dialog Backup Connector Eigenschaften Portal Es werden alle Organisationen und Communities angezeigt die im konfigurierten Portalserver vorhanden sind Bei einem Systembackup inkl Portal werden alle markierten Organisationen und Communities gesichert i
16. derefAliases neverDerefAliases sizeLimit 1000 gt lt filter gt lt equalityMatch name cn gt lt value gt john lt value gt lt equalityMatch gt lt filter gt Im folgenden Beispiel wird nach den gleichen Kriterien wie oben gesucht Allerdings sollen die ausgegeben Attribute auf das Attribut objectSid beschr nkt werden lt searchRequest dn ou Marketing dc inubit dc com scope singleLevel derefAliases neverDerefAliases sizeLimit 1000 gt lt filter gt lt equalityMatch name cn gt lt value gt john lt value gt lt equalityMatch gt lt filter gt lt attributes gt lt attribute name objectSid type binary gt lt attributes gt Wenn binare Attribute Uber den LDAP Connector ausgelesen werden sollen mussen diese Attribute bereits in der Eingangsnachricht gekennzeichnet bzw maskiert werden Im Search Request m ssen Sie dazu das Attribut type binary einf gen Die Werte aus dem LDAP System f r bin re Attribute werden mit der base64 Kodierung in der XML Ausgangsnachricht abgelegt inubit 6 1 Workbench Process Engine Systemkonnektor Guide 19 2 3 Add Beispiel 19 2 4 Delete Beispiel LDAP Connector 203 Dialog LDAP Connector Eigenschaften Neue Objekte und Attribute f gen Sie mit lt addRequest gt ein Die Anweisung zum Einf gen eines Objektes Alice Johnson vom Typ Person lautet lt addRequest dn 0U Marketi
17. inubit 6 1 Neue Features TCP IP Connector 395 Dialogbeschreibung Nummer des Ports ber den die Nachrichten ausgetauscht werden sollen Standardm ig ist dies der Port 60000 Portnummern gr er als 65536 k nnen Sie nicht nutzen Um den Standard wiederherzustellen klicken Sie auf den Button Standard Stellen Sie sicher dass keine andere Anwendung auf den A angegebenen Port zugreift und keine Firewall den Port blockiert Pr fen auf Start und Stopbytes Durch Aktivieren dieser Option nutzen Sie die Verarbeitung von IP Messages mit Start Stopbyte Sequenzen IP Nachrichten mit Start Stopbyte Begrenzung verarbeiten Neue Features Kap 37 2 S 393 Startbyte Sequenz Tragen Sie hier die Bytefolge ein mit der die gew nschte IP Nachricht beginnt Stopbyte Sequenz Tragen Sie hier die Bytefolge ein mit der die gew nschte IP Nachricht endet Verbindungstest Verbindung testen Zum Testen ob die Verbindung mit Ihren Angaben erfolgreich aufgebaut werden kann inubit 6 1 Neue Features 05 09 2013 396 TCP IP Connector Dialogbeschreibung 05 09 2013 inubit 6 1 Neue Features 3518 Connector Verwendung Konnektortypen 397 Dieser Abschnitt erl utert die folgenden Themen m Modulvariablen des VFS Connectors S 397 m Dialogbeschreibungen S 398 Ein VFS Virtual File System Connector sorgt daf r dass die inubit Process Engine mit lokalen und entfernten Dateisystem
18. www perl com doc manual html pod perlre html oder http www regular expressions info tutorial html Windows Das Windows Betriebssystem erm glicht es Dateien auszublenden Wenn ausgeblendete Dateien einem Wildcard Kriterium gen gen werden sie auch bertragen Stellen Sie sicher dass die Dateien die Sie im Verzeichnis des Explorers sehen k nnen auch alle Dateien sind die hier enthalten sind Blenden Sie dazu alle Dateien ein im Explorer Optionen Extras Ordneroptionen Inbox Unterverzeichnis Geben Sie den Verzeichnisnamen an den Sie in der Middleware unter Inbox angelegt haben und in das die eingehenden Dateien abgelegt werden sollen Der Ordner Inbox ist identisch mit dem Ordner lt rvs install dir gt usrdat auf dem rvs Server Wenn Sie kein anderes Verzeichnis konfiguriert haben werden hier die eingehenden Nachrichten abgelegt Virtueller Dateiname beim Input Connector nicht vorhanden Sie k nnen im virtuellen Dateinamen virtual dataset name VDSN als erstes einen Verzeichnisnamen angeben beispielsweise abc 123order edi in diesem Fall wird die Datei bei Ihrem Gesch ftspartner in folgendes Verzeichnis gelegt lt rvs install dir gt usrdat inbox abc Empf ngerstations ID beim Input Connector nicht vorhanden Eine Stations ID SID kann bis zu 16 Zeichen umfassen Diese ID wird nur lokal genutzt Die ID ist frei w hlbar und kann aus Zahlen inubit 6 1 Workbench Process Engi
19. 05 09 2013 In diesem Dialog haben Sie folgende Optionen Managername Name des Queue Managers zu dem die Verbindung aufgebaut werden soll Servername Name des Servers auf dem der WebSphere Application Server lauft Port Nummer des Ports uber den die Kommunikation zum WebSphere Application Server stattfindet Standardportnummer ist 1414 Der Button Standard setzt jederzeit den Port wieder auf 1414 zur ck Channel Name des Channels ein f r den Sie die Verbindung konfigurieren wollen Der MQ Series Queue Manager kann mehrere Channel haben Jeder Channel muss einen eigenen Namen haben Queuename Name der Queue ber die Sie Nachrichten empfangen m chten In einem Channel k nnen mehrere Queues verwaltet werden Methode Methode zur Nachrichtenbehandlung Wenn Nachrichten von einer Queue geholt werden sind sie dort nach der FIFO Methode gelistet Die erste Nachricht die empfangen wurde wird als erste geholt Input Connector inubit 6 1 Workbench Process Engine Systemkonnektor Guide WebSphere MO Connector 479 Dialog WebSphere Message Queue Connector GET Holt die erste Nachricht von der Queue und l scht diese aus der Queue BROWSE Holt eine Kopie der ersten Nachricht aus der Queue Die Originalnachricht bleibt in der Message Queue erhalten INQUIRE Fragt die Anzahl der Nachrichten in der Queue ab Das Ergebnis wird als ganze Zahl in einer XML formatierten Nachricht ausgegeben Ou
20. 355 Dialog Security Token Service WS Trust 32 3 Dialog Security Token Service WS Trust Service Name WSDL Datei Transport Sicherheit STS Authentifizierung Consumer Authentifizierung In diesem Dialog konfigurieren Sie den Security Token Service registrieren Service Provider und konfigurieren deren Authentifizierung am STS Name unter dem der STS seinen Dienst anbieten soll Standardm ig wird der Name des Konnektors verwendet Sie k nnen diesen Wert ndern WSDL Datei mit der Schnittstellenbeschreibung des STS den Pfaden zum Keystore des STS und zum Truststore der gesicherten Service Provider sowie den dazugeh rigen Passw rtern und Aliasen Zur Auswahl des Verschl sselungsverfahrens XML Encryption Die Daten innerhalb der zu bertragenden Nachrichten werden entsprechend dem Standard XML Encryption verschl sselt Siehe http www w3 org TR xmlenc core SSL Der Datentransport wird entsprechend dem SSL Protokoll verschl sselt Zum Hinzuf gen des Keystores Passwort Passwort des Keystores Keystore Button Datei ausw hlen Zum Importieren des Keystores Nach erfolgreichem Import wird die G ltigkeit des Schl ssels angezeigt X 509 Authentifizierung mit einem X 509 Zertifikat Die Datei mit den Zertifikaten k nnen Sie ber den Truststore Button importieren Benutzer Passwort Authentifizierung ber eine Benutzer Passwort Pr fung
21. JAAS Connector Eigenschaften t Markierte Zeile eine Position nach oben verschieben 4 Markierte Zeile eine Position nach unten verschieben Grunds tzlich ist die Reihenfolge der Login Modul Optionen f r die Abarbeitung nicht wichtig sondern verbessert die Ubersichtlichkeit Verbindungstest m Verbindung testen Zum Testen ob die Verbindung mit Ihren Angaben erfolgreich aufgebaut werden kann Der Verbindungstest kann nur ausgef hrt werden wenn Sie A Benutzername und Passwort mit der Option Fest eingegeben haben weil zum Testzeitpunkt keine Benutzerkontodaten aus Eingangsnachrichten oder Variablen zur Verfugung stehen 05 09 2013 inubit 6 1 Workbench Process Engine Systemkonnektor Guide D 173 162 Reflection Connector Dieser Abschnitt erl utert die folgenden Themen Eingangsnachricht erstellen S 173 Eigenen Methodenaufruf erzeugen S 174 Beispiel Methodenaufruf S 176 Attributliste S 180 Dialog Java Reflection Connector Eigenschaften S 180 Verwendung Mit einem Java Reflection Connector k nnen Sie dynamisch zur Laufzeit auf Java Objekte zugreifen und diese manipulieren Der Java Reflection Connector greift auf die Java Reflection API zu welches z B folgendes erm glicht Eigenschaften einer Klasse bestimmen Objekte erzeugen Methoden aufrufen Der Java Reflection Connector unterst tzt Aufrufe von statischen und nicht statischen Methoden auf einem Java Objekt Es k nnen
22. Lesebest tigungen versenden Lesebest tigungen abholen Wenn f r Nachrichten Lesebest tigungen angefordert sind erzeugt und versendet ein X 400 SE Input Connector automatisch Lesebest tigungen Nachrichten f r die eine Lesebest tigung angefordert wird enthalten ein isIPN Element mit dem Wert false Lesebest tigungen enthalten ein isIPN Element mit dem Wert true Lesebest tigungen f r Nachrichten die mit einem X 400 SE Output Connector versendet wurden werden nur dann aus der X 400 Mailbox abgeholt wenn Sie XML Nachrichten abholen 43 3 Dialogbeschreibungen Dieser Abschnitt erl utert die folgenden Themen Dialog X 400 Zugangsdaten S 486 Dialog Datenweitergabe konfigurieren S 488 Dialog Nachrichtenoptionen f r den Versand S 489 inubit 6 1 Workbench Process Engine Systemkonnektor Guide 05 09 2013 486 X 400 SE Connector Dialogbeschreibungen 43 3 1 Dialog X 400 Zugangsdaten Grundkonfiguration Authentifizierung In diesem Dialog geben Sie die Zugangsdaten zu Ihrer X 400 Box und Ihre Absenderadresse an PA Adresse Adresse des Providers Ihrer X 400 Box Ersetzen Sie Hostnamen und Port durch die Angaben Ihres X 400 Providers Hostnamen und Port Nummer finden Sie am Ende der Vorbelegung OMSPSAP SOMS_OSI_SERVER TOMS_ OSI SERVER URI 0O000 URL itot 1localhost 5432 localhost Hostname 5432 Port Nummer Der Button
23. Nachrichten l schen nach Tagen Die Angabe legt fest nach wie viel Tagen die IDs der bereits empfangenen RosettaNet Nachrichten aus dem Dateisystem gel scht werden Die IDs werden in einer XML Datei gespeichert Bei einer sehr gro en Anzahl von Nachrichten kann diese Datei so gro werden dass die Performance beeintr chtig wird Deswegen werden die IDs regelm ig gel scht Sendewiederholungsverz gerung Wartezeit in Sekunden die der Connector aktiv wartet bis er eine Nachricht erneut sendet Standard 30 Sekunden Das Produkt aus Sendewiederholungsverz gerung und Anzahl der Sendewiederholungen siehe Sendewiederholungen Workbench Process Engine Systemkonnektor Guide Kap 29 S 322 sollte in jedem Fall kleiner gew hlt werden als der Timeout des Connectors Register System Connector Eigenschaften Anh nge ins Dateisystem speichern nur beim Input Connector Wenn markiert dann werden Attachments nach dem Empfang automatisch in Variablen abgelegt F r jedes Attachment werden drei Variablen erstellt wenn mehrere Attachments vorhanden sind dann werden die Variablen durchnummeriert X beginnend bei null RNAttachment X Inhalt des Attachments base64 kodiert und komprimiert RNAttachmentContent Type X MIME Type des Attachments z B application xml RNAttachmentContent ID X inubit 6 1 Workbench Process Engine Systemkonnektor Guide Fehlerbehan
24. POST Mit POST kann einer Ressource etwas hinzugef gt werden Beispielsweise k nnte eine Ware zu einem Warenkorb hinzugef gt werden PUT Neue Ressourcen k nnen mit PUT erzeugt oder der Inhalt bestehender Ressourcen kann mit PUT ersetzt werden DELETE Ressourcen k nnen mit DELETE gel scht werden OPTIONS Liefert eine Liste mit den vom Server unterst tzten Methoden HEAD Genau wie bei GET wird eine Ressource ange fragt es wird jedoch in der Antwort kein Inhalt Body bertragen sondern nur der Response Header So kann z B vor einer GET Anfrage die Dateigr e abgefragt werden Um verschiedene Methoden auf eine Ressource anzuwenden wird immer die gleiche URL verwendet denn die URL ist unabh ngig von der durchgef hrten Aktion 27 4 Ressource anbieten Prinzip 05 09 2013 Einen Web Service in Form einer REST Ressource k nnen Sie durch einen Technical Workflow mit einem REST Input Listener Connector realisieren Der REST Connector bietet dann nach au en eine Ressource z B eine Auftrags oder Artikelliste in Form einer URL an Einzelne Ressourcen werden jeweils ber einen einzelnen REST Input Connector angeboten Die Ressourcen sind einzelne Objekte einer Anwendung die ber eine URL erreichbar sein m ssen und mit einem Dokument vorzugsweise in XML repr sentiert werden k nnen inubit 6 1 Workbench Process Engine Systemkonnektor Guide REST Connector 293 Ressource anbieten So
25. SC Logger Einstellungen In diesem Dialog konfigurieren Sie den Solution Center Logger ZielKnoten m Knoten ID W hlen Sie einen Knoten unter dem das neue Event Objekt angelegt werden soll Im Allgemeinen ist dieser Knoten eine Instanz von bfm3 ProcessBO Neuen Status Inhalt setzen Aktivieren Sie diese Option und tragen Sie die gew nschte Statusmeldung in das nebenstehende Feld ein um sie dem Status Attribut des oben angegebenen Knotens zuzuweisen Eventdaten m Event Typ 05 09 2013 bfm3 BusinessEvent Erstellt ein Ereignisobjekt der Klasse bfm3 BusinessEvent mit den Attributen Title Description Actor und Action Date inubit 6 1 Workbench Process Engine Systemkonnektor Guide Solution Center Logger 389 Dialog SC Logger Einstellungen bfm3 Milestone Erstellt ein von der Klasse bfm3 BusinessEvent abgeleitetes Ereignisobjekt der Klasse bfm3 Milestone mit den zus tzlichen Attributen Position und Status Siehe Eventdaten Mapping Workbench Process Engine Systemkonnektor Guide Kap S 389 Sie k nnen eigene Event Typen erstellen Siehe Eigene Event Typen erstellen Workbench Process Engine Systemkonnektor Guide Kap 36 2 S 388 Eventdaten Mapping m Title Bezeichnung des Ereignisobjekts wird aus dem Namen des Ereignisses im BPD bernommen Description Beschreibung des Ereignisobjekts Actor Benutzer der d
26. ffentliche Schl ssel des STS wird ben tigt um das vom STS signierte Token lesen zu k nnen Mit der Signatur versichert der STS dass das Token vom STS selbst ausgestellt wurde WS Security Konfiguration 509 Zertifikat Truststore oder Zertifikat hinzuf g X 509 Zertifikat Truststore oder Zertifikat hinzuf gen mm Ann nn man An Aen eee Nach dem erfolgreichen Import wird die G ltigkeit des Schl ssels angezeigt 6 Um die Kommunikation mit dem STS zu sichern legen Sie im Bereich Consumer Authentifizierung fest wie Ihr Consumer sich gegen ber den STS authentifizieren soll Der Consumer sendet diese Benutzer Passwort Kombination als Teil seines Security Token Requests an den STS Dar ber hinaus k nnen Sie zur zus tzlichen Absicherung ein X 509 Keystore angeben In diesem Fall m ssen Sie das g ltige Passwort und den Alias Namen eines im Keystore enthaltenen Schl sselpaares angeben 7 Klicken Sie auf Fertig stellen 8 Publizieren und aktivieren Sie den Workflow inubit 6 1 Workbench Process Engine Systemkonnektor Guide 05 09 2013 440 Web Services Connector Operationen eines Web Services erstellen 40 10 Operationen eines Web Services erstellen Voraussetzungen np Web Services Input Listener Connector bei dem de WSDL Datei am Modul selbst gespeichert ist Vorlagen optional XML Schema Datei oder WSDL Datei mit Operationen welche den zu erstellenden
27. 05 09 2013 Fehlermeldung Siehe AS2 Spezifikation inubit 6 1 Workbench Process Engine Systemkonnektor Guide Name AS2 Connector 33 Empfangen Senden und Pr fen von AS2 Nachrichten Wert ASMessageWarning 3 2 3 2 1 Warnung Siehe AS2 Spezifikation F r Infos ber Variablen und deren Verwendung siehe Workflow Variablen und Mappings Workbench Benutzer Guide Kap 14 S 383 Empfangen Senden und Pr fen von AS2 Nachrichten MIME Struktur Lu AS2 bietet einen gesicherten Datentransport ber die so genannte sichere bertragungsschleife secure transmission loop mit asymmetrischer Verschl sselung Dabei werden die Nachrichten verschl sselt und signiert Zus tzlich k nnen Empfangsbest tigungen angefordert werden Zum Verschl sseln und Signieren besitzen Absender und Empf nger einer Nachricht jeweils ein Schl sselpaar bestehend aus einem ffentlichen und einem privaten Schl ssel und tauschen ihre ffentlichen Schl ssel miteinander aus Beide besitzen also den ffentlichen Schl ssel des anderen und jeweils einen eigenen privaten Schl ssel der nie herausgegeben wird Beim Versenden wird je nach Konfiguration die Struktur Verpackung durch folgenden Ablauf aufgebaut Beim Senden m ssen Sie die Reihenfolge der Schritte zwingend einhalten beim Empfang ist die Reihenfolge der Schritte beliebig 1 Die Original MIME Nachricht wird optional komprimiert ber die versteckte Property
28. 24 6 2 1 Nachbarstation ber TCP IP 4 en ein nie 263 24 6 2 2 Nachbarstation ber ISDN san 263 24 6 2 3 Nachbarstation ber XOT ana een 264 24 6 24 Virtuelle Station een nennen 265 24 6 2 5 Routed aert deen ee leer Eege and 266 24 6 2 6 Verbindung aktivieren rn 266 24 6 2 7 Entfernen kei eilig 267 24 6 3 lee TEE 267 24 6 3 1 TCP IP Empf nger konfigurieren cc cccceccccceccecccecenensccicagenesctacaenescatecuasadccdcassensatecdsnenscdeausaaveanens 268 24 6 3 2 ISDN Empf nger konfigurieren 268 24 6 3 3 XOT Empf nger konfigurieren nn 269 24 6 3 4 TLS Empf nger konfigurieren uussnnesnennnnnnnnnnnnnnnnnnnnnnnnnnnnennnnnnnnnnnnnnnnnnnnnnnnnnnnnnnn nn 270 25 OpenOffice Connector sssini ENEE EES EEN EERSTEN EE HEHE KR 271 25 1 Voraussetzung OpenOffice Installation 4ussrsnnnennnnnnnnnnnennnnnnnennnnnnnnnnnnnnnnnnnnnnnnnnnnnnnennnn ann 271 25 2 F ktionspriNZip WEE 272 25 3 Beispiel Workflow erstellen AA 272 25 4 Dokument in das PDF Format konvertieren nn 275 25 5 Dokument bearbeiten 2 2 4 u a Bari 276 256 Dokument dr cken ee EES ASSEN 278 25 7 Dialog Grundeinstellungen either EAA EAA AANA kennen 279 26 OSCI C nnech r E 281 26 1 Voraussetzungen u iin 282 26 2 si 0 4 110 0 0 41074 0 ee 282 inubit 6 1 Workbench Process Engine Systemkonnektor Guide 05 09 2013 10 Inhaltsverzeichnis E ME ele eene EE 283 26 3 1 Dialog Abrufen von OSCI Nachrichten am Int
29. Argumente C ScriptFile cmd OutputFile Script echo This will be streamed into outputfile and provided to workflow gt 1 Bei den Argumenten File ScriptFile InputFile und OutputFile k nnen Sie eine der Dateiendung cmd bzw bat angeben z B ScriptFile bat Arbeitsverzeichnis F r tempor re Dateien Der Execution Connector und einige Applikationen ben tigen ein solches Verzeichnis Wenn Sie kein Verzeichnis angeben wird das jeweilige Standard Verzeichnis unter Tomcat bzw JBoss verwendet Das Standard Arbeitsverzeichnis ist Tomcat bin bzw JBoss bin oder das des jeweils genutzten Applikationservers wenn dieser nicht JBoss oder Tomcat ist Umgebungsvariablen werden als Variablen Wertepaare getrennt durch ein Zeichen bergeben Mehrere Umgebungsvariablen trennen Sie durch jeweils einen Zeilenumbruch Wenn aktiviert werden alle Systemvariablen des Systems mit der Process Engine an den Execution Connector Prozess bergeben damit die Befehle bzw das Skript darauf zugreifen k nnen Eingabefeld Um ein Skript eingeben zu k nnen m ssen Sie im Feld Parameter den Parameter ScriptFile einf gen Um auf die Parameter zuzugreifen die im Feld Parameter angegeben sind verwenden Sie Variablen Deren Syntax ist abh ngig vom eingesetzten Betriebssystem Windows 1 Linux 1 Button Externer Editor Zum Editieren des Skripts ffnet den externe
30. BEGIN DECLARE newEventID INT CALL getNewID IS EVENTS ID newEventID NSERT INTO is events id is plugin id pkl pk2 pk3 pk4 pk5 pk6 pk7 pk8 pk9 verb is structure name priority retrieve_ time status timestamp 0815 ist die Plugin ID VALUES newEventID 0815 NEW FATHERID NULL NULL NULL NULL NULL NULL NULL NULL insert FATHER CHILD 1 now 0 now END S DELIMITER 3 DBO Input Connector erstellen und konfigurieren a Aktivieren Sie den Scheduler um das Abfrage Intervall festzulegen Konfigurieren Sie im Dialog Datenbankeinstellungen Workbench Process Engine Systemkonnektor Guide Kap 7 6 1 S 104 die Datenbankverbindung und testen Sie diese Geben Sie die Plugin ID des DBO Medium Connectors an durch den die Events ausgelost wurden Markieren Sie die Option Event Listener um die Funktion des Konnektors festzulegen Geben Sie den Namen der Eventtabelle an Geben Sie eine Archiv Tabelle an wenn verarbeitete Events archiviert werden sollen 4 Klicken Sie auf Weiter Ein weiterer Dialog wird angezeigt 5 Klicken Sie auf Fertig stellen um die Konfiguration des Konnektors zu beenden 05 09 2013 inubit 6 1 Workbench Process Engine Systemkonnektor Guide Database Object Connector 99 Event Archiv mit Archiv Prozessor berwachen 7 3 Event Archiv mit Archiv Prozessor berwa
31. Delete S 75 Mehrere SQL Statements in einer Abfrage S 75 SQL Statements direkt bergeben Force S 78 Subqueries SubSelects S 79 Stored Procedures aufrufen Call S 81 6 4 1 Struktur von XML Querys Die grundlegende Struktur ist f r alle XML Querys identisch lt queries gt Umschlie endes Element f r ein Set von SQL Statements lt query gt Initiale Definition eines SQL Statements Kann mehrfach auftreten z B um mehrere SQL Anwei sungen innerhalb einer Abfrage abzusenden Attribute Pflichtfeld zul ssige Werte Erl uterung inubit 6 1 Workbench Process Engine Systemkonnektor Guide 05 09 2013 66 Database Connector XML Querys Struktur und Beispiele type Ja select Art des SQL Statements insert update delete call properties Nein force Mit force wird das SQL Statement das im Ele ment lt value gt angegeben ist direkt ausgef hrt Alle weiteren Angaben werden ignoriert forceResult Nein true false Wert true erm glicht die R ckgabe von Result Sets aus Stored Procedures queryID Nein Wird im ResultSet mit dem Wert der zugeh rigen Query gef llt lt value gt Zur direkten bergabe eines SQL Statements Dazu muss im Element lt query gt das Attribut properties den Wert force haben Alle weiteren Angaben werden ignoriert lt tables gt Einleitendes XML Element f r die Definition eines SQL Statements lt table gt Einleite
32. Der Service Provider pr ft die Signatur des Tokens mit dem ffentlichen Schl ssel des STS um zu verifizieren dass das Token wirklich vom STS stammt Anschlie end entschl sselt der Provider das Token mit seinem privaten Schl ssel und erh lt damit den Session Key und die darin enthaltenen Aussagen ber die Identit t des Consumers inubit 6 1 Workbench Process Engine Systemkonnektor Guide 05 09 2013 352 Security Token Service Connector Web Services Provider an STS Connector registrieren Anhand des Session Keys berpr ft der Provider die Signatur des Web Service Aufrufs Da zu diesem Zeitpunkt nur der STS der Consumer und der Service Provider den Session Key kennen kann der Service Provider davon ausgehen dass wirklich der Consumer f r den der STS das Token ausgestellt hat die Service Anfrage signiert hat Nun muss der Service Provider nur noch pr fen ob der STS die ben tigten Bescheinigungen in das Token integriert hat 6 Service Provider sendet Service Response oder Fehlermeldung Wenn die n tigen Bescheinigungen in das Token integriert sind dann wird der Service Request ausgef hrt die Service Response verschl sselt signiert und an den Consumer gesendet Wenn die Bescheinigungen fehlen wird eine Fehlermeldung zur ckgegeben 32 2 Web Services Provider an STS Connector registrieren 05 09 2013 Dieser Abschnitt erl utert wie Sie beliebige Web Services Provider an einem STS Connector registrieren um di
33. Die Daten werden in Form von OSCI Nachrichten bertragen Der OSCI Connector verbindet sich mit einer virtuellen Poststelle und erm glicht es innerhalb eines Workflows OSCl Nachrichten von einer virtuellen Poststelle entgegenzunehmen zu entpacken zu entschl sseln und ihre Signatur zu pr fen OSCl Nachrichten f r eine virtuelle Poststelle zu erstellen zu signieren und zu verschl sseln Die Funktionen des OSCI Connectors h ngen von der konkreten Konfiguration ab Input Connector Ruft OSCI Nachrichten im eingestellten Zeitintervall von einer virtuellen Poststelle ab und entpackt diese Der Input Connector wird nur aktiv wenn der Scheduler aktiviert ist Siehe Dialog Zeitgesteuerte Verarbeitung Workbench Process Engine Systemkonnektor Guide Kap 1 1 3 S 22 Medium Connector Versendet verschl sselte und signierte OSCI Nachrichten an eine Virtuelle Poststelle und leitet die Response an das nachfolgende Modul im Workflow weiter Die aktuelle OSCI Spezifikation finden Sie unter http www 1 osci de sixcms media php 13 osci_spezifikation_1_2_deutsch pdf Siehe auch Systemkonnektoren Workbench Process Engine Systemkonnektor Guide Kap 1 S 19 Module anlegen Workbench Benutzer Guide Kap 3 3 S 129 Technical Workflow Diagramme Workbench Benutzer Guide Kap 12 S 311 inubit 6 1 Workbench Process Engine Systemkonnektor Guide 05 09 2013 282 OSCI Connector Voraussetzungen 26
34. Empf nger hinzuf gen Empf nger werden der lokalen Station hinzugef gt Wie viele Empf nger Sie hinzuf gen k nnen entnehmen Sie dem Handbuch Ihrer eingesetzten OFTP Middleware Protokoll des Empf ngers Zur lokalen Station k nnen mehrere Empf nger hinzugef gt werden die ber verschiedene Protokolle angebunden sind Sie k nnen jeweils ein oder mehrere Empf nger vom Typ X 25 lu6 2 TCP IP oder ISDN hinzuf gen 23 6 2 1 X 25 Empf nger konfigurieren 05 09 2013 X 25 ist ein internationaler Telekommunikationsstandard der von der Internationalen Fernmeldeunion verabschiedet wurde Weitere Informationen finden Sie unter www itu int a VektorPosition Standard ist 2 m X 25 Adresse Jeder Rechner der in einem X 25 Netzwerk kommunizieren soll muss eine X 25 konforme Adresse haben Eine X 25 Adresse ist eine Folge von Ziffern Die ersten Ziffern geben den L ndercode an die darauffolgenden Ziffern bestimmen das Netzwerk innerhalb des Landes und die letzten Ziffern die Rechnernummer Unteradresse Wenn unter einem Anschluss mehrere Rechner existieren Subnetz dann bestimmen die letzten drei Ziffern der X 25 Adresse den Rechner im Subnetz Facilities Meist nicht angegeben Benutzerdaten Meist nicht angegeben Wenn Sie Facilities und Benutzerdaten angeben m chten dann als HEX Code Die Daten werden nur f r X 25 ber ISDN bertragungen ben tigt wenn Ihr X 25 Provider dies fordert
35. In einem Systemkonnektor werden die spezifischen Protokoll und Authentifizierungsdaten f r den Aufbau der Verbindung mit den Quell bzw Zielapplikationen gespeichert Siehe auch Technical Workflow Diagramme Workbench Benutzer Guide Kap 12 S 311 Systemkonnektoren aktivieren Workbench Benutzer Guide Kap 3 9 S 135 Systeme integrieren und Prozesse automatisieren Tutorials Kap 4 S 63 1 1 Dialogbeschreibungen Dieser Abschnitt erlautert die folgenden Themen a Dialog Allgemeine Moduleigenschaften S 19 Dialog System Connector Eigenschaften S 20 Dialog Zeitgesteuerte Verarbeitung S 22 Dialog SSL Konfiguration S 24 Dialog Remote Connector Konfiguration S 25 1 1 1 Dialog Allgemeine Moduleigenschaften Siehe Dialog Allgemeine Moduleigenschaften Workbench Benutzer Guide Kap 3 15 S 140 inubit 6 1 Workbench Process Engine Systemkonnektor Guide 05 09 2013 20 Systemkonnektoren Dialogbeschreibungen 1 1 2 Dialog System Connector Eigenschaften Grundkonfiguration Connector Status 05 09 2013 Dieser Dialog bietet folgende Optionen Connector Typ F r Systemkonnektoren gibt es folgende Konfigurationstypen Es gibt Systemkonnektoren bei denen nicht alle Typen konfigurierbar sind In diesen F llen sind die Optionen deaktiviert Input Connector Workflow Anfang Als Input Connector holt ein Systemkonnektor Daten von einer
36. Kap 29 3 S 314 Die Daten f r die RosettaNet Nachricht werden aus dem unternehmenseigenen ERP System geladen und mit Hilfe von XSLT Convertern in die RosettaNet Struktur berf hrt 1 Der XSLT Converter Create PIP specific Payload erstellt die PIP spezifische Nachricht Payload 2 Der XSLT Converter Create Headers erzeugt die Header Die folgende Abbildung zeigt ein beispielhaftes Mapping 05 09 2013 inubit 6 1 Workbench Process Engine Systemkonnektor Guide RosettaNet HTTPS Connector Beispiel Workflow RosettaNet Nachrichten erzeugen 313 XML Quelle _ XML Ziel 4 stylesheet 1 0 d version GB output i gt B template 3 4 RosettaNetxML B DeliveryHeader isSecureTransportRe B messageDateTime G DateTimeStamp jHelper getDateTimel yyyyMMddT HH gt L value o messageReceiverlde messageSenderlden messageTrackingID gt Instanceldentifier ServiceHeader ProcessControl ActivityControl GloballsageCod pipCode 4A5 GlobalProcess H pipinstanceld H 6 pipVersion amp KnownlnitiatingPa Pip4A5NotifyofF orecastReply gt ep copy of Der Zeitstempel wird durch die Java Methode jHelper getDateTime yyyyMMdd T HHmmss SSS Z ge setzt Dem Element GlobalProcessIndicatorCode wird die PIP ID zugewiesen die f r diese Nachricht vorgeschrieben ist hier 4A5 In der letzten Zeile wird der Payload durch einfaches Kopieren hinzugef
37. Klammern stehenden Namen des Pfadbestandteils innerhalb der am Connector konfigurierten Ressourcen URL So werden z B bei der Ressourcen URL users userName auftraege auftragsNr die Variablen restConnector requestURITemplateParam userName und restConnector requestURITemplateParam auftragsNr mit den konkreten Werten aus der Anfrage URL gesetzt restConnector clientAddress Enthalt die IP Adresse des aufrufenden Client restConnector requestAuthUser Enthalt den Namen des authentifizierten Benutzers falls bei den Authentifizierungs Optionen Portal Benutzerdaten verwenden ausgew hlt wurde Die Status und Header Daten der zu versendenden Antwort werden in folgende Variablen geschrieben restConnector responseStatusCode Enth lt Antwortcode f r das Ergebnis der gesendeten Antwort restConnector responseStatusDescription Enth lt die Beschreibung des Antwortcodes restConnector responseHeaders inubit 6 1 Workbench Process Engine Systemkonnektor Guide Medium Output Connector REST Connector 289 REST Funktionsprinzip Enth lt die Header Daten der gesendeten Antwort Nachricht Der Inhalt der Variablen entspricht den im Konnektor konfigurierten Standardwerten Die Variablen dienen dazu im Workflow dynamisch berschrieben zu werden Der Wert der Variable der am Ende des Workflows zur Verf gung steht wird f r den Versand der Antwort verwendet Die Stat
38. Klicken Sie auf den Link mit dem Namen des gew nschten Web Services Die WSDL wird angezeigt c Kopieren Sie die URL in die Zwischenablage d F gen Sie die URL im Register Aufzurufender Service in das Feld URL ein inubit 6 1 Workbench Process Engine Systemkonnektor Guide Web Services Connector 431 Asynchrone Web Services e Klicken Sie auf den Button WSDL Datei laden WSDL Daten WSDL laden von Datei URL UDDI URL http 192 168 0 223 8000 ibis ws AWSListen ws 4 A t EWSDL Datei laden E E Definition 2 BEE Lae ne O D gege Ae ie Die Checkbox Antwort asynchron empfangen separate WY Antwort Adresse mitschicken wird automatisch aktiviert Das Feld Antwort URL wsa ReplyTo wird automatisch auf die korrekten Werte gesetzt Ausschlaggebend daf r sind Policies in der WSDL 5 Klicken Sie auf Fertigstellen 6 Publizieren Sie das Modul Ziehen Sie eine Verbindung vom Request XSLT Converter zum soeben konfigurierten Web Services Medium Connector Weitere Module anlegen W hrend der Web Service die Anfrage bearbeitet und die Antwort erstellt wird der aufrufende Workflow fortgesetzt Der Workflow stoppt unmittelbar vor dem Callback Listener So gehen Sie vor 1 Legen Sie mehrere Module gem Ihren Anforderungen an 2 Verkn pfen Sie die Module untereinander und mit dem aufrufenden Web Services Connector Callback Listener Connector Di
39. Listet alle zus tzlichen Informationen die neben der G ltigkeit im Zertifikat enthalten sind inubit 6 1 Workbench Process Engine Systemkonnektor Guide 357 33 Selenium Connector Dieser Abschnitt erl utert die folgenden Themen m Funktionsprinzip S 358 m Fehlerbehandlung S 360 m Dialog Selenium Connector Eigenschaften S 361 Verwendung Der Selenium Connector verbindet das Test Framework Selenium mit der Testumgebung der inubit Software Er wird verwendet um automatisierte Testf lle bzw Test Suiten webbasierter Benutzeroberfl chen und Web Applikationen die mit dem Selenium Framework erstellt wurden aus dem Workflow heraus zu steuern Der Konnektor kann eingesetzt werden um z B Portalfunktionen des inubit Enterprise Portals zu testen Benutzereigene Erweiterungen mit der M glichkeit eigene Test Kommandos zu definieren und in der user extensions js zu hinterlegen werden nicht unterst tzt Konnektortypen Ein Selenium Connector kann als Medium oder Output Connector verwendet werden Medium Connector Sendet XML Testdaten an den Selenium Remote Control Server und erh lt Log Daten vom Selenium Server zur ck die an das folgende Modul im Workflow bergeben werden Output Connector Sendet XML Testdaten an den Selenium Remote Control Server und erh lt Log Daten vom Selenium Server zur ck die an eine Zielapplikation weitergegeben werden Voraussetzungen Die komplette Selenium Testu
40. Modul Editor und erstellen Sie eine Abfrage wie im folgenden Beispiel en Tr Bie H AST Stylesheet XML Quelle XML Ziel om _xs1 stylesheet http www w3 org 1999 XSL Transform d i xsl http www w3 org 2004 11 xmimime d i mime B com inubit ibis xsltext Misc a misc http www w3 org 200 1 XMLSchema d i xs 2 0 dei version elt E x s1 template oO E G queries false d i zipOutput purchaseOrder Ela query purchaseOrder false outputlds asc order iD gengen emm ON Rn pt ee Setzen Sie optional das Attribut zi pOutput true um Speicherplatz zu sparen Setzen Sie das Attribut outputIds false um zu verhindern dass die Objekt IDs geschrieben werden Die Objekt IDs werden beim Einlesen in die neue Datenbank automatisch geschrieben Setzen Sie das Attribut order asc um festzulegen dass die ltesten Datenbankobjekte zuerst geschrieben werden BO Connector zum Schreiben der So gehen Sie vor Daten erstellen S Erstellen und benennen Sie einen neuen BO Connector 2 Wechseln Sie auf das Register Business Object Connector Einstellungen 3 Konfigurieren Sie die Persistenz Schicht und die Verbindung zu der Datenbank deren Daten Sie auslesen und schreiben wollen 05 09 2013 inubit 6 1 Workbench Process Engine Systemkonnektor Guide Business Object Connector 57 Stammdatenreferenzen aktualisieren und l schen Die Einstellungen f r die Objektmodus A
41. Passwort Mit diesen Optionen k nnen Sie den Versand und den Empfang von Bin rdaten wie z B PDF oder JPG Dateien als Anhang von SOAP Nachrichten optimieren Die Optionen f r den Umgang mit Bin rdaten haben nur dann einen Effekt wenn in der eingehenden bzw ausgehenden SOAP Nachricht ein Element mit dem Attribut xmime contentType enthalten ist Siehe http www w3 org TR 2005 REC soap12 mtom 20050125 MTOM Anh nge f r ausgehende Nachricht aktivieren nur Medium Output Connector inubit 6 1 Workbench Process Engine Systemkonnektor Guide Web Services Connector 459 Dialogbeschreibungen Aktivieren Sie diese Option wenn Sie in der Ausgangsnachricht den Inhalt von Elementen mit dem Typ xmime base64Binary als MTOM Anh nge verschicken m chten Die Daten stammen aus WSAttachment Variablen Siehe Nachrichten mit bin ren Attachments versenden Workbench Process Engine Systemkonnektor Guide Kap 40 15 1 S 446 Bin rdaten aus Antwort Nachricht extrahieren und als Variablen Inhalte setzen nur Medium Output Connector Wenn diese Option aktiviert ist wird die empfangene SOAP Nachricht nach Elementen mit dem Attribut xmime contentType durchsucht Die Inhalte werden in wsAttachment Variablen geschrieben Siehe Nachrichten mit bin ren Attachments empfangen Workbench Process Engine Systemkonnektor Guide Kap 40 15 2 S 449 Anh nge ins Dateisystem speichern nur Medium Output Connector
42. Repository Signatur Verifier Output Die Pfade m ssen identisch sein mit den Pfaden die beim Q Konfigurieren des DigiSeal Servers Verifiers angegeben wurden Die Eingangs und Ausgangsverzeichnisse d rfen nicht ineinander geschachtelt werden sondern m ssen sich auf derselben Ebene befinden Eine Angabe f r ein Verifier_Output Verzeichnis wie z B Verifier Input Verifier Output ist also ung ltig Pr fungsdokumentationsverzeic Nur im Modus Pr fen hnisse Der Secrypt Verifier ben tigt die folgenden Verzeichnisse um die Pr fung der Signatur und deren Ergebnis zu dokumentieren Dokumententy m 05 09 2013 Pr ferfolgsverzeichnis Nach erfolgreicher Pr fung des Dokuments enth lt dieses Verzeichnis das gepr fte Dokument das Pr fergebnis und das Zertifikat Signaturfehlerverzeichnis Wenn die Pr fung der Signatur nicht erfolgreich war dann enth lt dieses Verzeichnis das gepr fte Dokument und das Pr fergebnis Systemfehlerverzeichnis F r die Fehlermeldung wenn beim Pr fprozess Fehler auftraten Typ Geben Sie an in welchem Datenformat die zu pr fenden bzw zu signierenden Dokumente dem Secrypt Connector bergeben werden inubit 6 1 Workbench Process Engine Systemkonnektor Guide Secrypt Connector 347 Dialog Secrypt Connector Eigenschaften Falls Sie im Pr f Modus als Dokumententyp p7s w hlen wird automatisch XML als Format f r die Eingangsnachrich
43. SAP Java Connector JCo installieren S 330 Funktionsprinzip S 331 XML Request Response erstellen S 332 Dialog SAP Connector Eigenschaften S 337 Verwendung Der SAP Connector verbindet sich zu einem SAP System und bietet folgende Kommunikationsarten mit dem SAP System Voraussetzungen m BAPIs RFCs Der SAP Connector kann BAPIs und RFCs im SAP aufrufen bzw von BAPIs RFCs aufgerufen werden IDocs IDocs sind ASCII Dokumente in einem XML Format mit zus tzlichen Statusinformationen Der SAP Connector nutzt IDocs um Daten mit dem SAP System auszutauschen Um die Kommunikation zwischen der inubit Process Engine und dem SAP System zu erm glichen m ssen Sie den SAP Java Connector JCo installieren Siehe SAP Java Connector JCo installieren Workbench Process Engine Systemkonnektor Guide Kap 30 1 S 330 Der Benutzer mit dem sich der SAP Connector via JCo mit dem SAP System verbindet muss auf dem SAP System erstellt und eingerichtet sein Die Gateways zur Verbindung mit dem SAP System sind als Netzwerk Services in der Datei etc services Linux bzw C Windows System32 drivers etc services Windows eingetragen Je nach Gateway Bezeichnung mussen die Eintrage wie folgt hei en sapgw00 3300 tcp sapgw01 3301 tcp Siehe auch Systemkonnektoren Workbench Process Engine Systemkonnektor Guide Kap 1 S 19 Module anlegen Workbench Benutzer Guide Kap 3 3 S 129 Technical Workflo
44. Sie k nnen jedoch auch nach einem Release Wechsel die bisherige Implementierung der Prozedur beibehalten oder alternativ eine selbst entwickelte Prozedur nutzen inubit 6 1 Workbench Process Engine Systemkonnektor Guide 05 09 2013 102 Database Object Connector Datenbankprozedur getNewID erstellen 7 514 Datenbankprozedur getNewID f r Oracle Listing 1 create or replace procedure getNewID 2 i tablename in varchar2 3 i fieldname in varchar2 4 o newid out number 5 is 6 i dotposition integer 7 s owner varchar2 64 8 s table varchar2 64 9 begin 10 i dotposition instr i tablename 1 if i _dotposition gt 0 then 2 s owner substr i tablename 1 i dotposition 1 13 s table substr i tablename i dotposition 1 14 else 15 s owner null le end if 17 begin 18 if s owner is null then 19 xecute immediate select seq_ i_fieldname nextval from dual into o_ newid 20 else 21 xecute immediate select s_owner seq_ i_fieldname nextval from dual into o newid 2 end if 23 return 24 exception 2 when others then 2 o newid null 21 end 28 begin 29 if s owner is null then EN xecute immediate select seq_ i_tablename nextval from dual into o_ newid 31 else gZ xecute immediate select s_owner seq_ s_table nextval from dual into o newid 3 end if A return 3 exception 36
45. Verschl sselt die Verbindung mit SSL Servername URL des SMTP Servers Domainname oder IP Adresse Wenn Sie keine Angabe machen dann wird automatisch localhost gesetzt Portnummer Voreingestellt auf 25 bzw 465 Der Button Standard stellt die Voreinstellung nach nderungen wieder her Authentifizierung Zu markieren wenn der Mailserver eine Authentifizierung verlangt Konto Benutzername Passwort Passwort dass Sie zusammen mit dem Benutzernamen erhalten haben Sie k nnen die Felder leer lassen wenn die Eingangsnachricht als MIME formatiert oder MIME XML versendet wird und bereits Nachrichteneigenschaften wie Absender Empf nger Betreff enth lt inubit 6 1 Workbench Process Engine Systemkonnektor Guide Mail Connector 223 Dialogbeschreibungen Aus den MIME Headern die in der Eingangsnachricht bereits vorhanden sind wird eine Liste der Empf nger mit der Reihenfolge TO CC BCC erstellt F r jeden Empf nger wird ein RCPT TO Kommando an den Mailserver geschickt Wenn Sie die Felder im Bereich Nachricht f llen dann Q berschreiben diese Angaben die Werte aus der Eingangsnachricht Von Absenderadresse An Empf ngeradresse Mehrere Empf ngeradressen werden durch Kommata getrennt Cc Weitere Empf ngeradressen Mehrere Empf ngeradressen werden durch Kommata getrennt Bcc Empf ngeradresse an die f r To und Cc Empf nger nicht sichtbar ist Mehrere Empf nger
46. XML Quelle XML Ziel x 1 stylesheet http www w3 org 1999 XSL Transform d i xsl http www w3 org 200 1 XMLSchema i i xs xs d i exdude result prefixes 2 0 a version a O xsl param oo document d i name E A xsl output Gul id method UTF 8 da encoding el El xsl template CH l OpenOfficeConnector CH Za OOWriter writer_pdf_Export gt 4 outputFilter CH InputDocument amp oo document xsl value of s AF B A GB auetvarss 9 4 BS D Q ergebnis des Mappings A OpenOfficeConnector E G OOWriter d i outputFilter writer_pdf_Export gt InputDocument 4 Weisen Sie dem Element outputFilter im XSLT Stylesheet den Wert writer_pdf_Export zu 05 09 2013 276 OpenOffice Connector Dokument bearbeiten Ersetzen Sie den XSLT Converter im Beispiel Workflow durch den soeben erstellten und angepassten XSLT Converter Passen Sie im File Connector auf der Seite Zu schreibende Datei ggf den Dateinamen und das Verzeichnis an Setzen Sie den Startpoint vor das Assign Modul am Anfang des Beispiel Workflows Starten Sie den Workflow mit dem zu konvertierenden Dokument Pr fen Sie ob das Dokument korrekt konvertiert wurde 25 5 Dokument bearbeiten 05 09 2013 So gehen Sie vor 1 Erstellen Sie ein Word oder Writer Dokument mit mehreren Textmarken z B f r eine Adresse Erstellen Sie mit einem XSLT Converter eine Eingangsnachricht Siehe Beispiel Workflow erstellen Workb
47. auf dem Ihr SAP System l uft Systemnummer Systemnummer zweistellig Kodierung nur bei Kommunikationsart BAPI RFC Geben Sie die Zeichenkodierung f r die zu kommunizierenden Daten an Login Informationen Ab Version 2 1 6 des SAP Connectors wird bei dem Login Benutzer A Passwort Gro und Kleinschreibung unterschieden Client Dreistellige Clientnummer Benutzer Name des Benutzers mit dem Sie Zugriff auf das SAP System haben Passwort Zum Benutzernamen passendes Passwort Sprache Sprache in der die SAP Systemdialoge angezeigt werden sollen Eingabe als zweistellige Buchstabenfolge in Gro schreibung z B DE EN oder FR Angabe ist optional Listener Einstellungen Nur bei Input Listener Die Gateway Einstellungen sind notwendig weil das SAP System nicht direkt sondern ber ein Gateway mit der inubit Process Engine kommuniziert Gateways Hostname Name des Gateway Servers Gateway Servicenummer Da es mehrere Gateway Hosts geben kann sind diese nummeriert Fragen Sie Ihren SAP Administrator nach dieser Nummer diese kann z B so aussehen sapgw00 Programm ID Vor dem Erstellen eines Input Listener Connectors muss im SAP System eine RFC Destination angelegt werden Diese hat eine Programm ID die hier angegeben werden muss Fragen Sie Ihren SAP Administrator nach dieser Programm ID Wenn die inubit Process Engine das Gateway nicht erreichen kann A versucht diese in 660 Sekund
48. d se soapenc 1 0 da version j ER w xsl output method xml encoding j l EI 28 xsl template Gu SAPREQUEST CH 7 BAPI_BANK_GETLIST hg BANK_CTRY M 4 req CHAR type 3 da length f o Um die Parameter mit Werten zu belegen geben Sie die Werte auf der linken Seite XML Quelle ein Beachten Sie dabei die Beschr nkungen die durch die Attribute vorgegeben sind Typ L nge Damit haben Sie ein Stylesheet erstellt das eine konforme XML Response bzw einen entsprechenden XML Request erzeugt 30 4 Dialog SAP Connector Eigenschaften Die Optionen in diesem Dialog sind abh ngig vom Konnektortyp und dem Kommunikationsmodus Kommunikationsmodus m BAPIRFC Zur Kommunikation mit BAPIs und RFCs Wenn Sie diese Kommunikationsart in Kombination mit einem Input Listener w hlen dann m ssen Sie zus tzlich angeben ob die Kommunikation synchron oder asynchron stattfinden soll Option Modus IDoc Zur Kommunikation ber IDocs inubit 6 1 Workbench Process Engine Systemkonnektor Guide 05 09 2013 338 SAP Connector Dialog SAP Connector Eigenschaften Der SAP Connector verarbeitet XML IDoc Wenn Sie EDI Nachrichten einlesen lassen m chten m ssen Sie diese erst mit einem EDI XML Adapter nach XML konvertieren Analog dazu k nnen Sie die XML IDoc Ausgangsnachrichten des SAP Connectors mit einem XML EDI Adapter nach EDI konvertieren System Informationen m Hostname Name des Rechners
49. er Mails abholen wird ein Dialog angezeigt Im Dialog zum Auslesen der Postf cher muss nur das Postfach angegeben werden auf welches sich die Aktion bezieht Verbindungstest m Verbindung testen Zum Testen ob die Verbindung mit Ihren Angaben erfolgreich aufgebaut werden kann 05 09 2013 inubit 6 1 Workbench Process Engine Systemkonnektor Guide e 115 SE Execution Connector Dieser Abschnitt erl utert die folgenden Themen Beispiel Verzeichnis ausgeben S 115 Beispiel Datei kopieren S 117 Beispiel Verzeichnis anlegen S 117 Dialog Execution Connector Eigenschaften S 118 Verwendung Mit dem Execution Connector rufen Sie eine externe Anwendung innerhalb eines Workflows auf Sie k nnen jede Anwendung aufrufen welche ber die Kommandozeile gestartet werden kann Siehe auch Systemkonnektoren Workbench Process Engine Systemkonnektor Guide Kap 1 S 19 Module anlegen Workbench Benutzer Guide Kap 3 3 S 129 Technical Workflow Diagramme Workbench Benutzer Guide Kap 12 S 311 Voraussetzungen Linux Stellen Sie sicher dass bei paralleler Ausf hrung des Execution Connectors ausreichend physischer Speicher verf gbar ist Pro IS Prozess wird die zweifache Gr e des maximalen Speichers des einzelnen iS Prozesses ben tigt 9 1 Beispiel Verzeichnis ausgeben Mit der folgenden Konfiguration k nnen Sie den Inhalt des Verzeichnisses opt data archive auflisten und
50. hnlich sind Die WSDL Datei muss dieselbe Bindungsart unterst tzen die Sie WY bei der Konfiguration des Connectors im Dialog Bereitgestellter Web Service Workbench Process Engine Systemkonnektor Guide Kap 40 16 1 S 451 angegeben haben So gehen Sie vor 1 Zeigen Sie im Web Service Editor das Register Bereitgestellter Service an 2 Operation hinzuf gen F hren Sie eine der folgenden Aktionen durch Klicken Sie auf den Button Operation hinzuf gen Markieren Sie das Wurzelelement ffnen Sie das Kontextmen und w hlen Sie Operation hinzuf gen Der folgende Dialog ffnet sich 1 Neue Operation x Name SayHello Art Anfrage Antwort X X Abbrechen Bu al u a Geben Sie einen sprechenden Namen f r die Operation ein b W hlen Sie die Art der Operation aus Anfrage Antwort Elemente f r die Eingabe und die R ckgabe der Operation werden eingef gt Anfrage Es wird nur ein Element f r die Eingabe eingef gt c Schlie en Sie den Dialog mit OK Die Operation wird mit dem angegebenen Namen und den ausgew hlten Eingabe R ckgabe Parametern unter dem Wurzelelement angezeigt 3 Nachrichtenteil einf gen Bei Bindungs Stil documentilliteral Beim Anlegen der Operation wurden automatisch Nachrichten Teile f r die Eingabe und Ausgabe Nachricht hinzugef gt 05 09 2013 inubit 6 1 Workbench Process Engine Systemkonnektor Guide Web Services C
51. httpheader request remoteAddress IP Adresse des Auf rufers wSServerNameAndPort 40 2 2 Web Services Output Connector URL bzw IP Adresse und Port unter der der Service aufgeru fen wurde Ein Web Services Output Connector setzt folgende Modulvariablen Name Erl uterung ISHttpResponseCode 40 2 3 Anh nge und Bin rdaten behandeln HTTP Antwortcode Ein Web Services Connector setzt bzw liest folgende Modulvariablen wenn eine der folgenden Optionen gesetzt ist a MTOM Anh nge f r ausgehende Nachricht aktivieren Binardaten aus Antwort Nachricht extrahieren und als Variablen Inhalte setzen Name Erl uterung wSAttachmentFileName lt number gt Dateinamen der ein zelnen Anh nge wWSAttachment lt number gt 05 09 2013 Nummer des An hangs inubit 6 1 Workbench Process Engine Systemkonnektor Guide Web Services Connector 417 Web Service anbieten Name Erl uterung WSAttachmentName lt number gt Name des Anhangs s Diese Variablen werden sowohl f r den Input als auch f r den Q Output Konnektor gesetzt Der Wert f r number beginnt bei 0 Web Services Input Connector Ein Web Services Input Connector setzt folgende Modulvariablen wenn die Option Bin rdaten aus Antwort Nachricht extrahieren und als Variablen Inhalte setzen markiert ist Name Erl uterung WSAttachmentNumber Gesamtanzahl der Anh nge WSAttachmentContent ID lt number gt
52. lt Components gt lt Entity gt lt Entities gt lt Command gt lt Commands gt lt LivelinkArchivingConnector gt inubit 6 1 Workbench Process Engine Systemkonnektor Guide 05 09 2013 214 Livelink PDMS Connector Dialog Livelink PDMS Connector Eigenschaften 20 3 Dialog Livelink PDMS Connector Eigenschaften Grundkonfiguration 05 09 2013 In diesem Dialog konfigurieren Sie die Zugangsdaten f r die Kommunikation zwischen der inubit Process Engine und dem Livelink Archive Server Protokoll W hlen Sie das HTTP oder HTTPS Protokoll Servername Domainname bzw IP Adresse des Ziel Servers Port Nummer des Ports f r die Kommunikation zum Ziel Server z B xyz inubit com Dom ne Name der internen Dom ne an der Sie sich mit den Zugangsdaten Benutzer und Passwort anmelden m chten Benutzer Passwort Zugangsdaten mit denen Sie sich an der oben genannten Dom ne anmelden m chten inubit 6 1 Workbench Process Engine Systemkonnektor Guide ETE ai Connector Verwendung Konnektortypen 215 Dieser Abschnitt erl utert die folgenden Themen m Modulvariablen des Mail Connectors S 215 m Dialogbeschreibungen S 216 Mit einen Mail Connector k nnen Sie E Mails von einem POP3 POP3S IMAP oder IMAPS Server holen bzw E Mails ber einen SMTP oder SMTPS Server versenden Input Connector Holt E Mails ab bis das Postfach leer ist Der Connector wird nur
53. lt servername gt 8000 uddi zur Verf gung In diesem Dialog haben Sie folgende Optionen URL Geben Sie die URL des UDDI Registers ein oder w hlen Sie ein UDDI Register aus der Liste aus UDDI V2 UDDI V3 Zur Auswahl der UDDI Version F r die Suche nach Web Services in der UDDI Register Name Stichwort nach dem die Inhalte der ausgew hlten Kategorie durchsucht werden soll Verwenden Sie als Wildcard Suchen Ein Klick auf den Button Suchen startet die Suche Web Services die mit der inubit Software erstellt und in eines der mitgelieferten UDDI Register publiziert wurden finden Sie wenn Sie nach dem Namen des Web Services Listeners suchen inubit 6 1 Workbench Process Engine Systemkonnektor Guide Suchergebnis Ausgew hlte URL Web Services Connector 467 Dialogbeschreibungen Zeigt alle Web Services die das gesuchte Stichwort enthalten Markieren Sie einen Web Service um ihn auszuw hlen Zeigt den im Bereich Suchergebnis ausgew hlten Web Services an Die Auswahl wird nach dem Klick auf OK in das Eingabefeld bernommen 40 16 6 Dialog UDDI Dateneinstellungen Lu UDDI Verbindungskonfigurationen Web Service Interface publizieren Input Listener Connector Um Ihren Web Service publizieren zu k nnen muss die Komponente UDDI installiert sein UDDI ist ein Teil der inubit Software Siehe Komponenten der inubit Software nachinstalliere
54. um die Daten der dazugeh rigen im Dateisystem abgespeicherten AS2 Nachricht zu finden Die Pr fsummen werden miteinander verglichen um sicherzustellen dass die Nachricht vollst ndig und korrekt beim Empf nger angekommen ist Zus tzlich kann der Absender mit dem ffentlichen Schl ssel des Empf ngers die Korrektheit der Signatur berpr fen Der Input Listener erzeugt eine XML Ausgangsnachricht mit folgender Struktur lt xml version 1 0 encoding UTF 8 gt lt MDNReport gt lt MDNSignature gt true lt MDNSignature gt M lt MIC gt true lt MIC gt lt Error gt decryption failed lt Error gt lt MDNReport gt Dabei haben die Elemente folgende Bedeutung lt MDNSignature gt Signatur der Empfangsbest tigung true wenn die Signatur korrekt ist false wenn die Empfangsbest tigung nicht signiert wurde oder wenn die Signaturpr fung einen Fehler ergeben hat lt MIC gt Message Integrity Check True oder false abh ngig davon ob die Pr fsummen ber den Inhalt bereinstimmen lt Error gt Platzhalter f r folgende Fehler Elemente Failure Error oder Warning Enthalten eine kurze Fehlermeldung die in der AS2 Spezifikation beschrieben ist inubit 6 1 Workbench Process Engine Systemkonnektor Guide 05 09 2013 36 AS2 Connector Dialogbeschreibungen FailureMessage ErrorMessage oder WarningMessage Enthalten ausf hrliche Fehlermeldungen selten unterst tzt E
55. unterhalb dessen das Objekt angelegt werden soll wird ber die Knoten ID oder eine XPath Abfrage definiert 2 Der Solution Center Connector liefert die Daten des Business Objekts mit der bergebenen Knoten ID bzw XPath Abfrage aus der Business Solution zur ck Das Business Objekt kann in nachfolgenden Modulen weiter bearbeitet werden Durch das berschreiben von Moduleigenschaften per Variablen Mapping k nnen Sie u a die Knoten ID aus einer vorhergehenden Objektabfrage setzen 35 2 Moduleigenschaften Der Solution Center Connector setzt folgende Moduleigenschaften Name Erl uterung Request Method Modus des Konnektors M gliche Werte GET Objektdaten abfragen m POST Objekt erzeugen PUT Objektdaten aktualisieren DELETE Objekt l schen NodelD ID des Knotens bzw Vaterknotens beim Er zeugen eines Objekts XPath XPath Abfrage um den Knoten bzw Vater knoten zu bestimmen Dieser XPath wird auf der Objekt Struktur des Solution Centers aus gef hrt blicherweise geben Sie hier auch eine Kontextknoten ID an ContextNodelD Nur in Zusammenhang mit dem Parameter XPath ID eines Solution Center Knotens Die XPath Abfrage wird relativ zu diesem Knoten ausgef hrt createEmptyObject leeres Objekt anlegen nur beim Anlegen eines neuen Objekts returnOutput R ckgabe der Knoteninformationen ber diesen Schalter unterdr cken Sie die R ck gabe der ge nder
56. 1 Workbench Process Engine Systemkonnektor Guide 05 09 2013 374 Solution Center Connector Verwenden von XPath Anfragen Setzen Sie die Moduleigenschaften XPath returnOutput und OutputDepth um bestimmte Werte ber das Variablen Mapping zu berschreiben Siehe Moduleigenschaften Workbench Process Engine Systemkonnektor Guide Kap 35 2 S 372 In diesem Dialog k nnen Sie Abbildungsregeln erstellen l schen und sortieren Eine Regel vom Typ Quelle Ausgangsnachricht gt Ziel Variable wird nach der Modulausf hrung durchgef hrt Modulausf hrung in der angezeigten Reihenfolge ausgef hrt alx aat 4 lo Quelle Ziel E Iscc solutions bfm3 BusinessFoundation cm title Business Fou 11 XPath amp rue returnOutput rt Gig OutputDepth av Ausgew hlter Eintrag Quelle N Ziel Statischer Wert v Moduleigenschaft Typ XML Struktur Text Moduleigenschaft XPath B SD Q wer Wert l scc solutions bfm3 BusinessFoundat lt XPath l We EN T BR ee en A Ihre XPath Abfragen nutzen XPath 1 0 mit folgenden Einschr nkungen Empfehlungen Vermeiden Sie in Anfragen m glichst und Wildcards Nutzen Sie die Angabe eines Kontextknotens um die Anfrage zu beschleunigen 35 4 1 Aggregationen ein und zweiseitig gerichtete Assoziationen 05 09 2013 ber XPath Anfragen k nnen Sie neben Aggregationen Eltern Kind Beziehung auch ein und zweiseitig
57. 1 1 4 S 24 SHA 1 deaktivieren inubit 6 1 Workbench Process Engine Systemkonnektor Guide FTP Connector 137 Dialogbeschreibungen Markieren Sie diese Option wenn Sie ltere Dienste einsetzen die keine SHA 1 Verschl sselung unterst tzten Damit vermeiden Sie Fehler bei der Ausf hrung des Connectors und damit einen Abbruch des Workflows Server Authentifizierung Wenn nicht markiert dann muss sich der SFTP Server Ihres Gesch ftspartners gegen ber dem FTP Connector identifizieren Wenn markiert dann gilt der angegeben SFTP Server als vertrauensw rdig Sie m ssen den SFTP Server zu einer known host Datei hinzuf gen diese Datei hochladen und oder den Pfad zu der Datei eingeben known_hosts Datei hinzuf gen Der Button ffnet einen Dateiexplorer zum Laden der known hosts Datei mit vertrauensw rdigen Servern Die Datei wird im FTP Connector gespeichert und wird bei jedem Verbindungsaufbau zum SFTP Server verwendet Pfad Pfad zur Datei known_hosts Vorteil nderungen in der Datei werden bei jeder Ausf hrung ber cksichtigt Wenn Sie die Datei hochgeladen und einen Pfad angegeben haben dann wird die Pfadangabe bevorzugt Client Authentifizierung Wenn markiert dann muss sich der Connector als Client gegen ber dem SFTP Server identifizieren Der Button Privaten Schl ssel hinzuf gen ffnet einen Dateiexplorer zum Laden des privaten Schl ssels bzw Keystores Um den Keystore laden zu k nnen m
58. 2 1 3 S 22 f r mehr Infos ber Logging Level Daten zwischen Web Applikationen austauschen Inter Portlet Kommunikation Workbench Benutzer Guide Kap 20 17 S 572 39 3 2 Dialog Interne Ressourcen In diesem Dialog haben Sie folgende Optionen Ressource Aus der Liste k nnen Sie eine der folgenden Optionen ausw hlen LoginPage ErrorPage Zeigt die mitgelieferte Standard Fehler oder Login Seite fur Web Applikationen an Sie k nnen die Seiten bearbeiten und bei Bedarf die Standard Versionen wiederherstellen Der Einsatz der LoginPage ist nur sinnvoll wenn Sie kein Enterprise Portal einsetzen Bei Einsatz des Enterprise Portals wird das Login durch das Portal realisiert CustomScript Zeigt einen einfachen Editor an in dem Sie JavaScript Funktionen programmieren konnen Diese JavaScript Funktionen k nnen in allen Task Generator Formularen genutzt werden die den Web Application Connector im Dialog Berechtigungen Workbench Process Engine Modul Guide Kap 4 10 2 S 133 referenzieren Im Task Generator f gen Sie im Formular Mapping z B einem Button das Attribut onclick hinzu und geben als Wert den Funktionsnamen an ggf mit einem oder mehreren Parametern Beim Klicken auf diesen Button im Portal wird die referenzierte Funktion ausgef hrt Die Dokumentation des inubit JavaScript Frameworks finden Sie im Verzeichnis lt inubit installdir gt documentation jsdoc index html wenn
59. 2 Events mit Event Listener berwachen und archivieren 4ssssnnnnennnsnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnn ann 96 7 3 Event Archiv mit Archiv Prozessor berwachen 99 7 4 Konfigurationsdatei Feldbeschreibungen 99 7 5 Datenbankprozedur getNewlD erstellen 44224444044n4nnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnn 101 7 5 1 Datenbankprozedur getNewlD f r Oracle uursnnsessnennnnnnnnnennnnnnnnnennnnnnnnnennnnnnnnnnnnnnnnnnnnnn nenn 102 7 5 2 Datenbankprozedur getNewlD f r MySQL suunsnnennnnnnnnnnnnnnnnnnnnnennnnnnnnnennnnnnnnnnnnnnnnnnnnn 103 7 6 Dialogbeschreib ngen u een 104 7 6 1 Dialog DatenbankeinstellUngen 22244002242444000200000000 En nannHannennnnnaannnnnnnannnnnnnnnannnnnannannne 104 7 6 2 Dialog Datenbank Connection Pooling AA 107 7 6 3 Dialog DBO Konfigurationsdatel AA 107 8 Exchange Connector vv ccicccccccciccccuscctdttens ce ccccees ssectececessecetecessnccdeeeessccenteceasecetsecusscuetieessaccnteceasncttecersecctteensecs 109 8 1 Installationsvoraussetzungen 4 sn animieren anhand hen AROSA Aa nennen hang ri 110 8 2 Exchange Connector verwenden 22 ccccceeeseeceeseeeceeeeeeeeneeeegeneneeeeeeenaneeeseqeaaneceeseaaeeeeesensnneeeeneeneeeeeees 110 8 3 Dialogbeschreibungen ET 111 8 3 1 Dialog Allgemeine Einstellungen A 112 8 3 2 Dial g Mails abholen 2 44 ee ame ee else 112 8 3 3 Dialog
60. 6 1 Workbench Process Engine Systemkonnektor Guide Database Connector 89 Dialogbeschreibungen Wenn markiert dann wird z B als Ergebnis eines einfachen Inserts eines Datensatzes lt ResultSets gt lt rows type insert gt 1 lt rows gt lt ResultSets gt ausgegeben statt nur lt rows type insert gt 1 lt rows gt a Datums und Zeitfelder im XML Schema Format ausgeben Wenn markiert dann werden Zeit und Datumsstempel im entsprechenden Format einschlie lich der Angabe von Zeitzonen mit ausgegeben z B 2009 10 19T12 25 09 00 02 Ansonsten wird die Datums und Zeitangabe ohne Zeitzone in der lokalen Zeit ausgegeben Bezeichner der XML Elemente In den Textfeldern bestimmen Sie die Namen der Elemente die in der XML Ausgangsnachricht angelegt werden Formatierungstyp Unkomprimiert Die Ergebnisse werden durch Elemente gekapselt Sie k nnen die Elementbezeichner manuell ndern Beispiel lt ResultSet gt lt Row gt lt Column id 1 gt lt Name gt Street lt Name gt lt Value gt Unter den Linden lt Value gt lt Column gt lt Row gt Komprimiert Die Ergebnisse werden durch Elemente gekapselt au er Feldnamen und werte Sie k nnen die Elementbezeichner ndern Beispiel lt ResultSet gt lt R gt lt C gt Street lt C gt lt R gt lt R gt lt C gt Unter den Linden lt C gt lt R gt Namen als Tags Die Namen der Spalten werden als Element Namen verwendet Falls die Spal
61. Archiv mit Archiv Prozessor berwachen Workbench Process Engine Systemkonnektor Guide Kap 7 3 S 99 Medium Connector Zum Erstellen Lesen Bearbeiten oder L schen eines oder mehrerer Gesch ftsobjekte Siehe Gesch ftsobjekte lesen erstellen bearbeiten oder l schen Workbench Process Engine Systemkonnektor Guide Kap 7 1 S 94 Der DBO Connector unterst tzt folgende Datenbanken Oracle MySQL 5 0 5 1 und 6 MS SQL inubit 6 1 Workbench Process Engine Systemkonnektor Guide 05 09 2013 94 Database Object Connector Gesch ftsobjekte lesen erstellen bearbeiten oder l schen 74 Gesch ftsobjekte lesen erstellen bearbeiten oder l schen Mapping Template 05 09 2013 F r den Zugriff auf Gesch ftsobjekte nutzen Sie einen DBO Medium Connector Mit der Eingangsnachricht steuern Sie welche Operation der Konnektor ausf hren soll steuern Sie ber den Inhalt der Eingangsnachrichten des Konnektors Die Kommunikation mit der Datenbank erfolgt grunds tzlich transaktional es wird immer die gesamte Operation durchgef hrt Falls ein Fehler auftritt dann wird die gesamte Operation zur ckgerollt Nach jeder erfolgreich durchgef hrten Transaktion gibt der Konnektor die ge nderten Gesch ftsobjekte aus Nach einem Delete wird eine Information ausgegeben welche Gesch ftsobjekte gel scht wurden Alle Eingangsnachrichten m ssen eine bestimmte Struktur haben Diese Struktur ist in den mitgelieferten
62. Browser S 466 Dialog UDDI Dateneinstellungen S 467 Dialog WS Security Konfiguration S 468 Dialog WS Security Konfiguration S 470 Dialog WS Reliable Messaging Konfiguration S 471 Dialog Namensr ume bearbeiten S 471 40 16 1 Dialog Bereitgestellter Web Service WSDL Definition Neue WSDL erzeugen Input und Medium Listener Connector In diesem Dialog legen Sie fest ob der Konnektor auf eine am Konnektor gespeicherte WSDL zugreifen soll oder auf eine WSDL die im gesamten Workflow zur Verf gung steht WSDL Definition am Modul speichern W hlen Sie diese Option wenn die WSDL an dem Connector gespeichert werden soll In diesem Fall steht die WSDL anderen in demselben Workflow verwendeten Connectoren nicht zur Verf gung Am Workflow PartnerLink gespeicherte WSDL Definition verwenden W hlen Sie diese Option wenn die WSDL im Workflow gespeichert werden soll Dann kann die WSDL auch von anderen in demselben Workflow verwendeten Web Services Connectoren verwendet werden Das Feld Workflow zeigt den Workflow Namen an sobald der Connector in einem Workflow verwendet wird Callback Listener spezifische Einstellung nur Medium Listener Connector WSDL von zugeh rigem Aufrufer Modul importieren inubit 6 1 Workbench Process Engine Systemkonnektor Guide 05 09 2013 452 Web Services Connector Dialogbeschreibungen 05 09 2013 W hlen Sie das entsprechende M
63. Connector 69 XML Querys Struktur und Beispiele 6 4 2 Select Daten anzeigen SQL SELECT name address phone fax FROM addresses WHERE name Georg Miller ORDER BY name ASC address DESC XML Query lt xml version 1 0 encoding 1S0 8859 1 gt lt queries gt lt query type select gt lt tables gt lt table gt lt tableNames gt lt tableName gt addresses lt tableName gt lt tableNames gt lt fields gt lt field gt lt fieldName gt name lt fieldName gt lt field gt lt field gt lt fieldName gt address lt fieldName gt lt field gt lt field gt lt fieldName gt phone lt fieldName gt lt field gt lt field gt lt fieldName gt fax lt fieldName gt lt field gt lt fields gt lt conditions gt lt condition gt lt leftValue gt name lt leftValue gt lt operation gt lt operation gt lt rightValue gt Georg Miller lt rightValue gt lt condition gt lt conditions gt lt sortOrders gt lt sort gt name lt sort gt lt sort order DESC gt address lt sort gt lt sortOrders gt lt table gt lt tables gt inubit 6 1 Workbench Process Engine Systemkonnektor Guide 05 09 2013 70 Database Connector XML Querys Struktur und Beispiele lt query gt lt queries gt 6 4 3 Select Distinct Mit einem SELECT DISTINCT werden alle unterschiedlichen Werte einer Tabelle zur ckgegeben SQL SELECT DISTINCT abteilung FROM mitarbeiter X
64. Connector Wahlen Sie die Request DTD bzw das entsprechende Schema aus damit eingehende Anfragen auf Korrektheit berpr ft werden k nnen Output Connector Mit der DTD dem Schema wird die Ausgangsnachricht auf Korrektheit berpr ft Um eine bereits geladene Datei zu aktualisieren m ssen Sie eine Datei mit einem anderen Namen laden Wenn Sie eine Datei mit demselben Namen laden dann wird die vorhandene Datei nicht ersetzt Nachweisbarkeit der Empfangsbest tigung Nur Input Connector Wenn markiert dann wird eine Hashsumme ber die Originalnachricht erzeugt und mit der Empfangsbest tigung zur ck gesendet Damit ist nachweisbar dass die Originalnachricht beim Empf nger angekommen ist Sendewiederholungen Input Connector Die Anzahl der Sendewiederholungen ist f r jeden PIP in der Tabelle 3 3 einer PIP Spezifikation unter Retry Count angegeben F r den PIP 3A2 ist zum Beispiel der Wert 3 angegeben Output Connector inubit 6 1 Workbench Process Engine Systemkonnektor Guide RosettaNet HTTPS Connector 323 Dialogbeschreibungen Die Anzahl der Sendewiederholungen ist f r jeden PIP in der Tabelle 3 3 einer PIP Spezifikation unter Retry Count angegeben F r den PIP 3A2 ist der Wert z B 3 Rollename Absender Rollenname Empf nger Nur Output Connector Die Rollennamen sind in der Spezifikation des jeweiligen PIPs festgelegt blicherweise sind die Rollen in der Tabelle 3 1 de
65. Dateien Jede Ressource hat eine Menge von Eigenschaften in XML notierte Properties die ber WebDAV Methoden erfragt und ge ndert werden k nnen Collection Als Collections werden die Verzeichnisse im Dateisystem des WebDAV Servers bezeichnet Jede Collection kann mehrere Ressourcen und Unter Collections enthalten WebDAV definiert eine Reihe von HTTP Methoden f r die verschiedenen Protokollmechanismen Anders als HTTP verwendet WEBDAV nicht ausschlie lich HTTP Header Felder um Requests und Responses mit zus tzlichen Parametern zu versehen sondern kann bestimmte Parameter auch im Content Body eines Requests bertragen Das Format der Eingangs und Ausgangsnachrichten ist abh ngig von der verwendeten WebDAV Methode und den Anforderungen des WebDAV f higen Zielsystems Siehe auch Systemkonnektoren Workbench Process Engine Systemkonnektor Guide Kap 1 S 19 Module anlegen Workbench Benutzer Guide Kap 3 3 S 129 Technical Workflow Diagramme Workbench Benutzer Guide Kap 12 S 311 inubit 6 1 Workbench Process Engine Systemkonnektor Guide 05 09 2013 474 WebDAV Connector Dialog WebDAV Connector 41 1 Dialog WebDAV Connector Einstellungen 05 09 2013 URL URL des WebDAV f higen Webservers SSL Button Siehe Dialog SSL Konfiguration Workbench Process Engine Systemkonnektor Guide Kap 1 1 4 S 24 Methode Erl uterungen zu allen WebDAV Methoden finden Sie i
66. Die Ausgangsdaten gepruftes Dokument und Prufergebnisse werden standardm ig als XML ausgegeben 2 Starten Sie den Workflow Sie k nnen die Workflow Zwischenergebnisse an jedem Watchpoint anzeigen doppelklicken Sie dazu auf den Watchpoint start_Secrypt Sign_binary_output_binary 1 Verify_binarlnput binary binary xml OD O Das Ergebnis a Watchpoint 1 Das Eingangsdokument ist ein PDF Dokument ohne Signatur a Watchpoint 2 Das Ergebnisdokument ist ein signiertes PDF Dokument inubit 6 1 Workbench Process Engine Systemkonnektor Guide Secrypt Connector 345 Modulvariablen Um das PDF Dokument in einem PDF Viewer anzusehen klicken Sie im Dialog Datei ansehen auf Ergebnisdatei speichern und speichern die Datei z B als Test pdf Im PDF Viewer wird die Signatur im Reiter Unterschriften angezeigt Watchpoint 3 Zibis_root root tmp 26_Doku_Secrypt__ 23012007 1 3563 Datei ansehen Im oberen Teil sehen Sie die Ergebnisdatei Der untere Teil des Dialogs zeigt EN Sie AIA E amp VerificationResult gt InputDocument DER Ost jMKJaqrrKOKNCAwIG9iagoBPCAvVHIwZSAays 5 6 VerificationResults j B verificationReport B Pruefdokumentation B Zusammenfassung e9 GeoeffneteDatei Ge ffnete Datei 4517c38336cae16c Schale1 e9 Pruefzeitpunkt Pr fzeitpunkt 2007 01 23 14 02 15 gt Pruefergebnis Die Signatur wurde erfolgreich gepr ft SS Dur
67. Die Daten werden nur f r X 25 ber ISDN bertragungen ben tigt wenn Ihr X 25 Provider dies fordert Timeout Zeit in Sekunden nach welcher der Versuch eine Verbindung aufzubauen abgebrochen wird DBit Delivery confirmation bit Wenn Sie diese Option ausw hlen fordert die sendende Station eine Empfangsbest tigung an X 25 Paketgr e Gr e der Datenpakete bei der Daten bertragung Standard 128 X 25 Fenstergr e Die Fenstergr e bei X 25 ISDN Kommunikation ist die Anzahl der Pakete die ohne Best tigung verschickt werden k nnen Die Fenstergr e kann w hrend des Verbindungsaufbaus ausgehandelt werden Wir empfehlen aber von vornherein die zum Partnernetzwerk passende Fenstergr e zu konfigurieren z B den Wert 7 Standard f r ISDN X 25 DBit Das D Bit ist ein Feld im Datenpaket von X 25 das f r die Ende zu Ende Best tigung verwendet wird Die DTE zeigt damit an ob sie den Empfang einer Ende zu Ende Best tigung w nscht Standard deaktiviert X 25 Modulo In der X 25 Daten bertragung wird ein auf Modulo basierendes Verfahren f r die folgerichtige bertragung von Nutzerinformationen mit Hilfe von Z hlern und einem Fenstermechanismus auf der Sicherungsschicht durchgef hrt F r X 25 sind zwei Modulo Varianten bekannt der Modulo 8 Z hler und der Modulo 128 Z hler Standard 8 Versenden von Dateien an Zielstationen au erhalb des OFTP Netzwerks RvsSid Odette ID Siehe
68. E Datenbank Explorer Geeignete Editoren f r den Inhalt zeigen XML Schema Template erzeugen amp Jaya Reflection Explorer Mit Dokument vergleichen TO ICA Explorer ET AINA QM N nn pb peut a b Lassen Sie sich von dem Datenbank Explorer durch die Erstellung der XML Query fuhren Wenn Sie den Datenbank Explorer beendet haben wird die XML Query im Bereich XML Zieldatei angezeigt c Ziehen Sie das queries Element nach oben auf das xsl template Element d Legen Sie fest wie die Elemente aus der Beispiel Eingangsnachricht auf die Query Elemente abgebildet werden sollen Siehe XML Querys Struktur und Beispiele Workbench Process Engine Systemkonnektor Guide Kap 6 4 S 65 05 09 2013 Um ResultSet Eintr ge besser zu Queries zuordnen zu k nnen f gen Sie den query Elementen das Attribut queryID inubit 6 1 Workbench Process Engine Systemkonnektor Guide Database Connector 65 XML Querys Struktur und Beispiele hinzu Im ResultSet wird dieses Attribut mit dem Wert der zugeh rigen Query gef llt 9 Publizieren Sie den Technical Workflow DA XML Querys Struktur und Beispiele Dieser Abschnitt erl utert die folgenden Themen Struktur von XML Querys S 65 Select Daten anzeigen S 69 Select Distinct S 70 Daten aus verschiedenen Tabellen Join S 71 Datens tze einf gen Insert S 72 Datens tze aktualisieren Update S 73 UpdateOrlnsert S 74 Datens tze l schen
69. Eingangsnachricht enth lt Eingangs Durchgangs und Ausgangsparameter inkl Datentypen und Werten Der AS 400 Connector erwartet folgende Eingaben Typ Wert und Lange aller erforderlichen Parameter Vollst ndiger Pfad zu der AS 400 Anwendung Zur berpr fung der Vertragsnummern werden folgende Parameter bergeben Parameter 1 Mandant char 1 stellig Auspr gung 1 AnbieterX 2 Anbieter2 Parameter 2 Vertragsnummer char 17 stellig Parameter 3 return code char 1 stellig Auspragung Auszuf hrendes Programm vertragsNrAbfrage inubit 6 1 Workbench Process Engine Systemkonnektor Guide 05 09 2013 28 AS 400 Connector Dialog AS 400 Connector Eigenschaften Anfrage inXPCML lt xml version 1 0 encoding UTF 8 gt lt xpcml xmlns xsi http www w3 0rg 2001 XMLSchema instance xsi noNamespaceSchemaLocation xpcml xsd version 4 0 gt lt program name vertragsNrAbfrage path xYZ2 1lib myprog lib vertragsNrAbfrage pgm gt lt parameterList gt lt stringParm name mandant passDirection inout length 1 gt 2 lt stringParm gt lt stringParm name vertragsNr passDirection inout length 17 gt 110 lt stringParm gt lt stringParm name vertragsNrBekannt passDirection inout length 1 gt 0 lt stringParm gt lt parameterList gt lt program gt lt xpcml gt 2 2 Dialog AS 400 Connector Eigenschaften Dieser Dialog bietet folgende Optione
70. Engine Systemkonnektor Guide Verbindungstest inubit IS Connector 157 Dialogbeschreibungen Verbindung testen Zum Testen ob die Verbindung mit Ihren Angaben erfolgreich aufgebaut werden kann 13 3 4 Dialog Input Datei en Input Datei en Bei Input Connector In diesem Dialog k nnen Sie das Lesen von Dateien von einer entfernten inubit Process Engine konfigurieren Verzeichnis Name des Verzeichnisses aus dem der Konnektor Dateien entgegennehmen soll Name der Datei en Name der Dateien die der Konnektor entgegennehmen soll Bei der Angabe des Dateinamens k nnen Sie Wildcards verwenden z B Inputdata xml Wildcard Inhalt des vorher ausgef hrten File oder FTP Connectors verwenden Wenn markiert dann wird der Wildcard Inhalt verwendet der von einem vorher ausgef hrten File oder FTP Connector erzeugt wurde Beispiel Ein vorher ausgef hrter File Connector wurde so konfiguriert das im Feld Dateiname eine Datei Test xml angegeben wurde Als Ausgangsnachricht wurde vom File Connector eine Datei mit Namen Test5 xml weitergeleitet Der Wildcard Inhalt ist in diesem Fall das Zeichen 5 Wenn Sie im vorliegenden Connector ebenfalls eine Wildcard angegeben haben zum Beispiel Ausgabe vm so wird an Stelle der Wildcard das Zeichen 5 eingef gt Dateien nach dem Lesen l schen Wenn markiert dann werden die Dateien nach dem Lesen gel scht Fehler erzeugen wenn L schvorgan
71. Filter m ssen auf eine Nachricht zutreffen damit diese geholt wird ODER Mindestens ein Filter muss auf eine Nachricht zutreffen damit diese geholt wird Filter hinzuf gen Der Button f gt folgende Zeile ein Were ures der Suter mn Senses enma Seppo te or ss ee So EE SS TE EE t SEA or D Seer eee In dieser Zeile definieren Sie die Filterkriterien Subject From To Liste zur Auswahl des Feldes das gefiltert werden soll enth lt Angabe dar ber dass im gew hlten Feld eine bestimmte Zeichenkette vorhanden sein muss Eingabefeld Zur Eingabe der Zeichenkette die vorhanden sein soll Verbindungstest m Verbindung testen Zum Testen ob die Verbindung mit Ihren Angaben erfolgreich aufgebaut werden kann inubit 6 1 Workbench Process Engine Systemkonnektor Guide 05 09 2013 114 Exchange Connector Dialogbeschreibungen 8 3 3 Dialog Eintr ge verschieben Dieser Dialog bietet folgende Optionen Eintr ge verschieben m Mailbox Postfach bzw Zugangskennung auf welches sich die Aktion bezieht In Ordner Name des Ordners bzw Pfad zum Ordner in welchen der Eintrag verschoben werden soll Pfadangaben m ssen nach folgendem Muster angegeben sein Ordnername gt gt gt Ordnername Verbindungstext Verbindung testen Zum Testen ob die Verbindung mit Ihren Angaben erfolgreich aufgebaut werden kann 8 3 4 Weitere Aktionen konfigurieren F r alle Aktionen au
72. Formulare validieren S 169 JAAS Connector erweitern S 170 Dialog JAAS Connector Eigenschaften S 170 JAAS Java Authentication and Authorization Service ist eine Java Schnittstelle die Klassen zur Authentifizierung und Autorisierung der aktuell angemeldeten Benutzer fur die Betriebssysteme Windows Solaris und Unix bietet Mit der Authentifizierung und Autorisierung wird berpr ft ob einem Benutzer der Zugang erlaubt wird Authentifizierung und welche Rechte er hat Autorisierung wenn der Zugang erlaubt wurde Der JAAS Connector bietet einen generischen Container f r unterschiedliche Authentifizierungsklassen Standardm ig bietet der JAAS Connector folgende Funktionalit ten Benutzerkonten in g ngigen Namens und Verzeichnisdiensten wie z B LDAP oder NIS mit dem JNDI Modul Java Naming and Directory Interface berpr fen Benutzerkonten auf Windows Betriebssystemen authentifizieren Um beliebige Benutzerkonten auf Windows Betriebssystemen validieren zu k nnen wird das Authentifizierungsprotokoll NTLM Microsoft NT LAN Manager unterst tzt Dies gilt f r alle Windows Systeme die ber einen NT Domainkontroller verf gen Auch Benutzerkonten des Verzeichnisdienstes Microsoft Active Directory k nnen so authentifiziert werden Zus tzlich k nnen Sie beliebige selbst entwickelte Module laden und zur Authentifizierung von Benutzerkonten nutzen Siehe auch JAAS Reference Guide http download oracl
73. Grundeinstellungen eingegeben wurden Ohne Kopie Beim Erzeugen eines Sendeeintrags wird standardm ig die zu versendende Datei ins Outbox Verzeichnis von rvsEVO kopiert und von hier versendet Mit der Option Ohne Kopie kann dies unterbunden werden In diesem Falle wird die Originaldatei nach erfolgreichem Versand gel scht Diese Option hat keine Auswirkung wenn die Datei im Format U Q unstrukturiert mit Kodekonvertierung versendet wird Datei auf dem Server l schen Nach der bertragung wird die Datei auf dem rvsEVO Server gel scht wenn diese Option ausgew hlt ist Serialisierung Aktiviert deaktiviert das exakte Einhalten der Reihenfolge der zu sendenden Dateien Nachrichten die zusammen versendet werden sollen m ssen dasselbe Label besitzen Synchroner Modus Wenn die Checkbox markiert ist wird der synchrone Daten bertragungsmodus aktiviert Satzmodus Fur die Formate F und V k nnen Sie zwischen den beiden folgenden Satzmodi wahlen BIN binar Standardm ig haben alle S tze die maximale Satzlange Ist der letzte Satz k rzer als die maximale Satzl nge wird er mit bin ren Nullen aufgef llt TXT Text Textdateien im Format F inubit 6 1 Workbench Process Engine Systemkonnektor Guide 05 09 2013 258 OFTP2 Connector Dialog OFTP Datenaustausch Konfiguration Format 05 09 2013 Sicherheit Zeilen die l nger sind als die maximale Satzl nge w
74. INF 1ib der inubit Process Engine kopiert rvs identity data 1 0 jar rvs util 1 3 1 jar rvs client api 1 3 1 jar rvs common exception 1 0 jar rvs data 1 3 1 jar rvs datahelper 1 5 jar rvs evo server jar F r weitere Informationen beachten Sie die Dokumentation der rvs Software 05 09 2013 clientGUI OFTP2 over Nachricht versenden mit Output Connector Der OFTP2 Connector bergibt die Nachrichten noch auf der inubit Process Engine an rvsEVO Der Versand kann mit Hilfe des Schedulers so konfiguriert werden dass die Nachricht sofort verschickt wird wenn sie im Workflow am OFTP2 Connector ankommt oder nur zu einer vereinbarten Zeit oder in einem Zeitintervall inubit 6 1 Workbench Process Engine Systemkonnektor Guide OFTP2 Connector 253 Daten bertragungsmodi rvsEVO verschickt die Nachricht ber das vereinbarte Protokoll an die vom Empf nger eingerichtete Station Die RVS Job ID steht nach der Modulausf hrung als Workflowvariable zur Verf gung Nachricht empfangen Input Connector Der OFTP2 Connector pr ft aktiv in einem festgelegten Zeitintervall ob Nachrichten vorhanden sind Input Listener Connector Der OFTP2 Connector wartet auf der konfigurierten Verbindung auf das Eintreffen von Nachrichten Abh ngig davon wie Ihr Konnektor konfiguriert ist findet die WY Kommunikation synchron oder asynchron statt siehe Datentibertragungsmodi Workbench Process Engine Sy
75. ISDN S 263 Nachbarstation ber XOT S 264 Virtuelle Station S 265 Routed Station S 266 Verbindung aktivieren S 266 Entfernen S 267 Eine Nachbarstation ist die Station eines Gesch ftspartners mit dem Sie Nachrichten austauschen wollen inubit 6 1 Workbench Process Engine Systemkonnektor Guide OFTP2 Connector 261 Dialog Stationen Nachbarstation hinzuf gen Mit dieser Option f gen Sie eine neue Nachbarstation hinzu Diese wird in einem Verzeichnisbaum unter LOC hinzugef gt Sie m ssen die Konfiguration der Nachbarstation kennen Wenn Sie die neu hinzugef gte Station ausw hlen k nnen Sie die Parameter auf der rechten Seite des Dialogs hinzuf gen Die Stationen k nnen f r verschiedene bertragungsprotokolle konfiguriert werden W hlen Sie eines der Protokolle TCP IP TLS ISDN XOT Proxy TCP IP oder Proxy TLS Bereich OFTP m Odette ID Pflicht Eindeutige Zeichenkette die aus maximal 25 Zeichen besteht Das erste Zeichen ist immer ein O Passwort empfangen Das vom Gesch ftspartner erwartete Passwort Passwort senden Das an den Gesch ftspartner gesendete Passwort Gr e des Austauschpuffers Maximale Gr e des bertragungspuffers in Byte M gliche Werte 0 99999 Anzahl der Austauschpuffer Maximale Zahl der gesendeten Bl cke ohne Erwartung einer Quittung M gliche Werte 0 999 Eingangsbest tigung EERP_in EERP End to End Response b
76. Input Listener Siehe Modulvariablen des AS2 Connectors Workbench Process Engine Systemkonnektor Guide Kap 3 1 S 32 3 3 5 Dialog AS MDN Validator Output Connector MDN Empfang mit Input Listener Siehe Modulvariablen des AS2 Connectors Workbench Process Engine Systemkonnektor Guide Kap 3 1 S 32 3 3 6 Dialog AS2 Listener Konfiguration MDN Empfang mit Listener Nachrichten senden mit Output Connector In diesem Dialog geben Sie den Server an an den die eingehenden AS2 Nachrichten geschickt werden sollen Konfiguration des Servers m URL Gibt die Adresse des Servers an z B http www example com Authentifizierung Wenn f r den Zugang zum Server eine Authentifizierung notwendig ist markieren Sie die Checkbox und geben Login und Passwort an das Sie von Ihrem Gesch ftspartner f r diesen Server erhalten haben 3 3 7 Dialog AS2 Konfiguration Output Connector Im Dialog zur AS2 Output Konfiguration legen Sie fest ob der Output Connector Nachrichten oder Empfangsbest tigungen senden soll 05 09 2013 inubit 6 1 Workbench Process Engine Systemkonnektor Guide AS2 Connector 39 Dialogbeschreibungen 3 3 8 Dialog AS Nachrichten Konfiguration Nachrichtenversand mit Output Connector Dieser Dialog bietet folgende Optionen Absender Empf nger AS ID Geben Sie die Absender und Empf nger ID ein Zeichenketten mit max 128 Zeichen Diese ID m ssen Sie vor dem ersten
77. Kap 1 1 4 S 24 zum Konfigurieren einer sicheren Verbindung Aufruf stellt eine asynchrone Antwort Callback dar Aktivieren Sie diese Option wenn Sie diesen Web Services Connector in einem Workflow mit einem asynchronen Web Service anstelle eines Reply Moduls verwenden wollen um die Antwort an einen Callback Listener zu senden In diesem Fall wird die Adresse aus der Variablen WSReplyTo bernommen Siehe Asynchronen Web Service anbieten Workbench Process Engine Systemkonnektor Guide Kap 40 5 1 S 427 Zu markieren wenn der Server auf dem der Web Service ver ffentlicht ist eine Authentifizierung verlangt Falls diese Option aktiviert ist werden die Authentifizierungsinformationen f r den Service Aufruf und f r das Laden der WSDL verwendet Methode W hlen Sie die gew nschte Methode f r die HTTP Authentifizierung aus Standardm ig ist die Authentifizierungsmethode Basic Authentication eingestellt Bei der Option Automatisch Digest NTLM Basic Authentication wird per Nachrichtenaustausch die Authentifizierungsmethode zwischen Konnektor und Ziel Server ermittelt Benutzername Passwort Wenn der Server eine Authentifizierung verlangt geben Sie den Benutzernamen und das Passwort ein Dom ne Nur bei Authentifizierungsmethode Automatesch Geben Sie die Windows Dom ne f r das NTLM Verfahren ein Aktivieren Sie diese Checkbox wenn die Antwort des aufgerufenen Web Services asyn
78. Metadaten abfragen 6 1 Metadaten abfragen Um Informationen ber eine Datenbank zu erhalten erstellen Sie eine Metadatenabfrage Damit k nnen Sie z B f r jede Spalte aller Tabellen oder f r jede Spalte einer ausgew hlten Tabelle Infos ber den Datentyp die Spaltenbreite und zul ssige Dezimalstellen erhalten So gehen Sie vor 1 Legen Sie einen Technical Workflow mit einem Database Connector an 2 Aktivieren Sie beim Database Connector im Dialog Datenbankverbindungen und Query Typ Workbench Process Engine Systemkonnektor Guide Kap 6 5 1 S 84 im Bereich Funktion die Option Metadaten lesen 3 Klicken Sie auf Weiter Der Dialog Metadaten Workbench Process Engine Systemkonnektor Guide Kap 6 5 2 S 87 wird angezeigt 4 Legen Sie fest welche Metadaten zu welchen Tabellen ausgelesen werden sollen Um Ihre Festlegungen zu pr fen k nnen Sie in dem Dialog eine Vorschau auf das Ausgabeformat der Metadaten anzeigen lassen 5 Beenden Sie den Assistenten mit Fertig stellen 6 Publizieren und aktivieren Sie den Technical Workflow 6 2 Statische SQL Query erstellen 05 09 2013 Voraussetzungen Sie ben tigen die Metadaten Ihrer Datenbank mindestens Tabellen und Spaltennamen m ssen bekannt sein Siehe Metadaten abfragen Workbench Process Engine Systemkonnektor Guide Kap 6 1 S 62 So gehen Sie vor 1 Legen Sie einen Technical Workflow mit einem Database Connect
79. Nachrichten Austausch mit Ihrem Gesch ftspartner vereinbaren Betreff Aussagekr ftige Angabe zu der Nachricht Kodierung W hlen Sie eine Kodierung aus die der Kodierung Ihrer AS2 Nachrichten entspricht Um bin re Daten z B Multimedia Daten zu bertragen w hlen Sie den leeren Eintrag MIME Typ W hlen Sie einen MIME Typ aus welcher dem Typ Ihrer AS2 Nachrichten entspricht Wenn der von Ihnen ben tigte MIME Typ nicht vorhanden ist geben Sie diesen ein Siehe http www iana org assignments media types f r eine Liste aller MIME Media Typen Dateiname Geben Sie optional einen Namen f r den Nachrichteninhalt der AS2 Nachricht an Dieser wird als filename Parameter in den HTTP Header Content Disposition bernommen 3 3 9 Dialog AS MIME Konfiguration Signieren Nachrichtenversand mit Output Connector In diesem Dialog legen Sie fest ob Nachrichten signiert verschl sselt und oder komprimiert werden Wenn markiert dann werden alle ausgehenden Nachrichten mit Ihrem privaten Schl ssel signiert G ltig bis Zeigt nach dem Laden des Schl ssels dessen G ltigkeitsdatum an Button Keystore hinzuf gen ffnet einen Dateiexplorer zum Laden des Schl ssels inubit 6 1 Workbench Process Engine Systemkonnektor Guide 05 09 2013 A0 AS2 Connector Dialogbeschreibungen Verschl sseln Lu Komprimieren Wenn markiert dann werden alle ausgehenden Nachrichten mit dem ffent
80. Name TP steht f r Transaction Program TP Name spezifiziert den Namen eines Advanced Program to Program Communication APPC Transaction Programms auf einem Datenbankserver Beispiele sind RVSOFTP oder DB2DRDA Modus Der Name des Modus muss eindeutig sein und den SNA Namenskonventionen entsprechen beispielsweise LU62PS Benutzer ID Passwort Benutzer ID entspricht einem Login Namen Einige SNA Netzwerke erfordern einen Authentifizierung Sicherheit Einige SNA Netzwerke erfordern Authentifizierung Wenn diese gefordert ist muss die Checkbox ausgew hlt werden Dadurch werden Benutzer ID und Passwort zu den bertragenen Daten hinzugef gt inubit 6 1 Workbench Process Engine Systemkonnektor Guide OFTP Connector 249 Dialog Stationen Sync Level M gliche Werte O oder NONE Verarbeitung muss nicht best tigt werden 1 oder CONFIRM Verarbeitung wird best tigt inubit 6 1 Workbench Process Engine Systemkonnektor Guide 05 09 2013 250 OFTP Connector Dialog Stationen 05 09 2013 inubit 6 1 Workbench Process Engine Systemkonnektor Guide 24 OFTP2 Connector ah Verwendung 24 1 Voraussetzungen ah 251 Dieser Abschnitt erl utert die folgenden Themen Voraussetzungen S 251 Funktionsprinzip S 252 Datentibertragungsmodi S 253 rvsEVO Monitoring S 254 Dialog OFTP Datenaustausch Konfiguration S 255 Dialog Stationen S 259 Verwenden Sie den OFTP2 Conne
81. OFTP konfigurieren Sie Kommunikationsparameter f r die lokale Station und alle Nachbarstationen inubit 6 1 Workbench Process Engine Systemkonnektor Guide 05 09 2013 260 OFTP2 Connector Dialog Stationen Empf ngerbereiche 24 6 2 Nachbarstationen 05 09 2013 F r die lokale Station konfigurieren Sie lediglich die drei Parameter Odette ID PKI und Zertifikatsvalidierung Die Beschreibung der Parameter entnehmen Sie der rvsEVO Dokumentation Odette ID Dies ist eine eindeutige Zeichenkette die aus maximal 25 Zeichen besteht Das erste Zeichen ist immer ein O Eine Odette ID erhalten Sie unter www vda de CertificationValidationType Zum Festlegen der Art der Zertifikatsvalidierung CERT_PATH schwache Validierung Validierung Uber ROOT Zertifikate und oder die Zertifikate der CAs CRL st rkere Validierung Validierung ber die Certificate Revocation List OCSP st rkste Validierung Validierung ber das Online Certificate Status Protocol NONE keine Validierung m UsePki Aktivierte Checkbox Aktiviert vorhandene PKI mit LDAP Deaktivierte Checkbox Zertifikate aus der lokalen Schl sselverwaltungsdatei verwenden Die Konfiguration ist abh ngig vom gew hlten Protokoll Siehe Empf nger Workbench Process Engine Systemkonnektor Guide Kap 24 6 3 S 267 Dieser Abschnitt erl utert die folgenden Themen Nachbarstation ber TCP IP S 263 Nachbarstation ber
82. Parameter mit primitiven z B int long char und komplexen beliebiges Java Objekt Java Datentypen gesetzt werden Mit dem Java Reflection Connector k nnen keine Java Algorithmen Q Schleifen Verzweigungen Ablauflogik ausgef hrt werden inubit interne Klassen wie z B ibis jar und damit auch Klassen wie Misc und Formatter k nnen nicht genutzt werden Siehe auch Systemkonnektoren Workbench Process Engine Systemkonnektor Guide Kap 1 S 19 Module anlegen Workbench Benutzer Guide Kap 3 3 S 129 Technical Workflow Diagramme Workbench Benutzer Guide Kap 12 S 311 16 1 Eingangsnachricht erstellen Als Eingangsnachricht ben tigt der Java Reflection Connector eine XML Datei mit folgendem Inhalt Klassenname des zu erstellenden Objekts Parameter f r den Konstruktor Typen und Werte Name der aufzurufenden Methode inubit 6 1 Workbench Process Engine Systemkonnektor Guide 05 09 2013 174 Java Reflection Connector Eigenen Methodenaufruf erzeugen Parameter der Methode Typen und Werte Die Ausgangsnachricht hat dieselbe Struktur wie die Eingangsnachricht Wenn gew nscht kann die Ausgangsnachricht die Eigenschaften der Reflection Klasse enthalten Erstellen Sie die serialisierte XML Struktur ausschlie lich wie im Folgenden beschrieben mit Hilfe des Java Reflection Explorers Eine manuell erstellte XML Struktur wird unter Umst nden vom Java Reflection Connector nicht interpreti
83. Quellapplikation und bergibt diese an das Nachfolgemodul Nach der Workflowausf hrung sendet der Input Connector das Ergebnis wieder an die Quellapplikation zur ck Medium Connector Workflow Mitte Ein Medium Connector setzt in der Regel einen synchronen Aufruf an eine Applikation ab nimmt die Antwort der Applikation entgegen und leitet diese das Nachfolge Modul im Workflow weiter Output Connector Workflow Ende Ein Output System Connector sendet Daten an eine Zielapplikation Der Konnektortyp wird am Modul durch ein Symbol signalisiert Eine bersicht der Symbole finden Sie im Abschnitt Symbole in Technical Workflows und im Verzeichnisbaum Workbench Benutzer Guide Kap 12 S 350 Auf Datenempfang warten Listener Connector Es sind nicht alle Systemkonnektoren als Listener konfigurierbar In diesen F llen ist die Option deaktiviert Ein Systemkonnektor kann als Listener betrieben werden Input Connector Listener warten auf Aufrufe oder Daten aus einer Quellapplikation Output Connector Listener stellen Daten f r ein Zielsystem zum Abholen bereit Aktiv Inaktiv Damit Systemkonnektoren in Technical Workflows oder BPEL Diagrammen zeitgesteuert und automatisiert ausgef hrt werden m ssen diese aktiv sein Inaktive Systemkonnektoren k nnen nur manuell gestartet werden z B zum Testen Siehe Systemkonnektoren aktivieren Workbench Benutzer Guide Kap 3 9 S 135 inubit 6 1 Workbench Pro
84. Server konfigurieren Sie k nnen den JMS Connector ohne weitere Konfigurationen einsetzen weil der JMS Connector die Queuing Schnittstelle des integrierten JBoss Applikationsservers oder den entfernten JBoss einer anderen Enterprise oder Enterprise Plus Edition nutzen kann Alternativ k nnen Sie einen beliebigen eigenen JMS basierten Queuing Server einsetzen Siehe JMS Connector in Enterprise Enterprise Plus Edition mit beliebigem JMS basierten Queuing Server einsetzen Workbench Process Engine Systemkonnektor Guide Kap 18 1 2 S 190 JMS Connector in Entry Standard oder Professional Edition einsetzen Wenn Sie eine Entry Standard oder Professional Edition basierend auf dem Tomcat Applikationsserver einsetzen k nnen Sie entweder die Queuing Schnittstelle des JBoss Applikationsserver in einer entfernten Enterprise oder Enterprise Plus Edition nutzen oder einen anderen beliebigen JMS basierten Queuing Server Dazu ben tigen Sie zus tzlich eine jar Datei als Kommunikationsbr cke zwischen Ihrer inubit Process Engine und dem entfernten Queuing Server So gehen Sie vor 1 jar Datei anfordern Wenn Sie auf den JBoss einer Enterprise oder Enterprise Plus Edition zugreifen m chten fordern Sie die Datei ibis jboss_ provider jar beim Support der Bosch Software Innovations GmbH an Wenn Sie auf einen beliebigen JMS basierten Queuing Servers zugreifen m chten fordern Sie die Datei provider jar von Ihrem JMS Provi
85. Sie beim Konfigurieren fest dass die Definition des aufzurufenden Web Services am Modul gespeichert werden soll Siehe Dialog Aufzurufender Web Service Workbench Process Engine Systemkonnektor Guide Kap 40 16 2 S 453 Geben Sie im Web Services Editor an wo die WSDL des aufzurufenden Web Services zu finden ist und laden Sie diese WSDL Zum Testen k nnen Sie z B den Web Service Provider nutzen dessen Erstellung im Abschnitt Web Service anbieten Workbench Process Engine Systemkonnektor Guide Kap 40 3 S 417 erl utert wird Wenn dieser Web Service Provider vorhanden und publiziert ist gehen Sie so vor um die Adresse der WSDL herauszufinden Klicken Sie im Register Aufzurufender Service am rechten Ende der Zeile auf den Button und w hlen Sie Publizierte Services anzeigen Im Web Browser ffnet sich eine Liste aller Web Services Klicken Sie auf den Link NamedesWebServices Die WSDL wird inubit 6 1 Workbench Process Engine Systemkonnektor Guide Web Services Connector 423 Web Service aufrufen angezeigt Kopieren Sie die URL in die Zwischenablage und f gen Sie diese im Register Aufzurufender Service in das Feld URL ein c Publizieren Sie den Konnektor d Erzeugen Sie einen Technical Workflow und f gen Sie den Web Services Output Connector ein 2 SOAP Request erstellen a Erzeugen Sie einen XSLT Converter und markieren Sie beim Konfigurieren die
86. Sie die inubit Dokumentation installiert haben Oder rufen Sie die Dokumentation direkt auf CustomLayout inubit 6 1 Workbench Process Engine Systemkonnektor Guide 05 09 2013 411 412 Web Application Connector Dialogbeschreibungen Zeigt einen Editor an in dem Sie CSS Klassen definieren k nnen Die CSS Klassen k nnen in allen Task Generator Formularen genutzt werden die den Web Application Connector im Dialog Berechtigungen Workbench Process Engine Modul Guide Kap 4 10 2 S 133 referenzieren Informationen ber die Syntax von Formatdefinitionen f r Klassen finden Sie unter http de selfhtml org css formate zentrale htm klassen Siehe Formulare mit CSS gestalten Workbench Process Engine Modul Guide Kap 4 2 3 S 64 39 3 3 Dialog Rechteverwaltung Rechte dieser Web Applikation 05 09 2013 In diesem Dialog definieren Sie Rechte Um ein Recht zu erzeugen geben Sie eine Zeichenkette in das Eingabefeld ein und klicken auf den Plus Button Das Recht wird im oberen Bereich angezeigt Zum L schen markieren Sie das Recht und klicken auf den Minus Button Das Recht wird aus dem Anzeigebereich entfernt Die Rechte werden in Formularen einzelnen Bedienelementen wie z B Buttons DropDown Listen oder Eingabefelder zugewiesen beim Deployen des Web Application Connector an das inubit Enterprise Portal bermittelt und dort Rollen zugeordnet Damit k nnen Sie feingranular steuern w
87. String gt InputRecord lt java lang String gt 22 lt param gt 23 lt createIndexedRecord gt 24 lt execute object ix result rec gt 25 lt param type javax resource cci InteractionSpec object iSpec gt 26 lt param type javax resource cci Record object S SiRec gt 27 lt execute gt 28 lt result value of Srec gt 29 lt jca gt Listing Abschnitt 2 von 2 Ausgef hrter Java Code Mit der Beispiel Eingangsnachricht wird folgender Java Code ausgef hrt Listing 1 following code is covered by JCA module settings 2 ConnectionFactory cf 3 Connection con cf getConnection 4 Interaction ix con getInteraction 5 following code is covered by JCA input message 6 EisInteractionSpec iSpec new EisInteractionSpec 7 iSpec setA a 8 RecordFactory rf cf getRecordFactory 9 IndexedRecord iRec rf createIndexedRecord InputRecord 10 Record rec ix execute iSpec iRec Listing Ausgangsnachricht Die Ausgangsnachricht enthalt den Wert der Variablen rec 17 4 Dialog J2EE Connector Architecture Adapter In diesem Dialog konfigurieren Sie die JCA Connector Eigenschaften inubit 6 1 Workbench Process Engine Systemkonnektor Guide 05 09 2013 185 186 JCA Connector Dialog J2EE Connector Architecture Adapter Allgemeine Einstellungen Authentifizierung Verbindungstest Ausgabe Optionen 0
88. Systemkonnektor Guide 05 09 2013 464 Web Services Connector Dialogbeschreibungen Modus Service Definition 05 09 2013 Akzeptierte Operation Empfangene Daten In diesem Dialog definieren Sie den aufzurufenden oder bereitgestellten Service den Modus eines Listeners die aufzurufende oder akzeptierte Operation und die Eingabe R ckgabe Daten Input Listener Connector Request entgegennehmen und Workflow starten W hlen Sie diesen Modus wenn der Web Service asynchron aufgerufen wird und die Antwort ber ein Reply Modul gesendet wird Asynchronen Callback entgegennehmen und Workflow fortf hren W hlen Sie diesen Modus f r einen Callback Listener an den ein Reply Modul die Antwort asynchron sendet In diesem Bereich wird die Adresse des bereitgestellten bzw aufzurufenden Services angezeigt die Sie im Modul Editor definiert haben Siehe Register Bereitgestellter Service Workbench Process Engine Systemkonnektor Guide Kap 40 16 3 1 S 454 Register Aufzurufender Service Workbench Process Engine Systemkonnektor Guide Kap 40 16 3 2 S 455 Mit einem Klick auf den s Button ffnen Sie ein Men mit folgenden Optionen Adresse kopieren Kopiert die Adresse des Web Services in die Zwischenablage Adresse der WSDL kopieren Kopiert die Adresse der WSDL in die Zwischenablage Publizierte Services anzeigen ffnet die Webseite http lt myServer gt 8000 ibis listServices und
89. TESTPROC INOUT gt lt parameter direction INOUT type NUMERIC gt 4 lt parameter gt lt method gt lt query gt lt query type call gt lt method name TESTPROC_INOUT2 gt lt parameter direction IN type NUMERIC gt 5 lt parameter gt lt parameter direction OUT type NUMERIC gt 5 lt parameter gt lt method gt lt query gt lt query type call gt lt method name TESTFUNC_OUT gt lt result type DATE gt lt method gt lt query gt lt query type call gt lt method name TESTFUNC_INOUT gt lt parameter type NUMERIC direction IN gt 2 lt parameter gt lt result type NUMERIC gt lt method gt lt query gt lt queries gt 05 09 2013 inubit 6 1 Workbench Process Engine Systemkonnektor Guide Database Connector 83 XML Querys Struktur und Beispiele lt xsl template gt lt xsl stylesheet gt Benutzung des Name Attributs Wird kein name Attribut f r die Parameter im query benutzt dann muss die Parameterreihenfolge exakt der im query definierten entsprechen Beispiel lt query type call gt lt method name TESTPROC_INOUT2 gt lt parameter direction IN type NUME parameter gt lt parameter direction IN type VARCHAR gt 5 lt parameter gt lt parameter direction OUT type NUMERIC gt 5 lt parameter gt lt method gt lt query gt DO
90. Templates beschrieben Es gibt f r jede Operation ein eigenes Template Insert mit und ohne Prim rschl ssel Select Update und Delete Sie finden alle Templates im Repository im Verzeichnis Global System Mapping Template Database Object Connector So gehen Sie vor 1 Erstellen Sie einen DBO Medium Connector 2 Konfigurieren Sie im Dialog Datenbankeinstellungen Workbench Process Engine Systemkonnektor Guide Kap 7 6 1 S 104 die Datenbankverbindung und testen Sie diese 3 Geben Sie im Feld Plugin ID eine ID ein Die ID muss innerhalb Ihrer inubit Installation je Datenbank eindeutig sein Die ID wird ben tigt wenn Sie zus tzlich einen DBO Input Connector als Event Listener einrichten Der Event Listener nutzt die ID um den DBO Medium Connector zu identifizieren der die zu Uberwachenden Events erzeugt Siehe Events mit Event Listener berwachen und archivieren Workbench Process Engine Systemkonnektor Guide Kap 7 2 S 96 4 Klicken Sie auf Weiter Der Dialog DBO Konfigurationsdatei Workbench Process Engine Systemkonnektor Guide Kap 7 6 3 S 107 ffnet sich und zeigt das zu Ihrer Datenbank passende Template f r die Konfigurationsdatei an 5 Konfigurationstemplate anpassen In der angezeigten Konfigurationsdatei bilden Sie die Struktur Ihrer Datenbanktabellen auf die vorgegebene XML Struktur ab Siehe Konfigurationsdatei Feldbeschreibungen Workbench Process Engine Systemkonne
91. VARCHAR2 50 DEFAULT NULL PK9 VARCHAR2 50 DEFAULT NULL inubit 6 1 Workbench Process Engine Systemkonnektor Guide Database Object Connector 97 Events mit Event Listener berwachen und archivieren IS STRUCTURE NAME VARCHAR2 50 DEFAULT NOT LE ERB VARCHAR2 10 DEFAULT NOT NULL RIORITY NUMBER 10 0 DEFAULT 0 NOT NULL MESTAMP DATE DEFAULT SYSDATE NOT NULL STATUS NUMBER 10 0 DEFAULT 0 NOT NULL RETRIEVE TIME DATE DEFAULT SYSDATE NOT NULL CREATE SEQUENCE SEQ IS EVENTS INCREMENT BY 1 START WITH 1 NOMAXVALUE NOCYCLE CACHE 10 F r MySQL Hus Z T O CREATE TABLE IS EVENTS ID NUMERIC 10 0 DEFAULT 0 NOT NULL IS PLUGIN ID VARCHAR 10 DEFAULT NOT NULL PK1 VARCHAR 100 NOT NULL PK2 VARCHAR 100 PK3 VARCHAR 50 PK4 VARCHAR 50 PK5 VARCHAR 50 PK6 VARCHAR 50 PK7 VARCHAR 50 PK8 VARCHAR 50 PK9 VARCHAR 50 IS_STRUCTURE NAME VARCHAR 50 DEFAULT NOT NULL VERB VARCHAR 10 DEFAULT NOT NULL A PRIORITY NUMERIC 10 0 DEFAULT 0 NOT NULL TIMESTAMP TIMESTAMP NOT NULL STATUS NUMERIC 10 0 DEFAULT 0 NOT NULL RETRIEVE TIME TIMESTAMP NOT NULL 2 Trigger erstellen Insert Trigger
92. VFS Connector Dialogbeschreibungen Die Eingabedaten sind in einer Zip Datei komprimiert Kodierung Bei Eingangsformat ZIP Kodierung Die Auswahl legt die Kodierung der Dateinamen fest Verzeichnis m Pfad Absoluter Pfad zu dem Verzeichnis das der VFS Connector beim Schreiben von Dateien verwenden soll nach dem Muster Root XY_TestGruppe XY_Testdaten Erzeuge fehlende Verzeichnisse Erzeugt alle nicht existierenden Verzeichnisse aus der Pfadangabe Datei nur bei Eingangsformat DATA Name Dateiname Optional mit Wildcard bzw regul rem Ausdruck m Bestehende Datei berschreiben Markiert Wenn bereits eine Datei mit demselben Namen existiert dann wird diese berschrieben Daten an die Datei anf gen Markiert Die zu lesende Datei wird bei jeder Ausf hrung des Workflows an eine evtl bereits existierende Datei angeh ngt Dies ist z B sinnvoll um Log Daten kumulativ in einer Datei zu protokollieren Diese Option kann nicht verwendet werden wenn im Dateinamen Q Wildcards angegeben sind Fehler erzeugen wenn Datei existiert Wenn markiert dann wird im Queue Manager ein Fehlereintrag f r den Workflow mit diesem VFS Connector angezeigt falls bereits eine Datei mit dem gleichen Namen existiert Ist ein Fehlerausgang konfiguriert wird dieser durchlaufen Sonst wird die Ausf hrung des Moduls abgebrochen 05 09 2013 inubit 6 1 Workbench Process Engine Systemkonnektor Guide 39 W App
93. Variable oo result aus c Wahlen Sie als Ziel Eingangsnachricht und als Kodierung UTF 8 Speichern Sie die Abbildungsregel mit OK Verbinden Sie den OpenOffice Connector mit dem Assign Modul ec inubit 6 1 Workbench Process Engine Systemkonnektor Guide File Connector einf gen OpenOffice Connector 275 Dokument in das PDF Format konvertieren So gehen Sie vor 1 S 3 4 Ki Erstellen Sie einen File Output Connector und benennen Sie ihn Wechseln Sie auf die Seite Zu schreibende Datei W hlen Sie als Eingangsformat Daten Geben Sie den Namen des Verzeichnisses ein in dem die Zieldatei gespeichert werden soll Geben Sie den Namen der Zieldatei ein Verbinden Sie das Assign Modul mit dem File Connector 25 4 Dokument in das PDF Format konvertieren inubit 6 1 Workbench Process Engine Systemkonnektor Guide So gehen Sie vor 1 Erstellen Sie in einem XSLT Converter eine Eingangsnachricht Siehe Beispiel Workflow erstellen Workbench Process Engine Systemkonnektor Guide Kap 25 3 S 272 Aktivieren Sie im Dialog XSLT Converter Eigenschaften die Checkbox Eingangsnachricht ignorieren Passen Sie das XSLT Stylesheet so an dass die Nachricht als Ergebnis des Mappings folgende Struktur hat Eigenschaften XSLT Converter Er Sa D A ver Stylsshest DOCIOPDF
94. WSDL wird per http localhost 8000 ibis ws HelloWorld wsdl abgerufen In der WSDL steht die Service Adresse http localhost 8000 ibis ws HelloWorld WSDL wird per http 127 0 0 1 8000 ibis ws HelloWorld wsdl abgerufen In der WSDL steht die Service Adresse http 127 0 0 1 8000 ibis ws HelloWorld Logging der SOAP Nachrichten aktivieren webservice log nur f r METRO Framework aktivierbar Siehe SOAP Nachrichten protokollieren Workbench Process Engine Systemkonnektor Guide Kap 40 14 S 445 Kompatibilit tsmodus mit Version 5 0 Axis2 Framework verwenden Aktivieren Sie diese Option um sicherzustellen dass Web Services Connectoren die mit einer inubit Version lt 5 1 angelegt wurden auch in der aktuellen Version laufen In der aktuellen Version wird Metro als Standard Web Service Framework eingesetzt w hrend in inubit Versionen lt 5 1 das Axis2 Framework verwendet wurde 40 16 3 6 Register SOAP Nachrichten Im Register SOAP Nachrichten k nnen Sie aus den Web Services Operationen im Register Bereitgestellter Service bzw Aufzurufender Service eine SOAP Eingabe oder Ausgangsnachricht erzeugen und anzeigen lassen Diese Nachrichten k nnen Sie z B als Templates im XSLT Converter verwenden 40 16 4 Dialog Web Service Einstellungen Aufruf Kontextmen des zu konfigurierenden Web Service Connectors gt Web Service Einstellungen inubit 6 1 Workbench Process Engine
95. Web Service wird in dem gew hlten UDDI Register publiziert 40 13 Aktive Web Services anzeigen 05 09 2013 Eine Liste aller aktiven Web Services erhalten Sie im Web Browser unter folgenden URL inubit IS 4 1 http myServer 8000 ibis services inubit BPM Suite 5 0 http myServer 8000 ibis services listServices inubit BPM Suite 5 3 http myServer 8000 ibis listServices inubit Software ab 6 0 http myServer 8000 ibis listServices Web Services die mit Web Services Input Konnektoren realisiert sind werden erst als aktiv gelistet wenn die entsprechenden Technical Workflows aktiviert sind Den Benutzernamen und das Passwort f r den Zugriff auf die Liste der aktiven Web Services setzen Sie in der Datei lt inubit installDir gt server Tomcat conf tomcat users xml So gehen Sie vor 1 Beenden Sie die Process Engine 2 ffnen Sie die Datei tomcat users xml zum Bearbeiten 3 Navigieren Sie zur Sektion lt tomcat users gt 4 Tragen Sie im Attribut username den Benutzernamen und im Attribut password das dazugeh rige Passwort ein 5 Starten Sie die Process Engine inubit 6 1 Workbench Process Engine Systemkonnektor Guide Web Services Connector 445 SOAP Nachrichten protokollieren 40 14 SOAP Nachrichten protokollieren Zur Fehleranalyse k nnen Sie SOAP Nachrichten der Web Services protokollieren lassen Das Logging steht nur f r Web Service Konnektoren ab Version 5 1 zur Verf gung wenn d
96. Wenn der Zugriff auf die angegebene Datei fehlschl gt wird die Ausf hrung des Workflows mit einem Fehler abgebrochen Zeitgesteuerter Input FTP Connector Der FTP Connector berpr ft entsprechend dem eingestellten Intervall ob eine Datei vorhanden ist Der Workflow wird nur gestartet wenn das der Fall ist Input Connector in der Mitte eines Workflows Wenn die Datei nicht existiert wird die Ausf hrung mit einer leeren Nachricht fortgesetzt Es wird kein Log Eintrag erzeugt Erzeuge XML Ausgangsnachricht mit der Statusinformation dar ber ob die Datei existiert oder nicht Der FTP Connector gibt eine XML Datei aus die ein einziges Attribut lt FileExists gt enth lt Dessen Wert ist entweder false wenn die angegebene Datei nicht existiert oder true wenn die angegebene Datei existiert inubit 6 1 Workbench Process Engine Systemkonnektor Guide Verzeichnis Konfiguration FTP Connector 141 Dialogbeschreibungen Erzeuge XML Ausgangsnachricht mit der Statusinformation dar ber dass die Datei nicht existiert ansonsten Abbruch des Workflows Wenn die Eingabedatei fehlt gibt der FTP Connector eine XML Datei mit dem Element FileExists false aus In allen anderen Fehlerf llen wird die Workflow Ausf hrung mit einem Fehler abgebrochen Nur bei Auswahl Verzeichnismodus Limit Dateianzahl Maximale Anzahl von Dateien die eingelesen werden Limit Gesamtgr e Maximale Gr e bis zu der Date
97. Wenn markiert dann werden die Eingangsnachrichten des Connectors vor dem Versand Base64 kodiert Diese Option ist sinnvoll f r Bin rdaten Konvertierung Nur Input Listener Connector m AJAX XML Konvertierung Wenn markiert dann werden eingehende AJAX Requests die von einem Task Generator erzeugt wurden nach XML konvertiert so wie es im Ausgangsmapping zur Verf gung steht Wenn die Option nicht markiert ist dann werden diese Requests als Byte Strom bergeben Eingabefelder gruppieren Wenn markiert dann werden alle Eingabefelder in der Eingangsnachricht die denselben Index haben bei der Ausgabe von einem Group Element umschlossen So ist es m glich in einem nachfolgenden XSLT Converter ber die Gruppen von Eingabefeldern mit xs1 for each zu iterieren Beispiel IN Eingabefeldliste Out Gruppenliste Vorname 1 lt Group gt Nachname 1 lt Vorname gt lt Nachname gt Stra e 1 eh Ort 1 Orc lt Group gt Vorname 2 lt Group gt Nachname 2 lt Vorname gt lt Nachname gt Stra e 2 ee Ort 2 lt Onaiey gt lt Group gt 05 09 2013 inubit 6 1 Workbench Process Engine Systemkonnektor Guide HTTP Connector 151 Dialog HTTP Connector Eigenschaften Eingabefelder haben einen Index wenn sie durch Kopieren mit der JavaScript Funktion copyComponentIS entstanden sind Diese Funktion ist in allen Formularen verf gbar die mit dem Task Generator erstellt wurden Siehe Tas
98. Wenn mehr als eine Datei bertragen wird legen Sie fest welche Dateien zuerst Ubertragen werden und in welcher Reihenfolge 10 2 2 Dialog Datenweitergabe Input Connector In diesem Dialog konfigurieren Sie die Ausgabe des Konnektors Verzeichnis Konfiguration Bei Auswahl Verzeichnismodus Inklusive Verzeichnisse Wenn markiert liest der File Connector zus tzlich zu den Dateien im angegebenen Verzeichnis auch das Verzeichnis selbst ein Mit Unterverzeichnissen Wenn markiert liest der File Connector zus tzlich rekursiv alle Unterverzeichnisse des angegebenen Verzeichnisses ein m Leere Verzeichnisse nach dem Lesen l schen L scht leere Verzeichnisse nach dem Lesen diese Option ist sinnvoll vor allem in Kombination mit der Option Dateien nach dem Lesen l schen Limit Dateianzahl Maximale Anzahl von Dateien die eingelesen werden Limit Gesamtgr e Maximale Gr e bis zu der Dateien eingelesen werden Dateipr fung Bei Auswahl Dateimodus Abbruch des Workflows wenn die Datei nicht existiert Im Testmodus Wenn der Zugriff auf die angegebene Datei fehlschl gt wird die Ausf hrung des Workflows mit einem Fehler abgebrochen Zeitgesteuerter Input File Connector Der File Connector berpr ft entsprechend dem eingestellten Intervall ob eine Datei vorhanden ist Der Workflow wird nur gestartet wenn das der Fall ist inubit 6 1 Workbench Process Engine Systemk
99. alle eingehenden Requests gegen die WSDL validiert Output Medium Connector Wenn markiert dann wird der ausgehende Requests gegen die WSDL validiert Antwortnachricht validieren Input Listener Connector Wenn markiert dann werden die ausgehenden Responses gegen die WSDL validiert Output Medium Connector Wenn markiert dann wird die eingehende Response gegen die WSDL validiert Workflow starten trotz nicht valider Anfrage Validierungsergebnis wird zum Workflow Input nur Input Listener Connector nur im Kompatibilit tsmodus F gt das Ergebnis der Validierung der Ausgangsnachricht hinzu Startet unabh ngig vom Ergebnis der Validierung den Workflow und bergibt das Validierungsergebnis an das nachfolgende Modul inubit 6 1 Workbench Process Engine Systemkonnektor Guide 05 09 2013 462 Web Services Connector Dialogbeschreibungen Asynchrone m Nachrichtenaustausch Callback Listener spezifische m Einstellung Fehlerbehandlung m UDD e Namensr ume a Weitere Optionen a 05 09 2013 Unterst tzung f r asynchronenen Antwort Versand nur Callback Listener Connector Siehe Callback Listener Connector anlegen Workbench Process Engine Systemkonnektor Guide Kap S 431 Listner nimmt Antwortnachrichten entgegen anstelle Anfrage Nachrichten nur Callback Listener Connector Ein und ausgehende Nachrichten werden in folgende Logdatei geschrieben lt iS installDir gt serv
100. an 5 Abh ngig von Ihrem Betriebssystem kopieren Sie die d11 so Dateien in eines der folgenden Verzeichnisse Windows Bei Start der inubit Process Engine ber das Startmen lt inubit installdir gt jvm jre bin Bei Einsatz der inubit Process Engine als Dienst unter Tomcat lt inubit installdir gt server Tomcat bin Linux 32 Bit lt inubit installdir gt _jvm jre bin Linux 64 Bit lt inubit installdir gt _jvm jre lib amd64 inubit 6 1 Workbench Process Engine Systemkonnektor Guide Lu 30 2 Funktionsprinzip SAP Connector 331 Funktionsprinzip Unter Umst nden m ssen Sie zus tzlich das Verzeichnis in die Umgebungsvariable PATH aufnehmen 6 Starten Sie die inubit Process Engine neu Typ Modus Funktion Input Connector BAPI RFC Der SAP Connector wird von einer Funktion im SAP System auf Listener synchron gerufen Die Funktion wird vom SAP Connector und den nachfol genden Modulen ausgef hrt Danach werden die R ckgabewerte in Form einer BAPI konformen XML Response an die aufrufende Funktion zur ckgegeben Zum Erstellen der XML Reponse wird ein XSLT Converter Modul und darin der SAP Explorer verwendet BAPI RFC Der SAP Connector wird von einer Funktion im SAP System auf asynchron gerufen Die Funktion wird vom SAP Connector und den nachfol genden Modulen ausgefuhrt evtl vorhandene Ruckgabewerte werden nicht an das SAP zur ckgegeben IDoc Der SAP Connector wird v
101. an der das wartende Backend System den Empfang der RosettaNet Nachricht best tigt hat Bedingte Weitergabe Der nachfolgende Demultiplexer pr ft den Inhalt der Nachricht und leitet diese an eines der nachfolgenden Module weiter Process_PIP4A3 Wenn im Service Header im Element RosettaNetXML ServiceHeader ProcessControl pipCode GlobalProcessIndicatorCode der Code 4A3 vorkommt dann wird die Nachricht zur weiteren Verarbeitung an den Workflow Connector Process_PIP_4A3 weitergeleitet Deliver_Acknowledge Wenn in der Nachricht der XPath RosettaNetConnector AcknowledgeReceived existiert dann handelt es sich bei der Nachricht um eine Best tigungsnachricht die zur weiteren Verarbeitung an den Workflow Connector Deliver_Acknowledge weitergeleitet wird Der verbundene Workflow enth lt den RosettaNet Output Connector der die Nachricht gesendet hat Dieser Output Connector wertet die Best tigungsnachricht aus um festzustellen zu welcher Nachricht die Best tigung geh rt Mit dieser Best tigung ist klar dass die Nachricht nicht erneut gesendet werden muss Dummy Wenn die Nachricht die Zeichenkette RosettaNetConnector MessageAllreadyProcessed enth lt dann wird die Nachricht an das Dummy Modul bergeben und nicht weiter verarbeitet An Stelle des Dummys k nnte auch z B ein Mail Connector stehen der einen Administrator von dem erneuten Eintreffen einer bereits gesendeten Nachricht informiert Wichtig ist d
102. bei jedem Zugriff auf die Datenbank erneut zeitintensiv eine Verbindung aufgebaut werden Wiederverwendung des Connection Pools Alle Database Connectoren bei denen die Werte der Einstellungen URL User und AutoCommit bereinstimmen verwenden denselben Connection Pool Max Anzahl aktiver Verbindungen im Pool Legt fest wie viele Verbindungen gleichzeitig aktiv sein d rfen inubit 6 1 Workbench Process Engine Systemkonnektor Guide Database Connector 91 Dialogbeschreibungen Eine zu kleine Anzahl von Verbindungen im Connection Pool kann zu Wartezeiten f hren eine zu gro e Zahl kann das Datenbanksystem unn tig belasten weil alle Verbindungen einen gewissen Verwaltungsaufwand seitens des Datenbanksystems erfordern Max Anzahl inaktiver Verbindungen im Pool Legt fest wie viele Verbindungen im Connection Pool gleichzeitig inaktiv sein d rfen Min Anzahl inaktiver Verbindungen im Pool Legt fest wie viele inaktive Verbindungen der Connection Pool immer h lt Anzahl zu pr fender inaktiver Verbindungen berpr ft inaktive Verbindungen in regelm igen Zeitabst nden darauf ob diese noch die korrekte Verbindungsfunktionalit t aufweisen Scheitert dieser Test wird die Verbindung aus dem Connection Pool entfernt Max Zeit des Pools um auf eine Verbindung zu warten Legen Sie fest wie lange der Pool h chstens warten soll bis der Connector eine Connection vom Pool erh lt Zeit zwisc
103. ber das CDO aufgebaut werden soll Benutzer Passwort Zugangsdaten des Benutzers mit denen Sie sich an der oben genannten Dom ne anmelden m chten Der Zugang muss ber die Berechtigungen verf gen welche f r die aktuelle Aktion n tig sind W hlen Sie eine der m glichen Aktionen aus Siehe Verwendung Workbench Process Engine Systemkonnektor Guide Kap 8 S 109 Dieser Dialog bietet folgende Optionen Mailbox Postfach auf welches sich die Aktion bezieht Lesen W hlen Sie aus ob alle oder nur die ungelesenen Mails abgeholt werden sollen inubit 6 1 Workbench Process Engine Systemkonnektor Guide Exchange Connector 113 Dialogbeschreibungen Nach der Verarbeitung Geben Sie an ob E Mails vom Exchange Server abgeholt und dabei vom Exchange Server gel scht werden sollen oder vom Exchange Server abgeholt und die Original E Mails als Gelesen markiert werden sollen nicht weiter bearbeitet werden sollen Anzahl von Nachrichten pro W hlen Sie eine der Optionen Aufruf Alle W hrend einer Modul Ausf hrung werden alle Mails in der angegebenen Mailbox vom Exchange Server geholt Maximum W hrend einer Modul Ausf hrung wird nur die angegebene Anzahl von Mails abgeholt Filtereinstellungen Zum Definieren von Filterkriterien denen E Mails entsprechen m ssen damit diese vom Mail Server abgeholt werden Verkn pfung der Filter Wenn mehr als ein Filter angegeben ist UND Alle
104. der Binardaten aus Ww einer Datei verwenden den Sie im Workflow vor den Web Services Connector platzieren Verwenden Sie dann ein Variablen Mapping in dem Sie die Binardaten einer Variable vom Typ xs base64Binary zuweisen 40 15 2 Nachrichten mit bin ren Attachments empfangen Standardm ig werden Inhalte von Anh ngen direkt in die empfangene SOAP XML Nachricht als base64 kodierte Daten integriert und dem Workflow bergeben Sie k nnen den Inhalt von Elementen mit Bin rdaten bzw die MTOM Anh nge auch extrahieren und als Inhalt von Workflow Variablen setzen inubit 6 1 Workbench Process Engine Systemkonnektor Guide 05 09 2013 450 Web Services Connector Bin rdaten als Attachments mit MTOM bertragen 05 09 2013 Voraussetzungen Web Services Medium Output oder Input Listener Connector ist angelegt und konfiguriert Siehe Web Service aufrufen Workbench Process Engine Systemkonnektor Guide Kap 40 4 S 421 So gehen Sie vor 1 Wahlen Sie im Modul Editor entweder den Web Services Medium Output oder Input Listener Connector der Bin r Inhalte oder MTOM Anh nge empf ngt 2 Zeigen Sie f r den jeweils gew hlten Konnektor Typ das Register Erweitert an und fahren Sie beim entsprechenden Konnektor fort Beim Input Listener Connector Aktivieren Sie im Bereich Anh nge Bin rdaten die Option Bin rdaten aus Eingabeachricht extrahieren und als Variablen Inhalte setzen Beim
105. des Feldes Knoten auf den Button Knoten ausw hlen Navigieren Sie in Ihrer Business Solution zu dem Knoten den Sie l schen wollen Klicken Sie auf Fertigstellen Setzen Sie den Startpoint vor den Solution Center Connector Starten Sie den Test ohne Datei 35 8 2 Objekt ber eine XPath Anfrage l schen So gehen Sie vor 1 Eine EE N Erstellen Sie einen Solution Center Connector Konfigurieren Sie allgemeinen Moduleigenschaften und die System Connector Eigenschaften des Solution Center Connector Wechseln Sie auf das Register SC Connector Eigenschaften W hlen Sie den Modus Objekt l schen Klicken Sie auf das Icon neben dem XPath Feld Navigieren Sie im Solution Center Explorer zu dem gew nschten Knoten und best tigen Sie die Auswahl mit OK Tragen Sie in das Feld Anzahl der Knotenebenen den gew nschten Wert ein Siehe Anzahl der Knotenebenen Workbench Process Engine Systemkonnektor Guide Kap 35 S 386 inubit 6 1 Workbench Process Engine Systemkonnektor Guide 05 09 2013 384 Solution Center Connector Dialog SC Connector Einstellungen 8 Starten Sie den Test ohne Datei 9 Pr fen Sie in der Ergebnisdatei ob die Daten des Vaterknotens korrekt zur ckgegeben wurden und im Solution Center Explorer ob das Objekt korrekt gel scht wurde 35 9 Dialog SC Connector Einstellungen In diesem Dialog konfigurieren Sie den Modus und die Kn
106. ea ee 213 inubit 6 1 Workbench Process Engine Systemkonnektor Guide 05 09 2013 7 8 Inhaltsverzeichnis 20 3 Dialog Livelink PDMS Connector Eigenschaften AA 214 21 Mall eil EE 215 21 1 Modulvariablen des Mail Connectors 44ss44444neeennnnnnnnnnnnnnnnnnennnnnnnnnennnnnnnnnnnnnnnsnnennnnnnsnennnnnnnnn nn 215 21 2 Dialogbeschreibungen u ea abe 216 21 2 1 Dialog Mail Connector Eigenschaften 216 21 2 2 Dialog Datenweitergabe konfourieren nn 217 21 2 3 Dialog Mitteilungskonfiguration 444444ssnnnnnnnnennnnnnnnnnnnnnnnnnnennnnnnnnnennnnnnnnnnnnnnnnnennnn ann 219 21 2 4 Dialog S MIME Entschl sselung nn 220 21 2 5 Dialog Eigenschaften der Eingabecdaten nn 220 21 2 6 Dialog SMTP Connector Eigenschaften A 222 21 2 7 Dialog S MIME Verschluseselung nn 224 22 MSMQ el EE 225 22 1 Voraussetzungen une nennen a re 225 22 2 Ein und Ausgangsnachrichten erstellen nn 226 22 3 Dialog MSMQ Connector Eigenschaften uusersnnnennnennnnnnnnnennnnnnnnnnnnnnnnnennnnnnnnnnnne nenn 227 23 OF TP Gonnector 4 uu 0224 22 un ee Er a einen 229 23 1 Voraussetzungen u nee een 229 23 2 Funktionsprinzip uuueruesssssssnnnnnennnnnennennnnnnnnnnnnnnnnnnnnannnnnnnnnnnnnnennnnnnnnannennnnrnnennnennennnennnnnnnernnennen namen 230 KREE nee ie Er ee TEE 231 23 4 IVS MONILOMIAG sau Han nn Elias 233 23 5 Dialog OFTP Datenaustausch Konfiguration
107. eindeutige ID des Anhangs WSAttachmentContent Type lt number gt Typ des Anhangs Lu Der Wert f r number beginnt bei 0 Siehe auch Modulvariablen definieren Workbench Benutzer Guide Kap 14 S 387 40 3 Web Service anbieten berblick Ein Web Service Provider wird in der inubit Software durch einen Technical Workflow mit einem Web Services Input Listener Connector realisiert Der Web Services Input Listener Connector bietet die Funktionalit t des Technical Workflows nach au en als Web Service an Das folgende Beispiel zeigt die wesentlichen Module f r einen Web Service Provider inubit 6 1 Workbench Process Engine Systemkonnektor Guide 05 09 2013 418 Web Services Connector Web Service anbieten 05 09 2013 ProvideVWWebService DoSomething CreateR esponse gt gt Demux a gt DoSomethingElse CreateR esponse gt gt KD Web Services Listener Connector ProvideWebService Der Web Services Input Listener Connector bietet u a die Operation sayHello an und wartet auf Aufrufe die SOAP Requests von anderen Web Services Wenn ein SOAP Request eintrifft wird dieser an das folgende Modul den Demultiplexer weitergeleitet und damit der Workflow gestartet Demultiplexer Demux optional Ein SOAP Request kann genau eine Operation des Web Services aufrufen auch wenn der Web Service mehrere Operationen anbietet Um anhand der XML Elemente im Request zu erkennen we
108. einer Message Queue Input Listener Connector Empf ngt eine Nachricht von der WebSphere MQ Software sobald neue Nachrichten in der Queue stehen holt diese Nachrichten ab und startet den Workflow Output Connector Schreibt Nachrichten in die Message Queue Siehe auch Systemkonnektoren Workbench Process Engine Systemkonnektor Guide Kap 1 S 19 Module anlegen Workbench Benutzer Guide Kap 3 3 S 129 Technical Workflow Diagramme Workbench Benutzer Guide Kap 12 S 311 Sie m ssen der inubit Software die Datei com ibm mq jar zug nglich machen So gehen Sie vor 1 Schlie en Sie die inubit Workbench 2 Stoppen Sie die inubit Process Engine 3 Kopieren Sie die Datei com ibm mq jar in das Verzeichnis lt inubit installdir gt client lib ext Die Datei ist Teil der IBM WebSphere MQ Software inubit 6 1 Workbench Process Engine Systemkonnektor Guide 05 09 2013 478 WebSphere MQ Connector Dialog WebSphere Message Queue Connector Kopieren Sie die Datei zus tzlich in eines der folgenden Verzeichnisse abh ngig vom eingesetzten Applikationsserver Tomcat lt inubit installdir gt server Tomcat webapps ibis WEB INF lib JBoss lt inubit installdir gt server JBoss server default lib Starten Sie die inubit Process Engine und die inubit Workbench neu 42 2 Dialog WebSphere Message Queue Connector Grundkonfiguration Queue Konfiguration
109. entsprechen m ssen Si F r Informationen ber regul re Ausdr cke siehe z B http www perl com doc manual htmi pod perlre html oder http www regular expressions info tutorial html Auswahl umkehren Wenn markiert dann wird das Muster das fur den Dateinamen durch Wildcard oder regularen Ausdruck angegeben wurde umgekehrt Damit werden alle Dateien gelesen deren Name dem Muster nicht entspricht Dateien nach dem Lesen l schen Wenn markiert dann werden die gelesenen Dateien nach dem Lesen gel scht Max Anzahl v Ausf hrungen pro zeitgesteuertem Aufruf inubit 6 1 Workbench Process Engine Systemkonnektor Guide 05 09 2013 402 VFS Connector Dialogbeschreibungen Lu Lesereihenfolge Beschr nkungen Konfiguration des Ausgangsformates 05 09 2013 Mit der Angabe legen Sie fest wie oft pro ausl sendem Event der Workflow maximal gestartet werden soll Ausl sendes Event ist das Erreichen eines Zeitpunktes Dann wird der Workflow so oft gestartet bis entweder keine weiteren Daten zu holen zu senden sind oder die Anzahl erreicht wurde welche bei maximale Ausf hrungen pro Aufruf konfiguriert wurde Mit der Begrenzung der Ausf hrung steuern Sie die Systemauslastung der inubit Process Engine Die Angabe wird im Test Modus ignoriert dann wird der Workflow genau einmal gestartet Die Option ist nur bei aktiviertem Scheduler aktiv Wenn mehr als eine Datei bertragen
110. ffnen Sie die Watchpoint Datei nach dem OpenOffice Connector Speichern Sie die Watchpoint Datei in die Zwischenablage So gehen Sie vor 1 2 3 4 5 Erstellen Sie ein Assign Modul und benennen Sie es Erstellen Sie eine neue Abbildungsregel f r das Variablen Mapping a Wahlen Sie als Quelle Eingangsnachricht und als Datentyp XML b Klicken Sie auf den Button XML Element ausw hlen am Ende der Zeile XPath c ffnen Sie die Zwischenablage mit der beim Anlegen des OpenOffice Connectors im Schritt 7 gespeicherten Watchpoint Datei d Ziehen Sie den Textknoten des Elements OutputDocument in die Zeile XPath 5 XPath Assistent XPath Opemoffi nnegt 1 GON ter OutputDocument text fP f Verwendete XPath Version 2 finiert in den Workflow Eigenschaften 3388 Ausf hren auf 41 El Q xML Queldateis Users hjh AppData Roaming inubi t Toolset 6 0 v E OpenOfficeConnector J t Ee E OOWriter dei outputFilter fiyriter_pdf_Export Ela OutputDo nt IVBERIOxLjQKIcOkw7zDtsOfCjIgMCBvY moKPDwvTGV nenn ae Aere fae uni ee ae TT e Speichern Sie die Anderungen mit OK f W hlen Sie als Ziel Variable g Erstellen Sie die Variable oo result mit dem Typ xs base64Binary Erstellen Sie eine weitere Abbildungsregel fur das Variablen Mapping a Wahlen Sie als Quelle Variable b Wahlen Sie als Variable die im Schritt 2 erstellte
111. fk_systyp gt 11 lt Property gt Property Name ixos bai LinkedIds MultiValue true gt lt Value gt gss id1 lt Value gt lt Value gt gss id2 lt Value gt lt Value gt myLink foo bar lt Value gt lt Property gt lt Properties gt lt Notes gt lt Annotations gt lt Components gt lt Entity gt lt Entities gt Beschreibung Property Name Erforderlich Der vollstandige Name des Properties Property MultiValue Optional Kennzeichen dass das Property aus mehreren Werten be steht Property Value Bedingt Ein oder mehrere Wert e eines MultiValue Properties Property Erforderlich Der Wert des Properties 20 2 3 3 Entity Components 05 09 2013 Komponenten beinhalten die eigentlichen Dokumente z B PDF Dokumente Pro Entitat konnen mehrere Komponenten also Dokumente abgelegt werden In der Regel ist dies aber immer dasselbe Dokument in unterschiedlichen Formaten So kann z B eine Rechnung als TIFF als PDF und als Word Dokument angelegt werden Die entsprechende Entitat hatte dann 3 Komponenten lt Entities gt inubit 6 1 Workbench Process Engine Systemkonnektor Guide A Livelink PDMS Connector 211 Inhalt und Struktur der Eingangs und Ausgangsnachrichten Entity gt lt Properties gt lt Notes gt lt Annotations gt lt Components gt lt Component gt lt Name gt data lt Name gt lt Format gt application pdf lt Format
112. geeignet zur Integration von Legacy Systemen die typischerweise nicht ber Web Service Schnittstellen verf gen dazu wird die Schnittstelle des Legacy Systems mit Hilfe eines Technical Workflows in einen Web Service transformiert und durch den Input Listener als Service verf gbar gemacht Der Input Listener erh lt einen Request startet den Workflow wartet auf das Ergebnis des Workflows und sendet dann das Ergebnis und die HTTP Status Meldung 200 zur ck Siehe Web Service anbieten Workbench Process Engine Systemkonnektor Guide Kap 40 3 S 417 Medium Listener Connector Wartet auf die Antwort eines asynchron aufgerufenen Web Services inubit 6 1 Workbench Process Engine Systemkonnektor Guide 05 09 2013 414 Web Services Connector Funktionsprinzip eines Web Services Metro Ein Medium Listener Connector wird daher im Workflow stets hinter einem Medium Connector der einen asynchronen Web Service aufruft genutzt Siehe Asynchronen Web Service aufrufen Workbench Process Engine Systemkonnektor Guide Kap 40 5 2 S 429 Medium Output Connector Der Connector sendet einen Request an einen externen Web Service oder an einen Web Service Input Listener und wartet auf die Response Sobald der Connector die Response erhalten hat bergibt er diese an das n chste Modul in seinem Workflow und f llt die Variablen TSHttpResponseCode z B mit Wert 200 wenn OK und ISHttpResponseTe
113. gt m mmm inubit 6 1 Workbench Process Engine Systemkonnektor Guide 05 09 2013 314 RosettaNet HTTPS Connector Beispiel Workflow RosettaNet Nachrichten versenden 29 3 Beispiel Workflow RosettaNet Nachrichten versenden Retry RN Ouput CUT DistributeRnOutput WatUntilAcknowledg Ack_Received_Dummy Splitter 3 RosettaNetCon xml xml xml Error Mail PropertyMapping RosettaNetCon Joiner 8 SendErrorMail Split Mime Copy_Base64 DecodeBase64 xml RosettaNetCon xml xml Der abgebildete Workflow versendet die RosettaNet Nachricht die im Abschnitt Beispiel Workflow RosettaNet Nachrichten versenden Workbench Process Engine Systemkonnektor Guide Kap 29 3 S 314 erstellt wurde und empfangt die Bestatigung Uber den Eingang der Nachricht Wenn die Business Message das letzte Mal gesendet wurde und immer noch keine Bestatigung fur die Nachricht eingegangen ist dann wird der Fehlerausgang angesteuert Nachricht versenden Der Output Connector RN Output CUT erh lt eine RosettaNet Business Message als Eingangsnachricht und verarbeitet diese wie folgt 1 Der Pr ambel Header wird hinzugef gt Er enth lt die RNIF Version 2 Der Delivery Header und der Service Header wurden im XSLT Converter erstellt der RosettaNet Output Connector f gt diesen Headern die noch fehlenden Informationen hinzu Die 05 09 2013 inubit 6 1 Workben
114. gt lt Encoding gt lt CreatedBy gt lt CreatedBy gt lt CreatedAt gt lt CreatedAt gt lt LastModifiedBy gt lt LastModifiedBy gt lt LastModifiedAt gt lt LastModifiedAt gt lt Volume gt lt Volume gt lt OnlineStatus gt lt OnlineStatus gt lt Data gt lt Base64 kodierte Bin rdaten gt lt Data gt lt Component gt lt Components gt lt Entity gt lt Entities gt Entity Components Feld Beschreibung Name Erforderlich Der Name der Komponente Dieser Name muss pro Format eindeutig sein Soll ein bestehendes Dokument berschrieben werden ist der Name und das Format das entscheidende Krite rium Primarschlussel Format Erforderlich Der MIME Type der Komponente Soll ein bestehendes Doku ment Uberschrieben werden ist der Name und das Format das entscheidende Kriterium Primarschlussel Encoding Optional Das Encoding der Komponente CreatedBy Bedingt Der Wert des Properties CreatedAt Bedingt Nur lesend fur Ausgangsnachricht LastModifiedBy Bedingt Nur lesend fur Ausgangsnachricht LastModifiedAt Bedingt Nur lesend fur Ausgangsnachricht Volume Bedingt Nur lesend fur Ausgangsnachricht OnlineStatus Bedingt Nur lesend fur Ausgangsnachricht Data Erforderlich Enthalt das eigentliche Dokument mit base64 Kodierung Im Archiv ist die Nachricht binar gespeichert Sie wird vor und nach dem Speichern bzw Le
115. inubit 6 1 Workbench Process Engine Systemkonnektor Guide SNMP Connector 367 Beispiel Input Connector lt Property name 1 3 6 1 4 1 272 4 3 1 1 24 1 4 gt lt SNMPVarBinds gt 34 3 Beispiel Input Connector Dieses Beispiel bezieht sich auf das Beispiel zum Medium Connector Falls die ISDN Verbindung des Routers immer dieselben Daten benutzt kann die Verbindung auch am Anfang eines Workflows mit einer statischen OID Tabelle konfiguriert werden Dazu wird ein SNMP Input Connector folgenderma en konfiguriert 8 Neues Modul anlegen Simple Network Management Protocol SNMP Connector Hier k nnen Sie die Eigenschaften des SNMP Connectors festlegen inubit 6 1 Workbench Process Engine Systemkonnektor Guide 05 09 2013 368 SNMP Connector Dialog SNMP Connector Eigenschaften 34 4 Dialog SNMP Connector Eigenschaften Grundkonfiguration Konfiguration der Variablenbindung 05 09 2013 In diesem Dialog haben Sie folgende Optionen SNMP Version Mit der Auswahl der Version 1 oder 2c wird die SNMP Nachricht entsprechend konfiguriert Fragen Sie Ihren Administrator welche SNMP Version in Ihrem Firmennetzwerk genutzt wird Servername Servername als Klarname oder IP Adresse Port Standardport ist 161 Wenn die SNMP Kommunikation ber einen anderen Port l uft erfragen Sie die Portnummer bei Ihrem Administrator Der Button Standard stellt die Standardportnummer wieder her Com
116. inubit Software dynamisch eingebunden Script js GcScript js und AjaxScript jsim Verzeichnis lt inubit installdir gt server ibis root conf form Wenn die Option nicht markiert ist dann m ssen Sie JavaScript Dateien manuell in den Header der angezeigten Portalseite einbinden inubit 6 1 Workbench Process Engine Systemkonnektor Guide 05 09 2013 410 Web Application Connector Dialogbeschreibungen 05 09 2013 Lu Die Bosch Software Innovations GmbH empfiehlt die Option zu markieren wenn Sie den Liferay Portalserver nutzen Formulare in Session nicht cachen Reduziert den Speicherverbrauch in der Portlet Session Trace Level Zum Festlegen der Protokollierungstiefe Portlets schreiben ihre Informationen in Protokolldateien im Verzeichnis lt inubit installdir gt ibis root log Mit Hilfe der Protokolldateien k nnen Sie Portletfehler und au ergew hnliche Bedingungen untersuchen Portlets testen und Fehler beheben Interportletkommunikations Id Eindeutiger Bezeichner f r das Portlet das Sie aktuell konfigurieren Die ID ist n tig damit das Portlet bei der Kommunikation zwischen Portlets identifiziert werden kann Diese ID wird automatisch beim Anlegen des Web Application Connectors vergeben kann aber manuell berschrieben werden Interportletkommunikation Ziel Eindeutiger Bezeichner des Portlets dem die Daten des aktuellen Portlets festgelegt im Feld Interportletkom ID zur Verf gung stehen solle
117. kann Digest Verlangt ebenfalls Benutzername und Passwort Das Passwort wird verschl sselt bertragen F r die Verschl sselung werden mehrere Parameter verwendet u a zuf llig erzeugte Werte Benutzername Benutzername f r die Authentifizierung Passwort Passwort f r die Authentifizierung Authentifizierung f r Zugriff auf Process Engine verwenden Passwort aus Portalkonfiguration Verwendung des internen Benutzers inubitlSPortallser vintern Anfragedaten nur f r POST und PUT Hier legen Sie die gew nschte Repr sentation der Anfragedaten fest W hlen Sie dazu aus der Liste der Medien Typen einen Content Type aus und definieren Sie einen Zeichensatz HTTP Header Die Angaben im Request Header informieren den Server z B ber die Art und Konfiguration des Clients und die vom Client erwarteten bzw unterst tzten Dokumentformate Hier legen Sie z B fest in welcher Repr sentation man eine Liste mit angefragten Auftr gen erhalten will Der Button Header bearbeiten ffnet einen Dialog In dem Dialog k nnen Sie den Request Header durch Doppelklick auf die einzelnen Zeilen der Header Liste definieren Ef Die zul ssigen Header sind in der HTTP Spezifikation festgelegt siehe http www w3 org Protocols rfc26 16 rfc26 16 sec5 htmi sec5 3 Test m Button Versand der Anfrage testen Zum Pr fen ob die Verbindung mit Ihren Angaben erfolgreich aufgebaut werden kann Der Button ffnet einen D
118. kann 26 3 2 Dialog Erstellen von OSCI Nachrichten am Intermedi r Virtuelle Poststelle 05 09 2013 Medium Connector In diesem Dialog legen Sie die Konfigurationseinstellungen des Autors und Empf ngers fest um OSCI Nachrichten am Intermedi r zu erstellen Intermedi r inubit 6 1 Workbench Process Engine Systemkonnektor Guide OSCI Connector 285 Dialogbeschreibungen Geben Sie die URL des Intermedi rs unter der dieser online erreichbar ist Zertifikat des Intermedi rs Laden Sie hier die Datei mit dem ffentlichen Zertifikat des Intermedi rs entspricht einer cer Datei Autor m Signatur Keystore Laden Sie die pfx Datei mit dem Zertifikat des Absenders das zum Signieren dient Passwort des Signatur Schl ssels Geben Sie das Keystore Passwort des privaten Schl ssels f r die Signierung der erstellten Nachricht ein Chiffrierungs Keystore Laden Sie hier die pfx Datei mit dem Zertifikat des privaten Schl ssels des Absenders zur Verschl sselung der erstellten Nachricht ein Passwort des Chiffrierungs Schl ssels Geben Sie das Keystore Passwort des privaten Schl ssels f r die Verschl sselung der erstellten Nachricht ein Empf nger m Chiffrierungs Zertifikat Laden Sie die Datei mit dem ffentlichen Zertifikat des Empf ngers Verbindungstest m Verbindung testen Zum Testen ob die Verbindung mit Ihren Angaben erfolgreich aufgebaut werden kann inubit 6 1 Workb
119. kommunizieren soll muss eine X 25 konforme Adresse haben Eine X 25 Adresse ist eine Folge von Ziffern Die ersten Ziffern geben den L ndercode an die darauffolgenden Ziffern bestimmen das Netzwerk innerhalb des Landes und die letzten Ziffern die Rechnernummer X 25 Facilities Meist nicht angegeben X 25 Benutzerdaten Meist nicht angegeben inubit 6 1 Workbench Process Engine Systemkonnektor Guide 05 09 2013 270 OFTP2 Connector Dialog Stationen Wenn Sie Facilities und Benutzerdaten angeben m chten dann als HEX Code Die Daten werden nur f r X 25 ber ISDN bertragungen ben tigt wenn Ihr X 25 Provider dies fordert RvsTimeOut Zeit in Sekunden nach welcher der Versuch eine Verbindung aufzubauen abgebrochen wird RvsRestartTimeOut Zeit in Sekunden nach welcher der Versuch eine Verbindung neu aufzubauen abgebrochen wird X 25 Paketgr e Hier wird blicherweise die Paketgr e 128 angegeben X 25 Fenstergr e Anzahl der Pakete die ohne Best tigung verschickt werden k nnen Standard 7 Max eingehende Verbindungen Maximale Anzahl gleichzeitig laufender Empfangsprozesse ber diesen Kanal Standard 1 Maximum 100 X 25 DBit Delivery Confirmation Bit Wenn ausgew hlt dann fordert die sendende Station eine Empfangsbest tigung an X 25 Modulo Modulo Variante Standard 8 Siehe X 25 Modulo Workbench Process Engine Systemkonnektor Guide Kap 24 S 265 24
120. name Strasse Sch neberger Ufer 89 91 gt BookmarkReplace name PLZ 10785 gt BookmarkReplace name Ort Berlin e TEE A nn a Je nach Art der gew nschten nderungen k nnen Sie einzelne BookmarkReplace Elemente weglassen oder weitere Elemente gem der Schemadatei hinzuf gen Refer to XML Schema als Vorlage f r Eingangsnachrichten Workbench Process Engine Systemkonnektor Guide Kap 25 S 272 5 Ersetzen Sie den XSLT Converter im Beispiel Workflow durch den im Schritt 1 erstellten XSLT Converter 6 Passen Sie im File Connector auf der Seite Zu schreibende Datei ggf den Dateinamen und das Verzeichnis an 7 Setzen Sie den Startpoint vor das Assign Modul am Anfang des Workflows 8 Starten Sie den Workflow mit dem zu bearbeitenden Dokument 9 Pr fen Sie ob das Dokument korrekt bearbeitet wurde inubit 6 1 Workbench Process Engine Systemkonnektor Guide 05 09 2013 278 OpenOffice Connector Dokument drucken 25 6 Dokument drucken So gehen Sie vor 1 Erstellen Sie ein Assign Modul um das Eingangsdokument Base64 zu kodieren Siehe Assign Modul zum Kodieren als Base64 Workbench Process Engine Systemkonnektor Guide Kap 25 S 272 2 Erstellen Sie mit einem XSLT Converter eine Eingangsnachricht Siehe Beispiel Workflow erstellen Workbench Process Engine Systemkonnektor Guide Kap 25 3 S 272 3 Aktivieren Sie auf der Seite XSLT Converte
121. nicht ausgegeben Datenweitergabe Nur im Verzeichnismodus im Dateimodus nur bei Abbruch des 05 09 2013 Workflows wenn Datei nicht existiert Art Legen Sie fest wie die Eingangsnachrichten an den Workflow bergeben werden sollen Daten nur bei Auswahl Dateimodus Die Eingangsnachrichten werden unver ndert weitergegeben Diese Option ist auszuw hlen wenn die Eingangsnachrichten z B als XML vorliegen IBlSDirectory Xml Legt fest dass die Eingangsnachrichten im IBISDirectory XML Format weitergegeben werden Dabei wird f r jede Eingangsnachricht ein XML Wrapper Element erzeugt Zip Die Eingabedateien werden in einer Zip Datei komprimiert Kodierung Legt die Kodierung des Zeichensatzes fest inubit 6 1 Workbench Process Engine Systemkonnektor Guide XML Konfiguration Zip Konfiguration File Connector 129 Dialogbeschreibungen nur bei Datenweitergabe gt Art IBISDirectory Xml Inklusive Daten Wenn markiert dann wird die gesamte Datei gelesen Wenn nicht markiert dann werden nur die Metadaten der Datei gelesenen z B Name Dateigr e und Datum Daten base64 kodieren Der Inhalt der Datei wird base64 kodiert der XML Ausgangsnachricht mitgegeben Daten komprimieren Die Daten werden Zip komprimiert Absoluten Pfad in XML speichern Wenn markiert wird der absolute Pfad der Datei in einem gesonderten Attribut path gespeichert nur bei Datenweitergabe
122. r den jeweils gew hlten Konnektor Typ das Register Erweitert an und fahren Sie beim entsprechenden Konnektor fort Beim Medium Output Connector a Aktivieren Sie im Bereich Anh nge Bin rdaten die Option MTOM Anh nge f r ausgehende Nachricht aktivieren b Passen Sie Ihre SOAP Nachricht so an dass die zu versendenden Bin rdaten in einem Nachrichten Element z B mit dem Namen imageData f r Grafikdaten vom Typ xmime base64Binary enthalten sind und weisen Sie dazu diesem Nachrichten Element das Attribut xmime contentType Zu Beim Input Listener Connector a Aktivieren Sie im Bereich Anh nge Bin rdaten die Option MTOM Anhange f r Antwort Nachricht aktivieren b Zeigen Sie das Register XML Schemas an c W hlen Sie das Nachrichten Element dessen Inhalt als Anhang verschickt werden soll z B imageData d Weisen Sie diesem Element den Typ xmime base64Binary zu indem Sie diesen Typ aus dem unteren Bereich des Editors aus der Gruppe der complex types auf das entsprechende Element oben in der Nachricht ziehen Damit haben Sie dem Element gleichzeitig das notwendige Attribut xmime contentType zugewiesen Passen Sie die ausgehende SOAP Nachricht so an z B in einem XSLT Converter dass im entsprechenden Nachrichten Element welches die MTOM Daten enthalten soll fur das xmime contentType Attribut der korrekte Inhalts Typ gesetzt ist z B image jpeg im Zweifelsfall setzen Sie ap
123. sicher dass Applikationen die auf die Datei warten die Datei erst nach deren Fertigstellung abholen Wenn markiert dann werden die Daten zun chst in eine tempor re Datei geschrieben Wenn dieser Vorgang abgeschlossen ist wird die tempor re Datei entsprechend dem angegebenen Namen umbenannt Bei gr eren Dateien kann das Erstellen der tempor ren Datei l nger dauern Konfiguration Modulausgang Eingangsnachricht zus tzlich auch in der Ausgangsnachricht setzen Wenn die Option markiert ist dann wird die Eingabedatei an nachfolgende Module weitergeleitet Abh ngig von der Gr e der Eingabedateien kann diese Option die Performance Ihres Systems beeinflussen Siehe Modulvariablen des File Connectors Workbench Process Engine Systemkonnektor Guide Kap 10 1 S 123 inubit 6 1 Workbench Process Engine Systemkonnektor Guide 05 09 2013 132 File Connector Dialogbeschreibungen 05 09 2013 inubit 6 1 Workbench Process Engine Systemkonnektor Guide nm FTP Connector 133 Dieser Abschnitt erl utert die folgenden Themen Modulvariablen S 133 Dialogbeschreibungen S 134 Verwendung Der FTP Connector unterst tzt die Transferprotokolle FTP FTPS und SFTP Konnektortypen Es gibt folgende Konfigurationsm glichkeiten f r FTP Connectoren 11 1 Modulvariablen Input Connector Holt Dateien von einem FTP Server Output Connector Schreibt Dateien in ein Verzeichnis auf einem FTP Server Siehe au
124. sprechend benannt Zertifikat des Empf ngers m Hinzuf gen hinzuf gen Der Button ffnet einen Dateiexplorer um die Keystore Datei mit dem Schl ssel zu laden Zum Laden ben tigen Sie den Alias des Zertifikats Daten des Zertifikats Zeigt nach dem Laden die ffentlichen Daten des Zertifikats an 05 09 2013 inubit 6 1 Workbench Process Engine Systemkonnektor Guide EH KOKO Connector SZ Verwendung Konnektortypen 22 1 Voraussetzungen Dieser Abschnitt erl utert die folgenden Themen m Voraussetzungen S 225 a Ein und Ausgangsnachrichten erstellen S 226 m Dialog MSMQ Connector Eigenschaften S 227 Microsoft Message Queuing MSMQ ist die Implementation einer Nachrichten Warteschlange u a zur Anbindung von MS Navision MS Axapta MS CRM und MS Biztalk MSMQ entkoppelt Sender und Empfangeranwendungen so dass die Senderanwendung Nachrichten senden kann und sich nicht darum k mmern muss ob und wann diese an die Empfangeranwendung ausgeliefert werden Alle Nachrichten werden von MSMQ in einer Warteschlange gespeichert und weitergeleitet sobald die Empf ngeranwendung erreichbar ist Nachrichten werden also auch dann zuverl ssig bermittelt wenn z B die Empf ngeranwendung nicht l uft oder der Rechner auf dem die Empf ngeranwendung installiert ist vor bergehend nicht mit dem Netzwerk verbunden ist Input Listener Connector Fungiert als Empf nger und wartet auf Nachrichten aus der
125. ssen Regul re Ausdr cke m ssen in Schr gstriche eingeschlossen WY werden Z B d d d d d d d qd inubit 6 1 Workbench Process Engine Systemkonnektor Guide 05 09 2013 126 File Connector Dialogbeschreibungen 05 09 2013 F r Informationen ber regul re Ausdr cke siehe z B http www perl com doc manual html pod perlre html oder http www regular expressions info tutorial html Wildcard Inhalt des vorher ausgef hrten File oder FTP Connectors verwenden Beispiel Ein vorher ausgef hrter File Connector wurde so konfiguriert dass im Feld Dateiname eine Datei Test xml angegeben wurde Als Ausgangsnachricht wurde vom File Connector eine Datei mit Namen Test5 xm1 weitergeleitet Der Wildcard Inhalt ist in diesem Fall das Zeichen 5 Wenn Sie im vorliegenden Connector ebenfalls eine Wildcard angegeben haben zum Beispiel Ausgabe vm so wird an Stelle der Wildcard das Zeichen 5 eingef gt Die Ausgabe des hier konfigurierten Connectors ist daher Ausgabe5 xml Dateien nach dem Lesen l schen Fehler erzeugen wenn L schvorgang fehlschl gt Wenn aktiviert werden die gelesenen Dateien nach dem Lesen gel scht Aktivieren Sie diese Option um alle Dateien eines Verzeichnisses nacheinander zu bearbeiten Wenn zus tzlich die Option Fehler erzeugen wenn L schvorgang fehlschl gt aktiviert ist dann wird im Queue Manager ein Fehlereintrag f r den Workflow mit diesem Modul angez
126. steht f r den Zugriff auf eine Instanz des Interfacetyps javax resource cci Interaction bereit F r detaillierte Informationen ber die Struktur der Ein und Ausgangsnachrichten siehe Ein und Ausgangsnachrichten Struktur Workbench Process Engine Systemkonnektor Guide Kap S 177 Beispiel Eingangsnachricht Listing 1 lt xml version 1 0 encoding UTF 8 gt 2 lt jca gt 3 lt References gt 4 lt cf javax resource cci ConnectionFactory class from JCA Connector gt 5 lt ix javax resource cci Interaction class to execute JCA call on gt 6 lt object name iSpec gt 7 lt com dsoft jca eis EisInteractionSpec gt 8 lt a gt a lt a gt 9 lt functionName gt functionName lt functionName gt 10 lt schema gt schema lt schema gt 11 lt com dsoft jca eis EisInteractionSpec gt 12 lt object gt 13 lt setA object iSpec result gt 14 lt param type java lang String name gt 15 lt string gt a lt string gt 16 lt param gt Listing Abschnitt 1 von 2 05 09 2013 inubit 6 1 Workbench Process Engine Systemkonnektor Guide JCA Connector Dialog J2EE Connector Architecture Adapter Listing 17 lt setA gt 18 lt getRecordFactory object Scf result rf gt 19 lt createIndexedRecord object S rf result iRec gt 20 lt param type java lang String gt 21 lt java lang
127. und Beispiele Enth lt den Wert auf der rechten Seite eines Kriteriums in einer WHERE Bedingung Dabei kann es sich um einen Wert um einen Spaltennamen oder um den Namen eines Subselect handeln Attribute Pflichtfeld zul ssige Werte Erl uterung type Nein subselect force subselect Zum Ausf hren einer Subquery force Die automatische Typerkennung wird f r dieses Feld ausgeschaltet Der Text von lt rightValue gt wird direkt an die Daten bank Ubergegeben Ist z B sinnvoll um ein gebaute Datenbankfunktionen AVG oder MAX auszuf hren lt sortOrders gt nur f r SELECT Sortiert die Ausgaben nach einem Feld auf oder absteigend lt sort gt Feld das als Sortierkriterium verwendet wird Attribute Pflichtfeld zul ssige Werte Erl uterung order Nein ASC aufstei Sortierreihenfolge gend DESC abstei gend lt tail gt Der Wert des Elements wird an die erzeugte SQL Anfrage angehangt Damit konnen Datenbank spe zifische SQL Erweiterungen hinzugef gt werden Die folgende Abbildung zeigt ein SELECT als Baumstruktur CHR queries B query d i type select ELE tables E table G tablelames gt tablehame FGS fields El field fieldNeme 6 condtions E condition E type OR e letale e operston rightalue Fes sortCrders ELS anrt E order ASC p tail 05 09 2013 inubit 6 1 Workbench Process Engine Systemkonnektor Guide Database
128. und Mappings Workbench Benutzer Guide Kap 14 S 383 21 2 Dialogbeschreibungen Dieser Abschnitt erl utert die folgenden Themen Dialog Mail Connector Eigenschaften S 216 Dialog Datenweitergabe konfigurieren S 217 Dialog Mitteilungskonfiguration S 219 Dialog S MIME Entschl sselung S 220 Dialog Eigenschaften der Eingabedaten S 220 Dialog SMTP Connector Eigenschaften S 222 Dialog S MIME Verschl sselung S 224 21 2 1 Dialog Mail Connector Eigenschaften Input Connector In diesem Dialog legen Sie die Zugangsdaten zu dem Mailserver fest Grundeinstellungen m Protokoll Protokoll das der Konnektor verwenden soll Ihr Mailserver muss das gew hlte Protokoll unterst tzen 05 09 2013 POP3 bertragungsprotokoll f r E Mails erlaubt das Auflisten Abholen und L schen von E Mails auf dem Mailserver POP3S POP ber SSL TLS Die Verbindung zum Mailserver wird durch SSL verschl sselt inubit 6 1 Workbench Process Engine Systemkonnektor Guide Mail Connector 217 Dialogbeschreibungen IMAP Erweitertes Ubertragungsprotokoll f r E Mails Die E Mails verbleiben in der Regel auf dem Mailserver damit k nnen E Mails von verschiedenen Standorten aus zentral verwaltet werden IMAPS IMAP over SSL Die Verbindung zum IMAP Server wird beim Verbindungsaufbau durch SSL verschl sselt Servername Name oder IP Adresse des Mailserv
129. unterhalb des adressierten Objekts und Assoziationen zwischen diesen in einem Schritt anlegen 05 09 2013 inubit 6 1 Workbench Process Engine Systemkonnektor Guide Solution Center Connector 381 Beispiel Objektdaten aktualisieren Voraussetzungen Sie haben die Daten des zu ndernden Knotens z B mit einem Solution Center Connector ermittelt Siehe Beispiel Objektdaten abfragen Workbench Process Engine Systemkonnektor Guide Kap 35 6 S 377 Sie haben die Daten als XML Struktur gespeichert 35 7 1 Objektdaten ber die Knoten ID aktualisieren So gehen Sie vor 1 Erstellen Sie in einem Technical Workflow einen Solution Center Connector und benennen Sie diesen Wechseln Sie auf die Seite SC Connector Einstellungen W hlen Sie den Modus Objektdaten aktualisieren Klicken Sie am Ende des Feldes Knoten auf den Button Knoten ausw hlen Navigieren Sie in Ihrer Business Solution zu dem Knoten den Sie aktualisieren wollen Klicken Sie auf Fertigstellen Erstellen Sie eine neue Abbildungsregel f r das Variablen Mapping a W hlen Sie als Quelle Statischer Wert b ffnen Sie die gespeicherten Daten der Knotenabfrage des zu ndernden Knotens als XML Struktur c Bearbeiten Sie die zu ndernden Attribute d W hlen Sie als Ziel Eingangsnachricht und als Kodierung UTF 8 e Speichern Sie die nderungen mit OK Setzen Sie den Startpoint vor d
130. wird legen Sie fest ob die Dateien sortiert eingelesen werden sollen und wenn ja in welcher Reihenfolge Max Anzahl Dateien Maximale Anzahl von Dateien die eingelesen werden Der Standardwert ist 1 Max Gesamtgr e Kumulative Maximalgr e bis zu der Dateien pro Ausf hrung eingelesen werden Wenn aktiviert dann liest der VFS Connector solange Dateien ein bis kumulativ der gew hlte Maximalwert erreicht ist Wenn als Ausgangsformat DATA gew hlt wurde wird grunds tzlich nur eine Datei eingelesen und dies solange bis die angegebene Maximalgr e f r diese eine Datei erreicht ist Standardwert ist 10 MB Falls bei den Beschr nkungen Werte im Bereich kleiner oder gleich Null gew hlt werden dann gibt es keine Beschr nkung DATA Die Ausgangsnachricht enth lt Daten die unver ndert weitergegeben werden sollen XML Legt fest dass die Ausgangsnachricht im IBISDirectory XML Format weitergegeben wird Das XML Schema finden Sie im inubit Repository im Verzeichnis Global System Mapping Templates File Connector a ZIP inubit 6 1 Workbench Process Engine Systemkonnektor Guide XML Konfiguration ZIP Konfiguration VFS Connector 403 Dialogbeschreibungen Die Ausgangsnachricht wird in einer Zip Datei komprimiert Hinweis zur XML Zip Ausgabe Wenn Sie Wildcards im Verzeichnisnamen konfiguriert haben dann werden die gelesenen Dateien im XML bzw Zip als Baumstruktur ausgegeben
131. 011_09_13 2011 09 13 gt fpm PurchaseDate 2011 09 13 ud ntng ee abe Den O E O E EN TT E D Aen XPath mit Kontextknoten 05 09 2013 2 3 hr Erstellen Sie einen Solution Center Connector Konfigurieren Sie die allgemeinen Moduleigenschaften und die System Connector Eigenschaften des Solution Center Connectors Wechseln Sie auf das Register SC Connector Eigenschaften W hlen Sie den Modus Objekt erzeugen Geben Sie an unter welchem Knoten das neue Objekt angelegt werden soll Wahlen Sie die Option Referenz ber XPath a Aktivieren Sie die Option Kontextknoten verwenden b Klicken Sie auf das Icon am Ende der Zeile Kontextknoten ID c Navigieren Sie im Solution Center Explorer zu dem Vaterknoten unter dem der neue Knoten angelegt werden soll und best tigen Sie die Auswahl mit OK Der Kontextknoten Typ wird abh ngig vom gew hlten Kontextknoten automatisch gesetzt inubit 6 1 Workbench Process Engine Systemkonnektor Guide XPath ohne Kontextknoten Solution Center Connector 377 Beispiel Objektdaten abfragen Referenz ber XPath V Kontextknoten verwenden Kontextknoten ID f4639e62 63f8 44b5 9844 373103687cb Kontextknoten Typ fpm FleetManagementBO m XPath bfm3 initiator E Niege A Aen Ae ec ae met tel nn d Tragen Sie z B ofm3 Initiator in das Feld XPath ein Lu Die Bearbeitung einer Abfrage ohne Ko
132. 1 Voraussetzungen Adresse URL des Intermedi rs ist vorhanden ffentliches Schl ssel Zertifikat cry cer des Intermedi rs ist vorhanden Privates Signatur Zertifikat ist vorhanden Privates Schl ssel Zertifikat ist vorhanden Passw rter f r die privaten Zertifikate sind vorhanden Speichern Sie die Zertifikatsdateien in einem entsprechenden WY Verzeichnis Die Zertifikate f r die privaten Schl ssel sind pfx Dateien die f r die ffentlichen Schl ssel cer Dateien 26 2 Funktionsprinzip Sie k nnen einen OSCI Connector verwenden um OSCI Nachrichten die zwischen einem OSCI Client als Absender einer virtuellen Poststelle VPS als OSCI Intermedi r und einem Empf nger transportiert werden mit der inubit Software ber den Intermedi r zu empfangen oder ber ihn zu versenden Ale wertet is a ersch Nachricht e a c i Virtoeffe m a E Poststelle Se Intermedi r D Absender Empf nger Dateniibermittlung OSCI ist der eGovernment Standard f r die sichere Daten bermittlung Dabei werden die Daten in Form von OSCI Nachrichten versendet und empfangen Zertifikatsverwaltung Zum Verschl sseln und Signieren von OSCI Nachrichten werden Zertifikate benutzt die gleichzeitig zur Adressierung der Nachrichten verwendet werden 05 09 2013 inubit 6 1 Workbench Process Engine Systemkonnektor Guide OSCI Connector 283 Dialogbeschreibungen Kommunikationsablauf Die zu bermittelnden Daten werden in Form
133. 2 2 ccc cece cece eeeeeece eae cases eeeeeeeecedeaaaaeaecaeceeeeeeeeesesecaaaasaeaeeeeeeeseeseseeeniaeeees 367 34 4 Dialog SNMP Connector Eigenschaften AAA 368 35 Solution Center CGonnector c cccicicccsceecicccesseccdecesseeceie EES SEENEN NEESS NEESS NEEEEEERS NEES NEE ENEE 371 39 1 Funktionsprinzip 4 2 40a ee a na aa has EST ENEE 371 39 2 Moduleigenschaften u 2 hen nm 372 35 3 Objekt XML Daten erzeugen ann 373 35 4 Verwenden von XPath Anfragen nn ea nennen 373 35 4 1 Aggregationen ein und zweiseitig gerichtete Assoziationen nennen 374 39 9 Beispiel Objekt erzeugen ssiri eniin annii ahnen 375 inubit 6 1 Workbench Process Engine Systemkonnektor Guide 05 09 2013 11 12 Inhaltsverzeichnis 35 5 1 Objekt ber die Knoten ID erzeugen nn ann 375 35 5 2 Objekt Uber eine XPath Anfrage erzeugen nn 376 35 6 Beispiel Objektdaten abfragen 377 35 6 1 Objektdaten ber die Knoten ID abfragen ee eceeeeeeeceeeeeeeeeeeeeeeeeeseeeeeeeeeseeeeeeeeseeeeaaeeeeeeeaees 378 35 6 2 Objektdaten ber eine XPath Anfrage abfragen nn 378 35 7 Beispiel Objektdaten aktualisieren u22000nmnnnan0onnennnnnnonnennannnnnnnnnnnnnnnnnnnnnnnnnnnnnnnannnnnnnennnnnnn 380 35 7 1 Objektdaten Uber die Knoten ID aktualeieren nn 381 35 7 2 Objektdaten ber eine XPath Anfrage aktualisieren en 381 35 8 Beispiel Objekt l schen nee Eed EE 382 35 8 1 Objekt Uber die Knoten ID l schen cicecccceccceceesssccc
134. 2 doc DSML Schema unter http www oasis open org committees dsml docs DSMLv2 xsd vollst ndige Definition der Distinguished Names unter http www ietf org rfc rfc2253 txt LDAP Schema Viewer unter http Idap akbkhome com index php der eine praktische Schnittstelle f r die Untersuchung von Standard LDAP Schema Objekten ist In DSMLv2 werden alle nderungen an Attributen durch Anh ngen eines operation Attributs an ein attr Element spezifiziert Eine operation kann add delete oder replace sein Die folgende Anweisung aktualisiert die Telefonnummer des Mitarbeiters Bob Rush lt modifyRequest dn CN Bob Rush OU Dev DC Example DC COM gt lt modification name telephoneNumber operation replace gt lt value gt 536 354 2343 lt value gt lt value gt 234 212 4534 lt value gt lt modification gt lt modifyRequest gt inubit 6 1 Workbench Process Engine Systemkonnektor Guide 05 09 2013 202 LDAP Connector DSMLv2 Anweisungen in Requests 19 2 2 Search Beispiel Suchen und Ausgeben Beispiel Suchen und Ausgabe eingrenzen 05 09 2013 Die Anweisung searchRequest sucht nach Daten auf dem LDAP Server Es werden alle Personen mit dem Namen John gesucht die sich im Pfad ou Marketing dc inubit dc com befinden Dabe werden alle gefunden Objekte samt ihrer Attribute ausgegeben lt searchRequest dn ou Marketing dc inubit dc com scope singleLevel
135. 25 Provider dies fordert Weitere Informationen k nnen Sie der rrsEVO Dokumentation entnehmen Terminal Kennung Auch Terminal ID genannt Eindeutige Nummer Ihres ISDN Endger ts Verbindungs Timeout Zeit in Sekunden nach welcher der Versuch eine Verbindung aufzubauen abgebrochen wird X 25 Adresse 15 stellige X 25 DTE Adresse der Partnerstation Angabe ist optional Es wird jedoch empfohlen hier die ISDN Nummer einzutragen da manche Gegenstellen eine X 25 Adresse erwarten X 25 Paketgr e Gr e der Datenpakete bei der Daten bertragung Standard 128 inubit 6 1 Workbench Process Engine Systemkonnektor Guide 05 09 2013 264 OFTP2 Connector Dialog Stationen 24 6 2 3 Nachbarstation ber XOT 05 09 2013 X 25 Facilities Spezielle Informationen oder Anlagen bei X 25 Ubertragung X 25 Benutzerdaten Benutzerangaben fiir X 25 Ubertragung X 25 Fenstergr e Die Fenstergr e bei X 25 ISDN Kommunikation ist die Anzahl der Pakete die ohne Best tigung verschickt werden k nnen Die Fenstergr e kann w hrend des Verbindungsaufbaus ausgehandelt werden Wir empfehlen aber von vornherein die zum Partnernetzwerk passende Fenstergr e zu konfigurieren z B den Wert 7 f r ISDN X 25 DBit Das D Bit ist ein Feld im Datenpaket von X 25 das f r die Ende zu Ende Best tigung benutzt wird Die DTE zeigt damit an ob sie den Empfang einer Ende zu Ende Best tigung w nscht Standard deak
136. 5 09 2013 Connection Factory Lookup Name JNDI Name der JCA Adapter Connection Factory an z B java eis PropertiesFileAdapter Mit der Connection Factory legen Sie fest zu welchem Resource Adapter die Verbindung hergestellt werden soll Die Connection Factory wird vom Resource Adapter zur Verf gung gestellt und ber das JNDI dem JBoss bekannt gemacht Authentifizierung erforderlich Um festzulegen dass eine Authentifizierung gegen ber dem Resource Adapter erforderlich ist ConnectionSpec Klassenname Klassenname der ConnectionSpec Um die Authentifizierungsdaten an die Methode getConnection der ConnectionFactory zu bergeben Wenn die Angabe fehlt dann wird die Verbindung zum Resource Adapter ohne Parameter hergestellt und keine Authentifizierung vorgenommen Benutzername Benutzernamen f r den Resource Adapter Passwort Passwort f r den Resource Adapter Verbindung testen Zum Testen ob die Verbindung mit Ihren Angaben erfolgreich aufgebaut werden kann Nur Resultate Diese Option verbessert die bersichtlichkeit und Performance bei gro en XML Eingabenachrichten Wenn markiert dann enth lt die Ausgabenachricht nur das XML Element lt result gt Die Eingabenachricht wird nicht ausgegeben inubit 6 1 Workbench Process Engine Systemkonnektor Guide 187 Dieser Abschnitt erl utert die folgenden Themen a Zugriff auf JMS basierten Queuing Server konfigurieren S 188 Dialogbeschreibungen S 1
137. 6 3 4 TLS Empf nger konfigurieren 05 09 2013 Mit einem TLS Empf nger Transport Layer Security kommunizieren Sie verschl sselt IP Adresse IP Adresse des TLS Empf ngers Port Port ber den der TLS Empf nger erreichbar ist inubit 6 1 Workbench Process Engine Systemkonnektor Guide ze OpenOffice Connector 271 Verwendung Dieser Abschnitt erl utert die folgenden Themen Voraussetzung OpenOffice Installation S 271 Funktionsprinzip S 272 Beispiel Workflow erstellen S 272 Dokument in das PDF Format konvertieren S 275 Dokument bearbeiten S 276 Dokument drucken S 278 Dialog Grundeinstellungen S 279 Mit dem OpenOffice Connector k nnen Sie Microsoft Word OpenOffice Writer Dokumente automatisiert bearbeiten konvertieren auf entfernten Rechnern drucken Remote Printing Service und Dokumentvorlagen z B f r Visitenkarten oder Abrechnungen mit Office pflegen Microsoft Excel und OpenOffice Calc Dokumente k nnen Sie automatisiert in andere Formate konvertieren Siehe XML Schema als Vorlage f r Eingangsnachrichten Workbench Process Engine Systemkonnektor Guide Kap 25 S 272 Siehe auch Systemkonnektoren Workbench Process Engine Systemkonnektor Guide Kap 1 S 19 Module anlegen Workbench Benutzer Guide Kap 3 3 S 129 Technical Workflow Diagramme Workbench Benutzer Guide Kap 12 S 311 25 1 Voraussetzung OpenOffice Installation Eine OpenOffic
138. 90 Verwendung Der JMS Java Message Service Connector verbindet die inubit Process Engine mit einem JMS Provider Konnektortypen Abh ngig von seiner Konfiguration bietet der Konnektor folgende Funktionen Input Connector Holt zeitgesteuert Nachrichten von einem JMS Provider und bergibt sie an das nachfolgende Modul im Technical Workflow Input Listener Connector Wartet auf Nachrichten von einem JMS Provider Sobald diese eingetroffen sind startet der Connector den Technical Workflow indem er sie an das nachfolgende Modul bergibt Medium Connector Wird durch den Empfang einer Nachricht vom vorhergehenden Modul im Workflow gestartet holt Nachrichten von einem JMS Provider ab und bergibt diese an das nachfolgende Modul im Workflow Medium Listener Connector Wird durch den Empfang einer Nachricht vom vorhergehenden Modul im Workflow gestartet und wartet dann auf Nachrichten von einem JMS Provider Sobald eine Nachricht eintrifft wird diese an das nachfolgende Modul bergeben Output Connector Sendet Nachrichten aus dem Technical Workflow an einen JMS Provider Siehe auch Systemkonnektoren Workbench Process Engine Systemkonnektor Guide Kap 1 S 19 Module anlegen Workbench Benutzer Guide Kap 3 3 S 129 Technical Workflow Diagramme Workbench Benutzer Guide Kap 12 S 311 inubit 6 1 Workbench Process Engine Systemkonnektor Guide 05 09 2013 JMS Connector Zugriff auf JMS basier
139. Acknowledge die Eingangsnachricht Dies bedeutet dass die Bestatigung zu dieser Nachricht noch nicht empfangen wurde Splitter Modul Das Splitter Modul empf ngt eine Best tigung die vom Input Connector Workflow weitergeleitet wurde und gibt die Best tigung an einen Mail Connector und an den nachfolgenden Demultiplexer weiter Siehe Beispiel Workflow Nachrichten empfangen und Best tigung senden Workbench Process Engine Systemkonnektor Guide Kap 29 4 S 316 Multiplexer Der Multiplexer erh lt Nachrichten aus dem Demultiplexer WaitUntilAcknowledge DistributeRNOutput sowie Best tigungsnachrichten aus dem Splitter und wertet beide aus Dazu werden die Instanz ID und die PIP Nummer der beiden Nachrichteneingange verglichen Wenn diese identisch sind wird eine Nachricht an den Output Connector weitergeleitet mit der eine vorher inubit 6 1 Workbench Process Engine Systemkonnektor Guide 05 09 2013 316 RosettaNet HTTPS Connector Beispiel Workflow Nachrichten empfangen und Best tigung senden verschickte Business Message best tigt wird Damit muss diese Business Message nicht mehr im Output Connector vorgehalten werden Der Workflow Send RosettaNet Message ist damit beendet 29 4 Beispiel Workflow Nachrichten empfangen und Best tigung senden Nachrichteneingang 05 09 2013 Process_PIP443 RosettaNetxML RosettaNet_InputConnector DistributeMessage u xml xml Deliver
140. Als Basisverzeichnis dient dabei das letzte feste Verzeichnis Beispiele Der Verzeichnisname ist foo bar blub Es werden die Unterverzeichnisse ab foo bar abgebildet Der Verzeichnisname ist foo bar xyz blub Es wird das Verzeichnis xyz blub abgebildet Bei Ausgabeformat XML Inklusive Verzeichnisse Wenn markiert enthalt die Ausgangsnachricht neben den Dateien auch die Verzeichnisse Inklusive Dateiinhalt Wenn markiert dann wird die gesamte Datei gelesen und ihr Inhalt base64 kodiert der XML Ausgangsdatei mitgegeben Wenn nicht markiert dann werden nur die Metadaten der Datei gelesenen z B Name Dateigr e und Datum Bei Ausgabeformat ZIP Inklusive Verzeichnisse Wenn markiert enthalt die Ausgangsnachricht neben den Dateien auch die Verzeichnisse Kodierung Die Auswahl legt die Kodierung der Dateinamen innerhalb des Zip Archivs fest 38 2 3 Dialog Output Connector Konfiguration Eingangsformat In diesem Dialog legen Sie fest wie der Konnektor Daten ausgibt DATA Die Eingangsnachricht besteht aus Daten die unver ndert weitergegeben werden sollen Die ist z B der Fall wenn die Eingangsdaten als XML vorliegen XML Die Eingangsnachricht liegt im IBISDirectory XML Format vor Siehe Konfiguration des Ausgangsformates Workbench Process Engine Systemkonnektor Guide Kap 38 S 402 ZIP inubit 6 1 Workbench Process Engine Systemkonnektor Guide 05 09 2013 404
141. Anfrage des Service Consumers Der STS Provider pr ft die Anfrage des Consumers an Hand der mitgelieferten Merkmale Diese k nnen Nutzername Passwort sein oder das Zertifikat mit dem die Anfrage signiert ist Wenn die Pr fung positiv verl uft dann erzeugt der STS zwei Token F rdas erste Token gilt Esenth lt einen Session Key mit der Information ob sich der Consumer erfolgreich authentifiziert hat Das Token ist mit dem ffentlichen Schl ssel des Service Providers verschl sselt Damit ist sichergestellt dass niemand au er dem Service Provider den Session Key auslesen kann Das Token ist vom STS signiert um zu versichern dass der STS dieses Token ausgestellt hat F r das zweite Token das Pr f Token gilt Das Pr f Token enth lt ebenfalls den Session Key Dieser ist n tig damit der Consumer seinen Web Service Aufruf signieren kann Das Pr f Token ist mit dem ffentlichen Schl ssel des Consumers verschl sselt damit auch der Consumer in den Besitz des Session Keys gelangen kann Der STS sendet Token und Pr f Token an den Consumer 4 Service Consumer ruft Service Provider auf Der Consumer empf ngt die beiden Token und extrahiert den Session Key aus dem Pr f Token Er erstellt den Aufruf des Web Services und signiert den Aufruf mit dem Session Key Dann sendet der Consumer den Aufruf und das eigentliche Token des STS an den Service Provider 5 Service Provider pr ft die Signatur des Tokens
142. Benutzern ber ein UDDI Verzeichnis zug nglich machen Siehe Web Service in UDDI publizieren Workbench Process Engine Systemkonnektor Guide Kap 40 12 S 443 40 4 Web Service aufrufen berblick Das Beispiel zeigt die beiden wesentlichen Module f r einen Web Service Aufruf inubit 6 1 Workbench Process Engine Systemkonnektor Guide 05 09 2013 422 Web Services Connector Web Service aufrufen 05 09 2013 CresteRequest_SayHello Call_WebService XSLT Converter zum Erstellen der Web Service Anfrage m Web Services Medium oder Output Connector zum Senden der Anfrage und zum Empfangen des Ergebnisses wenn vorhanden Ein Medium Connector kann eingesetzt werden wenn der Web Service ein Ergebnis zur cksendet das im Workflow weiterverarbeitet werden soll Der Medium Connector sendet die Anfrage wartet auf das Ergebnis und bergibt es an das nachfolgende Modul im Workflow So kann das Ergebnis z B in eine Datenbank geschrieben oder f r Drittsysteme geeignet aufbereitet werden Der Einsatz eines Output Connectors ist sinnvoll wenn die Anfrage eine One Way Operation ohne R ckgabe aufruft und keine weiteren Prozessschritte n tig sind Technisch verh lt sich der Output Connector genauso wie der Medium Connector d h auch der Output Connector wartet auf das Ergebnis und h lt es vor So gehen Sie vor 1 Web Services Connector konfigurieren a Erzeugen Sie einen Web Services Output Connector Legen
143. Bereitgestellter Service berschrieben Lediglich der Service und Port Name bleibt erhalten 40 16 3 5 Register Erweitert Proxy Einstellungen Nur Medium und Output Connector inubit 6 1 Workbench Process Engine Systemkonnektor Guide 05 09 2013 458 Web Services Connector Dialogbeschreibungen Anhange Binardaten 05 09 2013 Proxy Einstellungen k nnen Sie nur definieren wenn Sie die Option Kompatibilit tsmodus mit Version 5 0 Einsatz des Axis2 Frameworks aktivieren Wenn der Kompatibilitatsmodus aktiviert ist werden folgende Bedienfelder angezeigt Globale Proxy Konfiguration berschreiben Wenn die Option nicht markiert ist wird der Proxy Server verwendet der f r die inubit Process Engine konfiguriert wurde Siehe Proxy Server zwischen inubit Process Engine und entfernten Rechnern konfigurieren Process Engine Administrator und Entwickler Guide Kap 5 3 2 S 67 Wenn die Option markiert ist werden die folgenden Bedienfelder aktiviert und Sie k nnen die globalen Proxy Einstellungen berschreiben Servername Port Adresse und Portnummer des Proxy Servers Dom ne Dom ne aus welcher der Zugriff ber den Proxy Server erfolgen soll Ausnahmen Proxy Einstellungen gelten nicht f r die hier aufgef hrten Systeme Authentifizierung erforderlich Ist aktiviert wenn der Proxy Server eine Authentifizierung fordert Benutzername Benutzername f r den Proxy Server Passwort
144. Bereitgestellter Service S 454 Register Aufzurufender Service S 455 Register XML Schemas S 457 Register WSDL Editor S 457 Register Erweitert S 457 Register SOAP Nachrichten S 463 Der Web Service Editor wird nach dem Anlegen eines Web Services Connectors im Modul Editor angezeigt wenn Sie die Option WSDL Definition am Modul speichern gew hlt haben inubit 6 1 Workbench Process Engine Systemkonnektor Guide 05 09 2013 454 Web Services Connector Dialogbeschreibungen 40 16 3 1 Register Bereitgestellter Service 05 09 2013 WSDL Bindung Input Listener Connector In diesem Register erstellen Sie die Operationen die Ihr Web Service anbieten soll Aus den Angaben werden automatisch eine WSDL Datei als Schnittstellenbeschreibung Ihres Web Services sowie Ein und Ausgangsnachrichten erzeugt Service Name Entspricht dem Namen des Connectors und kann manuell ge ndert werden Port Name Entspricht dem Namen des Connectors mit dem Suffix Port und kann manuell ge ndert werden Der Port definiert den Verbindungspunkt zu einem Web Service vergleichbar dem Aufruf eines Moduls oder einer Klasse in einer traditionellen Programmiersprache Adresse Adresse unter welcher der Web Service angeboten wird Ein Klick auf den Button ffnet folgendes Men Adresse kopieren Kopiert die Adresse des Web Services in die Zwischenablage Adresse der WSDL kopieren Kopiert
145. Bereitstellung dieses Dokuments erteilt keinerlei Lizenzrechte an diesen Patenten Marken Urheberrechten oder anderem geistigen Eigentum aus genommen dies wurde explizit durch einen schriftlich festgelegten Lizenzvertrag mit der Bosch Software Innovations GmbH vereinbart Die von der Bosch Software Innovations GmbH angebotene Software kann Software komponenten anderer Hersteller enthalten inubit ist eine eingetragene Marke der Bosch Software Innovations GmbH Alle sonstigen in diesem Dokument aufgef hrten Produkt und Firmennamen sind m glicherweise eingetragene Marken der jeweiligen Inhaber Inhaltsverzeichnis Inhaltsverzeichnis Hinweise zum Systemkonnektor Guide uuus4r240nnnnennnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnsnnnnnnnnnsnnnnnnnnnnnnennnnnnnnenenn 15 Umfang der Dokumentaton rn 15 Tipps Hinweise und Links in der Dokumentatton nn nnen nn 17 Weitere Informationen und Support 17 1 Systemkonnektoren 2524 44 EES Ebern EENS CERS EEN 19 1 1 Dialogbeschreib ngen es ee ae EEdEeeER ES EE 19 1 1 1 Dialog Allgemeine Moduleigenschaften AA 19 1 1 2 Dialog System Connector Eigenschaften A 20 1 1 3 Dialog Zeitgesteuerte Verarbeitung urss4440nnnsnnnnnnnennnnnnennennnnnnnnnnennnnnnnnennnnnnnnnnnnnnn nn 22 1 14 TE e eet e EE 24 1 1 5 Dialog Remote Connector Konfiguration urss44snnnnennnnnnnnennnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnne nn 25 2 ASIA00 ele 27 2 1 Be
146. Connector best tigen kann dass die Nachricht auf der inubit Process Engine vorliegt Synchrone bertragung mit Input Listener Connector Die Empfangsbest tigung wird verschickt wenn sie vollst ndig auf der inubit Process Engine eingetroffen ist In der Konfiguration der Nachbarstation muss der Parameter EERP_out auf HOLD gesetzt werden Siehe Parameter EERP_out im Abschnitt Nachbarstationen Workbench Process Engine Systemkonnektor Guide Kap 24 6 2 S 260 Der Job Nachrichtenempfang bleibt aktiv bis die Empfangsbest tigung EERP_out gesendet wurde Synchrone bertragung mit Output Connector Setzen Sie beim Konfigurieren des Konnektors ein Timeout damit im Fehlerfall keine Blockade durch das Warten entsteht Ber cksichtigen Sie bei dem Wert die Nachrichtengr e und den bertragungsweg Kontrollieren Sie die Konfiguration der Gegenstelle wenn dort die EERP Nachricht auf hold steht kann es auch zu einer Blockade kommen Send Job bei erfolgreichem fehlgeschlagenem Senden rvs_is_ send Mit dem Kommandozeilentool StartCLI k nnen Sie u a die Verbindung der inubit Process Engine mit dem rvsEVO Server pr fen inubit 6 1 Workbench Process Engine Systemkonnektor Guide OFTP2 Connector 255 Dialog OFTP Datenaustausch Konfiguration Optionen Option Information Sir SEE Verbindung der inubit Process Engine mit dem rvsEVO Server pr fen rhost rvsEVO Host rlogin rvsEVO Log
147. Dateien aus dem angegebenen Verzeichnis bertragen Mit regul rem Ausdruck Wenn markiert dann k nnen Sie mit Hilfe eines regul ren Ausdrucks ein Muster angeben dem die Dateinamen der einzulesenden Dateien entsprechen m ssen Regul re Ausdr cke m ssen in Schr gstriche eingeschlossen LA werden Z B d d A A d d d q Si F r Informationen ber regul re Ausdr cke siehe z B http www perl com doc manual html pod perlre html oder http www reqular expressions info tutorial html Name Dateiname Kann eine Wildcard oder einen regularen Ausdruck enthalten Verwende Wildcard Inhalt des vorher ausgef hrten File oder FTP Connectors Diese Option ist nur aktiv wenn Sie die Checkbox Mit optionaler Wildcard markieren Wenn Sie diese Option anklicken dann wird der Wildcard Inhalt verwendet der von einem vorher ausgef hrten File oder FTP Connector erzeugt wurde z B Ein vorher ausgef hrter File Connector wurde so konfiguriert dass im Feld Dateiname eine Datei Test vml angegeben wurde Als Ausgangsnachricht hat der File Connector eine Datei mit Namen Test5 xml weitergeleitet Der Wildcard Inhalt ist in diesem Fall das Zeichen 5 Wenn Sie im aktuellen Connector ebenfalls eine Wildcard angeben z B Ausgabe xml dann wird die Wildcard durch 5 ersetzt und die Ausgabe des aktuellen Connectors ist Ausgabe5 xml Dateien nach dem Lesen l schen inubit 6 1 Wor
148. Dialog Output Dateinamen definieren S 141 11 2 1 Dialog FTP Connector Eigenschaften Grundkonfiguration 05 09 2013 In diesem Dialog werden die Zugangsdaten zum FTP Server abgefragt Abh ngig vom ausgew hlten Protokoll werden andere Bedienelemente angezeigt Protokoll W hlen Sie eines der Protokolle aus FTP File Transfer Protocol Zwischen zwei Rechnern die ber TCP IP verbunden sind wird eine Verbindung ber zwei Ports aufgebaut Ein Port wird zur Steuerung der Kommunikation genutzt also zum Austausch der Befehle ber den anderen Port werden die Daten unverschl sselt bertragen Diese bertragung ist nicht sicher inubit 6 1 Workbench Process Engine Systemkonnektor Guide FTP Connector 135 Dialogbeschreibungen FTPS FTP ber SSL Erweiterung von FTP Der Steuerport ist ber SSL gesichert Datenaustausch ist standardm ig unverschl sselt Bei dem FTP Connector k nnen Sie auch den Datenaustausch ber SSL sichern SFTP SSH FTP Erm glicht neben dem verschl sselten Datenaustausch auch eine Authentifizierung von Benutzern und Servern SFTP l sst sich einfacher durch NAT Gateways hindurch verwenden als FTPS Servername Domainname des FTP Servers z B ftp example com Port FTP und FTPS Standardm ig Port 21 SFTP Standardm ig Port 22 Falls der Verbindungstest fehlschl gt fragen Sie Ihren Administrator ber welchen Port der FTP Server erre
149. Dialogbeschreibungen 24 u a ale SEENEN 317 29 5 1 Dialog RosettaNet Connector Eigenschaften 318 29 5 1 1 Register Allgemein 4 He ea dere 319 29 3 1 2 Register Nof u nn ae ea nenne 321 29 5 1 3 Register Neuer PIP eanas aaa 321 29 5 2 Dialog Asynchrone Empfangsbest tigung 2444444ssnnnnnnnennnnnnnnnnnnnnnnnnnnennnnnnn nennen 323 29 5 3 Dialog S MIME Konfiguration nn ann 324 29 5 4 Dialog Verbindungsdaten f r Gesch ttenachrichten A 324 29 5 5 Dialog EmpfangsbestatigUngen rn 325 29 5 6 Dialog S MIME Konfiguration ann 326 05 09 2013 inubit 6 1 Workbench Process Engine Systemkonnektor Guide Inhaltsverzeichnis 29 5 7 Dialog Verbindungsdaten f r Empfangsbest tgungen nennen 326 29 5 8 Dialog RosettaNet Verbndungsdaten A 327 30 SAP COnNECtOF erone runoni Eiaa aan aaa an een ed 329 30 1 SAP Java Connector JCo installieren us444444nnnnnnsnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnn 330 30 2 Funktionsprinzip 444444444snnenennnnnnnnennnnnnnnnnnnnnnnnnnnnnnennnennennnnnannnnnnnrnnennnennennnnennennnn nennen EENES 331 30 3 XML Request Response erstellen cccceceeeeeeceeceeeeeeeeeeeseeeecaaaeaecaeeeeeeeeeeeeeseccceaeaeeeeeeeeeeeseseeninaeeaes 332 30 4 Dialog SAP Connector Eigenschaften un2snnaunennnnnannnnnnnnnannnnnnnnnnnnnnnnnnnennnnnnnnnnnnnnnannnn nn 337 31 Secrypt Connector
150. Felder Datenbank URL und Datenbanktreiber Klasse sinnvoll zu belegen Bei Auswahl von IS Log Database verbindet sich der Database Connector mit der inubit Logging Monitoring Datenbank F r die Verbindung wird die Konfiguration der inubit Process Engine verwendet deswegen werden alle anderen Felder in diesem Bereich deaktiviert 05 09 2013 inubit 6 1 Workbench Process Engine Systemkonnektor Guide Database Object Connector 105 Dialogbeschreibungen Falls Ihre Datenbank nicht vorhanden ist w hlen Sie die Voreinstellung Custom und f llen Sie die Felder manuell aus Unter Windows k nnen Sie auf die JOBC ODBC Bridge ausweichen W hlen Sie die JDBC ODBC Bridge nur wenn Sie keinen JDBC A Zugriff auf Ihrer Datenbank einrichten k nnen Eine JOBC ODBC Bridge hat eine schlechtere Performance der Funktionsumfang kann eingeschr nkt sein und die automatische Typerkennung ist deutlich langsamer Datenbank URL Wird vorbelegt wenn Sie eine vorkonfigurierte Datenbank gew hlt haben Geben Sie den Host den Port und den Datenbanknamen an Datenbanktreiber Klasse Entspricht der JDBC Verbindung der eingesetzten Datenbank Um eine andere Datenbank zu verwenden m ssen Sie einen passenden Treiber installieren Siehe Treiber installieren Process Engine Administrator und Entwickler Guide Kap 3 4 S 57 e Nach Installation eines JDBC Treiber f r den MS SQL Server Q m ssen Sie die inu
151. Header Konfiguration Workbench Process Engine Systemkonnektor Guide Kap 12 S 149 Output und Medium Connector HTTP Post Konfiguration Workbench Process Engine Systemkonnektor Guide Kap 12 S 151 inubit 6 1 Workbench Process Engine Systemkonnektor Guide 05 09 2013 148 HTTP Connector Header setzen und anzeigen Header anzeigen Header dynamisch setzen und berschreiben 05 09 2013 Alle Request und Response Header stehen nach der Workflow Ausf hrung als Modulvariablen zur Verf gung Request Header k nnen Sie z B am Watchpoint vor einem HTTP Input Listener Connector anzeigen mzz AS305ZFderinItions 3Esparz abcsparl 23 TestHttpListener Al Typ ndefiniert 293 efiniert text xml g localhost httpheader request content length httpheader request content type ur httpheader request host httpheader request soapaction ee ee Response Header k nnen Sie z B am Watchpoint nach einem HTTP Output Connector anzeigen httpheader response Connection undefiniert close httpheader response Content Length undefiniert 0 httphead bey 19 Nov 2009 12 39 undefiniert A f Apache phesdern response Server undefifert 1SCurrentTime xsistring 1258634157499 ISGlobalProcessId xsistring 104 I5ModuleId xsistring 19722025 u Sox oh A PRD a mn N a Dita u On nme mann ht Aa Sie k nnen mit Hilfe des Variablen M
152. L alle Zeichen Voraussetzung ist allerdings das ein RE besteht Dieser wird dann ausgef hrt RE steht f r Residenter Empfangseintrag Ein residenter Empfangseintrag wird f r eine Datei mit einem bestimmten Namen angelegt Trifft eine Datei mit diesem Namen ein so bestimmt der RE welche Aktion danach gestartet werden soll beispielsweise Datei ersetzen Datei l schen oder wie hier gefordert Code konvertieren F r Residente Empfangseintr ge gibt es in der OFTP Middleware eine eigene GUI zu deren Definition OFTPUNIX Alle Gro buchstaben Ziffern und die Sonderzeichen Punkt Minus UNIX alle Buchstaben Ziffern und die Sonderzeichen Eingangsbest tigung EERP_in EERP End to End Response bedeutet Empfangsbest tigung Die EERP_in wird vom Gesch ftspartner gesendet Die Combobox bietet die Eintr ge NEVER und NORMAL NEVER bedeutet dass der Gesch ftspartner keine Eingangsbest tigung sendet Die bertragung wird mit der korrekten bermittlung der Nachricht beendet NORMAL bedeutet dass eine Eingangsbest tigung erwartet wird Der Eingang der Best tigung geh rt zur Sendeaufforderung Eine Sendeaufforderung besteht so lange wie entweder noch Dateien zur bertragung anstehen oder auf den Eingang von Eingangsbest tigungen gewartet wird Mit dem Eingang der Best tigung wird auch die Sendeaufforderung beendet Die Auswahl NORMAL ist der Standard Ausgangsbest tigung EERP_out Eine Empfa
153. LETE Ressource l schen Siehe HTTP Methoden verwenden Workbench Process Engine Systemkonnektor Guide Kap 27 3 S 292 Aufbereitung empfangener Daten Legen Sie die Kodierung f r Daten fest die als Request im Format multipart form data eingehen 27 8 2 Dialog Konfiguration der Antwort Input Listener Connector 05 09 2013 inubit 6 1 Workbench Process Engine Systemkonnektor Guide Einstellungen f r GET Anfragen Einstellungen f r POST und PUT Anfragen REST Connector 301 Dialogbeschreibungen In diesem Dialog legen Sie die Einstellungen f r die zuvor ausgew hlten und von Ihrem Konnektor unterst tzten HTTP Methoden fest die f r eine Antwort genutzt werden Legen Sie hier fest wie die Repr sentation der Antwort Daten bei GET Requests aussehen soll Die Standard Einstellungen sind bereits sinnvoll gew hlt und k nnen belassen werden Medien Typ W hlen Sie den gew nschten Medien Typ aus Informationen zu MIME Typen finden Sie unter http de wikipedia org wiki Internet Media_Type und _http de selfhtml org diverses mimetypen htm Zeichensatz W hlen Sie den Zeichensatz der Antwort Daten aus Workflow asynchron starten Aktivieren Sie diese Option wenn der Input Listener nach dem Empfang des Request die HTTP Statusmeldung direkt an den Client zur ckliefern soll In diesem Fall wird die Antwort vor dem Start des Workflows geschickt Das Ergebnis des Workflows wird nicht z
154. Lokale Station Workbench Process Engine Systemkonnektor Guide Kap 24 S 259 inubit 6 1 Workbench Process Engine Systemkonnektor Guide 05 09 2013 266 OFTP2 Connector Dialog Stationen 24 6 2 5 Routed Station 24 6 2 6 Verbindung aktivieren 05 09 2013 Nachbarstationen Workbench Process Engine Systemkonnektor Guide Kap 24 S 260 Wenn Sie eine Nachbarstation markieren k nnen Sie aus dem Kontextmen die Option Routed Station hinzuf gen ausw hlen Nachrichten an eine und von einer Routed Station werden von der Nachbarstation weitergeleitet unter der sie angeordnet sind Die konkrete Adresse einer Routed Station ist f r Gesch ftspartner transparent Wenn Sie eine Routed Station anlegen zeigt der Dialog auf der rechten Seite die folgenden Parameter RvsNeighbourSid Der Name wird mit dem Namen der Nachbarstation vorbelegt unter der die Routed Station angelegt wurde Name Telefon Bemerkungen Diese Angaben sind optional Hier k nnen beispielsweise die Daten eines Sachbearbeiters hinterlegt werden Odette ID Eindeutige Zeichenkette mit max 25 Zeichen Das erste Zeichen ist immer ein O Eingangsbest tigung EERP_in End to End Response Empfangsbest tigung Die EERP_in wird vom Gesch ftspartner gesendet Die Combobox bietet die Eintr ge NEVER und NORMAL Ausgangsbest tigung EERP_out Eine Empfangsbest tigung wird von der lokalen Station an den Gesch ftspartner g
155. MLQuery Um ein SELECT DISTINCT zu formulieren haben Sie zwei M glichkeiten 1 DISTINCT beim Spaltennamen angeben lt queries gt lt query type select gt lt tables gt lt table gt lt tableNames gt lt tableName gt Mitarbeiter lt tableName gt lt tableNames gt lt fields gt lt field gt lt fieldName gt DISTINCT Abteilung lt fieldName gt lt field gt lt fields gt lt table gt lt tables gt lt query gt lt queries gt 2 Mit dem Attribut properties force die Abfrage direkt bergeben lt queries gt lt query type select properties force gt lt value gt SELECT DISTINCT Abteilung FROM Mitarbeiter lt value gt lt query gt lt queries gt 05 09 2013 inubit 6 1 Workbench Process Engine Systemkonnektor Guide Database Connector 71 XML Querys Struktur und Beispiele 6 4 4 Daten aus verschiedenen Tabellen Join Ein Join ist eine Abfrage die Datens tze aus zwei oder mehr verschiedenen Tabellenspalten zueinander in Beziehung setzt z B SOL SELECT FROM Gartenmoebel Kategorien WHERE Gartenmoebel KategorieNr Kategorien Kategorienummer XMLQuery lt xml version 1 0 encoding 1S0 8859 1 gt lt queries gt lt query type select gt lt tables gt lt table gt lt tableNames gt lt tableName gt Gartenmoebel lt tableName gt lt tableName gt Kategorien lt tableName gt lt tableNames gt lt fields gt
156. Medium Output Connector Aktivieren Sie im Bereich Anh nge Bin rdaten die Option Bin rdaten aus Antwort Nachricht extrahieren und als Variablen Inhalte setzen Die eingehende SOAP Nachricht wird nach Elementen mit dem Attribut xmime contentType durchsucht und deren Inhalt wird in folgende Variablen geschrieben WSAttachmentName index Name des Nachrichten Elements WSAttachment index Typ xs base64Binary Daten des Nachrichten Elements SAttachmentContent Type index Inhalts Typ der Daten SAttachmentNumber Gesamtzahl der gefunden Inhalte Wenn die Option Anh nge im Dateisystem speichern aktiviert ist dann wird die Variable WSAttachmentFileName index anstelle von WSAttachment index gesetzt Inhalt von WSAttachmentFileName index ist der Name der Datei mit den Daten Um die in den Variablen ausgelesenen Daten an das n chste Modul zu bergeben m ssen Sie ein Mapping durchf hren welches die entsprechenden Variablen auf die Eingangsnachricht abbildet inubit 6 1 Workbench Process Engine Systemkonnektor Guide Web Services Connector 451 Dialogbeschreibungen 40 16 Dialogbeschreibungen Dieser Abschnitt erl utert die folgenden Themen Dialog Bereitgestellter Web Service S 451 Dialog Aufzurufender Web Service S 453 Web Service Editor und Register S 453 Dialog Web Service Einstellungen S 463 Dialog UDDI
157. Option Eingangsnachricht ignorieren b F gen Sie den XSLT Converter in den Technical Workflow ein c ffnen Sie den XSLT Converter zum Bearbeiten d ffnen Sie im Bereich XML Zieldatei das A Men und w hlen Sie ffnen von gt Web Services Explorer Der folgende Dialog ffnet sich 1H Web Services Explorer x Web Services Connector Modulauswahl Wahlen Sie das Web Services Connector Modul aus dessen WSDL als Vorlage in den XSLT Converter geladen werden soll WSDL bernehmen von Modul ProvideWebService v Service ProvideWebService v Port ProvideWebServicePort e Operation SayHello Request Generator Optionen XML Schema XML Instanz Erzeuge optionale Elemente Kommentar zum Elementtyp hinzuf gen Anmerkungen hinzuf gen Erzeuge Beispiele f r Elementwerte e W hlen Sie den Web Services Connector aus und die aufzurufende Operation in Zusammenhang mit Request Klicken Sie auf Fertig stellen um den Dialog zu schlie en Die Struktur des SOAP Requests die der Web Service erwartet wird angezeigt f Ziehen Sie das Root Element der erzeugten SOAP Nachricht per Drag n Drop nach oben auf das xs1 template Element g Passen Sie die Werte im Bereich XML Quelle an z B inubit 6 1 Workbench Process Engine Systemkonnektor Guide 05 09 2013 424 Web Services Connector Web Service aufrufen Eigenschaf
158. Option um die ber die Variablen WSAttachmentFileName referenzierten Dateien nach der Antwortgenerierung zu l schen nur Input Listener Connector Authentifizierung erforderlich Zu aktivieren wenn der Service nur ber eine HTTP Basic Authentifizierung zug nglich sein soll Benutzername Benutzername Passwort Passwort Bei Fehler eine Antwort mit Status 500 Interner Server Fehler senden anstelle von Status 401 Bei aktivierter Option verh lt sich der Connector wie in fr heren iS Versionen und liefert einen HTTP Status 500 bei fehlgeschlagener Authentifizierung Im Client muss in diesem Fall eine pr emptive Authentifizierung eingestellt sein das hei t mit der Anfrage m ssen die Authentifizierungsdaten mitgeschickt werden anstatt auf eine HTTP Status 401 Antwort zu warten WS Security Zur sicheren bertragung von Web Service Nachrichten Setzt die Authentifizierung am Service ber Zertifikate voraus Die Authentifizierung des Service Konsumenten ist optional Input Listener Connector Markieren Sie die Option um WS Security zu aktivieren Zum Importieren der Zertifikate klicken Sie auf den Button Einstellungen Siehe Dialog WS Security Konfiguration Workbench Process Engine Systemkonnektor Guide Kap 40 16 7 S 468 Medium Output Connector Sie erhalten beim Import der WSDL eine Meldung falls der aufzurufende Web Service WS Security verwendet Klicken Sie auf den Butt
159. P Adresse des Routers an ber den die Nachrichten geleitet werden sollen Aktiv Wird die OFTP Middleware gestartet ist der Empf nger mit dieser Option nach dem Start sofort empfangsbereit 23 6 2 2 ISDN Empf nger konfigurieren ISDN Adresse Hier sind die letzten drei Zahlen der ISDN Adresse gem Richtlinie E 164 der ITU T gemeint die als Filter benutzt werden Damit k nnen Sie die Endger te anhand ihrer letzten drei Ziffern unterscheiden IP Adresse Geben Sie die IP Adresse oder den Rechnernamen Ihres ISDN Routers an Typ blicherweise RCAPI1 Remote Common ISDN Application Programming Interface Die Zahl steht f r die Nummer des Router Controllers hier die 1 Protokoll Geben Sie hier EDSS1 an dies steht f r das Signalisierungsprotokoll Euro Digital Subscriber Signaling System No 1 Paketgr e Hier wird blicherweise die Paketgr e 128 angegeben Facilities Meist nicht angegeben Benutzerdaten Meist nicht angegeben Wenn Sie Facilities und Benutzerdaten angeben m chten dann als HEX Code Die Daten werden nur f r X 25 ber ISDN bertragungen ben tigt wenn Ihr X 25 Provider dies fordert Terminal Kennung Auch Terminal ID Eindeutige Nummer Ihres ISDN Endger ts Timeout Zeit in Sekunden nach welcher der Versuch eine Verbindung aufzubauen abgebrochen wird RCV Timeout RCV steht f r receive Zeit in Sekunden f r die Aufrechterhaltung des Empfang 0 bedeute
160. Process Engine Systemkonnektor Guide 05 09 2013 290 REST Connector REST Funktionsprinzip Ressourcen Beispiele f r Ressourcen 05 09 2013 GET list all orders PUT unused POST add a new order DELETE unused GET get order details PUT update order POST add item DELETE cancel order interface GET list all customers PUT unused POST add new customer DELETE unused GET get customer details PUT update customer POST unused DELETE delete customer customers id orders GET get all orders for customer PUT unused POST add order DELETE cancel all customer orders Fur das Beispiel eines Online Shops als REST Service gibt es bei der Auftragsverwaltung z B eine URL fur die Menge der Bestellungen jedes Kunden und eine URL f r jede Bestellung Die Kommunikation erfolgt nur bei Bedarf auf Abruf Der Client bzw Konnektor wird aktiv und fordert vom Server eine Repr sentation einer Ressource an bzw modifiziert eine Ressource Im Beispiel des Online Shops stellt dieser eine Ansammlung von Ressourcen dar an die per HTTP Nachrichten gesendet werden k nnen z B zum Aufruf eines Kunden zu einer Bestellung in einem Warenkorb Die Ressource wird dabei nicht direkt manipuliert denn der Zugriff erfolgt indirekt ber die der Ressource zugeordnete URL Online Shop als Web Service http localhost 8000 ibis rest sqlshop Auflistung aller Auftrage http localhos
161. Remote Control Server l uft nicht oder die angegebene Server Port Adresse ist falsch Pr fen Sie die Verf gbarkeit des Selenium RC Servers indem Sie im Dialog auf den Verbindungstest Button klicken Der Server l uft wenn Sie als R ckgabe Verbindungstest war erfolgreich erhalten und auf dem Rechner auf dem der RC Server installiert ist eine Firefox Ins tanz ge ffnet wird Si Zum Problem der Basis URL und des Cross site Scriptings siehe http en wikipedia org wiki Same_origin_policy und http en wikipedia org wiki Cross site_scripting inubit 6 1 Workbench Process Engine Systemkonnektor Guide Selenium Connector 361 Dialog Selenium Connector Eigenschaften 33 3 Dialog Selenium Connector Eigenschaften Selenium Remote Control Server Lu Verbindungstest In diesem Dialog geben Sie die Zugangsdaten f r den Selenium Remote Control Server an und konfigurieren Einstellungen f r die Verbindung mit dem Server Server Adresse des angesprochenen Selenium Remote Control Servers Port Der Selenium Remote Control Server verwendet Port 4444 Browser Zu startender Browser inkl F r eine bersicht ber die von Selenium unterst tzten Browser siehe http seleniumhq org about platforms html browsers Timeout ms Ausf hrungszeit in Millisekunden Nach Ablauf der angegebenen Zeitdauer wird der Test abgebrochen Standardwert 30 000 ms Falls hier kein Wert eingegeben ist f llt de
162. Rollen aus LDAP inubit 6 1 Workbench Process Engine Systemkonnektor Guide 05 09 2013 16 Weitere Informationen Lu 05 09 2013 inubit Solution Center 3 0 Benutzer Guide Informationen wie Sie Fachmodelle anlegen mit Business Solutions arbeiten Ansichten erstellen Prozesse und Standardmodelle einbinden sowie eine Dokumentation der REST Schnittstelle Administrator Guide Erlautert wie Sie Daten sichern und wiederherstellen das inubit Solution Center Server als Dienst installieren Ports anpassen das Portal die Datenbank und HTTPS konfigurieren Benutzer verwalten und Diagramme importieren inubit WebModeler 3 0 Administrator und Benutzer Guide Alles uber das Anlegen und Bearbeiten von Modellen Anpassen der Ports Konfigurieren der Datenbank und von HTTPS Die aktuelle Dokumentation steht im inubit User Portal im Register Software unter der Adresse https www inubit user com zum Download bereit Die folgenden Informationen liegen als Booklet der DVD bei bzw sind als Dateien im Installationspaket enthalten readme txt Hinweise zur Installation und Migration Lesen Sie diese Datei grunds tzlich vor der Softwareinstallation oder Aktualisierung Quick Start Systemvoraussetzungen und Installationsanleitung als Booklet der Produkt DVD API Dokumentation des Plug in Software Development Kits Im Verzeichnis lt i S installdir gt documentation apidoc index html JavaScript Framework Im Ve
163. Service Konsumenten erhalten hat dann beendet der Service die bertragungssequenz wegen Inaktivit t Dasselbe gilt f r Service Konsumenten diese beenden die bertragung ebenfalls wenn der Service nach Ablauf der angegebenen Zeit keine Nachricht gesendet hat 40 16 10 Dialog Namensr ume bearbeiten Input Connector In diesem Dialog haben Sie folgende Optionen Ziel Namensraum Der Ziel Namensraum umfasst alle Namensr ume der WSDL Beachten Sie beim ndern des Ziel Namensraums dass Sie auch A bereits erzeugte SOAP Nachrichten und Inhalte von Nachrichten Variablen anpassen mussen Deklarierte Namensraume Liste aller verwendeten Namensr ume Zum Hinzuf gen Bearbeiten und L schen von Namensr umen inubit 6 1 Workbench Process Engine Systemkonnektor Guide 05 09 2013 472 Web Services Connector Dialogbeschreibungen 05 09 2013 inubit 6 1 Workbench Process Engine Systemkonnektor Guide 41 WebDAV Connector Verwendung 473 Dieser Abschnitt erl utert die folgenden Themen m Dialog WebDAV Connector S 474 Mit dem WebDAV Connector binden Sie die inubit Process Engine an WebDAV f hige Systeme an WebDAV Web based Distributed Authoring and Versioning ist eine Erweiterung des HTTP Protokolls die es erm glicht mit mehreren Clients parallel Ressourcen und Collections auf WebDAV Servern zu verwalten und zu bearbeiten m Ressource Ressourcen sind die auf dem WebDAV Server verwalteten
164. Sie bei der Auswahl des Nachrichtentyps f r den das Template erstellt wird Geben Sie den Namen des IDocs oder Teile davon ein Sie k nnen den Asterisk als Wildcard verwenden Klicken Sie auf Suchen um eine Liste mit passenden IDocs angezeigt zu bekommen Wenn Ihre Suche ein Ergebnis geliefert hat markieren Sie in der Tabelle das IDoc welches Sie benutzen m chten Legen Sie dann fest welche Art von XML Template erzeugt werden soll Single IDoc oder Multi IDoc Klicken Sie auf Fertigstellen Der Dialog schlie t sich und das Template wird im Bereich XML Ziel angezeigt Fahren Sie fort mit Schritt 8 7 Bei Auswahl BAPI ffnet sich der folgende Dialog inubit 6 1 Workbench Process Engine Systemkonnektor Guide 05 09 2013 336 SAP Connector XML Request Response erstellen iS SAP Explorer x XML Template Generierung Bitte w hlen Sie die Parameter aus die Sie zum Erstellung des XML Templates bernehmen m chten Auswahl der bernahmeparameter Funktion Parameter Typ Lange cm Defaut Beschreibung IV SAPREQUEST B V BAPI_BANK_SAYEREPLICA IV BANK_CTRY CHAR 3 M L nderschl ssel der IV BANK_KEY CHAR 15 M Bankschl ssel IV BANK_ADDRESS STRUCTURE M Adressdaten der Bank 2 kg BANK DETAIL STRUCTURE M Detaildaten Bank 4 CREAT_DATE DATE 8 M V CREATOR CHAR 12 M J METHOD CHAR 4 M J FORMATTING CHAR 3 M IV BANK_DELETE CHAR 1 M Attribute in das XML Template bernehmen
165. Sie den Vaterknoten an unter dem Sie einen neuen Knoten erstellen wollen Geben Sie im Feld leeres Objekt vom Typ den Typ des neuen Objekts an oder w hlen Sie diesen ber den Button XML Element ausw hlen Der Typ des angegebenen Vaterknotens muss es unterst tzen dass Kindknoten des angegebenen Typs unterhalb des Vaterknotens angelegt werden d rfen inubit 6 1 Workbench Process Engine Systemkonnektor Guide 05 09 2013 376 Solution Center Connector Beispiel Objekt erzeugen Alternativ dazu k nnen Sie die Attribute des Objekts bereits beim Anlegen ber eine Eingangsnachricht definieren 7 Setzen Sie den Startpoint vor den Solution Center Connector 8 Starten Sie den Test ohne Datei 35 5 2 Objekt ber eine XPath Anfrage erzeugen So gehen Sie vor 1 Erstellen Sie anhand des XSD Schemas Ihrer Business oder Process Solution eine XML Struktur z B ber einen XSLT Converter we Wr BR 3 Q rage XML source XML target C xsl stylesheet EN http www w3 org 1999 XSL Transform d i xsl http www w3 org 200 1 XMLSchema BC xs B xs d i exdude result prefixes 2 0 a version E xsl output method xml encoding UTF 8 Sf amp xsl template oO http localhost 8000 sc 1315211273158 FleetPoolManagement d i fpm http finubit com businessrepository d i br false gt fpm Checked false Sales_Contract_2011_09_13 gt fpm ContractNumber Sales_Contract_2
166. Standard stellt die Vorbelegung wieder her Die Verbindungsverschl sselung zur X 400 Box der Telekom muss ber stunnel mit 128 Bit erfolgen Wenn Sie den Hostnamen oder die Portnummer in der PA Adresse ndern m ssen Sie dieselben nderungen auch in der stunnel Konfiguration vornehmen Verbindungen zu X 400 Mailboxen anderer Anbieter die bis 56 Bit SSL Verschl sselung ben tigen k nnen Sie weiterhin mit dem Protokoll itots ohne stunnel verschl sseln Lu 05 09 2013 DN Bind Domainangabe Standard ist Cc de f r Deutschland Wenn Sie den X 400 SE Konnektor in einem anderen Land einsetzen m ssen Sie das L nderk rzel entsprechend ndern Der Button Standard stellt die Vorbelegung wieder her OR Adresse Abk f Originator Recipient Absenderadresse Wenn Sie mehrere X 400 SE Konnektoren mit derselben OR Adresse konfigurieren dann m ssen alle Konnektoren dieselben Einstellungen haben Sonst berschreiben sich die Konnektoren gegenseitig die Verbindungseinstellungen Beispiel S INUBIT O INUBIT IS A viaT C de inubit 6 1 Workbench Process Engine Systemkonnektor Guide X 400 SE Connector 487 Dialogbeschreibungen Die folgende Tabelle erl utert die Adressbestandteile Das beschriebene Format wird von der Deutschen Telekom unterst tzt Wenn Sie Ihre X 400 Box bei einem anderen Anbieter gemiet
167. Systemkonnektor Guide 05 09 2013 446 Web Services Connector Bin rdaten als Attachments mit MTOM bertragen Lu Die maximale Gr e und Anzahl der Log Datei en konfigurieren Sie unter inubit Workbench gt Configuration gt Allgemeine Einstellungen gt Monitoring gt Web Service Siehe Web Service Logs Process Engine Administrator und Entwickler Guide Kap 2 1 5 S 24 Die Protokolle finden Sie im Log Verzeichnis lt iS installdir gt server ibis root log webservice log x Dieses Logging steht nur f r Web Service Konnektoren ab Version 5 3 0 65 zur Verf gung wenn diese das Metro Framework nutzen Das Logging kann also nicht f r Web Service Konnektoren im Kompatibilit tsmodus mit dem Axis2 Framework genutzt werden 40 15 Bin rdaten als Attachments mit MTOM bertragen Dieser Abschnitt erl utert die folgenden Themen m Nachrichten mit bin ren Attachments versenden S 446 m Nachrichten mit bin ren Attachments empfangen S 449 Die Performance von Web Services wird durch die bertragung gro er Mengen von Bin rdaten beeintr chtigt MTOM Message Transmission Optimization Mechanism ist ein Mechanismus um die Performance bei der bertragung bin rer Daten in Web Services zu optimieren Dabei werden die Bin rdaten nicht base64 kodiert in der SOAP Nachricht sondern als Anhang der SOAP Nachricht verschickt Der vom W3C empfohlene MTOM Standard spezifiziert dass die Bin rda
168. TTP Methoden Siehe HTTP Header Workbench Process Engine Systemkonnektor Guide Kap 27 S 303 27 8 3 Dialog Konfiguration der Anfrage Basiskonfiguration Authentifizierung verwenden 05 09 2013 Medium und Output Connector In diesem Dialog zur Konfiguration der anzufragenden Ressource legen Sie die aufzurufende URL die HTTP Methode und evil eine Authentifizierung fest Aufzurufende URL Geben Sie die URL der Ressource ein an den der Connector seinen Request sendet z B Adresse eines HTTP Input Listeners SSL Dient zum Konfigurieren der Server bzw Client Authentifizierung und ffnet den Dialog SSL Konfiguration Workbench Process Engine Systemkonnektor Guide Kap 1 1 4 S 24 Methode Geben Sie hier die gew nschte HTTP Methode an mit der die Aktion die auf die Ressource angewendet werden soll definiert wird Siehe HTTP Methoden verwenden Workbench Process Engine Systemkonnektor Guide Kap 27 3 S 292 Markieren Sie diese Option wenn der Server eine Authentifizierung fordert Geben Sie dann den Account ein den der Connector f r die Authentifizierung verwenden soll Verfahren Basic Es werden Benutzername und Passwort verlangt und unverschl sselt bermittelt inubit 6 1 Workbench Process Engine Systemkonnektor Guide REST Connector 303 Dialogbeschreibungen Nur zu verwenden wenn die Verbindung zwischen Client und WY Server als sicher betrachtet werden
169. URL des Servers an den Connector seinen POST Request sendet z B Adresse eines HTTP Input Listeners Button SSL nur Input Connector Zum Absichern der Kommunikation Uber SSL Siehe Dialog SSL Konfiguration Workbench Process Engine Systemkonnektor Guide Kap 1 1 4 S 24 Authentifizierung m Authentifizierung erforderlich Mit dieser Option legen Sie fest dass sich jeder Client gegen ber dem Input Listener authentifizieren muss Verfahren Bei der Basic Authentication werden Benutzername und Passwort verlangt und unverschl sselt bermittelt Benutzername Benutzername f r die Authentifizierung Passwort Passwort f r die Authentifizierung HTTP Header Konfiguration ber den Header k nnen Informationen wie z B Dateigr e HTTP Server und User Agent Kennung oder MIME Typ zwischen Client und HTTP Server bertragen werden Der Button Header Liste ffnet einen Dialog in dem Sie Name Wert Paare als Header definieren k nnen inubit 6 1 Workbench Process Engine Systemkonnektor Guide 05 09 2013 150 HTTP Connector Dialog HTTP Connector Eigenschaften Ef Informationen ber zul ssige Header finden Sie in der HTTP Spezifikation siehe http www w3 org Protocols HTTP 1 1 rfc2616 pdf Wenn im Request bereits gleichnamige Request Header vorhanden Q sind dann werden diese Header mit den hier angegebenen Werten berschrieben Kodierung m Kodierung Dekodierung Base64
170. Username authentifizieren Mit den folgenden Optionen legen Sie fest wie das Username Token verarbeitet werden soll Interne Benutzerverwaltung Das Username Token wird gegen die interne inubit Benutzerverwaltung validiert Authentifizierung durch Workflow Das Username Token wird innerhalb eines anzugebenden Workflows authentifiziert Das Username Token Passwort wird als Passwort Moduleigenschaft verschl sselt und dem Workflow als XML Struktur bergeben inubit 6 1 Workbench Process Engine Systemkonnektor Guide 05 09 2013 470 Web Services Connector Dialogbeschreibungen Die Authentifizierung wird als erfolgreich gewertet wenn kein Fehler im Workflow geworfen wird 40 16 8 Dialog WS Security Konfiguration Security Token Service Authentifizierung STS Service Authentifizierung Consumer Authentifizierung Username Authentifizierung 05 09 2013 Medium und Output Connector In diesem Dialog haben Sie folgende Optionen X 509 Zertifikat Button Truststore oder Zertifikat ausw hlen ffnet einen Dateiexplorer zum Laden des ffentlichen Zertifikats des Service Wahlen Sie eine cer oder eine Truststore Datei Wenn Sie einen Truststore w hlen werden Sie anschlie end nach dem Alias der Zertifikats gefragt X 509 Zertifikat Button Truststore oder Zertifikat ausw hlen ffnet einen Dateiexplorer zum Laden des ffentlichen Zertifikats des Service Wahlen Sie eine cer od
171. Verbindung aufzubauen abgebrochen wird u Session Maximale Anzahl der parallel aktiven Empf nger Diesen Wert m ssen Sie von Ihrem Gesch ftspartner erfragen Der Standard ist 1 DBit Delivery confirmation bit Wenn Sie diese Option ausw hlen fordert die sendende Station eine Empfangsbest tigung an Geschlossene Benutzergruppe closed user group CUG Ist eine Station Mitglied in einer CUG dann werden Nachrichten nur zwischen Stationen gesendet und empfangen die in derselben CUG sind Virtuelle Schaltung Bei X 25 sind virtuelle Schaltungen virtual circuits m glich Dabei wird alles au er der bertragungsroute festgelegt Damit ist es m glich die Route bei Bedarf zu w hlen und ber mehrere Kan le durch Multiplexing die bertragungsrate zu erh hen Sie k nnen zwischen den Parametern S switched virtual circuit SVC und P permanent virtual circuit PVC w hlen PVC Verbindungen sind beispielsweise bei Banken g ngig SVC Verbindungen werden genutzt wo eine dauerhafte Verbindung nicht notwendig ist Wenn Sie eine Nachbarstation hinzuf gen die ber X 25 W kommuniziert dann werden keine Optionen f r das ISDN Protokoll angezeigt F r X 25 wird dann die Option Ger tename hinzugef gt Ger tename Benennt das Ger t device name Geben Sie eine beliebige alphanumerische Zeichenkette ein Der hier angegebene Namen muss mit dem Namen bereinstimmen der in der Konfiguration des Gesch ft
172. Versand Lu Output Connector In diesem Dialog legen Sie u a Empf nger Betreff und Format der zu versendenden Nachrichten fest und konfigurieren die Anh nge Um die Verbindungskosten zu senken empfiehlt die Bosch Software Innovations GmbH bei einer Ausf hrung des Konnektors mehrere Nachrichten zu versenden Siehe Verbindungskosten reduzieren Workbench Process Engine Systemkonnektor Guide Kap 43 S 483 inubit 6 1 Workbench Process Engine Systemkonnektor Guide 05 09 2013 490 X 400 SE Connector Dialogbeschreibungen Konfiguration des Eingangsformates Eigenschaften der Nachricht 05 09 2013 Format TXT Die Eingangsnachricht enthalt Text in dem Format dass bei der Option Kodierung angegeben ist DATA Die Eingangsnachricht enthalt Daten die unverandert weitergegeben werden sollen XML Die Eingangsnachricht liegt im IBISX400 XML Format vor Das entsprechende XML Schema sowie eine Beispielnachricht finden Sie im inubit Repository im Verzeichnis Global System Mapping Templates X 400 SE Connector Kodierung Nur bei Text als Eingangsnachricht Zeichensatz der Eingangsnachrichten Die Angabe wird ben tigt um byte kodierte Eingangsdaten korrekt in den Zeichensatz zu konvertieren der bei der Option Anhangtyp angegeben ist Betreff Aussagekr ftige Beschreibung der Nachricht Empf nger F r Infos ber das Adressformat des Empf ngers siehe OR A
173. Virtual Virtuelle Nachbarstation S 243 Routed Station S 244 Verbindung aktivieren S 245 Entfernen S 245 Eine Nachbarstation ist die Station eines Gesch ftspartners mit dem Sie Nachrichten austauschen wollen Mit dieser Option f gen Sie eine neue Nachbarstation hinzu Diese wird in einem Verzeichnisbaum unter LOC hinzugef gt Sie m ssen die Konfiguration der Nachbarstation kennen Wenn Sie die neu hinzugef gte Station ausw hlen k nnen Sie die Parameter auf der rechten Seite des Dialogs hinzuf gen Die Stationen k nnen f r verschiedene bertragungsprotokolle konfiguriert werden W hlen Sie eines der Protokolle X 25 Jup 2 TCP IP ISDN oder Virtual Dialoggruppe Odette Odette ID Dies ist eine eindeutige Zeichenkette die aus maximal 25 Zeichen besteht Das erste Zeichen ist immer ein O Passwort empfangen Das vom Gesch ftspartner erwartete Passwort m Passwort senden Das an den Gesch ftspartner gesendete Passwort Gr e des Austauschpuffers Die Gr e wird in Byte angegeben Der Standard ist 0 Wenn Sie hier einen Wert setzen wollen benutzen Sie den Wert des globalen Parameters OEXBUF wie im Handbuch der verwendeten OFTP Middleware beschrieben Anzahl der Austauschpuffer Der Standard ist 0 Die Zahl bestimmt die Anzahl der Puffer die gesendet werden ohne auf eine Antwort zu warten Empfangene Blockanzahl Da OFTP Nachrichten bei einer Verbindungsst rung nicht vollst
174. Web Services Connector o Eu er Sa gaang nd teen rn Die weiteren Angaben auf dem Register Bereitgestellter Web Service k nnen Sie nicht ndern da sie automatisch korrekt voreingestellt werden 6 Klicken Sie auf Weiter um das Register Modul Editor anzuzeigen 7 Zeigen Sie das Register Erweitert an 8 Aktivieren Sie im Bereich Callback Listener spezifische Einstellungen die Checkbox Listener nimmt Antwort Nachrichten entgegen anstelle von Anfrage Nachrichten sofern sie nicht bereits automatisch aktiviert wurde 9 Klicken Sie auf Fertigstellen 10 11 12 ffnen Sie die Web Service Einstellungen des Web Services Connectors ber das Kontextmen im Workflow Designer Aktivieren Sie im Bereich Modus die Option Asynchronen Callback entgegennehmen und Workflow weiterf hren Verbinden Sie das letzte der weiter oben konfigurierten weiteren Module mit dem soeben angelegten Callback Listener Connector Wenn Sie alle Module konfiguriert und verbunden haben dann publizieren Sie den Workflow inubit 6 1 Workbench Process Engine Systemkonnektor Guide Web Services Connector 433 Web Services Provider durch Security Token Service absichern 40 6 Web Services Provider durch Security Token Service absichern Dieser Abschnitt erl utert wie Sie einen Web Service Provider ber einen Security Token Service STS absichern Voraussetzungen Der Web Service Provid
175. Wenn der aufgerufene Web Service Anh nge sendet befinden sich diese in den entsprechenden MTOM Variablen Markieren Sie diese Option um die Anh nge in das Dateisystem zu speichern Die Pfade finden Sie in den MTOM Variablen Wenn die Option nicht markiert ist dann bleiben die Anh nge in den Workflow Variablen erhalten Bin rdaten aus Eingabenachricht extrahieren und als Variablen Inhalte setzen nur Input Listener Connector Wenn diese Option aktiviert ist wird die empfangene SOAP Nachricht nach Elementen mit dem Attribut xmime contentType durchsucht Die Elementinhalte werden in WSAttachment Variablen geschrieben Siehe Nachrichten mit bin ren Attachments empfangen Workbench Process Engine Systemkonnektor Guide Kap 40 15 2 S 449 MTOM Anhange f r Antwort Nachricht aktivieren nur Input Listener Connector Aktivieren Sie diese Option wenn Sie in der Ausgangsnachricht den Inhalt von Elementen vom Typ xmime base64Binary als MTOM Anh nge verschicken mit Daten aus WSAttachment Variablen m chten Siehe Nachrichten mit bin ren Attachments versenden Workbench Process Engine Systemkonnektor Guide Kap 40 15 1 S 446 Referenzierte Dateien nach Antwort l schen nur Input Listener Connector inubit 6 1 Workbench Process Engine Systemkonnektor Guide 05 09 2013 460 Web Services Connector Dialogbeschreibungen Authentifizierung W3C Standards 05 09 2013 Aktivieren Sie diese
176. Wenn markiert dann muss sich der Systemkonnektor den Sie gerade konfigurieren gegen ber dem entfernten Remote Connector mit einem privaten Schl ssel bzw Keystore identifizieren Der Button Keystore laden ffnet einen Dateiexplorer zum Laden des Keystores mit dem privaten und dem ffentlichen Schl ssel des Client Nach den Laden wird das Datum angezeigt bis zu dem die Schl ssel g ltig sind Verbindung testen Zum Testen ob die Verbindung mit Ihren Angaben erfolgreich aufgebaut werden kann inubit 6 1 Workbench Process Engine Systemkonnektor Guide EH A 1 Connector j Verwendung Dieser Abschnitt erl utert die folgenden Themen a Beispiel f r eine XPCML Eingangsnachricht S 27 m Dialog AS 400 Connector Eigenschaften S 28 Mit dem AS 400 Connector k nnen Sie Anwendungen auf einem AS 400 System aus einem Technical Workflow heraus starten Zum Aufrufen der Anwendung und bergeben evtl vorhandener Parameter ben tigen Sie eine XPCML basierte Eingangsnachricht Diese Eingangsnachricht erstellen Sie mit Hilfe eines XSLT Converters der vor den AS 400 Connector geschaltet wird Siehe auch Systemkonnektoren Workbench Process Engine Systemkonnektor Guide Kap 1 S 19 Module anlegen Workbench Benutzer Guide Kap 3 3 S 129 Technical Workflow Diagramme Workbench Benutzer Guide Kap 12 S 311 2 1 Beispiel f r eine XPCML Eingangsnachricht Beispiel Eine XPCML basierte
177. Workbench Process Engine Systemkonnektor Guide 05 09 2013 310 RosettaNet HTTPS Connector Struktur und Austausch von RosettaNet Nachrichten 29 1 Struktur und Austausch von RosettaNet Nachrichten Struktur Die folgende Abbildung zeigt die Struktur einer RosettaNet Business 05 09 2013 Message MIME multipart related Header nen E E RosettaNet Eee i Business Message Header XML Metadaten mit Informationen Uber die Nachricht Jede Nachricht muss alle Headerteile genau einmal enthalten Der Header hat folgende Struktur Preamble Header Version des RosettaNet Implementation Framework RNIF zu dem die Nachricht konform ist Die aktuelle Version ist RNIF 2 0 Delivery Header Identifiziert den Absender und den Empf nger Enth lt einen Datums und Zeitstempel Alle an der Weiterleitung einer Business Nachricht Beteiligten also der Absender der Empf nger und m gliche Zwischenstationen benutzen diese Informationen f r das Routing Service Header Informationen ber den Partner Interface Process PIP als ID die PIP Instanz als ID und die Prozessaktivit t Payload Enth lt die eigentlichen Nachrichten und ist XML kodiert Service Content inubit 6 1 Workbench Process Engine Systemkonnektor Guide RosettaNet HTTPS Connector 311 Struktur und Austausch von RosettaNet Nachrichten Gibt an ob die Nachricht eine action message oder eine signal message ist Die Prozessaktivit t einer a
178. _Acknowledge RosettaNe con gt gt xml xml xml Dummy RosettaNetCon xml xml Der abgebildete Workflow empfangt RosettaNet Nachrichten und leitet diese abhangig von ihrem Inhalt weiter Der RosettaNet Input Connector am Anfang des Workflows ist als Listener konfiguriert und wartet auf Nachrichten Wenn eine RosettaNet Business Message von einem Geschaftspartner gesendet wird dann f hrt der Connector folgende Schritte aus Speichert die Nachricht im angegebenen Arbeitsverzeichnis pr ft anhand der lt PIP gt msg Dateien im Arbeitsverzeichnis des Moduls ob die eingegangene Nachricht schon einmal gesendet wurde wenn ja dann erzeugt der Connector eine entsprechende XML Nachricht sendet sofort synchron eine Empfangsbest tigung leitet die Nachricht an das Demultiplexer Modul weiter Empfangsbest tigungen k nnen auch asynchron versendet werden z B nachdem das wartende Backend System die RosettaNet Nachricht erhalten hat Dazu aktivieren Sie im Input Connector im inubit 6 1 Workbench Process Engine Systemkonnektor Guide RosettaNet HTTPS Connector 317 Dialogbeschreibungen Dialog Asynchrone Empfangsbestatigung Workbench Process Engine Systemkonnektor Guide Kap 29 5 2 S 323 den Versand asynchroner Best tigungen und f gen einen Output Connector in den Workflow ein Der Output Connector versendet die Best tigung und sollte daher an einer Position im Workflow eingef gt werden
179. achricht an nachfolgende Module weitergeleitet Abh ngig von der Gr e der Eingangsnachrichten kann diese Option die Performance Ihres Systems beeinflussen inubit 6 1 Workbench Process Engine Systemkonnektor Guide 05 09 2013 160 inubit IS Connector Dialogbeschreibungen 05 09 2013 inubit 6 1 Workbench Process Engine Systemkonnektor Guide ITA Connector Verwendung Konnektortypen 161 Dieser Abschnitt erl utert die folgenden Themen m Voraussetzung f r den Betrieb Treiber installieren S 161 m Dokumente in ITA Archivsystem einf gen Insert S 162 m Dokumente aus ITA Archivsystem abholen Select S 164 m Dialog ITA Archiv Connector S 165 Mit einem ITA Connector k nnen Sie Dokumente in ein ITA Archivsystem der Firma SER Solutions Deutschland GmbH einf gen und abholen Das ITA Archivsystem erm glicht die strukturierte Suche nach Dokumenten indem Dokumentenattribute in der SERaTIO Indexdatenbank abgelegt und verwaltet werden Entsprechend unterst tzt auch der ITA Connector die Vergabe von Dokumentattributen beim Einf gen der Dokumente Ein ITA Connector wird immer als Medium Connector eingesetzt da er eine XML formatierte Query als Eingangsnachricht erwartet das Ergebnis der Query vom ITA Archivsystem entgegennimmt und an das nachfolgende Modul im Technical Workflow bergibt Siehe auch Systemkonnektoren Workbench Process Engine Systemkonnektor Guide Kap 1 S 19 Modul
180. adaten Ihrer Datenbank mindestens Tabellen und Spaltennamen m ssen bekannt sein Siehe Metadaten abfragen Workbench Process Engine Systemkonnektor Guide Kap 6 1 S 62 Beispiel XML Eingangsnachricht inubit 6 1 Workbench Process Engine Systemkonnektor Guide 05 09 2013 64 Database Connector Dynamische XML Query erstellen So gehen Sie vor 1 al a Legen Sie einen Technical Workflow mit einem Database Medium oder Output Connector an Aktivieren Sie beim Database Connector im Dialog Datenbankverbindungen und Query Typ Workbench Process Engine Systemkonnektor Guide Kap 6 5 1 S 84 im Bereich Funktion die Option Eingangsnachricht als Query ausf hren Publizieren Sie den Database Connector F gen Sie einen XSLT Converter in Ihren Technical Workflow ein Verbinden Sie die beiden Module ffnen Sie den XSLT Converter zum Bearbeiten und zeigen Sie den XSLT Mapper an ffnen Sie im Bereich XML Quelldatei das AL Men w hlen Sie Offnen und laden Sie Ihre Beispiel Eingangsnachricht XML Query erstellen a ffnen Sie im Bereich XML Zieldatei den Datenbank Explorer N Eigenschaften 2217 Converter LEI B 53 Q XSLT Stylesheet Liest_Metadaten PM Quelle LL 3 xsl http www w3 org 1999 xSL Transform at xs 2 0 a 1 BBQ xm zieldatei amp ffnen 3 Speichern cd Drucken Zwischenablage 2 Repository
181. adressen werden durch Kommata getrennt R ckantwort an Auszuf llen wenn die Absenderadresse nicht die Adresse ist unter der Sie eine R ckantwort erhalten wollen Betreff Gibt an worauf die Nachricht Bezug nimmt Sie k nnen f r den Betreff Datum Zeitstempel oder Prozess ID hinzuf gen lassen Datum Sie k nnen das Datum unterschiedlich ausgeben lassen Als Angabe ohne Datumsformat wird aus betreff_ TimeStamp xml die Angabe betreff 06082008 151047 xml erzeugt Als Angabe mit Datumsformat hh wird aus betreff TimeStamp hh xml die Angabe Betreff_ 11 xml erzeugt Bei der Angabe mit Datumsformat ddMM wird aus Betreff TimeStamp ddMM xml die Angabe Betreff_ 2309 xml erzeugt Zeitstempel Der Zeitstempel enth lt zus tzlich eine Angabe in Millisekunden Die Angabe betreff TimeStamp ddMMyyyy HHmmss SSS xml erzeugt betreff 12122002 151304 027 xml Prozess ID Um die Prozess ID mit auszugeben geben Sie den Betreff im folgenden Format an betreff PID ProcessId xml Verbindungstest m Verbindung testen Zum Testen ob die Verbindung mit Ihren Angaben erfolgreich aufgebaut werden kann inubit 6 1 Workbench Process Engine Systemkonnektor Guide 05 09 2013 224 Mail Connector Dialogbeschreibungen 21 2 7 Dialog S MIME Verschl sselung Output Connector In diesem Dialog k nnen Sie Nachrichten S MIME verschl sseln Verschl sselung aktivieren Die Option ist
182. ail wird in das IBIS MIME XML Format konvertiert Fur die Konvertierung wird folgendes Schema verwendet Global gt System gt Mapping Templates gt MIME Adapter gt SMimel 1 xsd Header Namen im XML klein schreiben Die Option ist sprechend Einheitlich klein geschriebene Namen vereinfachen den Zugriff auf die Elemente per XPath Inhalte immer Base64 kodieren Fur den Transport von Binardaten wie z B Grafiken Inhaltsverzeichnis des Postfaches als MIME XML Ladt die Header Informationen aus dem angegebenen Postfach herunter und konvertiert diese nach XML Ublicherweise umfassen Header Infos den Betreff Subject den Absender das Datum und die Prioritat inkl Inhalt der Nachrichten Inhalte immer Base64 kodieren F r den Transport von Bin rdaten wie z B Grafiken Header Namen im XML klein schreiben Die Option ist sprechend benannt Die einheitliche Schreibung erleichtert den Zugriff auf die Daten via XPath Daten aus dem Mitteilungsinhalt Die Nachricht wird dem Message Body entnommen also dem Teil der blicherweise den Nachrichteninhalt enth lt WI aus dem Mitteilungsanhang Die Nachricht wird dem Anhang entnommen Beachten Sie dass einige E Mail Programme z B Outlook auch plain Text Nachrichten als Anhang versenden Anhangsnameloder die Nummer des Anhangsindex Wenn Sie keine Angaben machen dann wird diejenige Datei im Workflow weitergeleitet die als erstes
183. aktiv wenn der Scheduler aktiviert ist Output Connector Formatiert E Mails im MIME Format und versendet diese Stellen Sie sicher dass der SMTP Server von dem Rechner aus erreichbar ist auf dem die inubit Process Engine installiert ist Pr fen Sie ob Mail Relaying von der inubit Process Engine aus erforderlich ist und stimmen Sie die Konfiguration des SMTP Servers entsprechend ab Siehe http de wikipedia org wiki SMTP Relay Server Um den Mail Connector anonym als Mail Relay zu nutzen erfragen Sie die Relay Konfiguration bei Ihrem Mail Administrator Bei dieser Nutzungsart k nnen Sie die Verbindung nicht testen Siehe auch Systemkonnektoren Workbench Process Engine Systemkonnektor Guide Kap 1 S 19 Dialog Zeitgesteuerte Verarbeitung Workbench Process Engine Systemkonnektor Guide Kap 1 1 3 S 22 Module anlegen Workbench Benutzer Guide Kap 3 3 S 129 Technical Workflow Diagramme Workbench Benutzer Guide Kap 12 S 311 21 1 Modulvariablen des Mail Connectors Bei der Ausf hrung eines Mail Connectors werden folgende Variablen gesetzt die Sie auswerten oder berschreiben k nnen u Message ID inubit 6 1 Workbench Process Engine Systemkonnektor Guide 05 09 2013 216 Mail Connector Dialogbeschreibungen From nur Input Connector Reply To nur Input Connector Subject nur Input Connector F r Infos ber Variablen und deren Verwendung siehe Workflow Variablen
184. alue SSURNSS datatype String gt lt equal gt lt isa entitytype siemens ad bereichsarchiv Dk10007R3Lief erung gt lt and gt lt and gt lt equal gt lt property name ixos dms Id gt lt literal value aaps44v2vy6ugvorzmcje3enjexgo datatype String gt lt equal gt lt and gt Dieser Abschnitt erl utert die folgenden Themen Entity Eigenschaften S 209 Entity Properties S 210 m Entity Components S 210 Die Entit ten sind die zentralen Elemente von Eingangs und Ausgangsnachrichten und sind jeweils analog im Livelink Archive Server repr sentiert In der Eingangsnachricht dienen Sie abh ngig vom Kommando als Vorgabe f r anzulegende Entit ten oder daf r welche Eigenschaften an bestehenden Entit ten ge ndert werden sollen inubit 6 1 Workbench Process Engine Systemkonnektor Guide Livelink PDMS Connector 209 Inhalt und Struktur der Eingangs und Ausgangsnachrichten In der Ausgangsnachricht dienen sie zur bergabe der Eigenschaften Struktur der Entit ten lt lt lt Entities gt lt Entity gt lt Entity Eigenschaften gt lt Properties gt lt Components gt Entity gt Entities gt Inhalt in eckigen Klammern ist optional 20 2 3 1 Entity Eigenschaften Entity Eigenschaften sind prim re Attribute der Entitat z B lt lt lt Entities gt lt Entity gt lt Type gt sieme
185. ame der Verwaltungsstruktur im Windows Netzwerk an der Sie sich mit den Zugangsdaten aus den Feldern Benutzer Passwort anmelden m chten Benutzer Passwort Zugangsdaten des Benutzers mit dem Sie sich an der oben genannten Dom ne anmelden m chten Der Benutzer muss berechtigt sein auf die Warteschlange zuzugreifen Verbindung testen Zum Testen ob die Verbindung mit Ihren Angaben erfolgreich aufgebaut werden kann inubit 6 1 Workbench Process Engine Systemkonnektor Guide 05 09 2013 228 MSMQ Connector Dialog MSMQ Connector Eigenschaften 05 09 2013 inubit 6 1 Workbench Process Engine Systemkonnektor Guide 23 OFTP Connector Verwendung 234 Voraussetzungen 229 Dieser Abschnitt erl utert die folgenden Themen Voraussetzungen S 229 Funktionsprinzip S 230 Daten bertragungsmodi S 231 rvs Monitoring S 233 Dialog OFTP Datenaustausch Konfiguration S 233 Dialog Stationen S 236 Der OFTP Connector wird genutzt um Gesch ftsdaten gem dem Odette File Transfer Protocol OFTP auszutauschen OFTP bietet die M glichkeit eine Verbindung nach dem Abbruch wieder aufzusetzen ohne die gesamte Datei erneut zu bertragen Es k nnen ASCII und EBCDIC Dateien bertragen werden Siehe auch Systemkonnektoren Workbench Process Engine Systemkonnektor Guide Kap 1 S 19 Module anlegen Workbench Benutzer Guide Kap 3 3 S 129 Technical Workflow D
186. an Name Accept v Liste der akzeptierten Medien Typen Wert bi Ersetzen mit gt application xml Hinzuf gen gt text xml wi OK X Abbrechen application vnd mycustomname xml FIE c W hlen Sie einen Medien Typen aus Sie k nnen auch mehrere Typen ausw hlen und es wird dann eine geordnete Liste der gew nschten Repr sentationen zur ckgeliefert d Schlie en Sie die Dialoge zum Bearbeiten des HTTP Headers mit OK 7 Klicken Sie Fertig stellen 8 Publizieren Sie den REST Connector inubit 6 1 Workbench Process Engine Systemkonnektor Guide 05 09 2013 298 REST Connector Dialogbeschreibungen F r das Abfragen einer Ressource mit GET ben tigen Sie keine Ausgangsnachricht da die Ressource nur angefragt jedoch keine nderung an den Daten vorgenommen werden F r das Zugreifen auf eine Ressource mit POST oder PUT ben tigen Sie eine Ausgangsnachricht Falls Sie z B Daten in eine Artikelliste hinzuf gen m chten k nnen Sie mit einem XSLT Converter im Workflow vor dem REST Connector eine XML Nachricht erstellen und diese mit versenden z B lt artikel gt lt beschreibung gt Rooibusch Tee lt beschreibung gt lt preis gt 2 80 lt preis gt lt einheit gt 100g lt einheit gt lt artikel gt Alle Eingangsnachrichten in den REST Output Medium Connector werden mit der Anfrage versendet Sie k nnen die aufzurufende URL der Ressource dynamisch anpassen indem Sie d
187. an die E Mail angeh ngt wurde Auch wenn die E Mail mehrere Anh nge hat wird nur der erste weitergeleitet inubit 6 1 Workbench Process Engine Systemkonnektor Guide Mail Connector 219 Dialogbeschreibungen Um bei mehreren Anh ngen gezielt einen bestimmten Anhang weiterzuleiten geben Sie dessen Namen oder Position an 21 2 3 Dialog Mitteilungskonfiguration Nach dem Lesen l schen Filtereinstellungen Input Connector In diesem Dialog haben Sie folgende Optionen L schen Wenn markiert dann werden zuerst die Nachrichten vom Mailserver auf die inubit Process Engine kopiert und dann vom Mailserver gel scht Ist diese Option markiert und der Inhalt der E Mail leer Body 0 Byte die E Mail besitzt aber einen Anhang wird die E Mail nach dem Lesen gel scht und f hrt zu keinem Workflow Start Um dies zu verhindern m ssen Sie im Register Datenweitergabe konfigurieren die Option MIME XML aktiviert haben Zum Definieren von Filterkriterien denen E Mails entsprechen m ssen damit diese vom Mailserver abgeholt werden Verkn pfung der Filter UND w Subject v enth lt e Supportanfrage Aa Message ID v enth lt e support inubit com fa Filter hinzuf gen Verkn pfung der Filter Wenn mehr als ein Filter angegeben ist UND Alle Filter m ssen auf eine Nachricht zutreffen damit diese geholt wird ODER Mindestens ein Filter muss auf eine Nachricht zutreffen damit diese
188. appings Header dynamisch berschreiben und neue Header setzen So gehen Sie vor Definieren Sie eine Abbildungsregel nach folgendem Muster Quellwert gt Zielwert httpheader lt headerName gt Beispiel Yariablen Mapping In diesem Dialog k nnen Sie Abbildungsregeln erstellen l schen und sor Eine Regel vom Typ Quelle Ausgabedatenstrom gt Ziel Yariable wird na Modulausf hrung durchgef hrt Alle anderen Regeln werden vor der Mo der angezeigten Reihenfolge ausgef hrt Jg 8 Git Ihm Quelle si text xml Q httpheader accept no cache httpheader cache control Siehe Workflow Variablen und Mappings Workbench Benutzer Guide Kap 14 S 383 inubit 6 1 Workbench Process Engine Systemkonnektor Guide HTTP Connector 149 Dialog HTTP Connector Eigenschaften 12 3 Dialog HTTP Connector Eigenschaften Dieser Dialog bietet folgende Optionen Grundkonfiguration m Server URL Input Listener Connector URL des Input Listeners unter welcher dieser auf Requests wartet Die URL wird automatisch nach folgendem Muster erstellt protokoll hostname port pfadZumServlet_ Nicht ndern NamedesInputListeners Teilen Sie die Server URL denjenigen mit die Nachrichten zur WY Verarbeitung an den Input Listener senden Input Connector URL des HTTP Servers oder HTTP Input Listener Connectors den der Input Connector aufruft Medium Output Connector
189. as Ereignisobjekt erstellt hat Action Date Erstellungsdatum des Ereignisobjekts Position nur f r den Event Typ bfm3 Milestone Positionsnummer eines Meilensteins Status nur f r den Event Typ bfm3 Milestone Status des Meilensteins F r selbstdefinierte Event Typen k nnen Sie weitere Attribute definieren und ber die Moduleigenschaften im Wizard oder das Variablen Mapping setzen inubit 6 1 Workbench Process Engine Systemkonnektor Guide 05 09 2013 390 Solution Center Logger Dialog SC Logger Einstellungen 05 09 2013 inubit 6 1 Workbench Process Engine Systemkonnektor Guide 37 edit Connector ES Verwendung 37 1 Konnektortypen inubit 6 1 Neue Features Lu Dieser Abschnitt erl utert die folgenden Themen m Konnektortypen S 391 a P Nachrichten mit Start Stopbyte Begrenzung verarbeiten S 393 m Dialogbeschreibung S 394 Der TCP IP Connector baut eine Socket Verbindung zwischen inubit und einem anderen Programm ber das TCP IP Protokoll auf und sendet bzw empf ngt beliebige Daten Der TCP IP Connector ist aufgrund seiner universellen Verwendbarkeit nur mit tiefergehendem Fachwissen verwendbar Die Funktionen des TCP IP Connectors sind von der Konfiguration abh ngig Input Listener Connector Der Konnektor bietet Serverfunktionalit t im Rahmen eines Workflows und etabliert unter der angegebenen IP Adresse und Port einen Dienst der auf Nachrichten von Cli
190. ass eine bereits gesendete Nachricht kein zweites Mal verarbeitet wird 29 5 Dialogbeschreibungen Dieser Abschnitt erl utert die folgenden Themen a Dialog RosettaNet Connector Eigenschaften S 318 inubit 6 1 Workbench Process Engine Systemkonnektor Guide 05 09 2013 318 RosettaNet HTTPS Connector Dialogbeschreibungen Dialog Asynchrone Empfangsbest tigung S 323 Dialog S MIME Konfiguration S 324 Dialog Verbindungsdaten f r Gesch ftsnachrichten S 324 Dialog Empfangsbest tigungen S 325 Dialog S MIME Konfiguration S 326 Dialog Verbindungsdaten fur Empfangsbest tigungen S 326 Dialog RosettaNet Verbindungsdaten S 327 Beachten Sie die Rechtschreibung wenn Sie Werte aus der Spezifikation bernehmen weil in RosettaNet Nachrichten bei allen Bezeichnungen und Werten zwischen Gro und Kleinschreibung unterschieden wird 29 5 1 Dialog RosettaNet Connector Eigenschaften 05 09 2013 Dieser Abschnitt erl utert die folgenden Themen a Register Allgemein S 319 m Register Not S 321 m Register Neuer PIP S 321 Neu Button Ein Klick auf Neu f gt eine weitere Registerkarte Neuer PIP f r den neuen PIP ein Siehe Register Neuer PIP Workbench Process Engine Systemkonnektor Guide Kap 29 5 1 3 S 321 L schen Button a Zeigen Sie die Registerkarte an die Sie l schen m chten b Klicken Sie a
191. atabase Connector fragt die Struktur der Datenbank und weitere Informationen ab Diese Infos ben tigen Sie z B wenn Sie in einer Abfrage Tabellen und Spaltennamen abbilden Siehe Metadaten abfragen Workbench Process Engine Systemkonnektor Guide Kap 6 1 S 62 Automatische Typenerkennung der Datenbankobjekte Wenn markiert dann werden Datentypen automatisch erkannt Wenn z B mit der Query ein Datum in die Datenbank eingef gt werden soll dann wird das Datum korrekt mit dem Typ Date bergeben Typerkennung cachen Aktivieren Sie die Checkbox um die Tabellendefinitionen vorzuhalten damit sie nicht bei jeder Ausf hrung des Database Connectors von der Datenbank abgefragt werden m ssen Auto Commit keine Transaktion inubit 6 1 Workbench Process Engine Systemkonnektor Guide 6 5 2 Dialog Metadaten Database Connector 87 Dialogbeschreibungen Bei einer Ausf hrung des Database Connectors k nnen mehrere SQL Statements ausgef hrt werden Mit dieser Option bestimmten Sie wann die nderungen dauerhaft in der Datenbank gespeichert werden Wenn das Auto Commit aktiviert ist dann wird f r jede Anderung automatisch ein Commit oder Rollback im Fehlerfall durchgef hrt Wenn die Option deaktiviert ist dann werden alle nderungen zusammen in einer Transaktion durchgef hrt Falls bei dieser Transaktion ein Fehler auftritt dann wird keine weitere nderung ausgef hrt und alle vorher bereits au
192. atei mit Namen Test5 xml weitergeleitet Der Wildcard Inhalt ist in diesem Fall das Zeichen 5 Wenn Sie im vorliegenden Connector ebenfalls eine Wildcard angegeben haben zum Beispiel Ausgabe vm so wird an Stelle der Wildcard das Zeichen 5 eingef gt Dateiname von vorher ausgef hrtem File Connector verwenden Wenn markiert dann wird der Dateiname verwendet der von einem vorher ausgef hrten File Connector benutzt wurde Beispiel ein vorher ausgef hrter File Connector wurde so konfiguriert das im Feld Verzeichnis und Dateiname eine Datei Test xml angegeben wurde Als Ausgangsnachricht wird vom File Connector eine Datei mit genau diesem Namen Test xml weitergeleitet Dieser Dateiname wird dann auch hier verwendet Daten an die Datei anf gen inubit 6 1 Workbench Process Engine Systemkonnektor Guide inubit IS Connector 159 Dialogbeschreibungen Wenn Sie diese Option w hlen wird die angegebene Datei nicht bei jeder Ausf hrung des Output Connectors berschrieben sondern es wird bei jeder Ausf hrung die Ausgangsnachricht an die Datei angeh ngt Dies ist zum Beispiel n tzlich wenn man Log Daten kumulativ in einer Datei protokollieren will Eventuell bestehende Datei berschreiben Diese Option ist vorausgew hlt Existiert eine Datei mit dem gleichen Namen wird diese berschrieben Eingangsnachricht zus tzlich auch als Ausgangsnachricht setzen Wenn markiert dann wird die Eingangsn
193. ation steht Ihnen als gedrucktes Handbuch als PDF Datei und als Onlinehilfe in inubit Workbench zur Verf gung Die Dokumentation besteht aus folgenden Teilen Installation Migration Quick Start Beschreibt die Hard und Softwarevoraussetzungen die Installation und die ersten Schritte Migrationsanleitung Tutorials F r den Ein und Durchstieg Die Tutorials erl utern die Verwendung der wichtigsten Softwarekomponenten anhand von fachlichen Szenarien inubit Workbench inubit Process Engine und inubit Enterprise Portal Benutzer Guide Beschreibt das Arbeiten mit inubit Workbench das Erstellen der verschiedenen Diagrammtypen und Module das Arbeiten mit Metadaten und Workflow Variablen Simulationen Tests das fachlich orientierte Monitoring und Reporting Administrator und Entwickler Guide Enth lt administrative Themen wie Konfiguration der inubit Process Engine Backup und Restore Benutzerverwaltung Security Aspekte Monitoring und Clustering Entwicklung von Plug ins und Thin Clients Modul Guide Data Converter Format Adapter Utilities Workflow und Web Service Controls verwenden und konfigurieren Systemkonnektor Guide Alles ber Einsatz und Konfiguration von Systemkonnektoren a Cluster Administration Administrator und Benutzer Guide Alles Uber das Installieren Konfigurieren und Betreiben der inubit Process Engine im Cluster Modus sowie Informationen ber das Anbinden von Prozessbenutzer und
194. ava sun com products jms docs html 18 2 4 Dialog Zus tzliche Eigenschaften In diesem Dialog k nnen Sie Eigenschaften selbst definieren Diese Eigenschaften k nnen Sie nutzen um die Kompatibilit t zu anderen Nachrichtensystemen herzustellen oder Nachrichten Selektoren zu definieren Um eine Eigenschaft hinzuzuf gen klicken Sie auf den Button Eigenschaften hinzuf gen F llen Sie im angezeigten Dialog die Eingabefelder Name Typ und Wert Siehe Dialog Nachrichten Selektor Workbench Process Engine Systemkonnektor Guide Kap 18 2 3 S 196 inubit 6 1 Workbench Process Engine Systemkonnektor Guide 05 09 2013 198 JMS Connector Dialogbeschreibungen 05 09 2013 inubit 6 1 Workbench Process Engine Systemkonnektor Guide 19 LDAP Connector 199 Verwendung 19 1 Konnektortypen Funktionsprinzip Dieser Abschnitt erlautert die folgenden Themen m Funktionsprinzip S 199 m DSMLv2 Anweisungen in Requests S 200 m Dialog LDAP Connector Eigenschaften S 203 Mit dem LDAP Connector k nnen Sie Daten auf einem Lightweight Directory Access Protocol LDAP Server einf gen ndern l schen und suchen Ein LDAP Connector kann als Medium oder Outputkonnektor konfiguriert werden Medium Connector Als Mediumkonnektor erh lt der LDAP Connector vom Vorg nger eine Abfrage als DSML Nachricht sendet diese an den LDAP Server erh lt vom LDAP Server ein Erge
195. b Services XSLT Converter zum Erstellen der Antwort konfigurieren Reply Modul zum Senden der Antwort konfigurieren 05 09 2013 Lu 2 W hlen Sie die beim Konfigurieren des asynchronen Web Service Listeners definierte Operation z B SayHello und die daf r generierte Eingangsnachricht 3 Klicken Sie auf Anzeigen damit die Nachricht in den Editor geladen wird 4 Speichern Sie die SOAP Eingabenachricht als Datei in Ihr Dateisystem 5 Klicken Sie auf Fertigstellen 6 Publizieren Sie das Modul Dieser XSLT Converter erstellt aus der Ausgangsnachricht des Web Services eine Antwortnachricht und bergibt sie an das Reply Modul So gehen Sie vor 1 Legen Sie einen neuen XSLT Converter an und benennen Sie ihn 2 Klicken Sie zwei Mal auf Weiter um zum Modul Editor zu gelangen Auf dem Register XSLT Converter Eigenschaften sind keine Anpassungen erforderlich 3 ffnen Sie im Fensterbereich XML Zieldatei einen Web Services Explorer 4 W hlen Sie als Modul den oben definierten Web Services Listener und als Operation die Response Operation 5 Ziehen Sie das Root Element der erzeugten Nachricht aus dem Bereich targetNamespace in der Schema Ansicht auf das Element xsl template im Bereich XML Ziel rechts oben 6 Tragen Sie im Bereich XML Quelle links oben den Text der Response Nachricht ein 7 Publizieren Sie das Modul 8 Ziehen Sie eine Verbindu
196. ber die echo Anweisungen in eine XML Struktur schreiben inubit 6 1 Workbench Process Engine Systemkonnektor Guide 05 09 2013 116 Execution Connector Beispiel Verzeichnis ausgeben Execution Connector Eigenschaften find type d maxdepth 1 printf lt Dir gt f lt Dir gt n echo lt Archive gt _ R ckgabewert als XML zuriickliefern 05 09 2013 inubit 6 1 Workbench Process Engine Systemkonnektor Guide 9 2 Beispiel Datei kopieren Execution Connector Beispiel Datei kopieren Execution Connector Properties E pass system variables to process Script bin bash cp trace log opt data tmp Check return value Expected value 0 Use of input and output message _ Use input message E Use output message E Use error exit Additional settings Buffer size of input message Pass back return value as XML 9 3 Beispiel Verzeichnis anlegen In diesem Beispiel wird auf die Workflow Variable var dir zugegriffen Wenn kein Verzeichnis mit dem Namen in var dir existiert wird es angelegt inubit 6 1 Workbench Process Engine Systemkonnektor Guide 05 09 2013 117 118 Execution Connector Dialog Execution Connector Eigenschaften ScriptFile Property var dir Is Arbeitsyerzeichnis opt da
197. berwachen ob in der Tabelle FATHI Gesch ftsobjekte erstellt werden Oracle CREATE OR REPLACE TRIGGER FATHER after insert AFTER INSERT ON FATHER FOR EACH ROW BEGIN NSERT INTO is events id is_ plugin id pkl pk2 pk3 pk4 pk5 pk6e DEI pk8 pk9 verb is structure name priority retrieve_ time status timestamp 0815 ist die Plugin ID VALUES SEQ S _EVENTS NEXTVAL 0815 Sal DO T inubit 6 1 Workbench Process Engine Systemkonnektor Guide 05 09 2013 98 Database Object Connector Events mit Event Listener berwachen und archivieren new FATHER NULL NULL sysdate 0 END MySQL ber MySQL Administrator Dy NULL NULL NULL NULL NULL NULL insert FATHER CHILD 1 sysdate Die Datenbankprozedur GetNewID muss vorhanden sein Siehe Datenbankprozedur getNewID f r MySQL Workbench Process Engine Systemkonnektor Guide Kap 7 5 2 S 103 DELIMITER DROP TRIGGER IF EXISTS FATHER after insert CREATE TRIGGER FATHER after insert AFTER NSERT ON FATHER FOR EACH ROW
198. bit Process Engine neu starten Um eine Adabas Datenbank einzusetzen kopieren Sie die Treiberklasse direkt in das Verzeichnis lt inubit installdir gt server JBoss server default lib bzw lt inubit installdir gt server webapps ibis WEB INF lib Benutzer Passwort Eingabe ist abh ngig von Ihrer Datenbank Connection Pooling Button Einstellungen Aktiviert das Connection Pooling Mit dem Button ffnen Sie den Dialog Datenbank Connection Pooling Workbench Process Engine Systemkonnektor Guide Kap 6 5 5 S 90 zur Konfiguration des Connection Pooling Spezielle Verbindungsparameter Zum Erstellen von Parametern wie z B Timeouts Anzahl offener Verbindungen etc die genutzt werden um die Datenbankverbindung abh ngig von Ihrer verwendeten Datenbank zu konfigurieren Die Parameter definieren Sie als Name Wert Paare Spezielle Einstellungen m Plugin ID Bei einem DBO Medium Connector inubit 6 1 Workbench Process Engine Systemkonnektor Guide 05 09 2013 106 Database Object Connector Dialogbeschreibungen 05 09 2013 Die ID identifiziert den jeweiligen Konnektor und muss innerhalb der inubit Installation und pro Datenbank eindeutig sein Bei einem DBO Input Connector ID des DBO Medium Connectors der die Events erzeugt welche der DBO Input Connector berwachen soll Ein DBO Input Connector kann nur die Events von einem DBO Medium Connector empfangen der dieselbe ID
199. bnis und gibt dieses Ergebnis an das nachfolgende Modul weiter Output Connector Als Outputkonnektor erh lt der LDAP Connector vom Vorg nger Modul eine DSML Nachricht und sendet diese an den LDAP Server Siehe auch Systemkonnektoren Workbench Process Engine Systemkonnektor Guide Kap 1 S 19 Module anlegen Workbench Benutzer Guide Kap 3 3 S 129 Technical Workflow Diagramme Workbench Benutzer Guide Kap 12 S 311 Der LDAP Connector stellt die Verbindung zu einem LDAP Server her liest einen DSMLv2 Request und bersetzt die darin enthaltenen Anweisungen in LDAP Aufrufe Die Directory Services Markup Language DSML ist ein OASIS Standard der den Zugriff auf Verzeichnisse mittels XML Schema und SOAP als Transportmechanismus spezifiziert und das komplette LDAP Datenmodell abbildet inubit 6 1 Workbench Process Engine Systemkonnektor Guide 05 09 2013 200 LDAP Connector DSMLv2 Anweisungen in Requests Um die Verbindung zu einem LDAP Server aufzubauen und Abfragen auszufuhren mussen Sie 1 einen LDAP Connector mit Verbindungsinformationen zum LDAP Server erstellen mit Hilfe eines XSLT Converters einen DSMLv2 Request in folgender Syntax erstellen lt batchRequest xmins urn oasis names tc DSML 2 0 core gt lt Jed inzelne Anweisung muss ein DN Attribut enthalten gt lt modifyRequest dn CN Joe Smith OU Dev DC inubit DC com gt lt modifyRequest gt lt addRequ
200. brufen von OSCI Nachrichten am Intermedi r Input Connector In diesem Dialog legen Sie die Konfigurationseinstellungen des Empf ngers fest um OSCI Nachrichten am Intermedi r abzurufen inubit 6 1 Workbench Process Engine Systemkonnektor Guide 05 09 2013 284 OSCI Connector Dialogbeschreibungen Lu Virtuelle Poststelle Empf nger Verbindungstest Da der Input Connector nur Nachrichten abruft wenn der Scheduler aktiviert ist m ssen Sie diesen im Dialog Zeitgesteuerte Verarbeitung Workbench Process Engine Systemkonnektor Guide Kap 1 1 3 S 22 aktivieren um das Polling Intervall festzulegen Intermedi r Geben Sie die URL des Intermedi rs unter der dieser online erreichbar ist Zertifikat des Intermedi rs Laden Sie hier die Datei mit dem ffentlichen Zertifikat des Intermedi rs entspricht einer cer Datei Signatur Keystore Laden Sie hier die pfx Datei mit dem privaten Schl ssel des Empf ngers Passwort des Signatur Schl ssels Geben Sie das Keystore Passwort des privaten Schl ssels f r die Signaturpr fung ein Chiffrierungs Keystore Laden Sie hier die p x Datei mit dem privaten Schl ssel f r die Entschl sselung ein a Passwort des Chiffrierungs Schl ssel Geben Sie das Keystore Passwort des privaten Schl ssels f r die Entschl sselung ein Verbindung testen Zum Testen ob die Verbindung mit Ihren Angaben erfolgreich aufgebaut werden
201. bytes an den konfigurierten Host und Port Siehe P Nachrichten mit Start Stopbyte Begrenzung verarbeiten Neue Features Kap 37 2 S 393 b Das Socket wird geschlossen Bei nicht konfigurierter Start Stopbyte Sequenz a Der Konnektor sendet die Nachricht des vorhergehenden Moduls im Workflow Client ohne Start Stopbytes an den konfigurierten Server und Port b Das Socket wird geschlossen 37 2 IP Nachrichten mit Start Stopbyte Begrenzung verarbeiten inubit 6 1 Neue Features F r den generischen Einsatz kann der Konnektor IP Nachrichten verarbeiten die mit einer Start bzw StopByte Begrenzung eindeutig gekennzeichnet sind Die folgende Darstellung illustriert einen solchen Nachrichtenaufbau Start und Stopbytes sind nicht Teil der Nachricht sondern Teil des Lower Layer Kommunikationsprotokolls Die Byte Sequenzen k nnen beliebig gew hlt werden Durch Aktivieren der Option Pr fen auf Start und Stopbytes k nnen die Werte im Konfigurationsdialog des Konnektors konfiguriert werden siehe Pr fen auf Start und Stopbytes Neue Features Kap 37 S 395 So gehen Sie vor 1 W hlen Sie den gew nschten TCP IP Connector aus und ffnen Sie diesen zum Bearbeiten 2 W hlen Sie den Dialog TCP IP Connector Eigenschaften 3 Aktivieren Sie im Bereich Konfiguration die Option Pr fen auf Start und Stopbytes 4 Tragen Sie im Feld Startbyte Sequenz die Bytefolge ein mit de
202. cal Workflow der das Portlet realisiert wissen in welchem Kontext die Portlet Instanz aufgerufen wurde ISWebLanguage Sprache die in der Portletinstanz genutzt wird ISPortalUser Loginname des aktuell angemeldeten Portalbenutzers ISWebContextPath Aktueller virtueller Pfad des Portlets ISParameters Liste der URL Parameter die an das Portlet bergeben wurden Die Informationen werden in der Eingangsnachricht des Web Application Connectors gesetzt und als XML Struktur ausgegeben Voraussetzungen Der Technical Workflow der das Portlet realisiert ist bereits deployed So gehen Sie vor 1 Zeigen Sie den Technical Workflow der das Portlet realisiert in der inubit Workbench an 2 Schalten Sie den Watch Modus ein Siehe Watch Modus verwenden Workbench Benutzer Guide Kap 16 2 S 444 3 F gen Sie das Portlet der gew nschten Seite und Gemeinschaft hinzu In der inubit Workbench werden Watchpoints angezeigt inubit 6 1 Workbench Process Engine Systemkonnektor Guide 05 09 2013 408 Web Application Connector Dialogbeschreibungen 4 ffnen Sie den Watchpoint vor oder nach dem Web Application Connector ut U nn SEA ann nn r OrderF orm Joiner 1 EnterOrder Splitter 1 Displayf eedback iS ibis_root tutorial inubit IS Team miller tmp 10_order_1 7032009_160009_WThre Datei ansehen Im oberen Bereich wird die Ergebnisdatei angezeigt im unteren Bereich werd
203. cess Engine Systemkonnektor Guide FTP Connector 143 Dialogbeschreibungen Dieser Mechanismus kann nicht eingesetzt werden wenn im A Dateinamen Wildcards verwendet werden Es gibt FTP Server die diesen Mechanismus nicht unterst tzen und eine Exception erzeugt Eventuell bestehende Datei berschreiben Existiert eine Datei mit dem gleichen Namen wird diese berschrieben Eingangsnachricht zus tzlich auch als Ausgangsnachricht setzen Wenn diese Option aktiviert ist wird die Eingangsnachricht an die Ausgangsnachricht angeh ngt inubit 6 1 Workbench Process Engine Systemkonnektor Guide 05 09 2013 144 FTP Connector Dialogbeschreibungen 05 09 2013 inubit 6 1 Workbench Process Engine Systemkonnektor Guide SS ES HTTP Connector 145 Dieser Abschnitt erl utert die folgenden Themen Parameter setzen und anzeigen S 146 Header setzen und anzeigen S 147 Dialog HTTP Connector Eigenschaften S 149 Verwendung Ein HTTP Connector erf llt abh ngig von seiner Konfiguration folgende Aufgaben Input Listener Connector Fungiert als HTTP Server und wartet auf Requests von Clients Dieser Konnektortyp kann synchron asynchron kommunizieren Synchrone Kommunikation Der Eingang eines Request startet den Workflow hinter dem Input Listener Connector Die Ausgangsnachricht des letzten Moduls im Workflow wird als Response an den Client zur ck gesendet Der HTTP Status in der Response kann im Workflow m
204. cess Engine Systemkonnektor Guide Systemkonnektoren 21 Dialogbeschreibungen Remote Connector Wenn markiert dann verbindet sich der Systemkonnektor zu einem Remote Connector auf einem entfernten Rechner Es kann nicht jeder Systemkonnektortyp als Remote Connector genutzt werden Diese Option ist nur aktiv wenn der Systemkonnektor als Remote Connector genutzt werden kann Systemkonnektoren die als Listener konfiguriert sind k nnen grunds tzlich nicht als Remote Connector betrieben werden Der Button Konfiguration ffnet den Dialog Remote Connector Konfiguration Workbench Process Engine Systemkonnektor Guide Kap 1 1 5 S 25 In diesem Dialog konfigurieren Sie die URL des Remote Connectors und Authentifizierungsdaten und k nnen die Verbindung testen F r mehr Informationen ber die Installation und Konfiguration eines Remote Connectors siehe Remote Connector Process Engine Administrator und Entwickler Guide Kap 13 S 153 Behandlungvon m Anzahl der Wiederholversuche verbindungstehlem Gibt an wie oft der Systemkonnektor versuchen soll eine Verbindung zu dem anzusprechenden System aufzubauen Wenn die Verbindung nicht wiederhergestellt werden kann wird ein Fehler geworfen Zeitabstand der Wiederholversuche Zeitintervall zwischen den einzelnen Versuchen eine Verbindung mit dem System herzustellen Timeout in Sek Standard Timeout Zeit die das Modul auf die Herstellung der Verbindun
205. ch Systemkonnektoren Workbench Process Engine Systemkonnektor Guide Kap 1 S 19 Module anlegen Workbench Benutzer Guide Kap 3 3 S 129 Technical Workflow Diagramme Workbench Benutzer Guide Kap 12 S 311 Bei der Ausf hrung eines FTP Connectors werden folgende Variablen gesetzt ReadFileDate Letztes Anderungsdatum der Eingangsdatei Format dd mm yyyy hh mm ss ReadFileName Name der Eingangsdatei mit Extension ReadFileSize Gr e der Eingangsdatei in Bytes ReadFileWildcardname Gibt den Inhalt der Wildcard aus die beim Konfigurieren des FTP Connectors im Dateinamen verwendet wurde WriteFileDate Nur beim FTP Output Connector inubit 6 1 Workbench Process Engine Systemkonnektor Guide 05 09 2013 134 FTP Connector Dialogbeschreibungen Erzeugungsdatum der Ausgabedatei Format dd MM yyyy HH mm ss WriteFileName Name der Ausgabedatei WriteFileWildcardname Nur beim FTP Output Connector wenn im zu erzeugenden Dateinamen z B Timestamp oder Wildcard verwendet werden Gibt den Inhalt der Wildcard aus die beim Konfigurieren des FTP Output Connectors im Dateinamen verwendet wurde Siehe Workflow Variablen und Mappings Workbench Benutzer Guide Kap 14 S 383 11 2 Dialogbeschreibungen Dieser Abschnitt erlautert die folgenden Themen Dialog FTP Connector Eigenschaften S 134 Dialog FTP Kommandos ausf hren S 137 Dialog Input Dateinamen definieren S 138
206. ch dem angegebenen Namen und erh lt eine Referenz auf das registrierte Objekt Topic No Local Blockiert den Empfang von Nachrichten die ber die eigene Verbindung ausgeliefert wurden m Message Acknowledgment Zur Auswahl des Kontroll Levels bei der Bestatigung von Nachrichten Es gibt folgenden Bestatigungsarten AUTO_ACKNOWLEDGE Die JMS Sitzung best tigt automatisch dass der Client die Nachricht erhalten hat Entweder wenn der Client erfolgreich einen Aufruf zum Nachrichtenerhalt durchgefuhrt hat oder wenn der Aufruf des Listeners zum Empfang einer Nachrichten gef hrt hat CLIENT_ACKNOWLEDGE Best tigung auf Session Ebene Ein Client best tigt eine Nachricht durch den Aufruf der Best tigungsmethode der Nachricht DUPS_OK_ACKNOWLEDGE Weist die JMS Session an die Auslieferung einer Nachricht lazy zu best tigen Das f hrt im Allgemeinen zur Auslieferung einer weiteren Kopie der Nachricht wenn der JMS Provider nicht direkt best tigt Sollte nur von Clients verwendet werden die Nachrichtenkopien zulassen inubit 6 1 Workbench Process Engine Systemkonnektor Guide 05 09 2013 196 JMS Connector Dialogbeschreibungen Dauerhafte Subskription Verbindungstest Nur wenn das Kommunikationsmodell Publish Subscribe gew hlt ist Die dauerhafte Subskription ist ein Sonderfall des Publish Subscribe Kommunikationsmodells Empf nger m ssen sich beim JMS Provider einschreiben aber nicht st ndi
207. ch Process Engine Systemkonnektor Guide Kap 18 2 1 S 191 im Feld URL des JNDI Servers die URL des entfernten Queuing Servers ein 18 2 Dialogbeschreibungen Dieser Abschnitt erl utert die folgenden Themen 05 09 2013 Dialog Verbindungskonfiguration S 191 Dialog Kommunikationsmodell S 193 Dialog Nachrichten Selektor S 196 Dialog Zus tzliche Eigenschaften S 197 inubit 6 1 Workbench Process Engine Systemkonnektor Guide JMS Connector 191 Dialogbeschreibungen 18 2 1 Dialog Verbindungskonfiguration Grundkonfiguration Lu In diesem Dialog geben Sie die Eigenschaften an die f r Verbindungen zu einem JNDI Java Naming and Directory Interface Provider gebraucht werden JMS benutzt das JNDI um die ben tigten Ressourcen zu finden Voreingestellte JNDI Konfiguration benutzen Zu markieren wenn Sie die Datei jndi properties in Ihrem Classpath haben und die dort angegebenen Eigenschaften verwenden m chten URL Prefix Naming Context Factory Standardwerte f r die g ngigsten JMS Provider JBoss URL localhost 1099 Prefix org jboss naming Naming Context Factory org jnp interfaces NamingContextFactory MQSeries URL ldap lt name gt 389 lt LDAP DN gt Prefix com ibm jndi NamingContextFactory com sun jndi ldap LdapCtxFactory SonicMQ ContextProviderUrl file localhost d sonicmq ContextUrlPrefixes lt empty gt NamingContextFactory co
208. ch Process Engine Systemkonnektor Guide RosettaNet HTTPS Connector 315 Beispiel Workflow RosettaNet Nachrichten versenden fehlenden Infos werden den Konfigurationsdaten bernommen die beim Anlegen des Connectors angegeben wurden Zus tzlich wird der Instanz Identifier erzeugt und hinzugef gt 3 Die f r jede Nachricht generierte ID wird in der Indexdatei ListofGeneratedIds xml im Arbeitsverzeichnis gespeichert Danach sendet der Output Connector die Nachricht an den Empf nger und h lt sie solange im Workflow bis die Best tigung eingegangen ist Fehler E Mail versenden Der Fehlerausgang wird angesteuert wenn die Business Message das letzte Mal gesendet wurde und immer noch keine Best tigung f r die Nachricht eingegangen ist Dann wird ber das Mail Connector Modul eine Nachricht gesendet welche dar ber informiert dass das Versenden der Business Message fehlgeschlagen ist Demultiplexer Zus tzlich wird die Nachricht dem Demultiplexer bergeben der die DistributeRNOutput Nachricht entweder an ein Dummy Modul oder an den Multiplexer WaitUntilAcknowlegde weiterleitet m Wenn der XPath RosettaNetConnector AcknowledgeReceived nicht leer ist dann erhalt das Dummy Modul die Eingangsnachricht Das bedeutet dass die Nachrichtenbestatigung am Output Connector angekommen und keine weitere Aktion notwendig ist m Wenn der XPath RosettaNetConnector Retry leer ist dann erh lt der Multiplexer WaitUntil
209. chen Als Archiv Prozessor sch tzt ein DBO Input Connector ein Event Archiv vor dem berlauf Der Konnektor pr ft im angegebenen Intervall ob die Event Tabelle Events enth lt die lter sind als zul ssig Wenn solche Events vorhanden sind l scht der Konnektor diese aus dem Archiv und gibt sie als Ausgangsnachricht aus So gehen Sie vor 1 Erstellen Sie einen DBO Input Connector 2 Aktivieren Sie den Scheduler um das Abfrage Intervall f r die Event Archiv Tabelle festzulegen 3 Konfigurieren Sie im Dialog Datenbankeinstellungen Workbench Process Engine Systemkonnektor Guide Kap 7 6 1 S 104 die Datenbankverbindung und testen Sie diese 4 Geben Sie die Plugin ID des DBO Input Connectors an der die Events berwacht und archiviert 5 Markieren Sie die Option Archiv Prozessor um die Funktion des DBO Connectors festzulegen 6 Geben Sie den Namen der Event Archiv Tabelle an die berwacht werden soll 7 Geben Sie im Feld Archiv Fenster an wie lange Events max in der Event Archiv Tabelle aufbewahrt werden sollen 8 Klicken Sie auf Weiter Ein weiterer Dialog wird angezeigt 9 Klicken Sie auf Fertig stellen um die Konfiguration des Konnektors zu beenden 7 4 Konfigurationsdatei Feldbeschreibungen Element Attribute Name Bedeutung DBStructure DBStructureName Obligatorisch Eindeutiger Name des Ele Description ments DBStructure DeleteObsoleteChilds Obligatorisch Obsolete Kindelemente sol Descript
210. chgefuehrtePruefungen H 6 Details lt gt YerificationResult ean a Workflow Variablen Name IsWorkflowName Doku_Secrypt secrypt result VALID workflowStarter MDS ae418ba5fb868e Nach der Pr fung wird das Eingangsdokument in eine XML Datei eingebettet Element InputDocument Das Pr fergebnis wird im Element lt Pruefergebnis gt angezeigt 31 3 Modulvariablen Bei der Ausf hrung eines Secrypt Connectors werden die folgenden Modulvariablen gesetzt Modulvariable Inhalt secrypt result Pr fergebnis secrypt certificationLevel advanced Signaturtyp qualified 31 4 Dialog Secrypt Connector Eigenschaften In diesem Dialog haben Sie folgende Optionen inubit 6 1 Workbench Process Engine Systemkonnektor Guide 05 09 2013 346 Secrypt Connector Dialog Secrypt Connector Eigenschaften Grundkonfiguration m Pfadkonfiguration des m Signaturservers Modus Markieren Sie eine der beiden Optionen um die Funktion des Secrypt Connectors zu definieren Signieren Das Dokument wird mit einer elektronischen Signatur versehen Pr fen Die Signaturen des Dokuments werden gepr ft Eingangspfad Pfad zu dem Verzeichnis in dem der Signaturserver die Dokumente zum Signieren Pr fen erwartet z B C IS Repository Signatur Verifier Input Ausgangspfad Pfad zum Verzeichnis in dem der Signaturserver die signierten bzw gepr ften Dokumente bereit stellt C IS_
211. chrichtigung konfiguriert werden Die Funktionen des SNMP Connectors sind von der Konfiguration abh ngig Input Connector Ubermittelt statisch OID Werte Paare aus einer Tabelle Medium Connector bermittelt dynamisch OID Werte Paare aus der XML Eingangsnachricht Siehe auch Systemkonnektoren Workbench Process Engine Systemkonnektor Guide Kap 1 S 19 Module anlegen Workbench Benutzer Guide Kap 3 3 S 129 Technical Workflow Diagramme Workbench Benutzer Guide Kap 12 S 311 Viele Netzwerkkomponenten enthalten Programme Uber die SNMP Kommunikation m glich ist Diese sogenannten Agenten die direkt auf dem berwachten Ger t laufen k nnen den Zustand des Ger ts bermitteln und Daten zur Konfiguration der Netzwerkkomponente empfangen und umsetzen inubit 6 1 Workbench Process Engine Systemkonnektor Guide 05 09 2013 364 SNMP Connector Funktionsprinzip Kommunikation Datenpakete OID 05 09 2013 Zur berwachung von Komponenten in einfachen und komplexen IT Netzwerken wird ein SNMP Server eingesetzt Die Agenten der Netzwerkkomponenten kommunizieren ber SNMP mit dem Server Die Kommunikation ber SNMP basiert auf dem verbindungslosen User Datagram Protocol UDP das den Datenpaketen von SNMP nur noch die Adressierung hinzuf gt und daher kaum Bandbreite ben tigt Standardm ig kommunizieren die Agenten ber Port 161 und der SNMP Manager ber Port 162 Die Struktur
212. chron an einen Callback Listener Connector gesendet werden soll inubit 6 1 Workbench Process Engine Systemkonnektor Guide Web Services Connector 457 Dialogbeschreibungen Antwort URL wsa ReplyTo Dieses Feld ist mit einer URL vorbelegt die den Namen des Moduls das Sie gerade anlegen und das Suffix Callback enth lt Diese URL wird f r die Kommunikation zwischen dem aufrufenden A Modul und dem Callback Listener bendtigt Die URL entspricht der Service URL des Callback Listener Connectors Sie m ssen die URL manuell anpassen wenn sich die Service URL des Callback Listener Connectors geandert hat 40 16 3 3 Register XML Schemas Input Listener Connector Dieses Register zeigt alle XML Schemas an die im Web Service verwendet werden Sie k nnen vorhandene Schemas z B aus dem Repository importieren oder im Typ Editor neue Schemas erstellen Siehe Editor verwenden Workbench Benutzer Guide Kap 1 14 S 60 Repositorydateien ber URL oder Pfad ansprechen Workbench Benutzer Guide Kap 19 10 S 522 40 16 3 4 Register WSDL Editor Input Listener Connector Im Register WSDL Editor wird die WSDL Datei angezeigt die aus dem Web Service erstellt wird der im Register Bereitgestellter Service definiert ist Sie k nnen diese WSDL bearbeiten oder eine vorhandene WSDL laden f Wenn Sie eine vorhandene WSDL laden werden fast alle Angaben in Q dem Register
213. cht das root Element und die ID eines Gesch ftsobjekts und gibt die Details des Gesch ftsobjekts inkl der Namensraum Angaben aus Standardm ig werden auch die Objekt IDs ausgegeben dieses Verhalten k nnen Sie abschalten Siehe Standard ID ausgeben Workbench Process Engine Systemkonnektor Guide Kap 5 S 58 Voraussetzungen Die Struktur des Gesch ftsobjekts ist konform zu dem XML Schema sein das im BO Connector definiert ist 05 09 2013 inubit 6 1 Workbench Process Engine Systemkonnektor Guide Business Object Connector 51 Querymodus verwenden Beispiel f r Eingangsnachricht Repository Dates ben Repository Datei bearbeiten Hier k nnen Sie den Inhalt der Datei bearbeiten Nach jeder nderung wird eine neue Version der Datei im Repository erzeugt 41 B E Q inubitrepository Reot jh readObject243 2xml 3 Bestellung bo ObjectId 243 xmins bo http inubit com bo Beispiel f r Ausgangsnachricht iS ibis_root jh tmp 675_BOC_17082010_135854_WThread 7 722290530 1 In diesem Dialog werden die Nachricht oben und die aktuell vorhandenen Workflow Variablen und die Workflow Variablen speichern um diese in weiteren Tests wiederzuverwenden BB Nachricht HEJA 3 Bestellung bestelldatum 20 10 08 17 bo ObjectId 243 xmins bo http finubit com bo EI A8 Lieferadresse land DE bo Objectid 244 G Name Alice Schmid 9 Stra e Walnussgasse 42 Z Or
214. cht nur das XML Element lt result gt Die Eingangsnachricht wird nicht ausgegeben Dient der bersichtlichkeit und Performance bei gro en XML Eingangsnachrichten inubit 6 1 Workbench Process Engine Systemkonnektor Guide 3 ii Connector 181 Dieser Abschnitt erlautert die folgenden Themen Funktionsprinzip S 181 Eingangsnachricht erstellen S 182 Beispiel Eingangsnachricht S 184 Dialog J2EE Connector Architecture Adapter S 185 Verwendung Mit dem JCA Connector J2EE Connector Architecture k nnen Sie beliebige Applikationen in die inubit Software integrieren Siehe auch 171 Funktionsprinzip Voraussetzungen m Systemkonnektoren Workbench Process Engine Systemkonnektor Guide Kap 1 S 19 Module anlegen Workbench Benutzer Guide Kap 3 3 S 129 Technical Workflow Diagramme Workbench Benutzer Guide Kap 12 S 311 Die inubit Process Engine muss im JBoss betrieben werden F r die Kommunikation mit der entfernten Applikation ben tigen Sie einen Resource Adapter Diesen erhalten Sie als rar Datei von dem Hersteller der Applikation die Sie integrieren m chten Der Resource Adapter muss auf denselben JBoss deployt sein wie die inubit Process Engine Sie m ssen die JCA Library jar Datei auf die inubit Process Engine laden um den JCA Connector Explorerassistenten nutzen zu k nnen Die JCA Library ist in der rar Datei des Resource Adapters enthalten Siehe Plug i
215. chtfeld zul ssige Werte Erl uterung type Nein subselect force subselect Zum Ausf hren einer Subquery force Die automatische Typerkennung wird f r dieses Feld ausgeschaltet Der Text von lt fieldValue gt wird direkt an die Datenbank bergegeben Z B sinnvoll um Datenbankfunktionen wie AVG oder MAX ausf hren zu lassen lt conditions gt nicht f r INSERT Umschlie endes XML Element f r die WHERE Bedingung eines SQL Statements Mehrere lt conditions gt Elemente k nnen geschachtelt werden um Statements zu gruppieren oder zu klammern EI a conditions condition D NUMBER 0 conditions Ei va condition D AMOUNT gt 0 E condition sll WALUE IS NULL J h ag lt condition gt Werte f r ein Kriterium in der WHERE Bedingung eines SQL Statements Kann mehrfach auftreten Attribute Pflichtfeld zul ssige Werte Erl uterung type Ja AND OR NOT Wert f r die Verkn pfung mit anderen Kri AND NOT OR NOT terien in weiteren lt condition gt Ele menten Standard ist AND lt leftValue gt Spaltenname auf der linken Seite eines Kriteriums in einer WHERE Bedingung lt operation gt Operator innerhalb eines Kriteriums in einer WHERE Bedingung z B lt gt gt lt IN NOT IN lt rightValue gt inubit 6 1 Workbench Process Engine Systemkonnektor Guide 05 09 2013 68 Database Connector XML Querys Struktur
216. ction message wird im PIP angegeben siehe Service Header signal messages sind Empfangsbest tigungen bzw Fehlermeldungen Attachments Wenn die Nachricht eine action message ist kann diese einen oder mehrere Anh nge enthalten Alle Teile einer Business Message sind im MIME S MIME Nachrichtenformat komprimiert Best tigungen Der Empfang von RosettaNet Nachrichten wird durch Best tigungen bzw Fehlermeldungen signalisiert Empfangsbest tigungen k nnen synchron oder asynchron versendet werden Transportprotokolle F r den Nachrichtentransport k nnen die Protokolle HTTP und HTTPS benutzt werden __ Asynchroner Grunds tzlich unterst tzt das PIP Modell den asynchronen Nachrichtenaustausch Nachrichtenaustausch der wie folgt abl uft 1 Gesch ftspartner A schickt eine RosettaNet Nachricht an Gesch ftspartner B Diese Nachricht enth lt eine sog PIP ID ber welche die Nachricht eindeutig identifiziert werden kann 2 B speichert eine Kopie der Nachricht um den Erhalt nachweisen zu k nnen 3 B sendet eine Best tigung an A Nun gibt es zwei M glichkeiten Aerhalt die Best tigung Aerhalt keine Best tigung innerhalb des vereinbarten Zeitraums Dann sendet A die Nachricht noch einmal B empf ngt die Nachricht B berpr ft ob die Nachricht vorher bereits empfangen wurde weil B sicher stellen muss dass Nachrichten exakt einmal verarbeitet werden Dazu wird die PIP ID der eingegangene
217. ction gt setSpeed lt action gt lt target gt 500 lt target gt lt value gt inubit 6 1 Workbench Process Engine Systemkonnektor Guide Selenium Connector 359 Funktionsprinzip lt command gt lt command gt lt action gt open lt action gt lt target gt lt target gt lt value gt lt command gt lt command gt lt action gt type lt action gt lt target gt q lt target gt lt value gt inubit lt value gt lt command gt lt command gt lt action gt clickAndWait lt action gt lt target gt btnG lt target gt lt value gt lt command gt lt suite gt lt script gt In der Eingangsnachricht muss die base ur1 der zu testenden Applikation angegeben werden diese URL muss gesetzt werden um Pfadangaben relativ zu machen denn so konnen Tests auch unabh ngig vom Ort der Applikation ausgef hrt werden F r eine korrekte Ausf hrung m ssen die Domains im base url Element und im open Element identisch sein Siehe Fehlerbehandlung Workbench Process Engine Systemkonnektor Guide Kap 33 2 S 360 Templates f r Eingabe und Ausgangsnachrichten finden Sie im W Repository unter Repository gt Global gt System gt Mapping Templates gt Selenium Connector Verarbeitung Die Eingangsnachricht bergibt der Selenium Connector dem Selenium Server Dieser f hrt die Test Befehle aus und bergibt dem Connector die Zusammenfassung der Test Resultate Diese Log Daten gibt
218. ctor nicht gemeinsam mit dem OFTP Connector Der OFTP2 Connector wird genutzt um Gesch ftsdaten gem dem Odette File Transfer Protocol Version 2 0 OFTP2 auszutauschen OFTP2 bietet die M glichkeit eine Verbindung nach dem Abbruch wieder aufzusetzen ohne die gesamte Datei erneut zu bertragen Es k nnen ASCII und EBCDIC Dateien bertragen werden Siehe auch Systemkonnektoren Workbench Process Engine Systemkonnektor Guide Kap 1 S 19 Module anlegen Workbench Benutzer Guide Kap 3 3 S 129 Technical Workflow Diagramme Workbench Benutzer Guide Kap 12 S 311 rvsEVO der Firma T Systems International GmbH muss installiert und konfiguriert sein Dabei m ssen Ubertragungsparameter eingestellt und Stationen mit einer definierten Station ID eingerichtet werden Die Software besteht aus dem rvsEVO Server und einer Client Komponente Sie kann sowohl ber das Benutzerinterface der Client Komponente als auch Uber das Benutzerinterface des rvsEVO Servers konfiguriert werden Erfragen Sie unbedingt bei Bosch Software Innovations GmbH welche rvs Version Sie fur Ihre Installation ben tigen inubit 6 1 Workbench Process Engine Systemkonnektor Guide 05 09 2013 252 OFTP2 Connector Funktionsprinzip 24 2 Funktionsprinzip inubit Suite OH Nachrichtenfluss Sie haben die folgenden Dateien der rvs Client Komponente in das Verzeichnis lt iS installdir gt server Tomcat webapps ibis WEB
219. d klicken Sie auf Weiter um zum Register System Connector Eigenschaften zu gelangen W hlen Sie auf dem Register System Connector Eigenschaften f r Verwendung den Eintrag Web Service Aufrufe empfangen Web Service bereitstellen W hlen Sie Aktiv als Connector Status und klicken Sie auf Weiter um zum Register Bereitgestellter Web Service zu gelangen W hlen Sie eine WSDL Bindung bzw neu den Typ und den Bindungs Stil Passen Sie ggf den Namensraum und die Bindungseinstellungen an Siehe Operationen eines Web Services erstellen Workbench Process Engine Systemkonnektor Guide Kap 40 10 S 440 Dialog Bereitgestellter Web Service Workbench Process Engine Systemkonnektor Guide Kap 40 16 1 S 451 Klicken Sie auf Weiter um zum Register Modul Editor zu gelangen Wechseln Sie ggf auf das Register Bereitgestellter Web Service und klicken Sie auf den Button Operation hinzuf gen Benennen Sie die Operation z B SayHello und w hlen Sie ggf als Art Anfrage Antwort Klicken Sie auf OK Aktivieren Sie auf dem Register Erweitert die Checkbox Unterst tzung f r asynchronen Antwort Versand SOAP Nachricht speichern So gehen Sie vor 1 Wechseln Sie auf das Register SOAP Nachricht inubit 6 1 Workbench Process Engine Systemkonnektor Guide 05 09 2013 428 Web Services Connector Asynchrone We
220. d oder im Technical Workflow selbst aktiviert ist dann wird die kleinste Angabe verwendet 05 09 2013 Sobald das Input Output Message Logging aktiviert ist k nnen Sie festlegen wie viele Nachrichten aufbewahrt werden sollen Anzahl Messages Zum Festlegen der Anzahl der Dateien an die aufbewahrt werden soll Falls diese Anzahl im Verlauf der Workflow Verarbeitung berschritten wird dann werden die ltesten Nachrichten gel scht bis die vorgegebene Anzahl wieder erreicht ist Synchronisiere mit System Log Wenn diese Option markiert ist dann werden die Nachrichten so behandelt wie bei der Option System Logging im Diagramm angegeben Siehe System Logging Workbench Benutzer Guide Kap S 120 Wenn die Option System Logging nicht markiert ist dann werden die Standard Einstellungen verwendet die in der Datei lt inubit installdir gt server ibis root conf logsDBConfig xmlim Element dataEntriesLimit festgelegt sind Dialog Zeitgesteuerte Verarbeitung Systemkonnektoren k nnen zeitgesteuert ausgef hrt werden In diesem Dialog legen Sie Startzeiten oder Startintervalle fest Systemkonnektoren starten nur zeitgesteuert wenn der dazu geh rige Technical Workflow auf eine inubit Process Engine publiziert und aktiviert wurde Im lokalen Modus und im Test Modus werden zeitgesteuerte Systemkonnektoren nicht gestartet Scheduler Aktivierung inubit 6 1 Workbench Process Engine Syste
221. dem beliebigen Modul k nnen Sie einen Solution Center Logger in den Workflow einf gen Solution Center Logger konfigurieren Die Attribute des zu erstellenden Ereignisobjekts konfigurieren Sie ber die Moduleigenschaften im Wizard oder ber das Variablen Mapping Automatisches Erstellen von Ereignisobjekten Ein Solution Center Logger erstellt bei jedem Durchlauf ein Ereignisobjekt Die Ereignisobjekte erscheinen im Solution Center direkt unterhalb des Prozessobjekts der Process Solution inubit 6 1 Workbench Process Engine Systemkonnektor Guide 05 09 2013 388 Solution Center Logger Eigene Event Typen erstellen 36 2 Eigene Event Typen erstellen So gehen Sie vor 1 ffnen Sie das zugeh rige BOD Ihrer Process Solution zum Bearbeiten 2 ffnen Sie das Register Basis Schemas in der Palette Externe Elemente 3 Ziehen Sie eine der Klassen bfm3 BusinessEvent oder bfm3 Milestone in den Rahmen Bewegungsdaten 4 Erstellen Sie weitere Event Klassen 5 Verbinden Sie die neuen Klassen mit der jeweiligen Elternklasse bfm3 BusinessEvent oder bfm3 Milestone ber eine Generalisierung 6 Publizieren Sie das BOD Deployen Sie das BOD in das Solution Center mit einem Klick auf das Icon Nach dem Deployment des BODs stehen die neuen Event Typen im Solution Center Logger zur Verf gung Event Typ Workbench Process Engine Systemkonnektor Guide Kap 36 S 388 36 3 Dialog
222. den FTP Server einen eigenen Bereich mit erforderlichem Login haben tragen Sie die Login Daten in die entsprechenden Felder ein Um anonym auf den FTP Server zugreifen k nnen klicken Sie auf den Button Anonymer Zugang Dann werden der Benutzername anonymous und das Passwort anonymous example com automatisch gesetzt Implizites FTPS benutzen Beschreibt eine ltere FTPS Version die in der aktuellen Spezifikation nicht mehr enthalten ist Fragen Sie den Administrator des FTPS Servers ob Implizites FTPS vorliegt Dieses FTPS l uft standardm ig auf Port 990 Die nachfolgenden Felder gelten f r das aktuelle FTPS und das Implizite FTPS gleicherma en Sicherungsart W hlen Sie ein Protokoll f r die Daten bertragung aus SSL oder TLS Secure Sockets Layer und Transport Layer Security TLS 1 0 und 1 1 sind die standardisierten Weiterentwicklungen von SSL 3 0 Beide stellen FTPS Sicherheitsmechanismen zur Absicherung der Verbindungen zur Verf gung TLS_C TLS inkl Kompression der verschl sselten Daten Abgesicherte Daten bertragung Standardm ig werden bei FTPS nur die Steuerbefehle verschl sselt bertragen Der FTP Connector kann zus tzlich Daten verschl sselt bertragen Wenn aktiviert dann werden Daten verschl sselt bertragen SSL Konfiguration F r die Server und oder Client Authentifizierung ffnet den Dialog SSL Konfiguration Workbench Process Engine Systemkonnektor Guide Kap
223. den SAP Explorer Erzeugen und publizieren Sie zuerst den SAP Connector damit WY dessen Verbindungsdaten zum SAP System automatisch bernommen werden k nnen Andernfalls m ssen Sie die Verbindungsdaten manuell eingeben So gehen Sie vor 1 Erzeugen Sie einen XSLT Converter 2 ffnen Sie das Modul im lokalen Arbeitsverzeichnis zum Bearbeiten Das Register XSLT Converter wird angezeigt 3 ffnen Sie im Bereich XML Zieldatei das L Men 4 W hlen Sie ffnen von gt SAP Explorer Der folgende Dialog ffnet sich iS SAP Explorer x Yerbindungsdaten zum SAP System Zur bernahme der Yerbindungsdaten aus einem existierenden SAP Connector Modul w hlen Sie das entsprechende Modul aus der Liste aus Die Verbindungsdaten werden dadurch automatisch bernommen Alternativ k nnen Sie die Verbindungsdaten auch manuell eingeben Einstellungen bernehmen von Modul BaP Listener Async X System Informationen Hostname sapix inubit com System Nummer nn Login Informationen Client ooo Benutzer JecuseR DO Passwort Pe Sprache DE der Zur ck w Fertig stellen X Abbrechen In diesem Dialog werden die Verbindungsdaten zum SAP System angezeigt 05 09 2013 inubit 6 1 Workbench Process Engine Systemkonnektor Guide SAP Connector 333 XML Request Response erstellen W hlen Sie aus der Liste Modul das SAP Modul mit den passenden Verbindungsdaten o
224. der LDAP Server ein anonymes Login unterst tzt Login Wenn Sie kein anonymes Login verwenden geben Sie Ihre Benutzerkennung f r den LDAP Server an Passwort Geben Sie das zu Ihrer Benutzerkennung geh rende Passwort an Klassenname Vorbelegt mit der Standard Java Klasse welche mit der inubit Software ausgeliefert wird Um eine andere Klasse f r den LDAP Namens und Verzeichnisdienst zu verwenden geben Sie den Klassennamen ein Stellen Sie sicher dass die angegebene Klasse im Java Classpath vorhanden ist Behandlung Referenzen Legen Sie fest wie Referenzen auf andere Verzeichnisse behandelt werden sollen Folgen Jeder Referenz automatisch folgen Ignorieren Standard Referenzen ignorieren Verbindung testen Zum Testen ob die Verbindung mit Ihren Angaben erfolgreich aufgebaut werden kann inubit 6 1 Workbench Process Engine Systemkonnektor Guide 20 Livelink PDMS Connector i Verwendung Konnektortypen Dieser Abschnitt erl utert die folgenden Themen a JAR Dateien installieren S 205 Inhalt und Struktur der Eingangs und Ausgangsnachrichten S 206 Dialog Livelink PDMS Connector Eigenschaften S 214 Mit dem Livelink PDMS Connector verbinden Sie die inubit Process Engine mit einem Livelink Archive Server Sie k nnen mit dem Konnektor auf archivierte Daten und Dokumente im Production Document Management System PDMS zugreifen bzw Daten dort ablegen Ein Livelink Co
225. der SNMP Datenpakete ist bei der Benutzung des SNMP Connectors transparent F r die Konfiguration des Connectors m ssen nur die Verbindungsdaten die Art des Datenpakets und die OID bekannt sein Von den sechs verschiedenen Datenpaketen die im SNMP Standard definiert sind werden f r den SNMP Connector nur vier ben tigt Die Datenpakete sind nach den Methoden benannt die mit ihnen ausgef hrt werden Der SNMP Connector unterst tzt die Operationen GET GETNEXT SET und TRAP Jeder Agent kennt die Menge der Parameter seiner Netzwerkkomponente ber diese kann entweder eine Statusmeldung erfolgen Trap oder die Konfiguration ge ndert werden Diese Parameter werden Managed Objects genannt Alle Managed Objects werden in einer tabellenartig angelegten Liste gehalten nicht in einer Datenbank Diese Liste hei t Management Information Base MIB Jedem Managed Object in der MIB wird eine Object Identifier OID zugeordnet Der Object Identifier ist eine Zeichenkette die sich aus Zahlen und Punkten zusammensetzt Dabei folgt der Aufbau der Zeichenkette einer Struktur die sich aus dem sogenannten MIB Baum zusammensetzt Siehe http de wikipedia org wiki SNMP f r eine Abbildung des MIB Baums In diesem Nummerncode gibt es auch einen Teil der f r die Firma steht Die Bosch Software Innovations GmbH hat die 15899 f r die inubit Software erhalten damit lautet der Anfang von OIDs im Klartext iso org dod internet pri
226. der Selenium Connector als Ausgangsnachricht aus Ausgangsnachricht lt result gt lt suite gt lt command display setSpeed 500 duration 31 gt 0K lt command gt lt command display open duration 813 gt 0K lt command gt inubit 6 1 Workbench Process Engine Systemkonnektor Guide 05 09 2013 360 Selenium Connector Fehlerbehandlung 33 2 Fehler lt command display type q duration 500 gt OK lt command gt lt command display clickAndWait btnG duration 1062 gt OK lt command gt lt suite gt lt lastlogs gt lt lastlog gt CDATA 13 24 42 413 org mortbay util Container Startet lt lastlog gt a lt lastlogs gt lt result gt Fehlerbehandlung Ursache INFO 10 11 L sung You appear to be changing domains from http XXX to http ZZZ Wenn keine Basis URL angegeben ist benutzt die inubit Software die Vor auswahl des RC Servers Manche Browser werten den Wechsel von der Vorauswahl zu der URL die im Element lt open gt angegeben ist als Cross Site Scripting und verhin dern die weitere Ausf hrung oder l sen einen Fehler aus Geben Sie die Basis URL in der Eingangs nachricht im Element base url an z B lt base url gt http www google com lt base url gt Danach muss das open Element mit der base url identisch sein da sonst der selbe Fehler wieder auftritt Connection re fused connect 05 09 2013 Der
227. der an 2 Kopieren Sie die Datei in das Verzeichnis lt inubit installdir gt Tomcat webapps ibis WEB INF lib 3 Starten Sie Tomcat neu Geben Sie beim Konfigurieren des JMS Connectors im Dialog Verbindungskonfiguration Workbench Process Engine Systemkonnektor Guide Kap 18 2 1 S 191 im Feld URL des JNDI Servers die URL des entfernten Queuing Servers ein inubit 6 1 Workbench Process Engine Systemkonnektor Guide 05 09 2013 190 JMS Connector Dialogbeschreibungen 18 1 2 JMS Connector in Enterprise Enterprise Plus Edition mit beliebigem JMS basierten Queuing Server einsetzen Um den integrierten JBoss Applikationsserver Ihrer Enterprise oder Q Enterprise Plus Edition oder einen entfernten JBoss einer anderen Enterprise oder Enterprise Plus Edition als Queuing Schnittstelle zu nutzen sind keine weiteren Schritte n tig Wenn Sie die Queuing Schnittstelle eines beliebigen anderen JMS basierten Queuing Servers nutzen m chten ben tigen Sie zus tzlich eine jar Datei als Kommunikationsbr cke zwischen Ihrer inubit Process Engine und dem entfernten Queuing Server So gehen Sie vor 1 Fordern Sie die Datei provider jar bei Ihrem JMS Provider an Kopieren Sie die Datei in das Verzeichnis lt inubit installdir gt server JBoss server default deploy ibis ear lib Starten Sie JBoss neu Geben Sie beim Konfigurieren des JMS Connectors im Dialog Verbindungskonfiguration Workben
228. der geben Sie die Verbindungsdaten manuell ein 5 Klicken Sie auf Weiter Der folgende Dialog wird angezeigt iS SAP Explorer x Templateauswahl w hlen Sie das zu erstellende Template aus Templates Ce RFC BAPI IDoc w Fertig stellen i gt Weiter X Abbrechen Markieren Sie eine der Optionen 6 Klicken Sie auf Weiter Die folgenden Dialoge sind abh ngig von der Art des ausgew hlten Templates Bei Auswahl RFC BAPI inubit 6 1 Workbench Process Engine Systemkonnektor Guide 05 09 2013 334 SAP Connector XML Request Response erstellen iS SAP Explorer x Suche und Auswahl Hier k nnen Sie im SAP Repository nach einem Funktionsmodul suchen welches Sie aufrufen m chten Bitte geben Sie dazu einen Funktionsnamen und oder eine Funktionsgruppe ein F r die Suche k nnen Sie als Wildcard das Zeichen 3 verwenden Suche Funktionsname JBAPT_BANK Funktionsgruppe Suchen Auswahl der Funktion Gruppe Beschreibung BAPI_BANK_CHANGE 1011 Bank ndern BAPI_BANK_CREATE 1011 Bank anlegen BAPI_BANK_GETDETAIL 1011 Detailangaben Banken BAPI_BANK_GETLIST 1011 Liste von Banken BAPI_BANK_SAVEREPLICA 1011 Einzelne Banken replizieren ALE Art des XML Templates Request Response J Fertig stellen X Abbrechen 05 09 2013 Dieser Dialog unterst tzt Sie bei der Auswahl der Funktion f r die Si
229. die Anmeldungen gegen die folgenden Benutzerverwaltungen pr ft inubit 6 1 Workbench Process Engine Systemkonnektor Guide 05 09 2013 356 Security Token Service Connector Dialog Security Token Service WS Trust Gesicherte Service Provider 05 09 2013 Wenn Sie beide Optionen markieren dann werden beide Benutzerverwaltungen gepr ft Die Pr fung wird als erfolgreich gewertet wenn die Pr fung in einer der beiden Benutzerverwaltungen erfolgreich ist Interne Benutzerverwaltung Die Authentifizierung ist nur fur Consumer m glich die als inubit Benutzer vorhanden sind Authentifizierung durch Workflow Die Authentifizierung der Consumer erfolgt durch einen Workflow gegen ein Backendsystem wie z B ein LDAP Verzeichnis Den Workflow m ssen Sie selbst entsprechend erstellen Wenn ein Workflow definiert ist dann erzeugt das letzte Modul des Workflows eine Ausgangsnachricht mit einer SAMLAssertion Workflowvariable Diese Variable enth lt Authorisierungsdaten Die Daten werden dem Service Provider bergeben und k nnen f r rechteabh ngige Implementierungen genutzt werden Zum Registrieren der Web Services URI des Provider Endpoints URL des registrierten Web Service ffentlicher Schl ssel ist g ltig bis Die Information ber die G ltigkeit des ffentlichen Schl ssels ist im X 509 Zertifikat gespeichert welches beim Registrieren eines Service Providers hinzugef gt wird Schl ssel Informationen
230. die Adresse der WSDL in die Zwischenablage Publizierte Services anzeigen ffnet die Webseite http lt myServer gt 8000 ibis listServices und zeigt alle aktiven Web Services der inubit Process Engine an Name und Port Typ der WSDL Bindung sind nderbar Typ und Bindungs Stil sind nicht nderbar Name Name der WSDL Bindung Port Typ Name des WSDL Elements wsdl portType Diese beiden Felder m ssen Sie nur dann anpassen wenn Sie den Service umbenannt haben Button Operation hinzuf gen Siehe Operationen eines Web Services erstellen Workbench Process Engine Systemkonnektor Guide Kap 40 10 S 440 inubit 6 1 Workbench Process Engine Systemkonnektor Guide Web Services Connector 455 Dialogbeschreibungen 40 16 3 2 Register Aufzurufender Service Medium und Output Connector In diesem Register haben Sie folgende Optionen WSDL Daten m WSDL laden von Datei Wenn Ihre WSDL Datei in einem Dateisystem verf gbar ist aktivieren Sie diese Option und geben Sie den Pfad der Datei an Alternativ klicken Sie auf ep um zu der WSDL Datei zu navigieren URL Wenn Ihre WSDL Datei ber eine URL verf gbar ist geben Sie die URL der Datei an Der Button am Ende des URL Feldes ffnen ein Men zur Auswahl folgender Funktionen Aktivieren Sie im Bereich Web Service in demselben Dialog die Option Authentifizierung erforderlich um bereits der Anfrage der WSDL Authen
231. ditor Erweitert SOAP Nachrichten Servicename AWSC_Listener Port Name AWSC_ListenerPort Adresse https ServerName Port bis ws AWSC_listener S AWSC_ListenerBinding WSDL Bindung m SayHello ep a A g Eingabe Name AWSC_ListenerBinding Port Typ AWSC_ListenerPortType ES wsc SayHello 1 1s anyType Typ SOAP 1 1 E B R ckgabe ES wsc SayHelloResponse 1 1s anyType Bindungs Stil document literal Vorlage ffnen Sie hier eine WSDL oder XSD Datei und bernehmen Sie Elemente per Drag n Drop 41 he Fugen Sie entsprechend der Funktionalitat die der Web Service zur Verf gung stellen soll weitere Operationen und Nachrichtenteile hinzu 40 11 PartnerLinks berschreiben Sie k nnen die Adresse des aufzurufenden Web Services mit Hilfe des Variablen Mappings dynamisch zur Ausf hrungszeit ndern So gehen Sie vor 1 ffnen Sie den Variablen Mapping Dialog am Web Services Connector 2 Wahlen Sie als Ziel den PartnerLink aus der die Daten des aufzurufenden Web Services enth lt 3 W hlen Sie als Quelle z B Statischer Wert 05 09 2013 inubit 6 1 Workbench Process Engine Systemkonnektor Guide Web Services Connector 443 Web Service in UDDI publizieren am alt l Im Statischer Wert Typ XML Struktur Text BB DQ wet SE Deere 4 Klicken Sie a
232. dlung 29 5 1 2 Register NoF 29 5 1 3 Register Neuer PIP PIP Einstellungen RosettaNet HTTPS Connector 321 Dialogbeschreibungen ID des Attachments kann genutzt werden um das Attachment in einem RosettaNet Dokument zu referenzieren nur beim Input Connector Individuell W hlen Sie diese Option wenn Sie die Fehlerbehandlung im Workflow selbst durchf hren wollen Bei aktivierter Option wirft der Workflow einen Fehler und Sie k nnen diesen behandeln Signal Exception Bei aktivierter Option sendet der Konnektor eine RosettaNet Signalnachricht mit dem entsprechenden Fehler und der Workflow l uft erfolgreich durch ohne einen Fehler zu werfen nur Output Connector Zum Erstellen einer Notification of Failure NoF Ein NoF ist im Prinzip ein PIPOA1 und wird im Fehlerfall versendet z B bei Timeouts innerhalb des Datenaustauschprozesses oder falls Nachrichten nicht verarbeitet werden k nnen Die Feldnamen sprechen f r sich Alle Partner Interface Processes PIPs sind von RosettaNet spezifiziert um zu garantieren dass Sender und Empf nger genormte Nachrichten austauschen Ein PIP besteht aus einem von acht m glichen Clustern jeder Cluster besteht aus einem oder mehreren Segmenten und jedes Segment enth lt ein oder mehrere PIP Beschreibungen F r jeden PIP gibt es eine Spezifikation PIPs k nnen f r einen Request oder einen Response ausgelegt sein oder auch beide Aktionen unterst
233. dresse Workbench Process Engine Systemkonnektor Guide Kap 43 S 486 Betreff und Empf nger sind optional wenn Sie XML als Eingangsformat ausgew hlt haben Wenn die Felder ausgef llt sind wird der Empf nger zus tzlich zu bereits in den Nachrichten vorhandenen Empf ngern in die XML Datei eingef gt Der Betreff wird f r alle Nachrichten bernommen und Uberschreibt die evtl vorhandenen Betreffs Versandbest tigung Wenn markiert dann wird ein Nachweis dar ber angefordert dass die Nachricht verschickt wurde Die Versandbest tigung wird automatisch vom X 400 Gateway an Sie als Absender der Nachricht gesendet und enth lt die ID der verschickten Nachricht Lesebest tigung Wenn markiert dann wird eine Lesebest tigung angefordert Die Lesebest tigung wird automatisch an Sie als Absender der Nachrichten gesendet sobald die Gesch ftspartner die Nachrichten aus der X 400 Box abholen inubit 6 1 Workbench Process Engine Systemkonnektor Guide X 400 SE Connector 491 Dialogbeschreibungen Anhangskonfiguration Nur bei Eingangsformat DATA und TXT Anhangtyp Um festzulegen mit welchem Zeichensatz die Eingangsnachricht des Output Connectors versendet werden soll w hlen Sie einen der folgenden Typen 1508859_1 8 Bit Zeichensatz enth lt viele Sonderzeichen der westeurop ischen Sprachen Siehe http de wikipedia org wiki ISO_8859 1 ISO8859 2 8 Bit Zeichensatz m
234. e Nur verf gbar beim Output Connector wenn als Eingangsformat Daten gew hlt wurde Erzeugungsdatum der Ausgabedatei Format dd MM yyyy HH mm ss WriteFileName Nur verf gbar beim Output Connector wenn als Eingangsformat Daten gewahlt wurde Name der Ausgabedatei WriteFileWildcardname Nur verf gbar beim Output Connector wenn als Eingangsformat Daten gew hlt wurde und wenn in dem Dateinamen der erzeugt werden soll z B Timestamp oder Wildcard verwendet werden Gibt den Inhalt der Wildcard aus die beim Konfigurieren des File Output Connectors im Dateinamen verwendet wurde Um die Variable WriteFileWildcardName nutzen zu k nnen m ssen sie diese auf die Variable ReadFileWildcardName mappen Fur Infos uber Variablen und deren Verwendung siehe Workflow Variablen und Mappings Workbench Benutzer Guide Kap 14 S 383 10 2 Dialogbeschreibungen Dieser Abschnitt erlautert die folgenden Themen Dialog Zu lesende Datei en S 124 Dialog Datenweitergabe S 127 Dialog Zu schreibende Datei S 129 10 2 1 Dialog Zu lesende Datei en 05 09 2013 Input Connector Dieser Dialog bietet folgende Optionen inubit 6 1 Workbench Process Engine Systemkonnektor Guide File Connector 125 Dialogbeschreibungen Modus Legen Sie fest in welchem Modus der File Connector arbeiten soll Dateimodus Pro Ausf hrung wird eine Datei im angegebenen Verzeichnis gelesen wenn de
235. e xm Schemas WSDL Editor Erweitert SOAP Nachrichten Servicename ProvideWebService Port Name ProvideWebServicePort Adresse http s ServerName Port ibis ws Provide WebService E RR ProvidewebServiceBinding N WSDL Bindung ProvideWebServiceBinding Port Typ ProvideWebServicePortType en AT gt Typ SOAP 1 1 Bindungs Stil document iteral Te TEN TED A ee en A uote A a gegen mapa e Benennen Sie die Operation z B mit SayHello f W hlen Sie bei Art Anfrage Antwort aus Damit legen Sie fest dass Ihr Web Service eine SOAP Response an den aufrufenden Web Service zur ckgibt statt nur dessen Request zu verarbeiten g Klicken Sie auf OK um den Dialog zu schlie en Beim Schlie en des Dialog wird aus Ihren Angaben die WSDL Ihres Web Services erzeugt in der u a die Strukturen der SOAP Requests und Responses definiert sind Sie k nnen die WSDL im Register WSDL Editor anzeigen und die SOAP Requests Responses im Register SOAP Nachrichten h Publizieren Sie den Konnektor 2 SOAP Response erstellen a Erzeugen Sie einen XSLT Converter f gen Sie diesen in den Technical Workflow ein und verbinden Sie ihn mit dem Web Services Input Listener Connector b ffnen Sie den XSLT Converter zum Bearbeiten Das Ergebnis der Workflow Verarbeitung muss WSDL konform als SOAP Response strukturiert werden bevor es an den aufrufenden Web Service zur ck
236. e Kap 13 S 153 FTP Connector Workbench Process Engine Systemkonnektor Guide Kap 11 S 133 HTTP Connector Workbench Process Engine Systemkonnektor Guide Kap 12 S 145 AS2 Connector Workbench Process Engine Systemkonnektor Guide Kap 3 S 31 RosettaNet HTTPS Connector Workbench Process Engine Systemkonnektor Guide Kap 29 S 309 1 1 5 Dialog Remote Connector Konfiguration Fur mehr Informationen uber Installation und Konfiguration eines Remote Connectors siehe Remote Connector Process Engine Administrator und Entwickler Guide Kap 13 S 153 URL URL des Remote Connectors Ersetzen Sie localhost durch den Namen des Rechners auf dem der Remote Connector installiert ist oder durch dessen IP Adresse Server Authentifizierung Wenn markiert dann muss sich der Remote Connector auf dem entfernten Rechner gegen ber dem Systemkonnektor den Sie gerade konfigurieren mit einem Zertifikat identifizieren Wenn nicht markiert dann wird jeder SSL Server als vertrauensw rdig betrachtet Der Button Datei ausw hlen ffnet einen Dateiexplorer zum Laden des Truststores mit dem ffentlichen Schl ssel des Remote Connectors inubit 6 1 Workbench Process Engine Systemkonnektor Guide 05 09 2013 26 Systemkonnektoren Dialogbeschreibungen Verbindungstest 05 09 2013 Nach den Laden wird das Datum angezeigt bis zu dem der Schl ssel g ltig ist Client Authentifizierung
237. e Optionen Einstellungen f r das Versenden m MIME formatiert RCF 822 Zum Senden von Mime formatierten Eingangsnachrichten 05 09 2013 inubit 6 1 Workbench Process Engine Systemkonnektor Guide Mail Connector 221 Dialogbeschreibungen MIME XML Zum Senden von Eingangsnachrichten die entsprechend der XML Schemadatei unter Global gt System gt Mapping Templates gt MIME Adapter gt IBISMimel 1 xsd formatiert sind Wenn Sie MIME formatiert oder MIME XML gew hlt haben Q dann werden die Angaben in den Eingangsnachrichten nur genutzt wenn Sie den Bereich Nachricht im Dialog SMTP Connector Eigenschaften Workbench Process Engine Systemkonnektor Guide Kap 21 2 6 S 222 leer lassen Daten Zum Senden von Nachrichten in einem beliebigen Format MIME Typ der Daten Typangabe der bermittelten Daten Content Transfer Encoding Zum Festlegen einer sicheren Kodierung f r nicht ASCII Zeichen z B Sonderzeichen und nicht Textteile z B Binaries bei der bertragung Stellt den verlustfreien Datenaustausch sicher auto Der Wert des Headers Content Transfer Encoding wird automatisch entsprechend dem Content Type und den zu versendenden Daten festgelegt base64 Zum bermitteln z B von bin ren oder 8 bit kodierten Nachrichten Als E Mail Anhang Sendet die Eingangsnachricht als Anhang einer E Mail Name des Anhangs Die Option ist spreche
238. e anlegen Workbench Benutzer Guide Kap 3 3 S 129 Technical Workflow Diagramme Workbench Benutzer Guide Kap 12 S 311 14 1 Voraussetzung f r den Betrieb Treiber installieren F r den Betrieb des ITA Connectors m ssen Sie folgende jar Dateien der Version 5 0 x bei Ihrem ITA Provider anfordern und in Ihre inubit Installation kopieren m blconfig jar lmetadata jar b blueline jar bluelineimpl jar b luelineutil jar inubit 6 1 Workbench Process Engine Systemkonnektor Guide 05 09 2013 162 ITA Connector Dokumente in ITA Archivsystem einf gen Insert m jdom jar Die Dateiversion ist abh ngig von der Version des genutzten ITA Q Servers So gehen Sie vor 1 Stoppen Sie Ihre inubit Process Engine 2 Kopieren Sie die j ar Dateien in das Verzeichnis lt iS installdir gt server Tomcat webapps ibis WEB INF lib 3 Starten Sie Ihre inubit Process Engine 14 2 Dokumente in ITA Archivsystem einf gen Insert Read Document Envelope_document Create_ITA_format Insert_document ID_Selector VWrte document ID Die Abbildung illustriert wie ein Dokument in ein ITA Archivsystem eingef gt werden kann 1 Der File Connector liest das Dokument aus dem Dateisystem 2 Der XML Enveloper konvertiert den Inhalt des Dokuments in ein XML Format 3 Im XSLT Converter wird der Inhalt des XML formatierten Dokuments in eine XML basierte Query konvertiert In dieser Q
239. e com javase 6 docs technotes quides security jaas JAASRefGuide html Dokumentation der JAAS Login Module http jaaslounge sourceforge net loginmodules html JNDI Uberblick http www oracle com technetwork java overview 142035 html Der JAAS Connector wird als Medium Connector genutzt Als Eingangsnachricht erwartet der JAAS Connector die zu validierenden Benutzerkontodaten Benutzername Passwort Die Benutzerkontodaten m ssen unverschl sselt bergeben werden inubit 6 1 Workbench Process Engine Systemkonnektor Guide 05 09 2013 168 JAAS Connector Beispielszenario Liste von Benutzerkonten berpr fen Der JAAS Connector bergibt die Benutzerkontodaten dem konfigurierten System welches die Korrektheit der Login Daten berpr ft und das Ergebnis an den JAAS Connector zur ckgibt Wenn die Validierung erfolgreich ist gibt der JAAS Connector seine Eingangsnachricht unver ndert aus Wenn die Validierung scheitert dann gibt der JAAS Connector eine XML basierte Fehlernachricht aus Die Fehlernachricht enth lt u a einen Fehlertext mit dem Grund f r die gescheiterte Validierung Zus tzlich wird die Eingangsnachricht an die Fehlernachricht angeh ngt Wenn die Eingangsnachricht nicht als XML Datei vorlag wird sie als Anhang der Fehlernachricht und base64 kodiert ausgegeben Siehe auch Systemkonnektoren Workbench Process Engine Systemkonnektor Guide Kap 1 S 19 Module anlegen Workbench Benutze
240. e des Java Reflection Connectors gesteuert Die Struktur der Ausgangsnachricht entspricht der XML Eingangsnachricht Der einzige Unterschied ist dass alle lt result gt Elemente zur Laufzeit aufgel st werden und der entsprechende Inhalt der referenzierten Variablen eingetragen wird Das Ergebnis des oben genannten Beispiels sieht so aus lt result value of SresultString gt lt string gt his is a test string to be parsed and manipulated lt string gt lt result gt inubit 6 1 Workbench Process Engine Systemkonnektor Guide 05 09 2013 180 Java Reflection Connector Attributliste 16 4 Attributliste Attribut Zul ssig auf Erl uterung name lt object gt Element Name zur Referenzierung des Wertes der Klasse Klassen lt param gt Element instanz bzw des Methodenparameters Parameterwert object Methoden Element Name der Klasse z B java lang String bzw Referenz lt param gt Element Zeichen Name der Referenzierung auf das die Methode bzw der Parameter angewendet werden soll result Methoden Element Name zur Referenzierung des R ckgabewertes einer Me thode type lt param gt Element Angabe der Klasse des Typs des Methodenparameters z B java lang String 16 5 Dialog Java Reflection Connector Eigenschaften 05 09 2013 Ausgabe Optionen In diesem Dialog haben Sie folgende Optionen Nur Resultate Wenn markiert dann enth lt die Ausgangsnachri
241. e einen Request bzw eine Response ben tigen Geben Sie den Funktionsnamen oder die Funktionsgruppe bzw Teile davon ein Sie k nnen den Asterisk als Wildcard verwenden Klicken Sie auf Suchen um eine Liste mit passenden Funktionen angezeigt zu bekommen Wenn Ihre Suche ein Ergebnis geliefert hat markieren Sie in der Tabelle die Funktion die Sie benutzen m chten Dann legen Sie fest welche Art von XML Template erzeugt werden soll Response Wenn Sie den SAP Connector als synchronen Input Listener verwenden Request Beim Einsatz als Medium oder Output Connector Klicken Sie auf Weiter Fahren Sie fort mit Schritt 7 Bei Auswahl IDoc inubit 6 1 Workbench Process Engine Systemkonnektor Guide SAP Connector XML Request Response erstellen 335 IS SAP Explorer x IDoc Suche Legen Sie das IDoc fest f r welches Sie das Template erstellen m chten Suche Message Typ Jadr Suchen Auswahl des IDocs B E ADR2MAS ADRZMASO1 454 BAPI zur Eingangsverteilung von pers nlichen ADRZMAS02 464 BAPI zur Eingangsverteilung von pers nlichen ADR3MAS ADR3MASO1L 454 BAPI zur Eingangsverteilung von Ansprechpar POOR 3SMASO2 464 BAPI zur Eingangsverteilung von Ansprechpar 5 ADRMAS Template Einstellungen Single IDoc Multi IDoc IV Beschreibungen beibehalten ger Zur ck tap yeiter X Abbrechen Dieser Dialog unterst tzt
242. e oder als Vorgabe welche Eigenschaften an bestehenden Entit ten ge ndert werden sollen Bedingungen f r die Suche nach spezifischen Eigenschaften Dokumentklassen oder Dokumenten IDs Die Ausgangsnachricht hat dieselbe Struktur wie die Eingangsnachricht lt LivelinkArchivingConnector gt lt Commands gt lt Command Type lt Kommando gt DetailedResult true false gt lt Entities gt lt Entity gt lt Mind eine Entit t je nach Kommando gt lt Entities gt lt Condition gt lt Command gt lt Commands gt lt LivelinkArchivingConnector gt inubit 6 1 Workbench Process Engine Systemkonnektor Guide Struktur der Ausgangsnachricht 20 2 1 Kommandos Livelink PDMS Connector 207 Inhalt und Struktur der Eingangs und Ausgangsnachrichten Die Ausgangsnachricht liefert die durch Kommandos adressierten Entit ten zur ck lt LivelinkArchivingConnector gt Entities gt lt Entit ten des Kommandos 1 gt lt Entity gt lt 0 bis n Entit ten gt Entities gt A A A Entities gt lt Entit ten des Kommandos 2 usw gt lt Entity gt lt 0 bis n Entit ten gt lt Entities gt lt Weitere Entit ten gt lt LivelinkArchivingConnector gt Es k nnen pro Ausf hrung des Konnektors mehrere Kommandos bergeben werden Diese werden in der definierten Reihenfolge und als eine Transaktion abgea
243. e org Installation ab 3 3 0 ist von der inubit Software erreichbar OpenOffice ist im Servermodus gestartet Dazu nutzen Sie aus dem OpenOffice Programm Verzeichnis lt OpenOfficeInstallDir gt App openoffice program folgenden Befehl soffice exe headless nofirststartwizard accept socket host localhost port 8100 urp StarOffice Service inubit 6 1 Workbench Process Engine Systemkonnektor Guide 05 09 2013 272 OpenOffice Connector Funktionsprinzip 25 2 Funktionsprinzip Der OpenOffice Connector erwartet eine XML Eingangsnachricht mit folgenden Elementen m Base64 kodiertes Eingangsdokument Ausgabefilter optional Operationen nderung Konvertierung oder Drucken die auf dem Dokument ausgef hrt werden sollen Der OpenOffice Connector ffnet das angegebene Eingangsdokument und f hrt die Operationen aus Abschlie end erstellt er das Zieldokument in dem angegebenen Format oder sendet es an den konfigurierten Drucker XML Schema als Vorlage f r Die Eingangsnachrichten f r den OpenOffice Connector erstellen Sie Eingangsnachrichten auf Basis des mitgelieferten XML Schemas 00C xsd mit einem XSLT Converter Knoten OOWriter Attribute f r Word Writer Dokumente Knoten OOCalc Attribute fur Excel Calc Dokumente Das XML Schema finden Sie im Repository in folgendem Verzeichnis Global System Mapping Templates OpenOffice Connector 25 3 Beispiel Workflow erstellen Mit dem folgenden Beisp
244. e zwischen zwei Versuchen vergehen soll eine Verbindung aufzubauen Der Standard ist 0 Protokolltyp der Nachbarstation Der weitere Aufbau des Dialogs f r die Nachbarstation h ngt davon ab welches Verbindungsprotokoll Sie ausgew hlt haben 23 6 1 1 Nachbarstation ber TCP IP IP Adresse Geben Sie entweder den Namen oder die IP Nummer des Rechners an ber den die TCP IP Verbindung l uft Port Geben Sie hier die Portnummer f r die TCP IP Verbindung an 23 6 1 2 Nachbarstation ber SNA LU6 2 SNA Systems Network Architecture ist eine Netzwerkarchitektur die von IBM entwickelt wurde Mit der LU Type 6 2 kann der parallele Aufbau von Verbindungen einer einzelnen Logical Unit zu mehreren Anwendungsprogrammen erreicht werden LU Name Name der Logischen Einheit logical unit LU Netzwerk ID Die Netzwerk ID auch NETID spezifiziert ein SNA Netzwerk Es ist eine ein bis achtstellige alphanumerische Zeichenkette TP Name TP steht f r Transaction Program TP Name spezifiziert den Namen eines Advanced Program to Program Communication APPC Transaction Programms auf einem Datenbankserver Beispiele sind RVSOFTP oder DB2DRDA Modus Der Name des Modus muss eindeutig sein und den SNA Namenskonventionen entsprechen beispielsweise LU62PS Benutzer ID Passwort Benutzer ID entspricht einem Login Namen Einige SNA Netzwerke erfordern einen Authentifizierung Sicherheit Einige SNA Netzwerke erfordern Aut
245. ebene Ein STS Connector wird immer als Input Listener eingesetzt Er validiert eingehende Authentifizierungs Requests und sendet bei positivem Validierungsergebnissen Tokens an den aufrufenden Web Service zur ck Der STS Connector setzt folgende Web Service Standards um a WS Security Standard fur die Sicherheit auf Nachrichtenebene Der Standard legt fest wie SOAP Nachrichten signiert und verschlusselt sowie Sicherheitstoken Ubertragen werden Siehe http www oasis open org committees download php 16790 wss v1 1 spec os SOAPMessageSecurity pdf WS Trust Definiert einen speziellen Web Service den SecurityTokenService fur die Ausgabe den Austausch und die Validierung von Security Token Siehe http docs oasis open org ws sx ws trust 200512 ws trust 1 3 os html Siehe auch inubit 6 1 Workbench Process Engine Systemkonnektor Guide 05 09 2013 349 350 Security Token Service Connector Funktionsprinzip des STS Connectors Systemkonnektoren Workbench Process Engine Systemkonnektor Guide Kap 1 S 19 Module anlegen Workbench Benutzer Guide Kap 3 3 S 129 Technical Workflow Diagramme Workbench Benutzer Guide Kap 12 S 311 32 1 Funktionsprinzip des STS Connectors STS Connector 1 Service ist 2 Sendet Security ber STS gesichert Token Request 3 Sendet Token Security Token Response 5Pr ft Signatur mg des Tokens und 9 a f hrt Request aus a E 4 Sende
246. ector Setzen Sie den Startpoint vor das Assign Modul 9 Starten Sie den Workflow mit dem zu druckenden Dokument 05 09 2013 inubit 6 1 Workbench Process Engine Systemkonnektor Guide OpenOffice Connector 279 Dialog Grundeinstellungen 10 Pr fen Sie ob das Dokument korrekt gedruckt wurde 25 7 Dialog Grundeinstellungen In diesem Dialog haben Sie folgende Optionen OpenOffice Server m Servername IP Adresse oder Host Name der Systems auf dem OpenOffice installiert ist Port Port Uber den OpenOffice Connector erreicht wird Standard Setzt den Port auf den Standardwert 8100 zur ck Verbindungstest m Verbindung testen Zum Testen ob die Verbindung mit Ihren Angaben erfolgreich aufgebaut werden kann inubit 6 1 Workbench Process Engine Systemkonnektor Guide 05 09 2013 280 OpenOffice Connector Dialog Grundeinstellungen 05 09 2013 inubit 6 1 Workbench Process Engine Systemkonnektor Guide PT osc Connector Verwendung Konnektortypen E 281 Dieser Abschnitt erl utert die folgenden Themen m Voraussetzungen S 282 m Funktionsprinzip S 282 m Dialogbeschreibungen S 283 Online Service Computer Interface OSCI ist ein Nachrichten Standard und dient als Grundlage f r die rechtssichere Daten bertragung im eGovernment Bereich auf Basis von digitaler Signatur und Verschl sselung zwischen zwei Kommunikationspartnern ber eine virtuelle Poststelle Intermedi r
247. edeutet Empfangsbest tigung Die EERP_in wird vom Gesch ftspartner gesendet NEVER Der Gesch ftspartner sendet keine Eingangsbest tigung Die bertragung wird mit der korrekten bermittlung der Nachricht beendet NORMAL Es wird eine Eingangsbest tigung erwartet Der Eingang der Best tigung geh rt zur Sendeaufforderung Eine Sendeaufforderung besteht so lange wie entweder noch Dateien zur bertragung anstehen oder auf den Eingang von Eingangsbest tigungen gewartet wird Mit dem Eingang der Best tigung wird auch die Sendeaufforderung beendet Die Auswahl NORMAL ist der Standard Ausgangsbest tigung EERP_out Eine Empfangsbest tigung wird von der lokalen Station an den Gesch ftspartner gesendet Standardm ig ist die Option IMMEDIATE vorausgew hlt NEVER Es wird keine Empfangsbest tigung gesendet NORMAL Beim Empfang einer Nachricht wird eine Empfangsbest tigung gesendet Wenn die Verbindung noch besteht wird die Best tigung sofort gesendet Wenn die Verbindung bereits abgebaut wurde wird die Best tigung beim n chsten Verbindungsaufbau gesendet inubit 6 1 Workbench Process Engine Systemkonnektor Guide 05 09 2013 262 OFTP2 Connector Dialog Stationen Protokolltyp der Nachbarstation 05 09 2013 SYNC Die Empfangsbest tigung wird ber dieselbe Verbindung gesendet ber welche die Nachricht eingegangen ist Das Bestehen der Verbindung wird dabei erzwungen Es wird gepr f
248. eesessdcdceneensccccentenscaddersansdaddeseeausaddenabessgudentenstagas 383 35 8 2 Objekt Uber eine XPath Anfrage l schen 0 0 eeeeeeeeeeee eee eeeee eee eeeeeaeeeeseeaaeeeeeeeaeeeeeeeeneeeeesenaes 383 35 9 Dialog SC Connector Einstellungen 4444444444400Rnnnnnnnnnnnnsnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnn ann 384 36 Solution Center LOQQCM ccccccccciccccsscscctecesseccte ces seeccteessacctececssccectecsseectitecssctitecesnccttecesscuentecessncttecessecctieenenes 387 36 1 Funktionsprinzip sasaaina aa ceeds eege EE See He Fer eege 387 36 2 Eigene Event Typen erstellen 2 akku 388 36 3 Dialog SC Logger Einstellungen 2 mr22440000Hnan00nnnnnnnnnannnnnnnnnannnnannnannnnnnnnnannnnnnnnnansnnnnnnnnnnnnn 388 Of KEREN 391 37 1 Konnektortypen EE 391 37 2 IP Nachrichten mit Start Stopbyte Begrenzung verarbeiten 2nsnsnnnenneennnnnnnnnnnnnnnnnn nme nennen 393 37 3 DialogbeSchreiDUng 0 eee ter tr nn ne ene ete ee eee eran eee AAAA AAAA eee naeeeeee 394 38 VES Enter eege ee EES EES EE EE EES ECH 38 1 Modulvariablen des VFS Connectors nn 397 RE ele ele Le E ME 398 38 2 1 Dialog VFS Connector Grundkonfiouraton A 398 38 2 2 Dialog Input CGonpechor konfiguration ann 400 38 2 3 Dialog Output Connector Konfiguration 4ussrnnnnennnennnnnnnnnennnnnnnnnennnnnnnnnennennnnnnnnnn nn 403 39 Web Application Connector aicin onsseceseceicsicescava
249. eich Bereitgestellte Ressourcen neben der URL auf sl 3 W hlen Sie die Option Publizierte Ressourcen anzeigen Im Browser ffnet sich eine Seite die aufbereitete Liste mit allen aktivierten Ressourcen anzeigt Ressourcen die mit einem REST Input Listener Connector realisiert sind werden erst als publiziert und aktiviert angezeigt wenn die entsprechenden Technical Workflows aktiviert sind 27 7 Ressource aufrufen Prinzip 05 09 2013 Sie k nnen mit dem REST Connector eine Ressource die ber eine bestimmte URL zur Verf gung steht aufrufen So k nnen Sie z B eine Artikelliste anfordern Sie m ssen dazu einen REST Output oder Medium Connector zum Versenden der Anfrage und zum Empfangen der Antwort anlegen und konfigurieren Medium Connector Verwenden Sie den Medium Connector wenn die aufgerufene Ressource eine Antwort zur cksendet die im Workflow weiterverarbeitet werden soll Output Connector Verwenden Sie den Output Connector wenn die Anfrage an eine Ressource ein Aufruf ohne R ckgabe ist Voraussetzungen URL der aufzurufenden Ressource ist verf gbar Authentifizierungsdaten sind verf gbar falls der Server f r die Ressource eine Authentifizierung fordert So gehen Sie vor 1 Legen Sie einen neuen REST Medium oder Output Connector 2 Geben Sie die URL der aufzurufenden Ressource ein 3 Geben Sie ggf die erforderlichen Authentifizierungsdaten ein Siehe Authentifi
250. eichnis aus dem Dateien gelesen werden sollen Bei Zugriff auf das Repository geben Sie den Pfad ein der im Repository im Register Detaildaten angegeben ist Siehe Detaildaten Workbench Benutzer Guide Kap 19 11 2 S 525 inubit 6 1 Workbench Process Engine Systemkonnektor Guide VFS Connector 401 Dialogbeschreibungen Sie k nnen folgende Wildcards verwenden um z B Dateien aus Verzeichnissen mit sich ndernden Namen und in beliebiger Verzeichnistiefe abholen zu lassen ein Asterisk Zum Filtern des Verzeichnisnamens oder Teilen davon Sie k nnen in einem Namen auch mehrere Wildcards verwenden Beispiele bar durchsucht foo bar oo bar durchsucht foo bar oder auch goo bar o bar durchsucht foo bar oder auch goa bar zwei Asterisks Zum Filtern des Verzeichnisnamens oder Teilen davon in beliebiger Schachtelungstiefe bar durchsucht foo bar und xyz gfd bar Bei der Nutzung von cifs muss dem Pfad der Sharename vorangestellt WY werden Leere Verzeichnisse l schen Wenn markiert dann werden leere Verzeichnisse gel scht wenn im Pfad ein Wildcard enthalten ist Datei m Name Dateiname Mit Wildcard Wenn markiert dann k nnen Sie beim Eingeben des Dateinamens Wildcards Asterisk verwenden Mit regularem Ausdruck Wenn markiert dann k nnen Sie mit Hilfe eines regul ren Ausdrucks ein Muster angeben dem die Dateinamen der einzulesenden Dateien
251. eigt falls die Datei nicht gel scht werden kann Wenn ein Fehlerausgang konfiguriert ist wird dieser durchlaufen Sonst wird die Ausf hrung des Moduls abgebrochen Freigabe der Datei abwarten Pr fintervall in Sekunden Nur im Dateimodus Markieren Sie diese Option um sicherzustellen dass der File Input Connector keine Dateien liest w hrend diese noch von anderen Applikationen geschrieben werden Wenn die Option markiert ist dann pr ft der File Input Connector in einem konfigurierbaren Intervall die Zeitstempel und Gr en der zu lesenden Dateien und vergleicht diese Die Dateien werden nur eingelesen wenn sich die Angaben nicht ge ndert haben Max Anzahl v Ausf hrungen pro zeitgesteuertem Aufruf Mit der Angabe legen Sie fest wie oft pro ausl sendem Event der Workflow maximal gestartet werden soll Ausl sendes Event ist das Erreichen eines Zeitpunktes Dann wird der Workflow so oft gestartet bis entweder keine weiteren Daten zu holen zu senden sind oder die Anzahl erreicht wurde welche bei maximale Ausf hrungen pro Aufruf konfiguriert wurde Mit der Begrenzung der Ausf hrung steuern Sie die Systemauslastung der inubit Process Engine Die Angabe wird im Test Modus ignoriert dann wird der Workflow genau einmal gestartet inubit 6 1 Workbench Process Engine Systemkonnektor Guide File Connector 127 Dialogbeschreibungen Die Option ist nur bei aktiviertem Scheduler aktiv Lesereihenfolge
252. einen Empfangs Job an residenter Empfangseintrag b Geben Sie das Skript als zu startenden Job an Das Skript liegt im Verzeichnis lt inubit installdir gt server ibis_ root conf bin AIX rvs_is receive pl Windows rvs is receive bat F r weitere Informationen beachten Sie die Dokumentation der rvs Software 05 09 2013 OFTP over TCP IP X 25 GUI GUI Nachricht versenden mit Output Connector Der OFTP Connector bergibt die Nachrichten noch auf der inubit Process Engine an rvs Der Versand kann mit Hilfe des Schedulers so konfiguriert werden dass die Nachricht sofort inubit 6 1 Workbench Process Engine Systemkonnektor Guide OFTP Connector 231 Daten bertragungsmodi verschickt wird wenn sie im Workflow am OFTP Connector ankommt oder nur zu einer vereinbarten Zeit oder in einem Zeitintervall rvs verschickt die Nachricht ber das vereinbarte Protokoll an die vom Empf nger eingerichtete Station Die RVS Job ID steht nach der Modulausf hrung als Workflowvariable zur Verf gung Nachricht empfangen Input Connector Der OFTP Connector pr ft aktiv in einem festgelegten Zeitintervall ob Nachrichten vorhanden sind Input Listener Connector Der OFTP Connector wartet auf der konfigurierten Verbindungen auf das Eintreffen von Nachrichten Abh ngig davon wie Ihr Connector konfiguriert ist findet die Kommunikation synchron oder asynchron statt siehe Daten bertragungsmodi Wor
253. elche Rollen zum Anzeigen und Bearbeiten ausgew hlter Formularelemente berechtigt sind Siehe Formularelemente abh ngig von Rechten machen nur bei Web Applikationen Workbench Process Engine Modul Guide Kap 4 2 7 S 70 inubit 6 1 Workbench Process Engine Systemkonnektor Guide 413 40 Web Services Connector Dieser Abschnitt erl utert die folgenden Themen a Funktionsprinzip eines Web Services S 414 m Modulvariablen des Web Services Connectors S 416 m Web Service anbieten S 417 m Web Service aufrufen S 421 m Asynchrone Web Services S 425 m Web Services Provider durch Security Token Service absichern S 433 a Schl sselpaar f r WS Security erstellen S 434 m Schl sselpaare f r WS Trust erstellen S 436 m STS gesicherten Web Service Provider aufrufen S 438 m Operationen eines Web Services erstellen S 440 m Partnerlinks berschreiben S 442 m Web Service in UDDI publizieren S 443 m Aktive Web Services anzeigen S 444 m SOAP Nachrichten protokollieren S 445 m Bin rdaten als Attachments mit MTOM bertragen S 446 m Dialogbeschreibungen S 451 Verwendung Der Web Services Connector ist ein zentraler Bestandteil einer SOA Die Einsatzm glichkeiten eines Web Services Connectors sind abh ngig von dessen Konfiguration Input Listener Connector Bietet die Funktionalit t eines Technical Workflows nach au en als Web Service an Als Input Listener ist der Web Services Connector
254. elesen Dabei haben Sie zwei Optionen Geben Sie im Textfeld Benutzername die Variable ISUserName an Verwenden Sie eine selbst definierte Variable Siehe Workflow Variablen und Mappings Workbench Benutzer Guide Kap 14 S 383 Fest Die Zeichenkette die im Textfeld Benutzername angegeben ist wird als Benutzername verwendet Lu Nur mit der Option Fest k nnen Sie die Verbindung testen Passwort Die bernahme des Passworts funktioniert genauso wie die bernahme des Benutzernamens D Zum bernehmen des Passwort aus XML basierten Eingangsnachrichten V Liest das Passwort aus einer Workflow Variablen Sie m ssen eine Workflow Variable anlegen da es standardm ig keine Workflow Variable f r das Passwort gibt Fest Eingabe eines Passworts zum Testen der Verbindung Login Modul Optionen Mit den Login Modul Optionen werden die Werte gesetzt die zur Verbindung mit dem System ben tigt werden auf dem das angegebene Benutzerkonto validiert werden soll Die Tabelle enth lt f r die standardm ig mitgelieferten Login Module bereits vorbelegte Eintr ge Wenn Sie ein eigenentwickeltes Login Modul benutzen m ssen Sie die Parameter in der Tabelle selbst anlegen Zum Bearbeiten der Tabelle verwenden Sie folgende Buttons Ai Neue Zeile hinzuf gen a Markierte Zeile l schen inubit 6 1 Workbench Process Engine Systemkonnektor Guide 05 09 2013 172 JAAS Connector Dialog
255. ellen Die Prozedur wird beim Einf gen neuer Gesch ftsobjekte ben tigt um jeweils eine eindeutige Gesch ftsobjekt ID zu ermitteln Siehe Datenbankprozedur getNewID erstellen Workbench Process Engine Systemkonnektor Guide Kap 7 5 S 101 8 Eingangsnachricht erstellen a Erstellen Sie einen XSLT Converter b Um ein Template als Zielstruktur zu laden ffnen Sie im Bereich XML Zieldatei das Men und w hlen ffnen von gt Repository Der Repository Browser ffnet sich c Navigieren Sie in das Verzeichnis Global System Mapping Template Database Object Connector d W hlen Sie ein Template aus und klicken Sie auf OK um den Repository Browser zu schlie en e Passen Sie das Template an die Strukturen Ihres Gesch ftsobjekts an f Verbinden Sie den XSLT Converter mit dem DBO Connector inubit 6 1 Workbench Process Engine Systemkonnektor Guide 05 09 2013 96 Database Object Connector Events mit Event Listener berwachen und archivieren 7 2 Events mit Event Listener berwachen und archivieren Prinzipielles Vorgehen 05 09 2013 Als Event Listener berwacht ein DBO Input Connector nderungen an Gesch ftsobjekten Dazu berpr ft der DBO Input Connector in regelm igen Abst nden ob in einer Eventtabelle eine neue Eventbenachrichtigung steht Wenn dies der Fall ist dann liest der DBO Input Connector das Gesch ftsobjekt ei
256. ellt Methodenaufrufe String resultString testString subString 1 testString length Der Java Code beinhaltet zwei Methodenaufrufe und muss daher entsprechend zerlegt werden Der Methodenaufruf testString length entspricht der folgenden XML Struktur lt length object StestString result stringLength gt Elementname lt length gt Entspricht dem Methodennamen der auf der Klasseninstanz aufgerufen werden soll Attribut object S testString Gibt die Klasseninstanz an Der Referenzname muss mit einem Zeichen beginnen weil es sich um eine Referenz handelt Bei statischen Methoden kann der Wert des Attributs object der Name der zu Grunde liegenden Klasse sein z B object java lang String Attribut result stringLength Damit wird der R ckgabewert der aufgerufenen Methode in der Variablen mit dem Referenznamen stringLength hinterlegt Auf diese Variable kann quivalent zur Klasseninstanz durch stringLength an anderer Stelle im XML zugegriffen werden Der Methodenaufruf testString subString wird durch die folgende XML Struktur aufgerufen lt substring object StestString result resultString gt lt param type int gt lt int gt 1 lt int gt lt param gt lt param type int object SstringLength name gt lt substring gt Elementname lt substring gt Entspricht wieder dem Methodennamen der auf der Klasseninstanz aufgerufen werden soll Als Klasse
257. em Dateisystem Sie haben folgende Konfigurationsm glichkeiten File Input Connector Holt Dateien und Verzeichnisse aus dem Dateisystem der inubit Process Engine und bergibt sie an das n chste Modul zur Bearbeitung File Output Connector Schreibt das Ergebnis des vorhergehenden Moduls in eine Datei in einem Verzeichnis der inubit Process Engine Wenn das Ergebnis ein Zip Archiv ist dann entpackt der File Output Connector dieses vor dem Speichern Siehe auch Systemkonnektoren Workbench Process Engine Systemkonnektor Guide Kap 1 S 19 Module anlegen Workbench Benutzer Guide Kap 3 3 S 129 Technical Workflow Diagramme Workbench Benutzer Guide Kap 12 S 311 10 1 Modulvariablen des File Connectors Bei der Ausf hrung eines File Connectors werden folgende Variablen gesetzt die Sie an den nachfolgenden Modulen des Workflows auswerten k nnen m ReadFileDate Letztes Anderungsdatum der Eingangsdatei Format dd mm yyyy hh mm ss m ReadFileName Name der Eingangsdatei mit Extension m ReadFileSize Gr e der Eingangsdatei in Bytes m ReadFileWildcardname inubit 6 1 Workbench Process Engine Systemkonnektor Guide 05 09 2013 124 File Connector Dialogbeschreibungen Gibt den Inhalt der Wildcard aus die beim Konfigurieren des File Connectors im Dateinamen verwendet wurde wenn die Option Wildcard Inhalte des vorher ausgef hrten File oder FTP Connectors verwenden gesetzt ist WriteFileDat
258. emkonnektor Guide Kap 7 5 S 107 Field DBForeignKey FieldName Implizit Referenz auf Fremdschl s sel Field isRequired Obligatorisch Wenn true dann muss die Spalte im XML vorhanden sein Field DefaultValue Implizit Standardwert des Feldes Field Sel ectExpressi on Implizit SE E aS wa lt like Leerzeichen danach 05 09 2013 inubit 6 1 Workbench Process Engine Systemkonnektor Guide Database Object Connector 101 Datenbankprozedur getNewID erstellen 7 5 Datenbankprozedur getNewID erstellen Dieser Abschnitt erlautert die folgenden Themen m Datenbankprozedur getNewID f r Oracle S 102 m Datenbankprozedur getNewID f r MySQL S 103 Beim Erzeugen eines neuen Geschaftsobjekts INSERT ruft der DBO Connector f r alle Tabellenspalten welche in der Konfigurationsdatei das Attribut IsAutoField true haben die Datenbankprozedur getNewID auf um eine eindeutige ID f r die Tabellenspalten vergeben zu k nnen getNewID muss folgender Struktur entsprechen getNewID i_tablename in varchar2 i_fieldname in varchar2 o newid out number getNewID steuert anhand der bergebenen Input Parameter aktueller Tabellenname und Name der Tabellenspalte die richtige Datenbank Sequenz an und bergibt die neue ID an den DBO Connector damit dieser das INSERT mit einer neuen ID durchf hren kann Die folgenden Implementierungsvorschl ge f r getNewID k nnen sich bei einem Release Wechsel ndern
259. en Allgemeine Moduleigenschaften System Connector Eigenschaften SC Connector Einstellungen cea Eigenschaften Modus Objektdaten abfragen Objekt erzeugen Objektdaten aktualisieren Objekt l schen Objekt Knoten Referenz ber Knoten ID El Dom nenbibliothek scc domain_library E Solutions scc solutions E Business Foundation bfm3 BusinessFoundation E FleetManagementHomepage fpm FleetManagementHomepage E LCsof2011_09_06 2 fpm FleetManagementBO E SC_2011_09_07 fpm FleetManagementBO 2011_09_07_SCs fpm SalesContract XPath scc solutions bfm3 BusinessFoundation cm title Business Foundation E bfm3 ProcessBOHome cm title FleetManagementHomepage bfm3 ProcessBO em title SC 2011 09 07 pm Contract em title 2011 09 07 SCs 9 F_ pm HN Hi J Objektdaten zur ckgeben Anzahl der Knotenebenen 1 Komplette Struktur zur ckgeben 7 Klicken Sie auf Fertigstellen 8 Setzen Sie den Startpoint vor den Solution Center Connector 9 Starten Sie den Test ohne Datei 10 ffnen Sie die Ergebnisdatei nach dem Solution Center Connector Die Ergebnisdatei sollte wie folgt aussehen inubit 6 1 Workbench Process Engine Systemkonnektor Guide 05 09 2013 380 Solution Center Connector Beispiel Objektdaten aktualisieren IM DS Nachricht ERARA B content xmins br http inubit com businessrepository xmi
260. en m Metadaten abfragen S 62 Statische SQL Query erstellen S 62 Dynamische XML Query erstellen S 63 XML Querys Struktur und Beispiele S 65 Dialogbeschreibungen S 84 ah Konnektortypen Der Database Connector verbindet sich ber eine JDBC oder ODBC Schnittstelle mit einer Datenbank und bietet folgende Funktionen an Metadatenabfragen Statische Datenbankabfragen via SQL Dynamische Datenbankabfragen via XML Querys In Stored Procedures k nnen keine CLOBs bergeben werden Der Database Connector unterst tzt jedoch das Senden Speichern von Daten als CLOB Datentyp bei Oracle 9 Datenbanken Input Connector Sendete eine statische SQL Query oder eine Metadatenabfrage an eine Datenbank und bergibt das Ergebnis an das nachfolgende Modul Medium Output Connector Sendet eine statische SQL Query eine Metadatenabfrage oder eine dynamische XML Query an eine Datenbank nimmt das Ergebnis der Datenbank entgegen und reicht es an das nachste Modul weiter Dynamisch erzeugte XML Querys sind z B sinnvoll wenn die zu modifizierenden Daten erst zur Laufzeit bekannt werden Siehe auch Systemkonnektoren Workbench Process Engine Systemkonnektor Guide Kap 1 S 19 Module anlegen Workbench Benutzer Guide Kap 3 3 S 129 Technical Workflow Diagramme Workbench Benutzer Guide Kap 12 S 311 inubit 6 1 Workbench Process Engine Systemkonnektor Guide 05 09 2013 62 Database Connector
261. en wie z B Windows Shared Verzeichnissen oder dem lokalen Repository kommunizieren kann Der Konnektor unterst tzt daf r das CIFS Samba und das Repository Protokoll Sie haben folgende Konfigurationsm glichkeiten Input Connector Holt Dateien aus einer virtuellen Verzeichnisstruktur und bergibt diese zur Weiterverarbeitung an einen Workflow Output Connector Schreibt das Ergebnis eines Workflows in eine Datei in einem virtuellen Verzeichnis Siehe auch Systemkonnektoren Workbench Process Engine Systemkonnektor Guide Kap 1 S 19 Module anlegen Workbench Benutzer Guide Kap 3 3 S 129 Technical Workflow Diagramme Workbench Benutzer Guide Kap 12 S 311 38 1 Modulvariablen des VFS Connectors Input Connector Bei der Ausf hrung eines VFS Connectors werden Modulvariablen gesetzt Die folgenden Variablen sind verf gbar wenn eine Datei gelesen wird und wenn als Ausgangsformat DATA gew hlt wurde Em ReadFileDate Letztes nderungsdatum der Eingangsdatei im Format yyyy MM dd T HH mm ss m ReadFileName Name der Eingangsdatei mit Extension inubit 6 1 Workbench Process Engine Systemkonnektor Guide 05 09 2013 398 VFS Connector Dialogbeschreibungen Output Connector ReadFileSize Gr e der Eingangsdatei in Bytes Die folgenden Variablen sind verf gbar wenn eine Datei geschrieben wird und wenn als Eingangsformat DATA gew hlt wurde WriteFileDate Erzeugungsda
262. en Intervallen die Verbindung wieder 05 09 2013 inubit 6 1 Workbench Process Engine Systemkonnektor Guide SAP Connector 339 Dialog SAP Connector Eigenschaften herzustellen Sie k nnen dieses Standardintervall in der SAP Connector Eigenschaftentabelle ndern Moduleigenschaft RetryInterval Angabe in Sekunden Modus Synchron Asynchron nur bei Einsatz als Input Listener und BAPI RFC Kommunikation Legen Sie fest ob die R ckgabewerte an SAP zur ckgegeben werden synchron oder nicht asynchron Weitere Einstellungen Transaktionshandling nur bei BAPI RFC als Medium Output Connector Mit Transaktionshandling Der SAP Connector setzt explizit ein Rollback bzw Commit ab Ohne Transaktionshandling Der SAP Connector setzt kein explizites Rollback bzw Commit ab Aufruffehlerbehandlung Exception werfen Bei einem Fehler wird eine Exception geworfen und die Ausf hrung des Workflows abgebrochen Inden Ausgabestrom schreiben Bei einem Fehler wird die Fehlermeldung als XML Datei ausgegeben und die Ausf hrung des Workflows fortgesetzt Die Fehlermeldung kann von einem nachfolgenden Modul behandelt werden Multi IDoc Verarbeitung nur bei Kommunikationsart IDoc Aktivieren Sie diese Option wenn bei der Ausf hrung eines Workflows mehr als ein IDoc verarbeitet werden soll Normalerweise wird in einem Workflow genau ein IDoc verarbeitet Dazu wird ber den SAP Connector eine Verbindung
263. en Parameter b ffnen Sie das Kontextmen und w hlen Sie Wert setzen Ein Dialog ffnet sich In diesem Dialog wird der Wert f r den gew hlten Parameter gesetzt Zur Unterst tzung wird der Datentyp des Parameters angezeigt Wenn es sich bei dem Parameter um ein Java Objekt mit einem komplexen Datentyp handelt dann muss zun chst ein passender Constructor zum Erzeugen dieses Java Objektes ausgew hlt werden Verfahren Sie wie im Schritt Constructor angeben beschrieben inubit 6 1 Workbench Process Engine Systemkonnektor Guide 05 09 2013 176 Java Reflection Connector Beispiel Methodenaufruf 9 Wenn alle Einstellungen vollst ndig sind beenden Sie den Assistenten Die Struktur der Eingangsnachricht wird erzeugt und angezeigt 10 Ziehen Sie die Struktur in den Bereich XML Ziel auf das lt xsl template gt Element um das XSLT Stylesheet zu erstellen F r Hinweise ber die Verwendung des XSLT Converters siehe Technical Workflow erstellen 3 CSV XML konvertieren nach openTRANS Tutorials Kap 4 5 S 72 11 Sie k nnen mit XSLT die Parameterwerte zur Laufzeit anpassen und berschreiben lassen dynamische Java Reflection Aufrufe realisieren 16 3 Beispiel Methodenaufruf Java Code Ergebnis Listing Listing 1 lt xml version 1 0 Listing 05 09 2013 Das mitgelieferte Beispiel Calling a method with simple parameters on a class instance setzt folgenden Java Code um St
264. en Service wiederholt aufruft dann muss sich der Konsument nicht erneut authentifizieren Security Mechanismus Zur Auswahl stehen die folgenden Service amp Consumer authentication with XML encryption and signature Fordert eine Authentifizierung vom Service und vom Konsumenten Die Daten werden durch XML Encryption verschl sselt Service amp Consumer authentication with transport security SSL Fordert eine Authentifizierung vom Service und vom Konsumenten Die Daten werden durch SSL verschl sselt Only Service authentication with transport security SSL Fordert eine Authentifizierung vom Service Die Daten werden durch SSL verschl sselt Security Token Service issued Token with Service Certificate STS Um den Service durch einen STS abzusichern Siehe Security Token Service Connector Workbench Process Engine Systemkonnektor Guide Kap 32 S 349 X 509 Truststore Button Datei ausw hlen Wenn ein Security Mechanismus mit Consumer authentication gew hlt wird dann kann sich der Service Konsument ber X 509 Zertifikate authentifizieren Der Button Datei ausw hlen ffnet einen Dateiexplorer zum Laden des Truststores mit den ffentlichen Schl sseln der Service Konsumenten Ein Truststore hat die Dateiendung jks Benutzer Passwort UsernameToken Wenn ein Security Mechanismus mit Consumer authentication gew hlt wird dann kann sich der Service Konsument ber den
265. en Sie den Truststore mit dem ffentlichen Schl ssel keytool import alias tomcat file public cer keystore public keystore storepass lt yourPassword gt 8 Importieren Sie das CA Zertifikat in den Truststore zur berpr fung der Zertifikatskette certificate chain check keytool import alias cacert file CAcert crt keystore public keystore storepass lt yourPassword gt 40 3 Schl sselpaare f r WS Trust erstellen Dieser Abschnitt erl utert die folgenden Themen m Selbstsigniertes Security Token Service STS Schl sselpaar erstellen S 437 Selbstsigniertes Service Schl sselpaar erstellen S 437 Verwendung Absicherung meist mehrerer Web Services durch einen Security Token Service STS ber zwei Schl sselpaare Schl ssel zur Authentifizierung eines Clients am STS Server Schl ssel zur Authentifizierung eines Clients am Web Services Funktionsweise Beim initialen Aufruf eines Web Service authentifiziert sich der Client zuerst am STS Nach erfolgreicher Authentifizierung erh lt der aufrufende Service den ffentlichen Schl ssel des Web Services vom STS wodurch der Zugriff auf dem Web Service erm glicht wird Die Authentifizierung am STS erfolgt mit WS Secure Conversation nur einmalig Um mit einer einmaligen Authentifizierung am STS den Zugriff auf mehrere Web Services zu erm glichen m ssen alle Webservices dieser Gruppe dasselbe Schl sselpaar nutzen 05 09 2013 inubit 6 1 Workbenc
266. en Solution Center Connector Starten Sie den Test ohne Datei 35 7 2 Objektdaten ber eine XPath Anfrage aktualisieren So gehen Sie vor 1 Erstellen Sie anhand des XSD Schemas Ihrer Business oder Process Solution eine XML Struktur mit den Attributen des Knotens den Sie andern wollen z B Uber einen XSLT Converter inubit 6 1 Workbench Process Engine Systemkonnektor Guide 05 09 2013 382 Solution Center Connector Beispiel Objekt l schen E E e A Q var stylesheet en XML source XML target y E A xal e C xs1 stylesheet ry http www w3 org 1999 XSL Transform d i xsl http www w3 org 200 1 XMLSchema d i xs B xs d i exdude result prefixes 2 0 d i version E xsl output method xml encoding UTF 8 amp d xsl template a http localhost 8000 sc 1315211273158 FleetPoolManagement lt fpm http inubit com businessrepository d i br false gt fpm Checked false Sales_Contract_2011_09_13 gt fpm ContractNumber Sales_Contract_2011_09_13 2011 09 13 gt fpm PurchaseDate 2011 09 13 R m weg EN EE E noni 2 Erstellen Sie einen Solution Center Connector 3 Konfigurieren Sie allgemeinen Moduleigenschaften und die System Connector Eigenschaften des Solution Center Connector Wechseln Sie auf das Register SC Connector Eigenschaften W hlen Sie den Modus Objektdaten aktualisieren 6 Geben Sie den Knoten an dessen Objektdaten aktualisiert we
267. en die Workflow Variablen a rs tBaQ 2 63 Properties version 4 1 Property name I5Sessionld 60C4BBODB1AFOEDSOC118A55294E3229 Property name ISPortletNamespace _75cfc19bc0a8005500a937ae1db4816a_WAR_isp Property name I5UserName inubitISPortallser intern Property name ISPortletActionUrl http localhost 8000 group inubit cockpit aufgaben p Property name ISWebLanguage de Property name ISPortalUser root t Property name SWebContextPath ep Property name ISParameters lt xml version 1 0 encoding UTF 8 gt lt parameters gt Die Informationen Uber die Portletinstanz werden angezeigt 39 3 Dialogbeschreibungen Dieser Abschnitt erl utert die folgenden Themen a Dialog Web Applikation S 408 m Dialog Interne Ressourcen S 411 m Dialog Rechteverwaltung S 412 39 3 1 Dialog Web Applikation In diesem Dialog haben Sie folgende Optionen Allgemeine Einstellungen m Kategorie 05 09 2013 Legt fest in welcher Anwendungskategorie das Portlet im inubit Enterprise Portal angeboten wird inubit 6 1 Workbench Process Engine Systemkonnektor Guide Web Application Connector 409 Dialogbeschreibungen Wenn Sie ein Portlet zu einer Seite hinzuf gen dann w hlen Sie es aus einer Liste von Kategorien aus Standardtitel des Portlets Zum Festlegen des Portlet Titels in den Standard Sprachen Deutsch und Englisc
268. en werden in den type Attributen der query Elemente definiert Falls kein type Attribut explizit angegeben ist dann wird ein READ ausgef hrt Mit der folgenden Eingangsnachricht werden erst alle Bestellungen aus der Datenbank gelesen und danach gel scht lt xml version 1 0 encoding UTF 8 gt lt queries gt lt READ default if no type is defined gt lt query xmlns bo http inubit com bo gt Bestellung lt query gt lt DELETE gt lt query xmins bo http inubit com bo type delete gt Bestellung lt query gt lt queries gt Voraussetzungen Sie haben eine XML Beispielnachricht die Ihr Gesch ftsobjekt repr sentiert Die Struktur des Gesch ftsobjekts muss dem XML Schema entsprechen das im Modulassistenten des BO Connectors angegeben ist So gehen Sie vor 1 Erstellen Sie einen XSLT Converter 2 Laden Sie das Mapping Template in den Bereich XML Zieldatei a ffnen Sie das J Men und w hlen Sie ffnen gt Repository Der Repository Browser ffnet sich inubit 6 1 Workbench Process Engine Systemkonnektor Guide 9 10 Business Object Connector 53 Querymodus verwenden b Navigieren Sie zu dem Mapping Template und laden Sie dieses Siehe Pfad des Mapping Templates Workbench Process Engine Systemkonnektor Guide Kap 5 S 52 Ziehen Sie das Queries Element unterhalb der gew nschten Operation nach oben in den Bere
269. en zu k nnen Wenn markiert dann werden die Eingangsnachrichten im Request Body URL kodiert und so formatiert als ob diese von einem Browser ber ein HTML Formular geschickt wurden z B inubit 6 1 Workbench Process Engine Systemkonnektor Guide 05 09 2013 152 HTTP Connector Dialog HTTP Connector Eigenschaften WEEZE ibis_root root tmp 10_Listen_08052008_174739_WThread 8 1 EES Datei ansehen Im oberen Bereich wird die Ergebnisdatei angezeigt im unteren Bereich werden die Text EDI l xml 3C 21DOCTYPE HTML PUBLIC 22 2FS2FW3C 2F 2FDTD H1 o Alin ARMAS Madho le AA a ad fr aa A n AN 0 MBN en bur E ae A An mn Post Feldname der Daten Sie k nnen das POST Feld xml s Abb oben durch einen beliebigen Namen ersetzen z B durch Eingangsdaten iS ibis_root root tmp 14_Listen_080520 Datei ansehen Im oberen Bereich wird die Ergebnisdatei angezeigt E Text EDI InputListener l Eingangsdaten 3C 21D0CTYPE HTML HTTP Post Wertepaar hinzuf gen ffnet einen Dialog in dem Sie Parameter als Name Wert Paare definieren k nnen Die Parameter werden an das Ende des Request Body geh ngt z B InputListener CT Er 319 321 322 09 09 30 2Fbody 3E 3C 2Fhtul 3Kspar2 abcsparl 123 et Anh S Ah ten Anbei un DA ste sn Rn 9 AARON A Map ET ech nm A ln ef EA nn Verbindungstest m Verbindung testen Zum Testen
270. ench Process Engine Systemkonnektor Guide Kap 25 3 S 272 Aktivieren Sie auf der Seite XSLT Converter Eigenschaften die Checkbox Eingangsnachricht ignorieren Passen Sie das XSLT Stylesheet so an dass die Nachricht als Ergebnis des Mappings folgende Struktur hat inubit 6 1 Workbench Process Engine Systemkonnektor Guide OpenOffice Connector 277 Dokument bearbeiten Eigenschaften XSLT Converter LPL G R H A XSLT Stylesheet ReplaceBookmark XML Quelle XML Ziel x 1 stylesheet http www w3 org 1999 XSL Transform d i xsl http www w3 org 2001 XMLSchema iG xs xs d i exdude result prefixes 2 0 a version amp Ee xs1 param oo document L name H xs1 output xml beq method UTF 8 ieg encoding St Ele x 1 template oO E OpenOfficeConnector CH B 49 OOWriter MS Word 97 a outputFilter CH ia InputDocument amp oo document i w xsl value of inubit AG G BookmarkReplace name Firma inubit AG Sch neberger Ufer 89 91 BookmarkReplace name Strasse Sch neberger Ufer 89 91 10785 G BookmarkReplace name PLZ 10785 Berlin G BookmarkReplace name Ort Berlin A B A O Quelvarab Name Typ Wert 17 BB H Q ergebnis des Mappings Ausf hrungszet in Milisekunden 18 uch OpenOfficeConnector E OOWriter outputFilter MS Word 97 lt gt InputDocument gt BookmarkReplace name Firma inubit AG gt BookmarkReplace
271. ench Process Engine Systemkonnektor Guide 05 09 2013 286 OSCI Connector Dialogbeschreibungen 05 09 2013 inubit 6 1 Workbench Process Engine Systemkonnektor Guide 27 REST Connector Verwendung Konnektortypen 287 Dieser Abschnitt erl utert die folgenden Themen Modulvariablen des REST Connectors S 288 REST Funktionsprinzip S 289 HTTP Methoden verwenden S 292 Ressource anbieten S 292 Verf gbare Input Connectoren anzeigen S 295 Publizierte Ressourcen anzeigen S 295 Ressource aufrufen S 296 Dialogbeschreibungen S 298 Der REST Connector bietet eine Schnittstelle um Daten via HTTP zu bertragen ohne dass es dabei eine zus tzliche Transportschicht wie z B SOAP gibt Der REST Connector wird genutzt um REST konforme Web Services ber eine URL aufzurufen oder anzubieten Die Funktionen des REST Connectors h ngen von der konkreten Konfiguration ab Input Listener Connector Stellt eine Ressource unter einer angegebenen URL zur Verf gung die von einem Client per Request angefragt werden kann Die angebotene Ressource stellt dabei das Ergebnis einer Workflow Ausf hrung dar Alle Parameter und Header die mit dem Request bergeben wurden stehen w hrend der Workflow Ausf hrung als Modulvariablen zur Verf gung Medium Output Connector Sendet als Client HTTP Requests an einen HTTP Server und gibt im Fall des Medium Connectors die zur ckgelieferte Antwort falls vorhanden an den Wo
272. enn die aufzurufende Aktion kein Ergebnis zur ckliefert Eingabe R ckgabe Daten Medium Output Connector Eingabe Ausgabenachricht verwenden Nur in Technical Workflows Wenn markiert dann wird der Web Service mit der Eingangsnachricht des Konnektors aufgerufen und die R ckgabenachricht wenn vorhanden wird wieder an den Konnektor bergeben Mit kompletter SOAP Nachricht Wenn markiert dann wird als Eingabe eine komplette SOAP Nachricht mit Envelope und Body ben tigt bzw als Ausgabe eine komplette SOAP Nachricht ausgegeben Mit nur Nutzdaten Inhalt von SOAP Body inubit 6 1 Workbench Process Engine Systemkonnektor Guide 05 09 2013 466 Web Services Connector Dialogbeschreibungen 40 16 5 Dialog UDDI Browser Lu UDDI Verbindungskonfiguration Wenn markiert dann wird als Eingabe nur das Element innerhalb des SOAP Body ben tigt bzw in der Ausgangsnachricht nur der Inhalt des SOAP Body ausgegeben Variablen verwenden Wenn markiert dann wird der Web Service Request aus der gewahlten Eingabe Variable erzeugt Falls der Web Service eine Response zur ck gibt dann wird diese in die Ruckgabe Variable geschrieben Eingabe Variable Zur Auswahl einer vorhandenen Variablen bzw zum Anlegen einer neuen Variablen R ckgabe Variable Zur Auswahl einer vorhandenen Variablen bzw zum Anlegen einer neuen Variablen Suchen 05 09 2013 Der UDDI Browser steht auch im Web Browser unter http
273. entifizierung vom Client erwartet Login Passwort Anmeldedaten des Clients am JMS Provider Sicherheit m Sicherheitsmanager benutzen Zum Aktivieren des Security Managers Security Manager sind abh ngig vom eingesetzten JMS JNDI Provider und sollten nur verwendet werden wenn sie laut den Vorgaben Ihres JMS Providers n tig sind Security Manager Name der Klasse in welcher der Security Manager implementiert ist Diese Klasse ist in den jar Dateien Ihres JMS Clients enthalten 18 2 2 Dialog Kommunikationsmodell In diesem Dialog haben Sie folgende Optionen Kommunikationsmodell Wahlen Sie eines der Modelle Publish Subscribe Dieses Modell wird f r allgemeine Broadcast Applikationen verwendet bei denen eine Nachricht viele Empf nger hat Ein Nachrichten Lieferant versendet Nachrichten zu einem Topic an alle Empf nger die sich vorher an dem Topic eingeschrieben haben Empf nger die zum Zeitpunkt des Versendens nicht eingeschrieben waren erhalten keine Nachrichten Sonderfall Dauerhafte Einschreibung WY Die Empfanger mussen sich einschreiben aber nicht standig aktiv inubit 6 1 Workbench Process Engine Systemkonnektor Guide 05 09 2013 194 JMS Connector Dialogbeschreibungen Einstellungen auf Nachrichten warten sondern k nnen sich diese sp ter abholen 05 09 2013 Point to Point Dieses Modell wird verwendet wenn Nachrichten nur einen Empf nger haben Die Nachric
274. ents wartet Durch die Aktivierung des Moduls bzw Workflows wird das Socket ge ffnet Sobald eine Nachricht eintrifft werden die nachfolgenden Module im Workflow ausgef hrt Bei konfigurierter Start Stopbyte Sequenz a Suche nach der Nachricht und Analyse der Start Stopbytes Siehe P Nachrichten mit Start Stopbyte Begrenzung verarbeiten Neue Features Kap 37 2 S 393 b Entfernung von Start Stopbytes wenn die erste Nachricht vollstandig empfangen wurde Durch die Start Stopbyte Sequenzen k nnen beliebig viele weitere Nachrichten empfangen werden Dadurch ist eine sequentielle Abfrage Antwortverbindung m glich c Pro Nachricht werden die nachfolgenden Module des Workflows einmal durchlaufen d Die Daten am Ende des Workflows werden an den aufrufenden Client zur ckgeschickt 05 09 2013 392 TCP IP Connector Konnektortypen Bei nicht konfigurierter Start Stopbyte Sequenz a b Die Nachricht besteht aus allen eingegangenen Bytes Das Nachrichtenende wird durch das Schlie en der Verbindung durch Client markiert Die Nachricht wird zur weiteren Bearbeitung an das n chste Modul im Workflow bergeben Beim Deaktivierung des Moduls bzw Workflows wird das Socket geschlossen Medium Connector Der Konnektor stellt eine Verbindung zum konfigurierten Server und Port her Bei konfigurierter Start Stopbyte Sequenz a d Der Konnektor sendet die Nachricht des vorhergehenden Moduls i
275. er der gesichert werden soll wurde mit der inubit Software erstellt Die URL des STS ist bekannt Folgende Daten liegen vor Keystore mit dem privaten Schl ssel des zu sichernden Web Services Truststore mit dem ffentlichen Schl ssel des STS So gehen Sie vor 1 ffnen Sie den Web Services Connector zum Bearbeiten 2 Aktivieren Sie im Register Erweitert im Bereich W3C Standards die Option WS Security und klicken Sie auf den Button Einstellungen Der Dialog WS Security Konfiguration ffnet sich 3 Geben Sie im Bereich Service Authentifizierung das Keystore Passwort an und importieren Sie den Keystore 4 W hlen Sie im Bereich Consumer Authentifizierung unter Security Mechanismus die Option Security Token Service issued Token with service certificate STS aus 5 Geben Sie im Bereich Consumer Authentifizierung im Feld STS Adresse die URL des STS an der Ihren Web Service absichern soll 6 Geben Sie an wie die Kommunikation Ihres Web Service Providers mit dem STS gesichert werden soll W hlen Sie X 509 und importieren Sie den Truststore mit dem ffentlichen Schl ssel des STS 7 Klicken Sie auf Fertig stellen 8 Publizieren und aktivieren Sie das Modul und ggf den enthaltenden Workflow In der WSDL Security Policy des Web Service Providers ist nun beschrieben wie und an welchem STS Consumer sich authentifizieren m ssen Falls noch n
276. er NUMBER 1 0 keyaccount user NUMBER 20 0 lastforum user NUMBER 20 0 contentarea_ user VARCHAR2 4000 deliveryplace user VARCHAR2 4000 DEFAULT 1 originp l ace user VARCHAR2 4000 DEFAULT 1 sms mail user VARCHAR2 1900 customer protection user NUMBER 1 0 lt value gt lt query gt lt query type select properties force gt lt value gt insert into xtrade user id user firstname_ user lastname user company user email user values 1 Hans M ller 1 h mueller karstadt de lt value gt lt query gt lt query properties force gt lt value gt DROP TABLE ORATEST TESTTABLE lt value gt lt query gt lt queries gt inubit 6 1 Workbench Process Engine Systemkonnektor Guide Database Connector 79 XML Querys Struktur und Beispiele lt xsl template gt lt xsl stylesheet gt 6 4 11 Subqueries SubSelects Sie k nnen SQL Abfragen verschachteln um das Ergebnis eines SubSelects in demselben Select auszuwerten SOL SELECT LieferscheinId ErstellungsDatum FROM LieferscheinTable WHERE factory SELECT factory FROM SpeditionsTable WHERE status X AND TransportId 10000037 AND gate SELECT gate FROM SpeditionsTable WHERE status X AND TransportId 10000037 AND status F Fla
277. er Web Service Consumer keine explizite MTOM Unterst tzung signalisiert hat dann werden die Anhangdaten inline in der SOAP Nachricht gesendet Sie definieren jeweils die eigentlichen Daten z B Grafiken als jpeg oder Dokumente als pdf als Workflow Variablen und passen die SOAP Nachricht so an dass ein Element vom Typ xmime base64Binary mit dem Attribut xmime contentType und dem jeweiligen Wert z B image jpeg enthalten ist Dabei m ssen Sie auch eine Variable anlegen die das Element der SOAP Nachricht angibt f r das die Daten bestimmt sind Die Elemente der SOAP Nachricht deren Inhalt mit Hilfe von MTOM verschickt werden soll m ssen mit dem Attribut xmime contentType belegt sein Voraussetzungen Web Services Medium Output oder Input Listener Connector ist angelegt und konfiguriert Siehe Web Service aufrufen Workbench Process Engine Systemkonnektor Guide Kap 40 4 S 421 m Sie haben eine SOAP Nachricht f r den Versand erstellt Siehe Web Service aufrufen Workbench Process Engine Systemkonnektor Guide Kap 40 4 S 421 So gehen Sie vor 1 Wahlen Sie im Modul Editor entweder den Web Services Medium Output oder Input Listener Connector der die Bin rdaten versenden soll inubit 6 1 Workbench Process Engine Systemkonnektor Guide 05 09 2013 448 Web Services Connector Bin rdaten als Attachments mit MTOM bertragen Beispiel f r SOAP Nachricht 05 09 2013 2 3 Zeigen Sie f
278. er eine Truststore Datei Wenn Sie einen Truststore w hlen werden Sie anschlie end nach dem Alias der Zertifikats gefragt Zur Authentifizierung des Service Konsumenten gegen ber dem Service a Passwort Passwort des privaten Schl ssels Keystore Button Datei ausw hlen ffnet einen Dateiexplorer zum Laden der j ks Datei die Ihre privaten Schl ssel enth lt Alias Wenn mehrere private Schlussel im Keystore liegen m ssen Sie den Alias des privaten Schl ssels angeben Name und Passwort des Kontos das f r den Zugriff auf den Server verwendet werden soll inubit 6 1 Workbench Process Engine Systemkonnektor Guide Web Services Connector 471 Dialogbeschreibungen 40 16 9 Dialog WS Reliable Messaging Konfiguration In diesem Dialog haben Sie folgende Optionen Nachrichten in Reihenfolge des Versands verarbeiten Die Option stellt sicher dass Nachrichten in derselben Reihenfolge beim Empf nger ankommen in der sie versendet wurden Nachrichten Zustellsicherheit W hlen Sie wie oft versucht werden soll eine Nachricht zuzustellen Ablaufsteuerung Zum aktivieren oder deaktivieren der Nachrichten Pufferung Maximale Puffergr e Geben Sie an wie viele Nachrichten maximal zwischengespeichert werden sollen Ist die maximale Puffergr e erreicht werden die brigen Nachrichten ignoriert Timeout bei Inaktivit t Wenn der Service nach Ablauf der angegebenen Zeit keine Nachricht von dem
279. er erhalten haben Siehe SSL Verbindung und Server Authentifizierung konfigurieren Process Engine Administrator und Entwickler Guide Kap 5 1 S 61 Verbindungstest m Verbindung testen Zum Testen ob die Verbindung mit Ihren Angaben erfolgreich aufgebaut werden kann 3 3 12 Dialog AS MDN Versand Konfiguration MDN Versand mit Output Connector Siehe Modulvariablen des AS2 Connectors Workbench Process Engine Systemkonnektor Guide Kap 3 1 S 32 inubit 6 1 Workbench Process Engine Systemkonnektor Guide 05 09 2013 42 AS2 Connector Dialogbeschreibungen Zum Laden des Keystores ben tigen Sie dessen Alias und Passwort 05 09 2013 inubit 6 1 Workbench Process Engine Systemkonnektor Guide Backup Connector Verwendung Dieser Abschnitt erl utert die folgenden Themen Dialog Backup Connector Eigenschaften S 43 Der Backup Connector sichert den aktuellen Systemzustand oder ausgew hlte Benutzer und Benutzergruppen und deren Daten Der Backup Connector kann zeitgesteuert gestartet werden so dass die Daten in regelm igen Zeitabst nden automatisch gesichert werden k nnen Siehe auch Datensicherung und wiederherstellung Process Engine Administrator und Entwickler Guide Kap 10 S 135 Systemkonnektoren Workbench Process Engine Systemkonnektor Guide Kap 1 S 19 Module anlegen Workbench Benutzer Guide Kap 3 3 S 129 Technical Workflow D
280. er ibis root log webservice log Siehe Callback Listener Connector anlegen Workbench Process Engine Systemkonnektor Guide Kap S 431 Bei Fehlerantwort Fehler werfen Wenn markiert dann wird ein Fehler bei der Workflow Ausf hrung ausgel st wenn der Output Connector eine Fehlerantwort Nachricht mit SOAPFault empf ngt Wenn der Fehler in der WSDL als m gliche Fehlerantwort definiert ist bekommt der ausgel ste Fehler den in der WSDL angegebenen Namen Publizieren nur Callback und Input Listener Connector Zum Publizieren der WSDL Datei in eine UDDI ffnet den Dialog UDDI Browser Workbench Process Engine Systemkonnektor Guide Kap 40 16 5 S 466 L schen Zum L schen einer bereits publizieren WSDL Datei aus einer UDDI Namensraume bearbeiten nur Input Listener Connector ffnet den Dialog Namensr ume bearbeiten Workbench Process Engine Systemkonnektor Guide Kap 40 16 10 S 471 Automatische Anpassung der Service Adresse in der WSDL deaktivieren Wenn die Option markiert ist inubit 6 1 Workbench Process Engine Systemkonnektor Guide Web Services Connector 463 Dialogbeschreibungen Der Host Port Teil der Service Adresse in der publizierten WSDL wird nicht angepasst Wenn die Option nicht markiert ist Der Host Port Teil der Service Adresse wird aus der URL der WSDL Anforderung bernommen Die Service Adresse in der publizierten WSDL wird wie folgt angepasst
281. erden abgeschnitten k rzere werden mit Leerzeichen aufgef llt Textdateien im Format V Zeilen die l nger sind als die maximale Satzl nge werden abgeschnitten k rzere Zeilen bleiben unver ndert nur Output Connector Formatinformation f r die Datei an die bertragen werden soll Format Text Zum bertragen von Textdateien im ASCII Format Feste S tze Zum bertragen von Dateien mit festen Satzl ngen Variable S tze Zum bertragen von Dateien mit variablen Satzl ngen Unstrukturiert Zum bertragen bin rer Dateien Maximale Satzl nge F r feste und variable S tze k nnen Sie eine maximale Satzl nge angeben nur bei Output Connector Sicherheitsmerkmale W hlen Sie die gew nschte Sicherheitsstufe Kompression Checkbox zum Aktivieren Deaktivieren der Datenkompression Verschl sselung Checkbox zum Aktivieren Deaktivieren der Dateiverschl sselung Hierbei handelt es sich nicht um die Session Verschl sselung von TLS Weitere Informationen zur Verschl sselung entnehmen Sie der rvsEVO Dokumentation Verschl sselungsalgorithmus Zur Auswahl des Verschl sselungsalgorithmus Standard DES EDE3_CBC Dateisignatur Checkbox zum Aktivieren Deaktivieren der Verwendung einer Dateisignatur Signierten EERP NERP beantragen Checkbox zum Beantragen Nichtbeantragen eines signierten EERP NERP inubit 6 1 Workbench Process Engine Systemkonnektor Guide OFTP2 Con
282. ereich XML Zieldatei das Men W hlen Sie ffnen von gt JCA Explorer Der Assistent ffnet sich W hlen Sie eine der beiden Optionen JCA Library ausw hlen jar inubit 6 1 Workbench Process Engine Systemkonnektor Guide JCA Connector 183 Eingangsnachricht erstellen W hlen Sie diese Option wenn Sie den Namen der JCA Library kennen Diese Auswahl schr nkt die Klassen auf diejenigen ein welche die Library anbietet und erleichtert damit das Auffinden der passenden Eintr ge JCA InteractionSpec Klasse ausw hlen Wahlen Sie diese Option wenn Sie den Namen der JCA Library nicht kennen Mit der InteractionSpec Klasse werden die auf dem JCA Resource Adapter aufzurufenden Funktionen festgelegt 5 Klicken Sie auf Weiter und lassen Sie sich von dem Assistenten durch die n chsten Dialoge f hren 6 Record festlegen W hlen Sie den Typ des Datensatzes aus der als Input Parameter dienen soll und benennen Sie diesen MappedRecord Liste deren Werte ber einen alphanumerischen Index referenziert sind IndexedRecord Liste deren Werte ber einen numerischen Index referenziert sind 7 Methode einf gen a W hlen Sie im Baum den Knoten Methods aus b ffnen Sie das Kontextmen und w hlen Sie Methode hinzuf gen Ein Dialog ffnet sich c W hlen Sie alle Methoden die aufgerufen werden sollen d Klicken Sie auf OK um zur ck in die Baumansicht zu gelangen Die ge
283. erfolgreich signiert nicht erfolgreich signiert wird in eine Workflow Variable geschrieben Der Secrypt Connector kopiert das signierte Dokument in ein definiertes Eingangsverzeichnis des Secrypt Verifiers Dieser pr ft das Dokument und legt das Pr fprotokoll gepr ftes Dokument Ergebnis und Signatur in definierte Ausgangs und Pr fdokumentationsverzeichnisse Der Secrypt Connector l scht bei jeder Ausf hrung alle selbst erstellten Dateien die in den Eingangs Ausgangs bzw Pr fdokumentationsverzeichnissen vorhanden sind inubit 6 1 Workbench Process Engine Systemkonnektor Guide 05 09 2013 344 Secrypt Connector Beispiel Workflow Falls der DigiSeal Server bzw Secrypt Verifier nicht auf demselben Rechner wie die inubit Process Engine laufen muss der Secrypt Connector als Remote Connector ausgef hrt werden Siehe Modulvariablen Workbench Process Engine Systemkonnektor Guide Kap 31 3 S 345 31 2 Beispiel Workflow 05 09 2013 Im folgenden Workflow wird ein PDF Dokument erst signiert und dann gepr ft So gehen Sie vor 1 Erstellen Sie einen Technical Workflow mit zwei Secrypt Medium Connectoren Geben Sie als Nachrichtentyp jeweils PDF an W hlen Sie beim ersten Connector den Modus Signieren und bei der Eingangs sowie Ausgangsdatenkonfiguration Bin rdaten W hlen Sie beim zweiten Connector den Modus Pr fen bei der Eingangsdatenkonfiguration Bin rdaten
284. ermedi r AA 283 26 3 2 Dialog Erstellen von OSCI Nachrichten am Intermedi r 444444nssnnnnnn nennen nennen 284 ZART SSH RR 287 27 1 Modulvariablen des REST Connectors 288 21 2 REST F nktionsprinzip u TEE 289 27 3 HTTP Methoden verwenden 2 ccccscsccececseecceeeeeneeneeeeecaeeeeeeeeeeneneetescadueeeenecedeneeeseeaeeeeeesecedenseeeseneeneees 292 27 4 Ressource anbietet EE 292 27 5 Verf gbare Input Connectoren anzeigen rn ann 295 27 6 Publizierte Ressourcen anzeigen sisse rn ran and nnd 295 27 1 Ressource Aufr fen nun endete 296 27 8 E ele elen EE 298 27 8 1 Dialog Konfiguration der Ressource 298 27 8 2 Dialog Konfiguration der Antwort 300 27 8 3 Dialog Konfiguration der Anfrage u 2244444nnssnnnnnnennnnnnnnnnnennnnnnnnnnnnnnnnnnnnnnnnnennnnnnnennn ann 302 28 RFID el ET 305 28 1 Funkti nsprinzip MEET 305 28 2 Beispiel Ausgangsnachricht s He aaa rad 306 28 3 Dialog RFID Port Connector Eigenschaften AAA 307 29 RosettaNet HTTPS Connector uunssennensnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnsnnnnennnnnnnnnnnnnsnnn nennen nnnnnnnnnnnnnnn 309 29 1 Struktur und Austausch von RosettaNet Nachrichten A 310 29 2 Beispiel Workflow RosettaNet Nachrichten erzeugen nenn nenn 312 29 3 Beispiel Workflow RosettaNet Nachrichten versenden nennen 314 29 4 Beispiel Workflow Nachrichten empfangen und Best tigung senden nen 316 29 5
285. ers Port Port der f r die Kommunikation genutzt wird Der Button Standard stellt den Standard Port wieder her Authentifizierung m Konto Benutzername f r das Mailkonto a Passwort Passwort f r das Mailkonto Zus tzliche Optionen nur bei IMAP und IMAPS als Protokoll AUTHENTICATE PLAIN Kommando bei der Authentifizierung vermeiden Wenn markiert wird die PLAIN Authentifizierung deaktiviert Diese Option ist sinnvoll bei der Anbindung des Exchange Q Servers 2007 Verbindungstest m Verbindung testen Zum Testen ob die Verbindung mit Ihren Angaben erfolgreich aufgebaut werden kann 21 2 2 Dialog Datenweitergabe konfigurieren Input Connector In diesem Dialog haben Sie folgende Optionen inubit 6 1 Workbench Process Engine Systemkonnektor Guide 05 09 2013 218 Mail Connector Dialogbeschreibungen Einstellungen f r die Datenweitergabe 05 09 2013 MIME F r E Mails im MIME Format Die E Mail wird unver ndert an das n chste Modul des Workflows weitergeleitet Die MIME Spezifikation erm glicht es Nachrichten in Sprachen mit unterschiedlichen Zeichens tzen oder multimedial erweiterte Email auszutauschen Eine MIME E Mail enth lt zus tzliche standardisierte Felder in den Headern welche die Datentypen des Inhalts und die Organisation der Nachrichten beschreiben MIME XML F r E Mails im MIME Format Die E Mail wird entsprechend ihrem MIME Typ kodiert und der Inhalt der Em
286. ert und f hrt zu einem Fehler im Modul So gehen Sie vor 1 Erstellen Sie einen XSLT Converter 2 ffnen Sie im Bereich XML Zieldatei das 4 Men 3 W hlen Sie ffnen von gt Java Reflection Explorer Der Assistent ffnet sich Lassen Sie sich von dem Assistenten durch die Erstellung der Nachricht leiten Siehe auch Eigenen Methodenaufruf erzeugen Workbench Process Engine Systemkonnektor Guide Kap 16 2 S 174 Beispiel Methodenaufruf Workbench Process Engine Systemkonnektor Guide Kap 16 3 S 176 16 2 Eigenen Methodenaufruf erzeugen 05 09 2013 Voraussetzungen Sie m ssen die jar Datei in die inubit Process Engine laden welche die Klasse enth lt deren Methoden ber den Java Reflection Connector aufgerufen werden sollen Siehe Plug ins installieren Process Engine Administrator und Entwickler Guide Kap 20 2 1 S 295 So gehen Sie vor 1 ffnen Sie den Java Reflection Explorer Siehe Eingangsnachricht erstellen Workbench Process Engine Systemkonnektor Guide Kap 16 1 S 173 2 W hlen Sie im ersten Dialog die Option Klasse Methode definieren aus inubit 6 1 Workbench Process Engine Systemkonnektor Guide Java Reflection Connector 175 Eigenen Methodenaufruf erzeugen 3 Klicken Sie auf Weiter Der n chste Dialog wird angezeigt Markieren Sie die Klasse auf welcher der Methodenaufruf erfolgen soll Wenn die gew nschte Klasse nicht in de
287. ese abzusichern Voraussetzungen Die Web Services die abgesichert werden sollen sind bereits vorhanden und die URL ber welche diese Web Services zu erreichen sind sind bekannt Die Truststores mit den ffentlichen Schl sseln aller Web Services die von dem STS gesichert werden sollen liegen vor So gehen Sie vor 1 Erstellen Sie einen STS Connector oder ffnen Sie einen vorhandenen zum Bearbeiten 2 Klicken Sie im Dialog Security Token Service WS Trust Workbench Process Engine Systemkonnektor Guide Kap 32 S 355 im Bereich Gesicherte Service Provider auf Hinzuf gen Der folgende Dialog ffnet sich inubit 6 1 Workbench Process Engine Systemkonnektor Guide Security Token Service Connector 353 Web Services Provider an STS Connector registrieren nenne anne FE nn Fi Gesicherte Service Provider q Sr alt Se inf A AEN ee Ae rt 7 LE SE DN R en URI des Provider Endpoints Service Provider hinzuf gen Geben Sie die URL und den ffentlichen Schl ssel des zu sch tzenden Service Providers an Das 509 Zertifikat muss der Version 3 mit SubjectKeyIdentifier entsprechen URI des Provider Endpoints http flocalhost 8000 ibis ws mySecuredService x 509 Zertifikat Truststore oder Zertifikat hinzuf gen G ltigkeit 2010 05 18 BEER nam ms m ET ni ati a ma te 3 Geben Sie im Feld URI des Provider Endpoints die URL des Web Service Provide
288. esendet Standardm ig ist die Option NORMAL siehe unten vorausgew hlt Die folgenden M glichkeiten stehen zur Verf gung NORMAL NEVER HOLD SYNC und ROUTING SYNC Siehe Nachbarstationen Workbench Process Engine Systemkonnektor Guide Kap 24 6 2 S 260 f r Infos ber die Eintr ge die f r die Empfangsbest tigungen gew hlt werden k nnen Wenn Sie eine Nachbarstation markieren k nnen Sie aus dem Kontextmen die Option Verbindung aktivieren ausw hlen Mit dieser Option k nnen Sie testen ob eine Verbindung mit den angegeben Daten zur konfigurierten Nachbarstation aufgebaut werden kann inubit 6 1 Workbench Process Engine Systemkonnektor Guide 24 6 2 7 Entfernen 24 6 3 Empf nger Empf nger entfernen Lu Empf nger hinzuf gen OFTP2 Connector 267 Dialog Stationen Wenn Sie eine Nachbarstation markieren k nnen Sie aus dem Kontextmen die Option Entfernen ausw hlen Wenn Sie diese Option w hlen wird die ausgew hlte Nachbarstation nach der Best tigung in einem Meldungsfenster gel scht Diese Ver nderung l scht auch die ausgew hlte Nachbarstation in der rvsEVO Software Dieser Abschnitt erl utert die folgenden Themen a TCP IP Empf nger konfigurieren S 268 m ISDN Empf nger konfigurieren S 268 m XOT Empf nger konfigurieren S 269 a TLS Empf nger konfigurieren S 270 Ein Empf nger ist eine Verbindungskonfiguration die auf einem der fo
289. eser Web Services Medium Listener Connector wartet auf die anlegen Antwort des Web Services Der Workflow stoppt unmittelbar vor diesem Connector und wird erst fortgesetzt nachdem die Antwort eingetroffen ist Liegt die Antwort bereits vor bevor der Workflow den Callback Listener erreicht hat wird sie zwischengespeichert So gehen Sie vor 1 Legen Sie einen neuen Web Services Connector an benennen Sie ihn und klicken Sie auf Weiter um zum n chsten Register zu gelangen inubit 6 1 Workbench Process Engine Systemkonnektor Guide 05 09 2013 432 Web Services Connector Asynchrone Web Services 05 09 2013 2 W hlen Sie auf dem Register System Connector Eigenschaften f r Verwendung den Eintrag Asynchrone Antwort Nachrichten Callbacks empfangen Die Option Medium Connector Workflow Mitte und die Checkbox Auf Datenempfang warten Listener Connector werden automatisch aktiviert 3 Klicken Sie auf Weiter um zum Register Bereitgestellter Web Service zu gelangen 4 Klicken Sie im Bereich Callback Listener spezifische Einstellungen in der Zeile WSDL von zugeh rigem Aufrufer Modul importieren auf das Icon 5 W hlen Sie den aufrufenden Web Services Connector den Sie am Anfang dieses Workflows angelegt haben 1 Modul ausw hlen Eee Module von Gruppe admin H E System Connector E P Module von Benutzer jh El P System Connector En
290. eseseaaeeeeeeaeeeeneneees 65 6 4 1 Struktur von XML Querys reed ae 65 64 2 Select Daten anzeige u 3 0 aaa balance blau 69 6 4 3 Select Distnct AAAA A ANNAA AAAA 70 6 4 4 Daten aus verschiedenen Tabellen Join 4444ssrsnnnennnennnnnnnnnnnnnnnnnnnennnnnnnnnnnnnnnnnnnnnnnnnnn mann 71 6 4 5 Datens tze einf gen Insert aneinander 72 6 4 6 Datens tze aktualisieren Update en 73 6 4 7 UpdateCtnsert ttrt tnr tE EAEE SAEESE EEEE EEEEEESEEESEEEEEEEEEEEESEESREESEEEEEEEEERES SEESE EEEE 74 6 4 8 Datens tze l schen Delete 2 4u u nu een 75 6 4 9 Mehrere SQL Statements in einer Abfrage A 75 6 4 10 SQL Statements direkt bergeben Force 78 6 4 11 Subqueries SubSelects en 79 6 4 12 Stored Procedures aufrufen Call r24244404444Ha44HaHRnnnnanannnnnnnnnannnnnnnannannannnnnnnnnnnnannannnnnnn 81 6 5 Dialogb amp schreib ngen u nee ea A A 84 6 5 1 Dialog Datenbankverbindungen und Ouen Twp nenn nenn 84 6 5 2 Dialog Metadaten AA 87 6 5 3 Dialog Statische Iesst UNENEE aan 88 6 5 4 Dialog Ergebnis der Query aaa ante 88 6 5 5 Dialog Datenbank Connection Pooling AA 90 05 09 2013 inubit 6 1 Workbench Process Engine Systemkonnektor Guide Inhaltsverzeichnis 7 Database Object Connector uusneesnnnnsennnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnrnnsnnnnnnnnsnnnnnnnnsnnnnnnrrssnnnnnernssnnnnerrnsnnnnnnrrnsnnen 93 7 1 Gesch ftsobjekte lesen erstellen bearbeiten oder l schen en 94 7
291. est gt lt addRequest gt lt delRequest gt lt delRequest gt lt batchRequest gt Die Response ist abh ngig von der Konfiguration des Connectors Bei einem Output Connector werden Fehler bzw Erfolgsmeldungen zur ckgegeben Bei einem Medium Connector werden die Ergebnisse in Form einer DSMLv2 Response zur ckgesendet lt batchResponse xmins urn oasis names tc DSML 2 0 core gt lt modifyResponse gt lt modifyResponse gt lt addResponse gt lt addResponse gt lt delResponse gt lt delResponse gt lt batchResponse gt 19 2 DSMLv2 Anweisungen in Requests Dieser Abschnitt erl utert folgende DSMLv2 Anweisungen 05 09 2013 Modify S 201 Search S 202 Add S 203 Delete S 203 inubit 6 1 Workbench Process Engine Systemkonnektor Guide Lu DN Attribute in Anweisungen 19 2 1 Modify Beispiel LDAP Connector 201 DSMLv2 Anweisungen in Requests F r alle Zugriffe auf konkrete Eintr ge eines LDAP Servers ben tigen Sie die eindeutigen Namen distinguished names der entsprechenden Objekte Jede Anweisung in einem Request muss ein DN Attribut distinguished names enthalten Das DN Attribute wird ben tigt um einen Eintrag in einem LDAP Verzeichnis eindeutig zu identifizieren und beschreibt wo genau in der Verzeichnishierarchie sich der Eintrag befindet Siehe auch DSML Dokumentation unter http www oasis open org committees dsml docs DSMLv
292. et PKI Aktiviert Deaktiviert die PKI Anbindung a Zertifikatsvalidierung Legt fest wie die Zertifikate validiert werden sollen Der weitere Aufbau des Dialogs fur die Nachbarstation hangt davon ab welches Verbindungsprotokoll Sie ausgew hlt haben inubit 6 1 Workbench Process Engine Systemkonnektor Guide 24 6 2 1 Nachbarstation ber TCP IP 24 6 2 2 Nachbarstation ber ISDN OFTP2 Connector 263 Dialog Stationen IP Adresse Name oder IP Nummer des Rechners ber den die TCP IP Verbindung l uft Port Portnummer f r die TCP IP Verbindung Wenn Sie eine Nachbarstation konfigurieren die ber ISDN verbunden ist wird automatisch das X 25 Protokoll zur Konfiguration hinzugef gt da ISDN allein nicht zum Aufbau einer OFTP2 konformen Verbindung ausreicht Nummer des zugeordneten Empf ngers Wird automatisch vergeben Typ Pflicht Nicht konfigurierbar Karten Nummer Pflicht Wird automatisch vergeben ISDN Adresse Entspricht der ISDN Nummer des Partners Typ blicherweise CAPI2A ISDN Protokoll Gibt den genutzten ISDN Standard an 1TR6 Deutscher Landesstandard E DSS1 EURO ISDN Standard Paketgr e blicherweise die Paketgr e 128 ISDN Facilities Meist nicht angegeben ISDN Benutzerdaten Meist nicht angegeben Wenn Sie Facilities und Benutzerdaten angeben m chten dann als HEX Code Die Daten werden nur f r X 25 ber ISDN bertragungen ben tigt wenn Ihr X
293. et die M glichkeit bei der Kommunikation einen sogenannten Community String zu bermitteln Nur Komponenten die in derselben Community sind reagieren auf Traps oder Konfigurationsbefehle Der Community String wird unverschl sselt verschickt Beispiel Medium Connector ber einen SNMP Medium Connector soll im Workflow ber einen Router eine ISDN Verbindung aufgebaut werden ber diese soll anschlie end am Ende des Workflows eine Nachricht an einen FTP Connector geschickt werden Beim SNMP Medium Connector kann keine Tabelle mit Tupeln aus OID und Wert angegeben werden Hier werden die entsprechenden Wertepaare in der XML Eingangsnachricht erwartet Der Wert einer OID kann eine der folgenden Angaben sein keine Angabe Die OID ist selbst die Anweisung zu einer Konfiguration Ganze Zahl Die Konfiguration ist abh ngig vom Zahlenwert Text In einer XML basierten Eingangsnachricht haben diese drei F lle das folgende Format OIDs und Werte sind Beispiele inubit 6 1 Workbench Process Engine Systemkonnektor Guide 05 09 2013 366 SNMP Connector Beispiel Medium Connector 05 09 2013 lt Property name 1 3 6 1 4 1 272 4 4 1 1 4 10001 0 gt lt Property name 1 3 6 1 4 1 272 4 3 1 1 7 1 4 type Integer gt 2 lt Property gt lt Property name 1 3 6 1 4 1 272 4 4 1 1 4 10001 0 gt UID name lt Property gt Der Router wird dynamisch w hrend der Workflow Ausf
294. et haben erfragen Sie dort das unterst tzte Adressformat Abk Steht f r Erl uterung S Surname Name der Firma Statt S und O oder Nachname der k nnen Sie auch Absenders die UA ID ver O Organization Beliebiger Name EE zZ Name z B O tu berlin a RE A viaT C de wenn die Internetad resse cs tu berlin te lekom de ist A Administration Z B A inubit wenn Ob Angaben f r Domain die Internetadresse A und C erforder www inubit com ist lich sind und wel viaT bedeutet che Werte sie dass die Adresse bei enthalten kann der Telekom ange Ihnen der Emp meldet ist f nger mitteilen C Country Name Z B C de f r Deutschland Gro und Kleinschreibung werden nicht unterschieden m Passwort Sie erhalten das Passwort von Ihrem X 400 Provider Keep alive Konfiguration der m Keep alive aktivieren Verbindung Wenn markiert dann wird die Verbindung zwischen X 400 Box und dem X 400 SE Connector so lange offen gehalten bis das Timeout abgelaufen ist Aktivieren Sie diese Option wenn Ihr X 400 Provider die Kosten pro Login abrechnet Timeout Sekunden Das Timeout gibt an wie viele Sekunden nach der letzten Ausf hrung des Konnektors die Verbindung geschlossen werden kann Durch Angabe eines Timeouts vermeiden Sie dass Verbindungen z B nachts offen bleiben obwohl keine Workflows ausgef hrt werden Verbindungstest m Verbindung testen Zum Testen ob die Verbindung mit Ihren Angaben erfolgreich aufgebaut we
295. f Siehe IETF AS2 Spezifikation unter http www ietf org rfe rfc4 130 txt 3 3 Dialogbeschreibungen Dieser Abschnitt erl utert die folgenden Themen Dialog AS2 Konfiguration S 36 Dialog AS S MIME Konfiguration S 36 Dialog AS2 Listener Konfiguration S 37 Dialog Message Archiv Konfiguration S 38 Dialog AS MDN Validator S 38 Dialog AS2 Listener Konfiguration S 38 Dialog AS2 Konfiguration S 38 Dialog AS Nachrichten Konfiguration S 39 Dialog AS MIME Konfiguration S 39 Dialog AS MDN Konfiguration S 40 Dialog HTTP S Server Konfiguration S 41 Dialog AS MDN Versand Konfiguration S 41 3 3 1 Dialog AS2 Konfiguration Input Listener Connector In diesem Dialog legen Sie fest ob der Input Listener Connector Nachrichten oder Empfangsbest tigungen empfangen soll 3 3 2 Dialog AS S MIME Konfiguration Nachrichtenempfang mit Input Listener Dieser Dialog bietet folgende Optionen 05 09 2013 inubit 6 1 Workbench Process Engine Systemkonnektor Guide AS2 Connector 37 Dialogbeschreibungen Signatur berpr fen Wenn die Option markiert ist dann werden die Signaturen aller eingehenden Nachrichten berpr ft Zum Pr fen wird der ffentliche Schl ssel des Gesch ftspartners ben tigt von dem Sie die Nachrichten empfangen Truststore oder Zertifikat hinzuf gen Button ffnet einen Dateiexplorer zum Laden des ffentl
296. fe Session Cookies ben tigen m ssen Sie nur daf r sorgen dass die WSCallerCookies Variable an das n chste Modul bergeben wird 40 5 Asynchrone Web Services Verwendung Dieser Abschnitt erl utert die folgenden Themen m Asynchronen Web Service anbieten S 427 m Asynchronen Web Service aufrufen S 429 Bei einem asynchronen Web Service sind das Versenden der Anfragenachricht und das Erhalten der Antwortnachricht entkoppelt Beide Nachrichten werden ber separate HTTP Verbindungen gesendet Damit kann die Bearbeitung der Anfrage l nger dauern ohne dass die Verbindung wegen eines Timeouts unterbrochen wird Asynchrone Web Services sind daher insbesondere f r langlaufende Services geeignet inubit 6 1 Workbench Process Engine Systemkonnektor Guide 05 09 2013 426 Web Services Connector Asynchrone Web Services Im Folgenden wird der Kommunikationsablauf bei einem asynchronen Service Aufruf skizziert In dem Beispiel sind beide Kommunikationspartner ber Technical Workflows implementiert In der Praxis muss dies nat rlich nicht der Fall sein Funktionsprinzip Ein Workflow der einen asynchronen Web Service anfordert wird bis zu einem Callback Listener abgearbeitet Der Workflow des aufgerufenen Web Services generiert w hrenddessen die Antwort Ein Reply Modul am Ende des aufgerufenen Workflows sendet die Antwort an den aufrufenden Workflow Der Callback Listener im aufrufenden Workflow nimmt die Antwort ent
297. fields gt lt field gt lt fieldName gt gate lt fieldName gt lt field gt lt fields gt lt conditions gt lt condition type AND gt lt leftValue gt status lt leftValue gt lt operation gt lt operation gt lt rightValue gt X lt rightValue gt lt condition gt lt condition type AND gt lt leftValue gt TransportId lt leftValue gt lt operation gt lt operation gt lt rightValue gt lt xsl value of select FormPrepare Response Panel Transporte SLB Nr gt lt rightValue gt lt condition gt lt conditions gt lt table gt lt table gt lt tableNames gt lt tableName gt LieferscheinTable lt tableName gt lt tableNames gt lt fields gt lt field gt lt fieldName gt LieferscheinId lt fieldName gt 05 09 2013 inubit 6 1 Workbench Process Engine Systemkonnektor Guide Database Connector XML Querys Struktur und Beispiele lt field gt lt field gt lt fieldName gt ErstellungsDatum lt fieldName gt lt field gt lt fields gt lt conditions gt lt condition type AND gt lt leftValue gt factory lt leftValue gt lt operation gt lt operation gt lt rightValue type subselect gt subFactory lt rightValue gt lt condition gt lt condition type AND gt lt leftValue gt gate lt leftValue gt lt operation gt lt operation gt lt rightValue type subselect gt subGate lt rightValue gt lt condition gt l
298. flow validiert Login Daten die in eine Formular Task eingegeben wurden Der Workflow wird gestartet durch den Input File Connector Trigger Der Task Generator Account Validation erzeugt eine Formular Task die in der Taskliste angezeigt wird Diese Formular Task besteht aus Eingabefeldern f r Benutzername und Passwort sowie einem Submit Button Nach dem Klick auf den Submit Button werden die eingegebenen Daten an den JAAS Connector Form Validation bergeben Wenn die Formular Task erneut aufgerufen wird dann wird wieder das Formular angezeigt Falls die eingegebenen Daten falsch waren wird eine Fehlermeldung angezeigt inubit 6 1 Workbench Process Engine Systemkonnektor Guide 05 09 2013 170 JAAS Connector JAAS Connector erweitern 15 3 JAAS Connector erweitern Sie k nnen die Funktionalit t des JAAS Connectors durch selbst entwickelte Authentifizierungsmodule erweitern Dazu m ssen Sie die jar Datei des Authentifizierungsmoduls in die inubit Process Engine hochladen So gehen Sie vor 1 Laden Sie die jar Datei in die inubit Process Engine Siehe Plug ins installieren Process Engine Administrator und Entwickler Guide Kap 20 2 1 S 295 2 Erstellen Sie einen JAAS Connector 3 Geben Sie im Dialog JAAS Connector Eigenschaften Workbench Process Engine Systemkonnektor Guide Kap 15 4 S 170 im Feld Login Modul den Klassennamen ein 4 Geben Sie die Parameter Ihres Moduls u
299. g auf Nachrichten warten Stattdessen k nnen sie diese sp ter abholen Subskriptions ID ID des Clients f r die Verbindung Login Nutzername des Clients m Passwort Passwort Verbindung testen Zum Testen ob die Verbindung mit Ihren Angaben erfolgreich aufgebaut werden kann 18 2 3 Dialog Nachrichten Selektor 05 09 2013 Nachrichten Selektor Lu In diesem Dialog haben Sie folgende Optionen Nachrichten Selektor werden genutzt um gezielt Nachrichten aus einem Topic oder einer Queue auszuw hlen Wenn ein Nachrichten Selektor angegeben ist dann werden nur Nachrichten an den Client bergeben deren Header und Properties zu dem Nachrichten Selektor passen Nachrichten Selektoren k nnen nicht auf Werte im Nachrichten Body zugreifen Ein Nachrichten Selektor ist ein bedingter Ausdruck bestehend aus einem Identifier und einem Operator gefolgt von einem Literal Die folgende Tabelle zeigt wie Nachrichten Selektoren konstruiert werden Element G ltige Werte Identifier Property oder Header Feldreferenz Operatoren AND OR LIKE BETWEEN lt gt lt gt lt gt IS NULL IS NOT NULL inubit 6 1 Workbench Process Engine Systemkonnektor Guide Element JMS Connector 197 Dialogbeschreibungen G ltige Werte Literale boolean byte short int long float double String Ef Siehe auch die JMS Spezifikation Version 1 1 Abschnitt Message Selector unter http j
300. g fehlschl gt Wenn markiert dann wird im Queue Manager ein Fehlereintrag f r den Workflow mit diesem Modul angezeigt Ist ein Fehlerausgang konfiguriert wird dieser durchlaufen Sonst wird die Ausf hrung des Moduls abgebrochen Maximale Anzahl von Dateien pro zeitgesteuertem Aufruf inubit 6 1 Workbench Process Engine Systemkonnektor Guide 05 09 2013 158 inubit IS Connector Dialogbeschreibungen Lesereihenfolge Numerischer Wert z B 100 um die Systemauslastung der inubit Process Engine bei Aufruf von File Connectoren zu steuern Legt die Reihenfolge fest in der die Dateien geholt werden 13 3 5 Dialog Output Datei en Output Datei en 05 09 2013 Bei Output Listener Connector In diesem Dialog konfigurieren Sie das Schreiben der Dateien Verzeichnis Name des Verzeichnisses aus dem der Connector Dateien entgegennehmen soll Name der Dateien Name der Dateien die der Connector entgegennehmen soll Bei der Angabe des Dateinamens k nnen Sie Wildcards verwenden z B Inputdata xml Wildcard Inhalt des vorher ausgef hrten File oder FTP Connectors verwenden Wenn markiert dann wird der Wildcard Inhalt verwendet der von einem vorher ausgef hrten File oder FTP Connector erzeugt wurde Beispiel Ein vorher ausgef hrter File Connector wurde so konfiguriert das im Feld Dateiname eine Datei Test xml angegeben wurde Als Ausgangsnachricht wurde vom File Connector eine D
301. g wartet Wenn nach Ablauf dieser Zeit keine Verbindung hergestellt werden kann dann wird die Modulausf hrung abgebrochen und ein Fehler geworfen Wenn Sie den Wert auf Null setzen ist die Wartezeit unendlich Wenn Sie die Option Standard Timeout markieren wird der Timeout auf 600 Sekunden gesetzt Input Output Message Logging Wenn diese Option aktiv ist werden die Eingabe und Ausgangsnachrichten des Systemkonnektors gespeichert Diese Funktion ist n tzlich bei der Fehlersuche und beim Testen wenn z B Nachrichten nicht bei einem Gesch ftspartner angekommen sind und erneut bermittelt werden m ssen oder wenn ein Workflow fehlerhaft ausgef hrt wurde und mit denselben Eingangsnachrichten erneut gestartet werden soll Workflows starten Sie im Queue Manager neu Dort k nnen Sie auch die Eingabe und Ausgangsnachrichten anzeigen lassen Siehe inubit 6 1 Workbench Process Engine Systemkonnektor Guide 05 09 2013 ER 1 1 3 Systemkonnektoren Dialogbeschreibungen Message Log anzeigen Process Engine Administrator und Entwickler Guide Kap 7 6 4 S 114 Prozess erneut starten Process Engine Administrator und Entwickler Guide Kap 7 6 5 S 114 Aktivieren Sie das Input Output Message Logging nur wenn Sie es ben tigen Sonst kann bei wenig Plattenplatz das Dateisystem mit Dateien aus dem Input Output Message Logging voll laufen Wenn das Input Output Logging bei mehreren Systemkonnektoren un
302. gangsnachricht Der lesende BO Connector erkennt automatisch ob es sich bei der Eingangsnachricht um das Ergebnis einer Datenbankabfrage handelt und liest dieses dann in die angegebene Datenbank ein Alle fehlenden Tabellen und Indizes werden automatisch angelegt Die eingelesenen Objekte werden der Datenbank mit neuen Objekt IDs hinzugef gt Optional k nnen Sie die Ausgangsnachricht des schreibenden BO Connectors ber einen File Connector in das Dateisystem schreiben z B um eine Datenbank vom Testsystem zum Produktivsystem zu transferieren Die gespeicherte Datei ber einen File Connector einlesen und an den einlesenden BO Connector bergeben Optional k nnen Sie die Ausgangsnachricht komprimieren Systemkonnektor Guide 05 09 2013 56 Business Object Connector Querymodus verwenden Voraussetzungen Datenbankabfrage schreiben Sie haben Zugriff auf die Datenbank die Sie sichern bzw migrieren wollen Gespeicherte Datenbankabfrage einlesen Sie haben Zugriff auf die Datenbank in die Sie die Daten einer Ausgangsdatenbank sichern bzw zu der Sie die Daten migrieren wollen Sie haben Zugriff auf die einzulesenden Daten Abfrage als Eingangsnachricht So gehen Sie vor tell erste Erstellen und benennen Sie einen neuen XSLT Converter 2 Wechseln Sie auf das Register XSLT Converter Eigenschaften und aktivieren Sie die Checkbox Eingangsnachricht ignorieren 3 Wechseln Sie auf das Register
303. gegen und setzt den Workflow fort c S S S Si ke z ke 3 E c E gz S gz 4 E E 2 c 5 s o o EF 35 lt Oe Es Oe AXSLTCreateRequest AWSMediumCaller DoSomething DoSomethingElse ACallBackWSListen NextSteps Web Service Der Workflow wird nach dem Web Service Aufruf aufrufen fortgesetzt und vor dem Callback Listener angehalten Voraussetzungen m Um einen asynchronen Web Service mit einem beliebigen Web Service Client aufzurufen muss der Client WS Addressing unterst tzen und eine nicht anonyme Antwort Adresse wsa ReplyTo verwenden Ein asynchroner Web Service der eine nicht anonyme Antwort Adresse wsa ReplyTo erwartet muss ber einen Medium Web Service Connector aufgerufen werden 05 09 2013 inubit 6 1 Workbench Process Engine Systemkonnektor Guide Web Services Connector 427 Asynchrone Web Services 40 5 1 Asynchronen Web Service anbieten Ein Workflow der einen asynchronen Web Service anbieten soll muss mindestens aus folgenden Modulen bestehen Asynchroner Web Service Listener XSLT Converter zur Erstellen der Antwort Reply Modul zum Senden der Antwort an den Callback Listener Asynchronen Web Service Dieser Listener nimmt die Anfragen entgegen bearbeitet sie und leitet Listener anlegen sie an das n chste Modul im Workflow weiter So gehen Sie vor 1 10 Legen Sie in einem neuen Workflow einen neuen Web Services Connector an benennen Sie ihn un
304. gehen Sie vor 1 Ressource konfigurieren a Erstellen Sie einen REST Input Listener Connector b W hlen Sie aus der Liste unter Vorgaben verwenden f r welche Art von Ressource dieser Konnektor anbieten soll Siehe Bereitgestellte Ressource Workbench Process Engine Systemkonnektor Guide Kap 27 S 299 c Definieren Sie eine URL unter der auf die Ressource zugegriffen werden kann F r dynamische Pfadbestandteile k nnen geschweifte gt Klammern verwendet werden z B http localhost 8000 ibis rest orders orderID Hier wird der Wert von orderID als Workflow Variable im Workflow zur Verf gung gestellt und kann benutzt werden um die Daten des gew nschten Auftrags zu ermitteln Geben Sie am Ende des Pfades ein um Pfade zu unterst tzen die mit beliebigen Zeichen enden d Sichern Sie Ihren Rest Service vor unzul ssigen Zugriffen durch Aktivieren der Option Authentifizierung erforderlich e Legen Sie die gew nschte Authentifizierungsmethode fest und geben Sie die f r einen Request erforderlichen Zugangsdaten an f Legen Sie fest welche Operationen auf Ihrer Ressource ausgef hrt werden k nnen f Es sind nicht f r jeden Ressourcentyp alle HTTP Methoden W zugelassen Standardm ig sind die f r eine gew hlte Ressource sinnvollen HTTP Methoden vorausgew hlt g Legen Sie die Kodierung f r Daten fest die als Request im Format multipart form data eingehen 2 Antw
305. geholt wird Filter hinzuf gen Der Button f gt eine neue Zeile ein in der Sie die Filterkriterien definieren inubit 6 1 Workbench Process Engine Systemkonnektor Guide 05 09 2013 220 Mail Connector Dialogbeschreibungen Subject From To Liste zur Auswahl des Feldes das gefiltert werden soll Dar ber hinaus k nnen Sie beliebige E Mail Header Namen direkt eingeben z B Message ID enthalt enthalt nicht Angabe ob im gew hlten Feld eine bestimmte Zeichenkette vorhanden sein muss oder nicht Eingabefeld Zur Eingabe der Zeichenkette die vorhanden oder nicht vorhanden sein soll Filterbedingung l schen Klicken Sie auf das Icon A um eine Filterbedingung zu entfernen 21 2 4 Dialog S MIME Entschl sselung Input Connector In diesem Dialog haben Sie folgende Optionen Entschl sselung aktivieren Aktivieren Sie diese Option wenn die E Mails die der Mail Connector abholen soll verschl sselt sind Privaten Schl ssel hinzuf gen m Hinzuf gen Button Der Button ffnet einen Dateiexplorer zum Laden des privaten Schl ssels mit dem die E Mails entschl sselt werden Zum Laden ben tigen Sie den Alias und das Passwort des W Schl ssels ffentliche Daten des Schl ssels Zeigt die ffentlichen Daten des Zertifikats nachdem der private Schl ssel geladen wurde 21 2 5 Dialog Eigenschaften der Eingabedaten Output Connector In diesem Dialog haben Sie folgend
306. gen TagID ID des Transponders die dieser sendet FieldStrengths Feldst rke mit der das Signal empfangen wurde Die Feldst rke wird in Werten zwischen 128 und 128 angegeben Dabei bedeutet 128 kein Signal empfangen Time Datum und Uhrzeit an zu der das Signal empfangen wurde IPortID Bei der Konfiguration des RFID Connectors geben Sie ber den Servernamen und die Portnummer an von welchem i Port das Signal empfangen wurde In diesem Fall hat der i Port die ID 2 28 3 Dialog RFID IPort Connector Eigenschaften In diesem Dialog haben Sie folgende Optionen Konfiguration m Servername IP Nummer oder Servernamen des IPort Port Standardportnummer ist 7070 Mit dem Button Standard stellen Sie nach nderungen den Standardwert wieder her inubit 6 1 Workbench Process Engine Systemkonnektor Guide 05 09 2013 308 RFID Connector Dialog RFID Port Connector Eigenschaften 05 09 2013 inubit 6 1 Workbench Process Engine Systemkonnektor Guide ET RosettaNet HTTPS Connector 309 Verwendung a Funktionsumfang Dieser Abschnitt erlautert die folgenden Themen m Struktur und Austausch von RosettaNet Nachrichten S 310 m Beispiel Workflow RosettaNet Nachrichten erzeugen S 312 m Beispiel Workflow RosettaNet Nachrichten versenden S 314 Beispiel Workflow Nachrichten empfangen und Best tigung senden S 316 m Dialogbeschreibungen S 317 Der RosettaNet Standard d
307. gerichtete Assoziationen adressieren Bei einer Aggregation navigieren Sie vom Elternknoten zum Kindknoten Beispiel fpm Fuhrpark fpm Fahrzeug alle Fahrzeuge des Fuhrparks Bei einer einseitig gerichteten Assoziation navigieren Sie vom Quellknoten zum Zielknoten Beispiel fom Mitarbeiter fpm IstFahrerVon Mitarbeiter ist Fahrer von Fahrzeug inubit 6 1 Workbench Process Engine Systemkonnektor Guide Solution Center Connector 375 Beispiel Objekt erzeugen Bei einer zweiseitig gerichteten Assoziation k nnen Sie sowohl vom Quellknoten zum Zielknoten als auch vom Zielknoten zum Quellknoten navigieren Beispiel pm Mitarbeiter fpm IstHatFahrer Mitarbeiter ist Fahrer von Fahrzeug pm Fahrzeug fpm IstHatFahrer Fahrzeug hat Mitarbeiter als Fahrer 35 5 Beispiel Objekt erzeugen Dieser Abschnitt erl utert die folgenden Themen Objekt ber die Knoten ID erzeugen S 375 Objekt ber eine XPath Anfrage erzeugen S 376 Verwendung Adressieren des Vaterknotens und optional R ckgabe des neuen Knoteninhalts als XML Struktur 35 5 1 Objekt ber die Knoten ID erzeugen So gehen Sie vor 1 Lu Erstellen Sie in einem Technical Workflow einen Solution Center Connector und benennen Sie diesen Wechseln Sie auf die Seite SC Connector Einstellungen W hlen Sie den Modus Objekt erzeugen Klicken Sie auf den Button Knoten ausw hlen am Ende des Feldes Knotens Geben
308. gesendet werden kann inubit 6 1 Workbench Process Engine Systemkonnektor Guide 05 09 2013 420 Web Services Connector Web Service anbieten c In diesem Beispiel fand keine Verarbeitung statt daher erstellen Sie nun lediglich ein Ausgangsmapping ffnen Sie im Bereich XML Zieldatei das A Men und w hlen Sie ffnen von gt Web Services Explorer Ein Dialog ffnet sich d W hlen Sie bei Modul Ihren Web Services Input Listener aus und bei Operation SayHello Response P LE Web Services Explorer Web Services Connector Modulauswahl W hlen Sie das Web Services Connector Modul aus dessen WSDL als Vorlage in den XSLT Converter geladen werden soll WSDL bernehmen von Modul ProvideWebService X Service ProvideWebService X Port ProvideWebServicePort e Operation SayHello Response e Generator Optionen XML Schema XML Instanz Erzeuge optionale Elemente Kommentar zum Elementtyp hinzuf gen Anmerkungen hinzuf gen Erzeuge Beispiele f r Elementwerte x brechen e Klicken Sie auf Fertig stellen Die Struktur der SOAP Nachricht wird angezeigt f Ziehen Sie das Root Element der erzeugten SOAP Nachricht per Drag n Drop nach oben auf das xs1 template Element und passen Sie z B den Wert des sayHelloResponse Elements an 05 09 2013 inubit 6 1 Workbench Process Engine Systemkonnektor Guide Web Services Connector 421 Web Service aufrufen Leite ST Cove
309. gt Art Zip Kodierung Legt die Kodierung des Zeichensatzes fest 10 2 3 Dialog Zu schreibende Datei Eingangsformat Zip Konfiguration Output Connector In diesem Dialog geben Sie das Format der Eingangsnachrichten an und legen fest wie diese Nachrichten ins Dateisystem geschrieben werden sollen Eingangsformat Geben Sie das Format der Eingangsnachrichten an Daten Die Eingangsnachrichten sind Daten die unver ndert weitergegeben werden sollen IBISDirectory Xml Die Eingangsnachrichten haben das IBISDirectory XML Format Zip Bei dieser Option erwartet der File Connector ein Zip Archiv als Eingangsnachricht Der File Connector entpackt dieses Archiv und speichert die entpackten Daten im angegebenen Verzeichnis Bei Eingangsformat Zip inubit 6 1 Workbench Process Engine Systemkonnektor Guide 05 09 2013 130 File Connector Dialogbeschreibungen Kodierung Die Auswahl legt die Kodierung der Datei und Verzeichnisnamen fest Verzeichnis m 05 09 2013 Name Absoluter Pfad zu dem Verzeichnis das der File Connector beim Schreiben von Dateien verwenden soll Zus tzlich k nnen Sie dem zu erzeugenden Dateinamen ein Datum einen Zeitstempel oder die Prozess ID hinzuf gen Datum Auch die Datumsangabe hat einen Zeitstempel Wenn Sie den Dateinamen folgenderma en angegeben file _ TimeStamp xml erh lt die Ausgabedatei folgenden Namen file 12122012 151047 xml mit file als Da
310. h Weitere Sprachen f gen Sie ber das Kontextmen der Tabelle hinzu Timeout Zum Definieren der Zeitbeschr nkung nach deren Ablauf inaktive Benutzer sich erneut am Portlet anmelden m ssen Erweiterte Einstellungen JSR 168 CSS Klassen verwenden Wenn die Option markiert ist dann erhalten die CSS Klassen der Portlet Komponenten die Namen die in der JSR 168 definiert sind Die Portlet Komponenten passen sich dann automatisch an das Theme an das aktuell im Enterprise Portal ausgew hlt ist weil f r die Darstellung der Themes die JSR 168 konformen Klassennamen genutzt werden Portlet Komponenten sind z B Buttons Gruppen oder Eingabefelder Wenn die Option nicht markiert ist dann werden inubit spezifische CSS Klassennamen verwendet Gi Siehe http jcp org aboutJava communityprocess final jsr168 index html Abschnitt CSS Style Definitions CSS einbinden Wenn die Option markiert ist dann werden die CSS Klassen der inubit Software dynamisch eingebunden Layout css und CustomLayout css im Verzeichnis lt inubit installdir gt server ibis root conf form Wenn die Option nicht markiert ist dann m ssen Sie CSS Klassen manuell in den Header der angezeigten Portalseite einbinden Die Bosch Software Innovations GmbH empfiehlt diese Option zu Q markieren wenn Sie den Liferay Portalserver nutzen JavaScript einbinden Wenn die Option markiert ist dann werden die mitgelieferten JavaScript Dateien der
311. h Process Engine Systemkonnektor Guide Web Services Connector 437 Schl sselpaare f r WS Trust erstellen 40 8 1 Selbstsigniertes Security Token Service STS Schl sselpaar erstellen Verwendung Zur Authentifizierung eines Clients an einem Security Token Service So gehen Sie vor 1 Generieren Sie ein Schl sselpaar mit der SubjectKeyldentifier Erweiterung Setzen Sie dazu die Optionen gem Ihren Anforderungen openssl req x509 days 9999 nodes newkey rsa 2048 subj C myCountry ST myState L myCity O myOrganization OU myDepartment CN myServerName keyour SITE okey OUt SES Extensions v3 Ca Si http www openssl org docs apps reg html 2 Konvertieren Sie das im Schritt 1 generierte Schl sselpaar in das PKCS12 Format um es in den Java Keystore importieren zu k nnen Dabei m ssen Sie ein Passwort vergeben Openssl mees erg EE ns EES EE key BE keys nt EH et 3 Importieren Sie die PKCS12 Datei in den Java Keystore keytool importkeystore srckeystore STS pl2 srcstoretype pkcs12 srcalias 1 srcstorepass lt yourPassword gt destkeystore STS keystore jks destalias tomcat deststorepass lt yourPassword gt Si http docs oracle com javase 6 docs technotes tools solaris keytool html 4 Generieren Sie einen JKS Truststore mit dem Service Zertifikat Als Passwort geben Sie das im Schritt 2 vergebenen Passwort an keytool import ee si keyertore SUS riustetrore jka Lle S19 eme alia
312. hema dr wsap10 http www w3 org 2006 05 addressing wsdi Qa soap12 http schemas xmlsoap org wsdl soap12 dat name mySTS d i targetNamespace http tempuri org B 43 wsp Policy da wsu Id ISecurityTokenService_policy EG wsp ExactlyOne B wsp All lt f sunsp DisableStreamingSecurity xmlns sunsp http schemas sun com 2006 6 te STSConfiguration ar te http schemas sun com ws 2006 05 trust server d i encryptIssuedkey true ar encryptIssuedToken false H te LifeTime 36000 D te Contract com sun xml ws security trust impl IssueSamlTokenContract amp 3 te Issuer InubitSTS E G tc ServiceProvide Sees tc ServiceProvider d i endpoint http localhost 8000 ibis ws mySecuredService G te Cert is onen rafessto sis wss saml ta DOS Krah tc ServiceProvider erstellt Pr fen Sie den Wert des Attributs endpoint damit Sie den Alias im richtigen Element ndern F r jeden hinzugef gten Web Service Provider wird ein Element 7 Klicken Sie auf Fertig stellen um die Konfiguration zu beenden 8 Wenn Ihr Web Service Provider in der inubit Software erstellt wurde m ssen Sie noch dessen Kommunikation mit dem STS konfigurieren Siehe Web Services Provider durch Security Token Service absichern Workbench Process Engine Systemkonnektor Guide Kap 40 6 S 433 05 09 2013 inubit 6 1 Workbench Process Engine Systemkonnektor Guide Security Token Service Connector
313. hen Pr fung inaktiver Verbindungen Zeit zwischen zwei Pr fungen inaktiver Verbindungen Angabe in Millisekunden Min Zeit f r inaktive Verbindungen im Pool Zeit in der eine ungenutzte Verbindung im Pool offen bleibt bis sie geschlossen wird Aktion wenn Pool voll ist W hlen Sie aus welche Aktion ausgef hrt werden soll wenn alle Verbindungen im Connection Pool in Benutzung sind Fehlschlagen mit Exception Das Anfordern einer Verbindung aus dem Connection Pool wird abgewiesen damit scheitert die Datenbankanfrage und eine Fehlermeldung wird erzeugt Pool blockieren Das Anfordern einer Verbindung wird blockiert Neue Verbindung erzeugen Eine weitere Verbindung wird erzeugt Validierung Der Pool nutzt eine Verbindung erst nach einer erfolgreichen Pr fung Falls die Pr fung fehlschl gt wird eine neue Verbindung erzeugt Damit werden Fehler am Datenbank Connector vermieden und die Stabilit t bei hoch ausgelasteten Datenbanken wird verbessert Test beim Entnehmen von Verbindungen aus dem Pool Testet eine Datenbankverbindung des Pools auf Funktionalit t wenn diese aus dem Connection Pool genommen wird inubit 6 1 Workbench Process Engine Systemkonnektor Guide 05 09 2013 92 Database Connector Dialogbeschreibungen Test beim Zur cklegen von Verbindungen in den Pool Testet eine Datenbankverbindung des Pools auf Funktionalit t wenn diese nach der Benutzung zur ck gelegt wird Test w hrend die Verb
314. hentifizierung Wenn diese gefordert ist muss die Checkbox ausgew hlt werden Dadurch werden Benutzer ID und Passwort zu den bertragenen Daten hinzugef gt Sync Level Die hier m glichen Werte sind 0 und 1 oder NONE und CONFIRM 0 oder NONE bedeutet dass die Verarbeitung nicht best tigt werden muss Bei 1 oder CONFIRM wird die Verarbeitung best tigt inubit 6 1 Workbench Process Engine Systemkonnektor Guide 05 09 2013 242 OFTP Connector Dialog Stationen 23 6 1 3 Nachbarstation ber ISDN Wenn Sie eine Nachbarstation konfigurieren die ber ISDN verbunden ist wird automatisch das X 25 Protokoll zur Konfiguration hinzugef gt da ISDN allein nicht zum Aufbau einer OFTP konformen Verbindung ausreicht ISDN Adresse Hier sind die letzten drei Zahlen der ISDN Adresse gem Richtlinie E 164 der ITU T gemeint die als Filter benutzt werden Damit k nnen Sie die Endger te anhand ihrer letzten drei Ziffern unterscheiden IP Adresse Geben Sie die IP Adresse oder den Rechnernamen Ihres ISDN Routers an nur n tig wenn Sie mehrere ISDN Router verwenden Typ blicherweise RCAPI1 Dabei steht RCAPI f r Remote Common ISDN Application Programming Interface die Zahl steht f r die Nummer des Router Controllers hier 1 Protokoll EDSS1 Signalisierungsprotokoll Euro Digital Subscriber Signaling System No 1 Paketgr e blicherweise die Paketgr e 128 Facilities Meist nicht angegeben Benutzerda
315. holen des Vorgangs zu beenden muss ein Endzeitpunkt definiert werden Zeitraum Zeitraum Anfangs und Enddatum in dem der Scheduler aktiviert werden soll Leseverhalten von m Bei aktivierter Zeitsteuerung werden Workflows mit folgenden Input Konnektoren Input Konnektoren so oft neu gestartet wie Daten vorhanden sind Mail Connector inubit iS Connector JMS Connector inubit 6 1 Workbench Process Engine Systemkonnektor Guide 05 09 2013 24 Systemkonnektoren Dialogbeschreibungen Leseverhalten von Medium Output Konnektoren Behandlung von Fehlern Bei aktivierter Zeitsteuerung kann f r folgende Input Konnektoren die maximale Anzahl von Ausf hrungen pro zeitgesteuertem Aufruf definiert werden File Connector Siehe Dialog Zu lesende Datei en Workbench Process Engine Systemkonnektor Guide Kap 10 2 1 S 124 VFS Connector Siehe Dialog Input Connector Konfiguration Workbench Process Engine Systemkonnektor Guide Kap 38 2 2 S 400 FTP Connector Siehe Dialog Input Dateinamen definieren Workbench Process Engine Systemkonnektor Guide Kap 11 2 3 S 138 Konnektoren die ein Vorg ngermodul haben werden bei jedem Workflow Durchlauf genau einmal ausgef hrt Bei jedem fehlerhaften Aufruf Log Eintrag erstellen Wenn aktiviert dann wird f r jeden Fehler der beim Start des Systemkonnektors auftritt ein Eintrag im Register Monitoring gt System Log er
316. hrung konfiguriert Die ben tigten Werte werden aus den Eingangsnachrichten gelesen von einem XSLT Converter in eine XML Nachricht transformiert und an den SNMP Connector bergeben Die folgende Abbildung zeigt das Mapping im XSLT Converter Dabei bedeuten die Abk rzungen a PPP Point to Point Protocol m PAP Password Authentification Protocol B xsl stylesheet http www w3 org 1999 XSL Transform xs 1 0 version H xsl output D xsl param H xsl paran D H xsl paran Fe amp xsl template gt E SNMPYarBinds 4 0 a version CO 6 Property Integer B A type 1 3 6 1 4 1 272 4 3 1 1 7 1 4 CS name Method PAP 2 B E CA Property 1 3 6 1 4 1 272 4 4 1 1 4 10001 0 B a name DialNumber rari var pppDial a xsl value of CA ep Property 1 3 6 1 4 1 272 4 3 1 1 9 1 4 B a name pppPassword of var pppPass E xsl value of CA B Property 1 3 6 1 4 1 272 4 3 1 1 24 1 4 B d i name pppUsername Da var pppUser KE xsl value of Die folgenden Zeilen zeigen die XML Nachricht die als Ergebnis das Mappings an den SNMP Medium Connector bergeben wird lt xml version 1 0 encoding ISO 8859 1 gt lt SNMPVarBinds version 4 0 gt lt Property name 1 3 6 1 4 1 272 4 3 1 1 7 1 4 type Integer gt 2 lt Property gt lt Property name 1 3 6 1 4 1 272 4 4 1 1 4 10001 0 gt lt Property name 1 3 6 1 4 1 272 4 3 1 1 9 1 4 gt
317. hten die ein Nachrichten Lieferant schickt werden first in first out in eine Nachrichten Queue gestellt Nachrichten Empf nger k nnen die Nachrichten der Reihe nach zu einem beliebigen sp teren Zeitpunkt aus der Queue abholen Die folgenden Optionen werden angezeigt wenn Sie als Kommunikationsmodell Point to Point gew hlt haben Name der Queue Der Queue Name bezeichnet ein Objekt das vom JMS Provider erzeugt und beim JNDI Server registriert wurde Der JMS Connector durchsucht den JNDI Server nach dem angegebenen Queue Name und erh lt eine Referenz auf das Objekt Klasse f r Verbindungsaufbau Name der Connection Factory Die Connection Factory ist das Objekt das ein Client benutzt um eine Verbindung mit dem JMS Provider zu erstellen Das Objekt wurde von dem JMS Provider erzeugt und beim JNDI Server registriert Der JMS Connector durchsucht den JNDI Server nach der angegebenen Klasse und erh lt eine Referenz auf das registrierte Objekt Synchroner Modus Wenn markiert dann werden Nachrichten vom JMS Server synchron empfangen d h der Eingang einer Nachricht startet den Workflow der bis zum Ende durchlaufen wird bevor die n chste Nachricht empfangen werden kann Die laufende Workflow Verarbeitung blockt den Empfang neuer Nachrichten und erst der beendete Workflow gibt das Signal zum Empfang und der Verarbeitung der n chsten Nachricht in der Queue Der JMS Server kann auch mehrere Nachrichten parallel und synchr
318. iagramme Workbench Benutzer Guide Kap 12 S 311 4 1 Dialog Backup Connector Eigenschaften Backup Dateiname Backup Level Dieser Dialog bietet folgende Optionen Name Name der Sicherungsdatei Die Sicherungsdatei wird in das Verzeichnis lt inubit installdir gt server ibis root ibis data backup geschrieben E u In den Ausgabestrom schreiben Wenn markiert dann werden die gesicherten Daten zus tzlich als Ausgangsnachricht dem Workflow bergeben System Sichert den aktuellen Systemzustand der inubit Process Engine Folgende Verzeichnisse werden immer gesichert inubit 6 1 Workbench Process Engine Systemkonnektor Guide 05 09 2013 44 Backup Connector Dialog Backup Connector Eigenschaften inubit Konfiguration lt inubit installdir gt server ibis _root conf au er den EDI Regeln im edi Verzeichnis inubit Process Engine Log Verzeichnis lt inubit installdir gt server ibis root log Die Benutzergruppe admin umfasst alle Benutzer Benutzer Benutzergruppen Um ausgew hlte Benutzer bzw Benutzergruppen zu sichern Es werden alle Workflows Module Benutzer sowie Untergruppen und optional deren Repository und Monitoring Dateien gesichert Um alle Benutzergruppen zu sichern markieren Sie die Gruppe admin In diesem Fall wartet Backup Connector bis alle Workflows ihre aktuellen Aufgaben beendet haben Erweiterte Backup Optionen m inubit Log Datenbank
319. iagramme Workbench Benutzer Guide Kap 12 S 311 rvs Software der Firma T Systems International GmbH muss Version 5 05 oder 5 07 installiert und konfiguriert sein Dabei m ssen bertragungsparameter eingestellt und Stationen mit einer definierten Station ID eingerichtet werden Die Software besteht aus der rvs Middleware dem rvs Server und einer Client Komponente und kann sowohl ber das Benutzerinterface der Middleware als auch ber das Benutzerinterface des rvs Servers konfiguriert werden Erfragen Sie unbedingt bei Bosch Software Innovations GmbH welche rvs Version Sie f r Ihre Installation ben tigen rvsclient jar inubit 6 1 Workbench Process Engine Systemkonnektor Guide 05 09 2013 230 OFTP Connector Funktionsprinzip 23 2 Funktionsprinzip inubit BPM Suite Oo gt i Nachrichtenfluss Die Datei rvs client classes rvsclient jar der rvs Client Komponente muss als Treiber Bibliothek auf die inubit Process Engine hochgeladen werden Siehe Treiber installieren Process Engine Administrator und Entwickler Guide Kap 3 4 S 57 OFTP als Listener betreiben Um den OFTP Connector im Listener Modus zu betreiben m ssen Sie in der rvs Software auf ein Skript verweisen Dieses Skript sendet eine Benachrichtigung an den OFTP Connector sobald eine Gesch ftsnachricht eingetroffen ist Das Skript ist im Lieferumfang der inubit Software enthalten a Legen Sie in der GUI der rvs Middleware
320. ialog Web Applikation Work bench Process Engine Systemkonnek tor Guide Kap 39 3 1 S 408 bei der Option Timeout Workbench Process Engine Systemkonnektor Guide Kap 39 S 409 ISWebAppName Name des Web Application Connectors Siehe auch Modulvariablen definieren Workbench Benutzer Guide Kap 14 S 387 Zus tzlich gibt ein Web Application Connector Informationen ber WY Portlet Instanzen aus siehe Informationen aus Portlet Instanzen abfragen Workbench Process Engine Systemkonnektor Guide Kap 39 2 S 406 39 2 Informationen aus Portlet Instanzen abfragen Sie k nnen von jeder Portlet Instanz folgende Informationen abfragen ISSession ID Eindeutige ID der aktuellen Session ISPortletNamespace Eindeutige ID der verwendeten Portletklasse ISUserName Name des Benutzers welcher in der inubit Workbench im Register Configuration gt Allgemein im Konfigurationsbereich Portal gt Servereinstellungen bei der Option Portal Login angegeben ist ISPortletActionUrl Eindeutige ID der Portletinstanz 05 09 2013 inubit 6 1 Workbench Process Engine Systemkonnektor Guide Web Application Connector 407 Informationen aus Portlet Instanzen abfragen Die Portletinstanz ist z B n tig um ein mandantenf higes Portlet zu erstellen das in Abh ngigkeit von der Gemeinschaft f r die es angezeigt wird unterschiedliche Systeme anspricht Dazu muss der Techni
321. ialog in dem die konfigurierte Verbindung getestet werden kann und eine Antwort mit Status Code HTTP Header und Daten angezeigt wird inubit 6 1 Workbench Process Engine Systemkonnektor Guide 05 09 2013 304 REST Connector Dialogbeschreibungen 05 09 2013 inubit 6 1 Workbench Process Engine Systemkonnektor Guide 305 Dieser Abschnitt erl utert die folgenden Themen m Funktionsprinzip S 305 m Beispiel Ausgangsnachricht S 306 a Dialog RFID IPort Connector Eigenschaften S 307 Verwendung Der RFID Radio Frequenz Identifikation Connector kann event gesteuert einen Technical Workflow ausl sen Das ausl sende Event ist der Eingang einer Nachricht die von einem iPort Ger t der Firma IDENTEC SOLUTIONS gesendet wird Ef Siehe www identecsolutions com Siehe auch Systemkonnektoren Workbench Process Engine Systemkonnektor Guide Kap 1 S 19 Module anlegen Workbench Benutzer Guide Kap 3 3 S 129 Technical Workflow Diagramme Workbench Benutzer Guide Kap 12 S 311 28 1 Funktionsprinzip Wenn ein Transpondersignal durch die Antennen eines i Port Empf ngerger ts erfasst wird schickt dieses eine Nachricht an den RFID Connector und l st damit die Ausf hrung des Workflows aus in den der Connector integriert ist Ein i Port kann mit bis zu vier Antennen verbunden sein die z B in verschiedenen R umen oder Stockwerken eines Geb udes sein k nnen Dabei kann jede Antenne a
322. ich XSLT Stylesheet auf das template Element Um zus tzlich eine andere Operation durchf hren zu lassen f gen Sie ein query Element mit dem gew nschten Attribut hinzu Laden Sie die XML Beispielnachricht in den Bereich XML Quelldatei Abh ngig vom gew nschten Ergebnis ersetzen Sie die MyObject Elemente des Templates durch die root Elemente Ihrer Gesch ftsobjekte oder geben einen XPath Ausdruck an Erl uterungen zu den Attributen finden Sie im Mapping Template Testen Sie die XSLT Datei Siehe XSLT Stylesheets testen Workbench Process Engine Modul Guide Kap 5 2 S 149 Wenn der Test erfolgreich war k nnen Sie den XSLT Converter publizieren Legen Sie einen BO Connector an Verbinden Sie den XSLT Converter mit Ihrem BO Connector 5 3 1 Unterst tzte Query Attribute Query Attribute definieren Sie wie folgt lt Attribut gt lt Wert gt z B type create Die unterst tzten Attribute f r die einzelnen Operation entnehmen Sie WY dem Mapping Template im Abschnitt Pfad des Mapping Templates Workbench Process Engine Systemkonnektor Guide Kap 5 S 52 Attribut Beschreibung Mogliche Werte type Bestimmt die Operation der Query create Objekt erstellen read Objekt lesen Standard update Objekt ndern delete Objekt l schen queryld Legt die Query Id fest welche am Result Query Id set zur expliziten Pr fung ausgegeben wird inubit 6 1 Workbench Process Engine Systemkon
323. ichbar ist Mit dem Button Standard stellen Sie nach Port nderungen den Standardwert wieder her Verbindungsmodus nur FTP FTPS Aktiv Der Client ffnet der Client einen zuf lligen Port und teilt dem Server diesen Port und die eigene IP Adresse ber das PORT Kommando mit Passiv Der Client sendet ein PASV Kommando der Server ffnet einen Port und bermittelt diesen mitsamt IP Adresse an den Client Auto Meist die passende Einstellung W hlen Sie Aktiv oder Passiv nur dann wenn Ihr Administrator den FTP Server entsprechend konfiguriert hat bertragungsart Geben Sie an ob die zu bertragenden Dateien bin r sind oder ASCII Daten enthalten Regionalschema Regionalschema des Servers Das Regionalschema bestimmt u a die Art des Zeichensatz und der Datumsangabe Kodierung Geben Sie die Kodierung des Kontrollkanals f r die Kommunikation zwischen Konnektor und FTP Server an inubit 6 1 Workbench Process Engine Systemkonnektor Guide 05 09 2013 136 FTP Connector Dialogbeschreibungen Authentifizierung nur FTPS SSL Konfiguration nur FTSP SSL Konfiguration nur SFTP Uber den Kontrollkanal werden die Befehle und dabei auch die Dateinamen als Zeichenketten bertragen Um sicherzustellen dass dabei z B Umlaute korrekt bertragen werden ist die Definition der Kodierung notwendig da diese von Server zu Server unterschiedlich sein kann 05 09 2013 Falls Sie f r
324. ichen Schl ssels Nach dem Laden wird ber dem Button die G ltigkeit des Schl ssels angezeigt Eingehende Nachricht muss signiert sein Wenn markiert dann erzeugt das Eintreffen einer unsignierten Nachricht einen Fehler Entschl sselung Wenn die Option markiert ist dann werden alle eingehenden Nachrichten entschl sselt Dazu ben tigen Sie Ihren privaten Schl ssel Keystore hinzuf gen Button ffnet einen Dateiexplorer zum Laden des Schl ssels Nach dem Laden wird ber dem Button die G ltigkeit des Schl ssels angezeigt Eingehende Nachricht muss verschl sselt sein Wenn markiert dann erzeugt das Eintreffen einer unverschl sselten Nachricht einen Fehler 3 3 3 Dialog AS2 Listener Konfiguration Nachrichtenempfang mit Listener Dieser Dialog bietet folgende Optionen Konfiguration des Servers m URL URL des Servers auf dem die inubit Process Engine mit dem AS2 Input Connector l uft Die URL ist standardm ig vorbelegt mit einer URL nach folgendem Muster http lt localhost 8000 gt ibis servlet SHTTPUploadServlet lt Module Name gt Passen Sie ggf die URL an Authentifizierung Wenn f r Ihren Server eine Authentifizierung notwendig ist geben Sie hier die entsprechenden Daten an WI inubit 6 1 Workbench Process Engine Systemkonnektor Guide 05 09 2013 38 AS2 Connector Dialogbeschreibungen 3 3 4 Dialog Message Archiv Konfiguration MDN Empfang mit
325. ichnis des Workflows ab Ein Input inubit IS Connector auf einer entfernten inubit Process Engine holt diese Datei ab Der Input inubit IS Connector holt Dateien von einem Output Listener inubit IS Connector auf einer entfernten inubit Process Engine per Datei Download Der Output inubit IS Connector sendet Ergebnisdaten direkt an einen Input Listener inubit IS Connector auf einer entfernten inubit Process Engine Der Medium inubit IS Connector sendet Zwischenergebnisse eines Workflows an einen Input Listener inubit IS Connector auf einer entfernten inubit Process Engine Die Ergebnisse des dort angesto enen Workflow Prozesses werden als Eingangsnachricht an den Nachfolger des inubit IS Medium Connectors zur ck gegeben 13 3 Dialogbeschreibungen Dieser Abschnitt erl utert die folgenden Themen Dialog Authentifizierung S 155 Dialog Funktion S 156 Dialog Verbindungsdaten S 156 Dialog Input Datei en S 157 Dialog Output Datei en S 158 13 3 1 Dialog Authentifizierung Nur Input Listener Connector In diesem Dialog werden die Zugangsdaten zur inubit Process Engine abgefragt mit denen sich ein Client authentifizieren muss um Daten an den inubit IS Connector senden zu k nnen Geben Sie einen beliebigen Benutzernamen und ein Passwort an inubit 6 1 Workbench Process Engine Systemkonnektor Guide 05 09 2013 156 inubit IS Connector Dialogbeschreibungen 13 3 2 Dialog Fun
326. icht geschehen registrieren Sie den Web Service Q Provider am STS Hinweise zum Registrieren an einem inubit internen STS finden Sie im Abschnitt Web Services Provider an STS Connector registrieren Workbench Process Engine Systemkonnektor Guide Kap 32 2 S 352 inubit 6 1 Workbench Process Engine Systemkonnektor Guide 05 09 2013 434 Web Services Connector Schl sselpaar f r WS Security erstellen 40 7 Schl sselpaar f r WS Security erstellen Dieser Abschnitt erl utert die folgenden Themen m Selbstsigniertes Schl sselpaar erstellen S 434 Extern signiertes Schl sselpaar erstellen S 435 Verwendung m Absichern eines Web Service Providers ohne Security Token Service Siehe Schl sselpaare f r WS Trust erstellen Workbench Process Engine Systemkonnektor Guide Kap 40 8 S 436 Authentifizierung eines Clients bei einem Web Service Provider ohne Security Token Service Die Authentifizierung erfolgt einmal pro Session ber ein selbst oder extern signiertes Schl sselpaar direkt am Webservice 40 7 1 Selbstsigniertes Schl sselpaar erstellen So gehen Sie vor 1 Generieren Sie ein Schl sselpaar mit der Erweiterung SubjectKeyldentifier Setzen Sie dazu die Optionen gem Ihren Anforderungen openssl req x509 days 365 nodes newkey rsa 2048 subj C myCountry ST myState L myCity O myOrganization OU myDepartment CN myServerName keyour Seulicsaigimecl key out laten Crt Etat Lem WS CE
327. ichten Aktivieren Sie die Keep alive Funktion Siehe Keep alive aktivieren Workbench Process Engine Systemkonnektor Guide Kap 43 S 487 Reduzieren Sie die Anzahl der Verbindungen pro Tag Versand von Nachrichten B ndeln Sie die Nachrichten vor dem Versenden Konvertieren Sie dazu die Nachrichten in das IBISX400 Format und f hren Sie die Nachrichten mit einem XSLT Converter zusammen bevor Sie diese versenden Das XML Schema und eine Beispielnachricht finden Sie im inubit Repository im Verzsichnis Global System Mapping Templates X 400 SE Connector Die Funktion eines X 400 SE Connectors ist von seiner Konfiguration abhangig Input Connector Verbindet sich mit einer X 400 Mailbox holt Nachrichten aus der Box ab und Ubergibt sie dem Technical Workflow inubit 6 1 Workbench Process Engine Systemkonnektor Guide 05 09 2013 484 X 400 SE Connector Voraussetzungen f r den Betrieb Das Format der Daten in welchem diese an den Workflow weitergegeben werden h ngt von der Konfiguration des Input Connectors ab Output Connector Verbindet sich mit einer X 400 Box und versendet eine oder mehrere X 400 Nachrichten Das Format der X 400 Nachricht h ngt von der Konfiguration des Output Connectors ab Siehe auch Systemkonnektoren Workbench Process Engine Systemkonnektor Guide Kap 1 S 19 Module anlegen Workbench Benutzer Guide Kap 3 3 S 129 Technical Workflow Diagramme Workbench Benu
328. ie Moduleigenschaft Request URI mit Hilfe des Variablen Mappings berschreiben siehe Workflow Variablen und Mappings Workbench Benutzer Guide Kap 14 S 383 27 8 Dialogbeschreibungen Dieser Abschnitt erlautert die folgenden Themen Dialog Konfiguration der Ressource S 298 m Dialog Konfiguration der Antwort S 300 m Dialog Konfiguration der Anfrage S 302 27 8 1 Dialog Konfiguration der Ressource 05 09 2013 Input Listener Connector In diesem Dialog legen Sie den Pfad f r die vom Konnektor angebotene Ressource die Authentifizierung und die HTTP Methoden fest inubit 6 1 Workbench Process Engine Systemkonnektor Guide REST Connector 299 Dialogbeschreibungen Bereitgestellte Ressource m Vorgaben verwenden f r W hlen Sie aus welchen Typ von Ressource der Konnektor anbieten soll Die Wahl des Ressourcen Typs legt gleichzeitig die Vorauswahl der standardm ig unterst tzten HTTP Methode n fest Siehe Unterst tzte HTTP Methoden Workbench Process Engine Systemkonnektor Guide Kap 27 S 300 Einzelne Ressource W hlen Sie die Option wenn nur lesend auf eine einzelne Ressource zugegriffen werden soll z B Bestellung anzeigen Es wird automatisch die HTTP Methode GET vorausgew hlt Sammel Ressource W hlen Sie die Option wenn die Ressource z B eine Liste von Auftr gen auftraege umfassen soll und diese Liste abgerufen oder der Liste neue E
329. ie die Kontextknoten ID ermitteln XPath XPath Ausdruck der auf die XML Struktur Ihrer Business Solution angewendet wird Innerhalb des Ausdrucks k nnen Sie Workflow Variablen verwenden Mit dem XPath Ausdruck k nnen Sie ein Business Objekt oder ein Attribut eines Business Objekts Ihrer Business Solution referenzieren Falls Sie einen Kontextknoten angegeben haben wird der XPath Ausdruck relativ zu dem angegeben Knoten ausgef hrt Das automatische Generieren des XSD Schemas f r jedes BOD erleichtert das Erstellen neuer Knoten das ndern und L schen vorhandener Knoten und deren Attribute und Assoziationen Siehe Verwenden von XPath Anfragen Workbench Process Engine Systemkonnektor Guide Kap 35 4 S 373 Bereich Zu erzeugendes Objekt Bei Modus Objekt erzeugen Im Bereich Zu erzeugendes Objekt geben Sie an wie das Objekt angelegt werden soll Es stehen zwei Verfahren zur Auswahl aus Eingabenachricht Aktivieren Sie diese Checkbox wenn Sie das neue Objekt anhand einer an den Solution Center Connector bergebenen XML Struktur erstellen wollen leeres Objekt vom Typ Zur Angabe des Typs des neuen leeren Objekts Bereich Objekt Vaterknoten Bei Modus Objekt erzeugen Im Bereich Vaterknoten geben Sie den Knoten an unter dem das neue Objekt angelegt werden soll Es stehen zwei Verfahren zur Auswahl Referenz ber Knoten ID Zum Eintragen oder Ausw hlen der Kn
330. iel Workflow k nnen Sie je nach Konfiguration des XSLT Converters und des File Connectors Word und Writer Dokumente bearbeiten konvertieren oder drucken EncodeToBase64 Doc200C OpenOfficeConnector DecodeBase64 SaveFile Assign Modul zum Kodieren als So gehen Sie vor en Erstellen Sie ein Assign Modul und benennen Sie es 2 Erstellen Sie eine neue Abbildungsregel f r das Variablen Mapping W hlen Sie als Quelle Ausgangsnachricht und als Datentyp Bin rdaten W hlen Sie als Ziel Variable 05 09 2013 inubit 6 1 Workbench Process Engine Systemkonnektor Guide OpenOffice Connector 273 Beispiel Workflow erstellen Erstellen Sie die Variable oo document mit dem Typ xs base64Binary Speichern Sie die Abbildungsregel mit OK XSLT Converter So gehen Sie vor 1 2 Erstellen Sie einen XSLT Converter Aktivieren Sie auf der Seite XSLT Converter Eigenschaften die Checkbox Eingangsnachricht ignorieren ffnen Sie im Fenster XML Zieldatei die Schemadatei OOC xsd Siehe XML Schema als Vorlage f r Eingangsnachrichten Workbench Process Engine Systemkonnektor Guide Kap S 272 Ziehen Sie das Root Element OpenOfficeConnector der Schemadatei aus dem Bereich XML Ziel auf das Element xsl template im Bereich XML Ziel des XSLT Stylesheets Entfernen Sie alle nicht ben tigten Elemente Welche Elemente Sie ben tigen k nnen Sie anhand der Beispie
331. ien eingelesen werden inklusive Daten Wenn markiert dann wird der gesamte Inhalt der Datei eingelesen Wenn nicht markiert dann werden nur die Metadaten der Datei eingelesenen z B Name Dateigr e und Datum 11 2 4 Dialog Output Dateinamen definieren Verzeichnis Datei Lu Output Connector Dieser Dialog bietet folgende Optionen Name Verzeichnis auf dem FTP Server welches der FTP Connector beim Schreiben von Dateien verwenden soll Erzeuge fehlende Verzeichnisse Wenn aktiviert werden fehlende Verzeichnisse auf dem FTP Server erzeugt Name Geben Sie einen Namen f r die Datei an die der Output Connector schreibt Im Dateinamen k nnen Sie einen Asterisk verwenden der an der jeweiligen Stelle einen Z hler einf gt um das berschreiben von Dateien zu verhindern z B Outputdata output xml In diesem Fall w rden Dateien mit den Namen output211 xml inubit 6 1 Workbench Process Engine Systemkonnektor Guide 05 09 2013 142 FTP Connector Dialogbeschreibungen 05 09 2013 output212 xml output213 xml usw auf dem FTP Server erzeugt werden Sie k nnen dem Dateinamen ein Datum einen Zeitstempel oder eine Prozess ID hinzuf gen lassen Datum Angabe ohne Datumsformat file TimeStamp xml erzeugt file 06082008 151047 xml mit file Dateiname 12122002 Datum im Format ddMMyyyy 151047 Zeit im Format hhmmss Angabe mit Datumsformat hh File TimeStamp hh xm
332. ient als Basis f r den weltweiten Datenaustausch zwischen Firmen mit Schwerpunkt im Bereich Supply Chain Management F r mehr Informationen ber das RosettaNet Protokoll siehe www rosettanet org B2Bi am Beispiel von RosettaNet Vortrag gehalten an der Universit t Hamburg http vsis www informatik uni hamburg de teaching ss 03 sam sam03_rn pdf Der RosettaNet Connector unterstutzt die folgenden Funktionalitaten RosettaNet Implementation Framework RNIF V2 0 RNIF beschreibt den Aufbau der XML Nachrichten das Vorgehen beim Ver und Entpacken der Nachrichten die unterst tzen Protokolle Sicherheitsanforderungen und die Fehlerbehandlung Asynchrones Empfangen von Nachrichten ber HTTP S Entpacken empfangener Nachrichten Syntax Check der Nachrichten und Konvertierung in ein eigenes XML Format Archivierung von Nachrichten Erzeugen einer g ltigen RosettaNet Nachricht aus einer im Workflow aufbereiteten PIP Nachricht RosettaNet Partner Interface Processes PIP definieren Gesch ftsprozesse zwischen Gesch ftspartnern Asynchroner Versand von Nachrichten und Empfangsbest tigungen ber HTTP S Erzeugung und Kontrolle der verwendeten Nachrichten IDs entsprechend dem RNIF Siehe auch Systemkonnektoren Workbench Process Engine Systemkonnektor Guide Kap 1 S 19 Module anlegen Workbench Benutzer Guide Kap 3 3 S 129 Technical Workflow Diagramme Workbench Benutzer Guide Kap 12 S 311 inubit 6 1
333. ierung In diesem Dialog haben Sie folgende Optionen Seratio Servername Port Domain oder IP Nummer des Seratio Indexservers Die Standardportnummer ist 2005 Der Button Standard stellt die Standardportnummer wieder her Archiv Servername Port Domain oder IP Nummer des ITA Archivservers H ufig sind die IP Nummern des Seratio Indexservers und des ITA Archivservers identisch Die Standardportnummer ist 2000 Der Button Standard stellt die Standardportnummer wieder her Systemdatenbankname Standard Name der Systemdatenbank Standardname ist SYSTEM Der Button Standard stellt den Standardnamen wieder her Systemname Beachten Sie das Gro und Kleinschreibung unterschieden wird Login Passwort Zugangsdaten zur Systemdatenbank inubit 6 1 Workbench Process Engine Systemkonnektor Guide 05 09 2013 166 ITA Connector Dialog ITA Archiv Connector Teilbestand m Datenbankname blicherweise sind Datenbanksysteme in Teilbest nde unterteilt Geben Sie hier den Datenbanknamen an Verbindungstest m Verbindung testen Zum Testen ob die Verbindung mit Ihren Angaben erfolgreich aufgebaut werden kann 05 09 2013 inubit 6 1 Workbench Process Engine Systemkonnektor Guide e AAs Connector Verwendung Konnektortypen 167 Dieser Abschnitt erl utert die folgenden Themen m Beispielszenario Liste von Benutzerkonten berpr fen S 168 m Beispielszenario Benutzerdaten ber Task
334. iese das Metro Framework nutzen Das Logging kann also nicht f r Web Service Konnektoren im Kompatibilit tsmodus mit dem Axis2 Framework genutzt werden Protokollierung f r alle So gehen Sie vor Web Services aktivieren 1 Erstellen Sie eine neue Java System Property Aus und eingehende Nachrichten f r Medium oder Output Web Services Konnektoren com sun xml ws transport http client HttpTransportPipe dump true Aus und eingehende Nachrichten von Listener Web Service Konnektoren com sun xml ws transport http HttpAdapter dump true Siehe Java System Properties Process Engine Administrator und Entwickler Guide Kap 2 2 10 9 S 44 2 Speichern Sie Ihre nderung Die Protokolle finden Sie im Konsolenfenster oder im Log Verzeichnis Ihres Applikationsservers a Tomcat lt inubit installdir gt server Tomcat logs catalina lt Datum gt 1og unter Linux zus tzlich catalina out m JBoss lt inubit installdir gt server JBoss server default log server log bzw server 1log lt Datum gt Protokollierung f r einzelne So gehen Sie vor Web Services aktivieren D F Offnen Sie den Web Services Connector zum Bearbeiten im Modul Editor 2 Wechseln Sie auf das Register Erweitert 3 Aktivieren Sie im Bereich Weitere Optionen die Option Logging der SOAP Nachrichten aktivieren webservice log 4 Publizieren und aktivieren Sie das Modul inubit 6 1 Workbench Process Engine
335. in rmwname Name des rvsEVO Servers rpassword rvsEVO Passwort Siehe Remote berwachung mit Command Line Interface StartCLI Process Engine Administrator und Entwickler Guide Kap 7 10 S 117 24 5 Dialog OFTP Datenaustausch Konfiguration Dieser Dialog unterscheidet sich f r Input Connector Input Listener Connector und Output Connector Grundeinstellungen m rvsEVO Serveradresse Geben Sie hier die Rechnernamen oder die IP Nummer an z B MyServer oder 123 456 7 8 Bei der Eingabe m ssen Sie die Anf hrungsstriche weg lassen Wenn die RMI Registry nicht auf Port 3755 l uft geben Sie die Portnummer an die mit einem Doppelpunkt vom Rechnernamen getrennt wird z B MyServer 1234 rvsEVO Name Hier wird blicherweise die Zeichenkette rvsmw benutzt Wenn Sie einen anderen Namen fur rvsEVO vergeben haben bernehmen Sie diesen hier Anmeldung Geben Sie hier die Benutzernamen an mit dem Sie sich bei rvsEVO anmelden Gro und Kleinschreibung wird unterschieden a Passwort Geben Sie hier Ihr Passwort ein Dateiname Der Name wird f r die OFTP2 bertragung benutzt und muss dem Empf nger bekannt gemacht werden damit dieser auf die Datei zugreifen kann inubit 6 1 Workbench Process Engine Systemkonnektor Guide 05 09 2013 256 OFTP2 Connector Dialog OFTP Datenaustausch Konfiguration 05 09 2013 Im Dateinamen k nnen Sie Wildcards oder regul re Ausdr cke ve
336. indungen inaktiv sind Testet eine Datenbankverbindung des Pools auf Funktionalit t w hrend sie nicht verwendet wird Validierung SQL Query Pr ft und validiert die Verbindung mit einer SQL Query Mit starten Sie den Test Setze Vorgabewerte Button Stellt die ausgelieferten Standardwerte wieder her 05 09 2013 inubit 6 1 Workbench Process Engine Systemkonnektor Guide Database Object Connector Verwendung Konnektortypen Unterst tzte Datenbanken Dieser Abschnitt erl utert die folgenden Themen Gesch ftsobjekte lesen erstellen bearbeiten oder l schen S 94 Events mit Event Listener berwachen und archivieren S 96 Event Archiv mit Archiv Prozessor berwachen S 99 Konfigurationsdatei Feldbeschreibungen S 99 Datenbankprozedur getNewID erstellen S 101 Dialogbeschreibungen S 104 Der Database Object Connector DBO Connector erm glicht den direkten Zugriff auf Gesch ftsobjekte deren Daten in hierarchisch strukturierten Datenbanktabellen gespeichert sind Abh ngig von seiner Konfiguration hat ein DBO Connector folgende Funktionen Input Connector Als Event Listener berwacht und archiviert ein DBO Connector nderungen an Gesch ftsobjekten Siehe Events mit Event Listener berwachen und archivieren Workbench Process Engine Systemkonnektor Guide Kap 7 2 S 96 Als Archiv Prozessor sch tzt ein DBO Input Connector ein Event Archiv vor dem berlauf Siehe Event
337. intr ge hinzugef gt werden sollen Es sind standardm ig nur die Methoden GET und POST erlaubt Einzel Ressource aus Sammlung W hlen Sie diese Option wenn Sie z B einen einzelnen Auftrag aus einer Auftragsliste oder eine Artikelnummer als Ressource anbieten wollen Unterst tzte Methoden sind hier GET Daten abrufen PUT Daten ndern und DELETE Daten l schen URL URL des Input Listeners unter welcher dieser auf Requests wartet und seine Ressource zur Verf gung stellt Die URL ist standardm ig nach folgendem Muster vorbelegt http s ServerName Port ibis rest rc NamedesInputListeners Passen Sie ggf den Teil der URL hinter rc beliebig an F r dynamische Pfad Bestandteile k nnen geschweifte Klammern verwendet werden z B users userName auftraege auftragsNr Geben Sie am Ende des Pfades ein um Pfade zu unterst tzen die mit beliebigen Zeichen enden Authentifizierung erforderlich Markieren Sie diese Option wenn f r den Zugriff auf die Ressource eine Authentifizierung erforderlich sein soll Statische Zugangsdaten verwenden Definieren Sie hier ein zu verwendendes Verfahren und die f r den Zugriff erforderlichen Authentifizierungsdaten Verfahren Basic Es werden Benutzername und Passwort verlangt und unverschl sselt bermittelt inubit 6 1 Workbench Process Engine Systemkonnektor Guide 05 09 2013 300 REST Connector Dialogbeschreibungen Nur zu
338. inubit 6 1 inubit Workbench Process Engine Systemkonnektor Guide Copyright Rechtliche Bestimmungen Bosch Software Innovations GmbH Sch neberger Ufer 89 91 10785 Berlin Deutschland Phone 49 30 72 61 12 0 Fax 49 30 72 61 12 100 E Mail info de bosch si com URL www bosch si com Bosch Software Innovations GmbH 2013 Die in diesen Unterlagen enthaltenen Angaben und Daten einschlie lich URLs und anderer Verweise auf Internetbasis k nnen ohne vorherige Ank ndigung ge ndert werden Die Produktdokumentation wurde sorgf ltig erstellt Die darin enthaltenen An gaben k nnen jedoch nicht als Zusicherung von Eigenschaften der Software gelten Die Haftung der Bosch Software Innovations GmbH umfasst nur die in den Verkaufs und Lieferbedingungen festgelegten Bestimmungen Die Benutzer sind verantwortlich f r das Einhalten aller anwendbaren Urheberrechts gesetze Unabh ngig von der Anwendbarkeit der entsprechenden Urheberrechtsge setze darf ohne ausdr ckliche schriftliche Erlaubnis der Bosch Software Innovations GmbH kein Teil dieses Dokuments f r irgendwelche Zwecke vervielf ltigt oder ber tragen werden unabh ngig davon auf welche Art und Weise oder mit welchen Mit teln elektronisch oder mechanisch dies geschieht Die Bosch Software Innovations GmbH kann Inhaber von Patenten Marken Urheber rechten oder anderen Rechten an geistigem Eigentum sein die den Inhalt dieses Do kuments betreffen Die
339. ion anlegen zeigt der Dialog auf der rechten Seite die folgenden Parameter RvsNeighbourSid Der Name wird mit dem Namen der Nachbarstation vorbelegt unter der die Routed Station angelegt wurde Name Telefon Bemerkungen Diese Angaben sind optional Hier k nnen beispielsweise die Daten eines Sachbearbeiters hinterlegt werden Odette ID Eindeutige Zeichenkette mit max 25 Zeichen Das erste Zeichen ist immer ein O Eingangsbestatigung EERP_in End to End Response Empfangsbest tigung Die EERP_in wird vom Gesch ftspartner gesendet Die Combobox bietet die Eintr ge NEVER und NORMAL Ausgangsbest tigung EERP_out Eine Empfangsbest tigung wird von der lokalen Station an den Gesch ftspartner gesendet Standardm ig ist die Option IMMEDIATE siehe unten vorausgew hlt Die folgenden M glichkeiten stehen zur Verf gung NEVER NORMAL SYNC IMMEDIATE HOLD und HOLD IMMEDIATE Siehe Nachbarstationen Workbench Process Engine Systemkonnektor Guide Kap 23 6 1 S 237 f r Infos ber die Eintr ge die f r die Empfangsbest tigungen gew hlt werden k nnen inubit 6 1 Workbench Process Engine Systemkonnektor Guide OFTP Connector 245 Dialog Stationen 23 6 1 7 Verbindung aktivieren Wenn Sie eine Nachbarstation markieren k nnen Sie aus dem Kontextmen die Option Verbindung aktivieren ausw hlen Mit dieser Option k nnen Sie testen ob eine Verbindung mit den angegeben Daten zur k
340. ion len gel scht werden DBStructure SoftDelete Obligatorisch Noch nicht unterst tzt Description inubit 6 1 Workbench Process Engine Systemkonnektor Guide 05 09 2013 100 Database Object Connector Konfigurationsdatei Feldbeschreibungen Element Attribute Name Bedeutung DBStructure AutoInserUpdateConversion Obligatorisch Noch nicht unterst tzt Description Table DBTableName Obligatorisch Tabellenname in der DB Table TagTableName Obligatorisch Tabellenname in XML Table DBProc InsteadUpdate Implizit StoredProcedure statt Up date Table DBProc InsteadInsert Implizit StoredProcedure statt Insert Table DBProc_InsteadSelect Implizit StoredProcedure statt Select Table DBProc InsteadDelete Implizit StoredProcedure statt De lete Table DBSoftDeletField Implizit Noch nicht unterst tzt Table DBSOftDeletValue Implizit Noch nicht unterst tzt Field DBFieldName Obligatorisch Feldname in der DB Field TagFieldName Obligatorisch Feldname im XML Field DBSPParamlIdx Implizit StoredProcedure Parameter Index Field DBFieldType Implizit Feldtyp Field DBFieldLength Implizit Feldlange Field DBIsPrimaryKey Obligatorisch Prim rschl ssel Field TsAutoField Implizit Autoident Feld wenn true dann wird ber getNewID eine ID geholt Siehe Datenbankprozedur getNewID erstellen Workbench Process Engine Syst
341. ispiel f r eine XPCML Eingangsnachricht aesseseeessesessnssseernnnesinnnnssennnnnnnnnnnatannnaanannnaataannaadtananaaan naat 27 2 2 Dialog AS 400 Connector Eigenschaften AAA 28 SAS2Z COMMGCION tee ee a a en een 31 3 1 Modulvariablen des AS2 Connectors 2240s444424400nnnnnnnnnonnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnannnnnnnnnannnnnnnnnnnannnn nn 32 3 2 Empfangen Senden und Pr fen von AS2 Nachrichten nen 33 3 2 1 MIME Strukt r 2 44 28 ee lu Bene eege eet 33 3 22 BeispielworkfloWS 0e 0 seele aetna trete laine 34 3 3 Dialogbeschreibungen es ist Rebeet nee Be nenne 36 3 3 1 Dialog AS2 konfouraton nenn nenn 36 3 3 2 Dialog AS S MIME Konfiguration usserssnnennnensnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnennnnnnnnnennnnnnnnsnnnnnn 36 3 3 3 Dialog AS2 Listener kontfguratton nennen 37 3 3 4 Dialog Message Archiv Konfiouraton nn 38 3 3 5 Dialog AS MDN Valtdator nennen 38 3 3 6 Dialog AS2 Listener Konfiguration ussersnnseeensnnnnnnnennnnnnnnnnnnnnnnnnennnnnnnnnnnnnnnnnnnnnnnnnnnnennn nn nenn 38 3 3 7 Dialog AS2 Konfiguration nee ea aa EES 38 3 3 8 Dialog AS Nachrichten Konfiguration nenn 39 3 3 9 Dialog AS MIME Konfiguration u 4 444eesennnnnnennnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnennnnnnnnnennnn nennen nnnnnsn nn 39 3 3 10 Dialog AS MDN Konnfiguration A 40 3 3 11 Dialog HTTP S Server Konfiguration nennen 41 3 3 12 Dialog AS MDN Versand K
342. it Hilfe der Modulvariable httpstatus gesetzt werden Asynchrone Kommunikation Der HTTP Input Listener empf ngt einen Request und sendet direkt eine HTTP Statusmeldung an den Client zur ck Dann wird mit dem Request der Workflow gestartet Das Ergebnis des Workflows wird nicht zur ckgegeben Alle Parameter und Header die mit dem Request bergeben wurden stehen w hrend der Workflow Ausf hrung als Modulvariablen zur Verf gung Input Connector Sendet als Client GET Requests an einen HTTP Server um Daten anzufordern Parameter werden im Anfrage Teil der URL bergeben Der Nachrichteninhalt der Response wird als Ausgangsnachricht des Moduls an den Workflow bergeben Bei Statuscode lt 200 oder gt 300 wird ein Fehler erzeugt Medium Output Connector Diese Konnektortypen senden in der Funktion von Clients POST Requests an einen HTTP Server Parameter und Eingangsnachrichten werden im Request Body bertragen Wenn die Response des HTTP Servers ein Statuscode lt 200 oder gt 300 ist dann wird ein Fehler erzeugt Andere Statuscodes gibt der Medium Output Connector als Ausgangsnachricht aus Der HTTP Connector unterst tzt die Protokolle HTTP und HTTPS Siehe auch Systemkonnektoren Workbench Process Engine Systemkonnektor Guide Kap 1 S 19 Module anlegen Workbench Benutzer Guide Kap 3 3 S 129 inubit 6 1 Workbench Process Engine Systemkonnektor Guide 05 09 2013 146 HTTP Connector Parameter setzen u
343. it vielen Sonderzeichen der mittel und s dosteurop ischen Sprachen Siehe http de wikipedia org wiki ISO_ 8859 2 IA5 7 Bit Zeichensatz gem ISO 646 mit verschiedenen lokalen Varianten Die inubit Software unterst tzt die Variante IA5 US Siehe http de wikipedia org wiki ISO_646 Binary F r Eingangsnachrichten im Binarformat FILE F r Eingangsnachrichten im Bin rformat mit FTBP Anhang File Transfer Bodyparts Dieser Anhangtyp erm glicht die Versendung zus tzlicher Dateiinformationen wie z B Dateiname Beachten Sie dass dieser Anhangtyp nicht von allen X 400 Boxen unterst tzt wird 1508859_1_RAW F r die bertragung von Anh ngen ohne feste Zeichenkodierung als Raw Daten Dateiname Nur bei Anhangtyp FILE Zus tzliche Angabe eines Dateinamens f r die Ausgangsnachricht inubit 6 1 Workbench Process Engine Systemkonnektor Guide 05 09 2013 492 X 400 SE Connector Dialogbeschreibungen 05 09 2013 inubit 6 1 Workbench Process Engine Systemkonnektor Guide
344. iten des RosettaNet Konsortiums heruntergeladen werden ZIP Datei des aktuellen RNIF V2 0 Pr ambel DTD Preamble MS VO2 00 dtd Delivery Header DTD DeliveryHeader MS V02 00 dtd m Service Header DTD ServiceHeader MS V02 00 dtd Receipt Ack DTD AcknowledgmentOfReceipt MS V02_ 00 dtd Exception DTD Exception MS V02 00 dtd Not DTD 0A1 MS V02 00 FailureNotification dtd Um eine bereits geladene Datei zu aktualisieren m ssen Sie eine WY Datei mit einem anderen Namen laden Wenn Sie eine Datei mit demselben Namen laden dann wird die vorhandene Datei nicht ersetzt Identifikation m Ihre DUNS Geben Sie Ihre eigene DUNS Nummer an Eine DUNS Nummer dient der eindeutigen Identifikation von Gesch ftspartnern inubit 6 1 Workbench Process Engine Systemkonnektor Guide 05 09 2013 320 RosettaNet HTTPS Connector Dialogbeschreibungen Nachrichtenarchiv aufr umen Verz gerung der Sendewiederholung Lu Behandlung von Anh ngen 05 09 2013 Sie erhalten eine DUNS Nummer bei der Dun amp Bradstreet Corporation unter http www dnb com Partner DUNS Geben Sie die DUNS Nummer Ihres Gesch ftspartners an Location ID Die Location ID ist eine frei w hlbare alphanumerische Zeichenkette in einem beliebigen Format Sie kann z B benutzt werden um eine spezielle Niederlassung des Gesch ftspartners zu bezeichnen Auf die Location ID einigen sich die Gesch ftspartner untereinander
345. iviert Archiv Fenster in Tagen Nur beim Input Connector inubit 6 1 Workbench Process Engine Systemkonnektor Guide Database Object Connector 107 Dialogbeschreibungen Alle archivierten Events die lter als X Tage sind werden aus dem Archiv gel scht und dem Workflow zur Verf gung gestellt Verbindungstest m Verbindung testen Zum Testen ob die Verbindung mit Ihren Angaben erfolgreich aufgebaut werden kann 7 6 2 Dialog Datenbank Connection Pooling Siehe Dialog Datenbank Connection Pooling Workbench Process Engine Systemkonnektor Guide Kap 6 5 5 S 90 7 6 3 Dialog DBO Konfigurationsdatei In diesem Dialog wird die Konfigurationsdatei des DBO Connectors angezeigt In der Konfigurationsdatei wird die Struktur der Datenbanktabellen auf eine XML Struktur abgebildet Siehe Konfigurationsdatei Feldbeschreibungen Workbench Process Engine Systemkonnektor Guide Kap 7 4 S 99 Beim Erstellen eines DBO Connectors wird automatisch ein zur gew hlten Datenbank passendes Template f r die Konfigurationsdatei geladen Dieses Template m ssen Sie anpassen Sie k nnen Ihre angepasste Konfigurationsdatei im Repository oder im Dateisystem speichern um diese in weiteren DBO Connectoren wiederzuverwenden inubit 6 1 Workbench Process Engine Systemkonnektor Guide 05 09 2013 108 Database Object Connector Dialogbeschreibungen 05 09 2013 inubit 6 1 Workbench Process Engine Systemkon
346. k Generator Data Converter Workbench Process Engine Modul Guide Kap 4 S 57 HTTP Eingangsnachricht in XML wandeln Wenn markiert dann werden eingehende HTTP bzw Multipart form Requests inkl Header etc in XML konvertiert Wenn die Option nicht markiert ist wird der Body des HTTP Requests ohne Konvertierung in die Ausgangsnachricht geschrieben Multipart MIMEs m ssen dann geparst werden Synchrone HTTP Antwort Nur Input Listener Connector Aktivieren Wenn aktiviert dann empf ngt der Input Listener den Request startet den Workflow und wartet auf dessen Ergebnis Das Ergebnis ist die Ausgangsnachricht des letzten Moduls im Workflow Sobald das Ergebnis vorliegt sendet der Input Listener es zusammen mit einer Status Meldung an das aufrufende Modul zur ck Wenn die Option nicht aktiviert ist dann empf ngt der Input Listener einen Request sendet sofort die Status Meldung zur ck und startet dann den Workflow Es wird kein Ergebnis zur ck gegeben Fehlermeldung zur ckliefern Wenn aktiviert dann wird im Falle eines internen Serverfehlers Fehlercode 500 eine detaillierte Fehlermeldung an den Client zur ck geschickt Wenn die Option nicht aktiviert ist dann wird lediglich der Fehlercode 500 ohne Details zur ck gesendet HTTP Post Konfiguration Nur Medium Output Connector F r die Parameter bergabe Ausgabe als HTTP Post Mitteilung formatieren Markieren Sie diese Option um Parameter bergeb
347. kbench Process Engine Systemkonnektor Guide Kap 23 3 S 231 23 3 Daten bertragungsmodi Lu Der OFTP Connector unterst tzt folgende Daten bertragungsmodi Asynchrone bertragung mit Input Connector Der Input Connector holt die Daten entsprechend der Konfiguration im Dialog Zeitgesteuerte Verarbeitung Workbench Process Engine Systemkonnektor Guide Kap 1 1 3 S 22 rvs sendet eine Best tigung EERP wenn die Verbindung weiter besteht oder beim n chsten Verbindungsaufbau Dies entspricht der Option Normal f r den Parameter EERP_out Das L schen beendeter Jobs Nachrichtenempfang muss unterdr ckt werden Einstellung setparm CMDDELETE 0 im rvs Siehe Parameters EERP_out im Abschnitt Nachbarstationen Workbench Process Engine Systemkonnektor Guide Kap 23 6 1 S 237 Die Bestatigung garantiert dem Absender der Nachricht nicht dass die Nachricht auf der inubit Process Engine angekommen ist inubit 6 1 Workbench Process Engine Systemkonnektor Guide 05 09 2013 232 OFTP Connector Daten bertragungsmodi 05 09 2013 Achten Sie darauf dass die zul ssige Gr e der Datenbank im Verlauf des Betriebs nicht berschritten wird Wenn Sie mehr Informationen als den Dateinamen erhalten m chten dann m ssen Sie die rvs Konfiguration entsprechend ndern Synchrone bertragung durch rvs mit Input Listener Connector rvs best tigt per EERP out den Empfang der Nachricht Diese
348. kbench Process Engine Systemkonnektor Guide 05 09 2013 140 FTP Connector Dialogbeschreibungen Lesereihenfolge Dateipr fung Lu Wenn die Dateien nach der bertragung gel scht werden sollen aktivieren Sie die Checkbox Fehler erzeugen wenn L schvorgang fehlschl gt Wenn ein Fehler auftritt werden die Modulausf hrung und der Workflow fortgesetzt Wenn die Option aktiviert ist und ein Fehler auftritt dann wird im Queue Manager ein Fehlereintrag f r den Workflow mit diesem Modul angezeigt Ist ein Fehlerausgang konfiguriert wird dieser durchlaufen Sonst wird die Ausf hrung des Moduls abgebrochen Max Anzahl v Ausf hrungen pro zeitgesteuertem Aufruf Mit der Angabe legen Sie fest wie oft pro ausl sendem Event der Workflow maximal gestartet werden soll Ausl sendes Event ist das Erreichen eines Zeitpunktes Dann wird der Workflow so oft gestartet bis entweder keine weiteren Daten zu holen zu senden sind oder die Anzahl erreicht wurde welche bei maximale Ausf hrungen pro Aufruf konfiguriert wurde Mit der Begrenzung der Ausf hrung steuern Sie die Systemauslastung der inubit Process Engine Die Angabe wird im Test Modus ignoriert dann wird der Workflow genau einmal gestartet Die Option ist nur bei aktiviertem Scheduler aktiv 05 09 2013 Legen Sie Reihenfolge und Sortierung beim Lesen der Dateien fest Abbruch des Workflows wenn die Datei nicht existiert Im Testmodus
349. konfigurierten Warteschlange Medium Output Connector Agiert als Sender und schreibt Nachrichten in die angegebene Warteschlange Beide Konnektortypen geben die Eingangsnachricht wieder aus Siehe auch Systemkonnektoren Workbench Process Engine Systemkonnektor Guide Kap 1 S 19 Module anlegen Workbench Benutzer Guide Kap 3 3 S 129 Technical Workflow Diagramme Workbench Benutzer Guide Kap 12 S 311 Zugriff auf einen MSMQ Server Installation von J Integra for COM inubit 6 1 Workbench Process Engine Systemkonnektor Guide 05 09 2013 226 MSMQ Connector Ein und Ausgangsnachrichten erstellen E J Integra for COM muss auf dem MSMQ Server installiert werden weil dort die n tige Bibliothek mgoa d11 vorliegt inubit BPM Suite DCOM MSMQ Server J Integra for COM Eine detaillierte Installationsanleitung finden Sie unter http j integra intrinsyc com support com doc Installation eines DCOM Surrogats Um ber DCOM auf die MSMQ COM Komponente zugreifen zu k nnen muss das DCOM Surrogat mit dem Befehl setdllhost exe mgoa dll MSMQ auf dem MSMQ Server installiert werden Die Bibliothek mgoa d11 ist Teil des MSMQ Servers Java Wrapper msmq jar F r den Zugriff auf die Bibliothek mgoa d11 aus der inubit Software Siehe Treiber installieren Process Engine Administrator und Entwickler Guide Kap 3 4 S 57 Sie erhalten die Software und den Java Wrapper zusa
350. ktion In diesem Dialog legen Sie die Funktion des inubit IS Connectors fest Es ist abh ngig von der Konfiguration welche Funktion w hlbar ist Input Connector Datei herunterladen Medium Connector Workflow ausf hren Listener Output Connector Als Datei speichern Output Connector Workflow ausf hren Daten werden gesendet und direkt von einem Workflow verarbeitet Datei hochladen Daten werden auf den entfernten Server geladen der Workflow wird sp ter ausgef hrt 13 3 3 Dialog Verbindungsdaten Grundkonfiguration Authentifizierung Workflow 05 09 2013 Bei Medium und Input Connector Im Dialog zur Konfiguration der Konnektor Eigenschaften geben Sie die Zugangsdaten zur entfernten inubit Process Engine an von dem der inubit IS Connector Daten abholen soll Server URL Ersetzen Sie localhost mit dem Namen oder der IP Adresse der entfernten inubit Process Engine a SSL F r die Server und oder Client Authentifizierung ffnet den Dialog SSL Konfiguration Workbench Process Engine Systemkonnektor Guide Kap 1 1 4 S 24 Anmeldename Benutzername eines Accounts auf der entfernten inubit Process Engine a Passwort Passwort zu dem oben angegebenen Benutzernamen Name Name des Workflows mit dem die Verbindung erstellt werden soll System Connector Name des Systemkonnektors in dem Workflow mit dem die Verbindung erstellt werden soll inubit 6 1 Workbench Process
351. ktor Guide WebDAV Connector 475 Dialog WebDAV Connector Bei Methoden wie z B DELETE die keine R ckgabe liefern wird eine Status Response erzeugt z B lt xml version 1 0 encoding UTF 8 gt lt WebDAV version 1 0 gt lt StatusCode gt 200 lt StatusCode gt lt StatusText gt OK lt StatusText gt lt WebDAV gt Eingangsnachricht bertragen Wenn markiert wird zus tzlich zum Request die Eingangsnachricht zum WebDAV Server bertragen Tabelle Request Header Wert Im Request Header k nnen weitere Informationen in Form von Resource Properties bermittelt werden z B Content Type Der MIME Typ beschreibt das Format der bermittelten Daten z B text xml From Mailadresse des Anfragenden Accept Datenformate und Pr ferenzen des Benutzers f r Daten Enth lt eine Liste von Daten und Darstellungsformaten Um ein Property zu definieren ffnen Sie das Kontextmen der Tabelle und w hlen Hinzuf gen Um den Wert des Propertys einzugeben doppelklicken Sie in der Tabelle in die Spalte Wert Authentifizierung m Methode W hlen Sie eine der beiden Methoden aus Basic Wenn markiert dann fordert der WebDAV Server Benutzername und Passwort an beides wird unverschl sselt bertragen NT Verwenden Sie diese Methode wenn der WebDAV Server auf einem NT System l uft Dieses Authentifizierungsschema ist ein Standard der Firma Microsoft und erm glicht ei
352. ktor Guide Kap 7 4 S 99 inubit 6 1 Workbench Process Engine Systemkonnektor Guide Database Object Connector 95 Gesch ftsobjekte lesen erstellen bearbeiten oder l schen a Gesch ftsobjekte definieren Gesch ftsobjekte werden im DBStructureDescription Element beschrieben Sie k nnen beliebig viele DBStructureDescription Elemente konfigurieren und beliebig tiefe Hierarchien durch Untertabellen abbilden Kopieren Sie das Element FATHER_CHILD DBStructureDescription und passen Sie dieses an Ihre Tabellenstruktur an Das Beispielelement DBStructureDescription mit dem Attribut DBStructureName FATHER CHILD zeigt wie Constraints f r Prim r und Fremdschl ssel innerhalb DBStructureDescription abgebildet werden b Optional Datumsformat f r JDBC Session anpassen MySQL Das Datumsformat xs dateTime ist fest konfiguriert so dass es nicht einmalig f r die gesamte Session gesetzt werden kann Oracle Die Konfigurationsdatei initialisiert die JDBC Session mit dem Datumsformat xs dateTime yyyy mm dd T hh24 mi ss Siehe Konfigurationsdatei Feldbeschreibungen Workbench Process Engine Systemkonnektor Guide Kap 7 4 S 99 c Optional Sie k nnen die angepasste Konfigurationsdatei ins Repository oder ins Dateisystem speichern um die Konfigurationsdatei in anderen DBO Konnektoren wiederzuverwenden 6 Klicken Sie auf Fertig stellen Der Assistent schlie t sich 7 Datenbankprozedur getNewID erst
353. kunden nach welcher der Versuch eine Verbindung aufzubauen abgebrochen wird 24 6 3 2 ISDN Empf nger konfigurieren 05 09 2013 VectorPosition Nicht editierbar Typ blicherweise CAPI2A ISDN Protokoll Gibt den genutzten ISDN Standard an 1TR6 Deutscher Landesstandard E DSS1 EURO ISDN Standard ISDN Facilities Meist nicht angegeben ISDN Benutzerdaten Meist nicht angegeben X 25 Paketgr e Hier wird blicherweise die Paketgr e 128 angegeben Wenn Sie Facilities und Benutzerdaten angeben m chten dann als HEX Code Die Daten werden nur f r X 25 ber ISDN bertragungen ben tigt wenn Ihr X 25 Provider dies fordert ISDN Terminal Kennung Eindeutige Nummer Ihres ISDN Endger ts Empf nger Nummer Nicht editierbar Aktiv Die unter LOC konfigurierten Empf nger werden mit dieser Checkbox aktiviert ISDN Nummer Eigene ISDN Nummer Verbindungs Timeout Zeit in Sekunden nach welcher der Versuch eine Verbindung aufzubauen abgebrochen wird RCV Timeout RCV steht f r receive Zeit in Sekunden f r die Aufrechterhaltung des Empfang O bedeutet es existiert kein Timeout Max eingehende Verbindungen Anzahl der gleichzeitig eingehenden Verbindungen X 25 Facilities inubit 6 1 Workbench Process Engine Systemkonnektor Guide OFTP2 Connector 269 Dialog Stationen Spezielle Informationen oder Anlagen bei X 25 bertragung X 25 Benutzerdaten Benut
354. l lt fiel ldValue gt 2003 03 20 10 20 00 000000000 lt fieldValue gt lt field gt lt field gt ldName gt wert lt fieldName gt lt fiel lt fiel lt fields lt table gt lt tables gt lt query gt lt query type lt tables gt lt table gt dValue gt 10 12 lt fieldValue gt lt field gt gt select gt lt tableNames gt lt tableName gt eins lt tableName gt lt tableNames gt lt fields gt lt field gt lt fieldName gt lt fieldName gt lt field gt lt fields gt lt conditions gt lt conditi on type OR gt lt leftValue gt id lt leftValue gt lt operation gt lt operation gt lt rightValue gt 1 lt rightValue gt lt condition gt 05 09 2013 inubit 6 1 Workbench Process Engine Systemkonnektor Guide Database Connector XML Querys Struktur und Beispiele lt conditions gt lt table gt lt tables gt lt query gt lt query type update gt lt tables gt lt table gt lt tableNames gt lt tableName gt eins lt tableName gt lt tableNames gt lt fields gt lt field gt lt fieldName gt id lt fieldName gt lt fieldValue gt 2 lt fieldValue gt lt field gt lt fields gt lt conditions gt lt condition type OR gt lt leftValue gt id lt leftValue gt lt operation gt lt operation gt lt rightValue gt 1 lt rightValue gt lt condition gt lt conditions gt lt table gt lt tables g
355. l einer vorkonfigurierten Datenbank um die Felder Datenbank URL und Datenbanktreiber Klasse sinnvoll zu belegen Bei Auswahl von IS Log Database verbindet sich der Database Connector mit der inubit Logging Monitoring Datenbank F r die Verbindung wird die Konfiguration der inubit Process Engine verwendet deswegen werden alle anderen Felder in diesem Bereich deaktiviert Falls Ihre Datenbank nicht vorhanden ist w hlen Sie die Voreinstellung Custom und f llen Sie die Felder manuell aus Unter Windows k nnen Sie auf die JDBC ODBC Bridge ausweichen W hlen Sie die JDBC ODBC Bridge nur wenn Sie keinen JDBC Zugriff auf Ihrer Datenbank einrichten k nnen Eine JOBC ODBC Bridge hat eine schlechtere Performance der Funktionsumfang kann eingeschr nkt sein und die automatische Typerkennung ist deutlich langsamer Datenbank URL Wird vorbelegt wenn Sie eine vorkonfigurierte Datenbank gew hlt haben Geben Sie den Host den Port und den Datenbanknamen an Datenbanktreiber Klasse inubit 6 1 Workbench Process Engine Systemkonnektor Guide Database Connector 85 Dialogbeschreibungen Entspricht der JDBC Verbindung der eingesetzten Datenbank Um eine andere Datenbank zu verwenden m ssen Sie einen passenden Treiber installieren Siehe Treiber installieren Process Engine Administrator und Entwickler Guide Kap 3 4 S 57 Nach Installation eines JDBC Treiber f r den MS SQL Server LN m s
356. l erzeugt File 11 xml Angabe mit Datumsformat damm File TimeStamp ddMM xml erzeugt File 2309 xml Zeitstempel Der Zeitstempel enth lt zus tzlich eine Angabe in Millisekunden file STimeStamp ddMMyyyy HHmmss SSS xml erzeugt file 12122002 151304 027 xm l Prozess ID file PID ProcessId xml Verwende Wildcard Inhalt des vorher ausgef hrten File oder FTP Connectors Wenn Sie diese Option anklicken so wird der Wildcard Inhalt verwendet der von einem vorher ausgefuhrten File oder FTP Connector erzeugt wurde Verwende Dateiname von vorher ausgefuhrtem File Connector Wenn Sie diese Option wahlen so wird der Dateiname verwendet der von einem vorher ausgef hrten File Connector benutzt wurde Beispiel ein vorher ausgef hrter File Connector wurde so konfiguriert das im Feld Verzeichnis und Dateiname eine Datei Test ml angegeben wurde Als Ausgangsnachricht wird vom File Connector eine Datei mit genau diesem Namen Test ml weitergeleitet Dieser Dateiname wird dann auch hier verwendet Falls im Feld Name zus tzlich ein Dateiname eingegeben wird wird dieser vom System ignoriert Daten an die Datei anf gen Wenn Sie diese Option w hlen dann wird bei jeder Ausf hrung des FTP Connectors die Ausgangsnachricht an die bereits existierende Datei angeh ngt Dies ist zum Beispiel n tzlich wenn Sie Log Daten kumulativ in einer Datei protokollieren m chten inubit 6 1 Workbench Pro
357. lche Operation ausgef hrt wird kann ein Demultiplexer genutzt werden Der Demultiplexer leitet den Request in den passenden Zweig des Workflows weiter in denen der Request verarbeitet wird In dem abgebildeten Beispiel sind die beiden Empty Module DoSomething und DoSomethingElse Platzhalter f r weitere verarbeitende Module XSLT Converter CreateResponse Das Ergebnis der Verarbeitung die SOAP Response wird vom letzten Modul des Technical Workflows in einer Web Service konformen Darstellung an den aufrufenden Web Service zur ckgegeben Diese SOAP Response wird mit einem XSLT Converter erstellt So gehen Sie vor 1 Web Services Input Listener Connector konfigurieren a Erzeugen Sie einen Technical Workflow b F gen Sie einen Web Services Input Listener Connector ein Legen Sie beim Konfigurieren fest dass die Definition des aufzurufenden Web Services am Modul gespeichert werden soll Siehe Dialog Bereitgestellter Web Service Workbench Process Engine Systemkonnektor Guide Kap 40 16 1 S 451 inubit 6 1 Workbench Process Engine Systemkonnektor Guide Web Services Connector 419 Web Service anbieten c ffnen Sie das Kontextmen des Konnektors und w hlen Sie Bearbeiten um den Web Service Editor anzuzeigen d Klicken Sie auf Operation hinzuf gen Der folgende Dialog ffnet sich Eigenschaften Web Service Editor Bereitgestellter Servic
358. le erkennen Siehe Dokument in das PDF Format konvertieren Workbench Process Engine Systemkonnektor Guide Kap 25 S 275 Dokument bearbeiten Workbench Process Engine Systemkonnektor Guide Kap 25 S 276 Dokument drucken Workbench Process Engine Systemkonnektor Guide Kap 25 S 278 F gen Sie mit dem XSLT Kommandoassistenten das Element param mit dem Attribut name oo document oberhalb des Elements xIs output ein Weisen Sie dem Element InputDocument das XSLT Kommando value of und den Wert Soo document zu Damit lesen Sie den Wert der im Assign Modul definierten Variablen oo document die den Inhalt des zu bearbeitenden Dokuments enth lt in das Element InputDocument ein Klicken Sie auf Fertigstellen Verbinden Sie das Assign Modul mit dem XSLT Converter OpenOffice Connector einf gen So gehen Sie vor 1 2 Erstellen Sie einen OpenOffice Connector Geben Sie an auf welchem System der OpenOffice Server installiert ist Feld Servername und ber welchen Port er erreicht werden kann Verbinden Sie den XSLT Converter mit dem OpenOffice Connector inubit 6 1 Workbench Process Engine Systemkonnektor Guide 05 09 2013 274 OpenOffice Connector Beispiel Workflow erstellen Assign Modul zum Dekodieren aus Base64 einf gen 05 09 2013 SU N AS Setzen Sie den Startpoint vor das Assign Modul Starten Sie den Workflow mit einer Word Writer Datei
359. lgenden Optionen stehen Ihnen zur Verf gung Als WSDL Import hinzuf gen In die WSDL wird ein wsdl import Element mit der angegebenen URL als Referenz eingef gt Inhalt bernehmen Die Inhalte aus der im Feld URL angegebenen Datei werden in die WSDL kopiert inubit 6 1 Workbench Process Engine Systemkonnektor Guide Web Services Connector 453 Dialogbeschreibungen URL Mit einem Klick auf das Icon sam Ende des URL Feldes ffnen Sie ein Men um die URL der WSDL anzugeben eine Repositorydatei oder ein Modul auszuw hlen 40 16 2 Dialog Aufzurufender Web Service Medium und Output Connector In diesem Dialog legen Sie fest ob der Konnektor auf eine am Konnektor selbst gespeicherte WSDL zugreifen soll oder auf eine WSDL die im gesamten Workflow zur Verf gung steht WSDL Definition m Definition des aufzurufenden Web Services am Modul speichern W hlen Sie diese Option wenn die WSDL an dem Connector gespeichert werden soll Am Workflow PartnerLink gespeicherte Definition verwenden W hlen Sie diese Option wenn die WSDL im Workflow gespeichert werden soll In diesem Fall kann dieselbe WSDL auch von anderen in demselben Workflow verwendeten Web Services Connectoren verwendet werden Workflow Das Feld zeigt den Workflow Namen an sobald der Connector in einem Workflow verwendet wird 40 16 3 Web Service Editor und Register Dieser Abschnitt erl utert die folgenden Themen Register
360. lgenden Protokolle beruht TCP IP ISDN XOT oder TLS Wenn Sie den Stationen Dialog aufrufen und links den Eintrag LOC ausw hlen werden auf der rechten Seite des Dialogs alle Empf nger aufgelistet Sie k nnen Empf nger hinzuf gen und entfernen Wenn Sie diese Option ausw hlen k nnen Sie aus der Liste aller konfigurierten Empf nger ausw hlen welchen Sie entfernen wollen Stellen Sie sicher dass ber den Empf nger den Sie l schen wollen keine Nachrichten mehr ausgetauscht werden Empf nger werden der lokalen Station hinzugef gt Wie viele Empf nger Sie hinzuf gen k nnen entnehmen Sie dem Handbuch Ihrer eingesetzten OFTP2 Middleware Protokoll des Empf ngers Zur lokalen Station k nnen mehrere Empf nger hinzugef gt werden die ber verschiedene Protokolle angebunden sind Sie k nnen jeweils ein oder mehrere Empf nger vom Typ TCP IP ISDN XOT oder TLS hinzuf gen inubit 6 1 Workbench Process Engine Systemkonnektor Guide 05 09 2013 268 OFTP2 Connector Dialog Stationen 24 6 3 1 TCP IP Empf nger konfigurieren VectorPosition Nicht editierbar Empf nger Nummer Nicht editierbar IP Adresse IP Adresse oder Rechnernamen Ihres ISDN Routers Port Portnummer ber die Nachrichten empfangen werden Max Eingangssessions Maximale Anzahl von parallelen Eingangssessions Aktiv Die unter LOC konfigurierten Empf nger werden mit dieser Checkbox aktiviert Timeout Zeit in Se
361. lication Connector 405 Verwendung Dieser Abschnitt erl utert die folgenden Themen m Modulvariablen des Web Application Connectors S 406 m Informationen aus Portlet Instanzen abfragen S 406 m Dialogbeschreibungen S 408 Der Web Application Input Connector macht die Funktionalit t eines Technical Workflows in einem Portalserver als Portlet verf gbar Beim Konfigurieren des Systemkonnektors legen Sie folgendes fest Titel und Timeout des Portlets Trace Level JavaScript Funktionen und CSS Klassen die in allen Formularen verf gbar sind die im Technical Workflow erzeugt werden Rechte des Portlets Hohe Benutzerzahlen und High Availability sind m glich indem Sie das Loadbalancing ber mehrere identische inubit Process Engines aktivieren und konfigurieren Siehe auch Systemkonnektoren Workbench Process Engine Systemkonnektor Guide Kap 1 S 19 Module anlegen Workbench Benutzer Guide Kap 3 3 S 129 Technical Workflow Diagramme Workbench Benutzer Guide Kap 12 S 311 inubit 6 1 Workbench Process Engine Systemkonnektor Guide 05 09 2013 406 Web Application Connector Modulvariablen des Web Application Connectors 39 1 Modulvariablen des Web Application Connectors Ein Web Application Connector setzt folgende Modulvariablen Name Erl uterung ISPortalUser Loginname des aktuell angemeldeten Portalbenutzers ISWebAppTimeout Timeout in Sekunden wird festgelegt im D
362. lichen Schl ssel Ihres Gesch ftspartners verschl sselt Wenn Ihr Gesch ftspartner zum Empfang von AS2 Nachrichten nicht den inubit AS2 Connector verwendet dann m ssen Sie vor dem Verschl sseln den Verschl sselungsalgorithmus seiner Software ermitteln weil nicht alle Produkte alle Algorithmen unterst tzen Verschl sselungsalgorithmus Zur Auswahl des Verschl sselungsalgorithmus Standard ist DES_EDE3_CBC weil dieses Verfahren das gangigste ist Die Empf ngerseite erkennt das Verschl sselungsverfahren der Nachricht automatisch G ltig bis Zeigt nach dem Laden des Schl ssels das G ltigkeitsdatum an Button Truststore oder Zertifikat hinzuf gen ffnet einen Dateiexplorer zum Laden des ffentlichen Schl ssels Wenn markiert dann werden die Nachrichten entsprechend der S MIME Spezifikation komprimiert 3 3 10 Dialog AS MDN Konfiguration 05 09 2013 Nachrichtenversand mit Output Connector In diesem Dialog legen Sie fest ob Sie Empfangsbest tigungen MDN vom Empf nger erwarten Standardm ig werden synchrone Empfangsbest tigungen verlangt Synchrone Empfangsbest tigungen sendet der Empf nger sofort nach Erhalt der Nachrichten ber HTTP an die Adresse die in der Nachricht als Absenderadresse angegeben ist Der Output Connector wartet solange bis die Empfangsbest tigung eingetroffen ist Um die Empfangsbest tigung zu speichern schalten Sie z B einen File Connector hinter de
363. lidiert versendet und durch Empfangsbest tigungen best tigt werden Die Urheberschaft einer Gesch ftsnachricht wird durch digitale Signaturen und die Datensicherheit durch Verschl sselung gew hrleistet Der Absender erh lt aus dem AS2 bertragungsstandard eine digitale Empfangsquittung Message Disposition Notification MDN mit welcher der Absender die fristgerechte Zustellung beweisen kann Vor dem Versenden wird f r jede Gesch ftsnachricht ein Umschlag in Form einer Standard MIME Struktur erzeugt Die Gesch ftsnachrichten k nnen in einem XML Format EDI Format z B ANSI X12 oder UN EDIFACT oder in jedem anderen strukturierten Format vorliegen Siehe IETF AS2 Spezifikation unter http www ietf org rfe rfc4130 txt Der AS2 Connector wurde erfolgreich mit folgenden Produkten getestet Compinia ComAS2 OpenAS2 IP Works AS2 Connector Siehe auch Systemkonnektoren Workbench Process Engine Systemkonnektor Guide Kap 1 S 19 Module anlegen Workbench Benutzer Guide Kap 3 3 S 129 Technical Workflow Diagramme Workbench Benutzer Guide Kap 12 S 311 inubit 6 1 Workbench Process Engine Systemkonnektor Guide 05 09 2013 32 AS2 Connector Modulvariablen des AS2 Connectors 3 1 Modulvariablen des AS2 Connectors Variablen des AS2 Connectors Die Tabelle enthalt alle Variablen welche ein AS2 Connector bei seiner Ausf hrung setzt unabh ngig davon ob es sich um einen Input oder Outp
364. lle Transpondersignale empfangen Die inubit Process Engine ist ber TCP IP z B ber Ethernet mit dem i Port verbunden der RFID Connector fragt ber den Port 7070 der inubit Process Engine den i Port ab und leitet ein empfangenes Signal an den nachgeschalteten Workflow weiter inubit 6 1 Workbench Process Engine Systemkonnektor Guide 05 09 2013 306 RFID Connector Beispiel Ausgangsnachricht RENTEN aaee EnS Other antenna coaxial cable TCP IP connection inubit BPM Suite EE vn e e gt 28 2 Beispiel Ausgangsnachricht Eine Ausgangsnachricht kann z B folgenderma en aussehen lt xml version 1 0 encoding UTF 8 gt lt Event gt lt Mask gt 27 lt Mask gt lt TagID gt 223741 lt TagID gt lt Detection gt 0 lt Detection gt lt FieldStrengths 0 antenna 0 gt 65 7 lt FieldStrengths_0 gt lt FieldStrengths 1 antenna 1 gt 128 lt FieldStrengths_1 gt 05 09 2013 inubit 6 1 Workbench Process Engine Systemkonnektor Guide RFID Connector 307 Dialog RFID IPort Connector Eigenschaften lt FieldStrengths_2 antenna 2 gt 128 lt FieldStrengths_2 gt lt FieldStrengths_3 antenna 3 gt 128 lt FieldStrengths 3 gt lt Time gt Wed Apr 07 15 27 36 CEST 2004 lt Time gt lt IPortID gt 2 lt IPortID gt lt maxAntenna gt 1 lt maxAntenna gt lt Event gt Bedeutung der XML Elemente Die XML Elemente haben folgende Bedeutun
365. lls der Server in einer solchen l uft und Sie sich ber eine Windows Dom ne anmelden m ssen inubit 6 1 Workbench Process Engine Systemkonnektor Guide 05 09 2013 400 VFS Connector Dialogbeschreibungen Verbindungsmodus nur FTP Aktiv Der Client ffnet den konfigurierten Port und teilt dem Server diesen Port und die eigene IP Adresse ber das PORT Kommando mit Passiv Der Client sendet ein PASV Kommando der Server ffnet den konfigurierten Port und bermittelt diesen mitsamt IP Adresse an den Client Standard Der Client nutzt die Server Einstellungen bertragungsart Geben Sie an ob die zu bertragenden Dateien bin r sind oder ASCII Daten enthalten W hlen Sie Standard wenn der Client die Server Einstellungen nutzen soll Gebietsschema Das Gebietsschema des Servers bestimmt u a die Art des Zeichensatzes und der Datumsangabe Kodierung Geben Sie die Kodierung des Kontrollkanals f r die Kommunikation zwischen Konnektor und FTP Server an Uber den Kontrollkanal werden die Befehle und dabei auch die Dateinamen als Zeichenketten bertragen Um sicherzustellen dass dabei z B Umlaute korrekt bertragen werden ist die Definition der Kodierung notwendig da diese von Server zu Server unterschiedlich sein kann 38 2 2 Dialog Input Connector Konfiguration Verzeichnis 05 09 2013 In diesem Dialog konfigurieren Sie wie der Konnektor Daten einliest Pfad Absoluter Pfad zu dem Verz
366. lt Part gt lt Data gt Daten lt Data gt lt Part gt lt Representation gt lt Representations gt lt Document gt lt Query gt 14 3 Dokumente aus ITA Archivsystem abholen Select Create_ITA_format Select_document Selector Write_document Die Abbildung illustriert wie ein Dokument aus dem ITA Archivsystem gelesen werden kann 1 Der XSLT Converter erstellt eine XML basierte Query in der die Operation definiert ist die der ITA Connector ausf hren soll hier Select Zus tzlich muss die Dokument ID angegeben sein Die Query muss konform zu dem XML Schema des ITA Connectors sein 05 09 2013 inubit 6 1 Workbench Process Engine Systemkonnektor Guide Beispiel ITA Connector 165 Dialog ITA Archiv Connector Das XML Schema finden Sie im Repository unter Global gt System gt Mapping Templates gt ITA Archiv Connector gt Query xsd 3 Der ITA Connector erh lt die XML basierte Query als Eingangsnachricht sendet diese an das ITA Archivsystem erh lt vom ITA Archivsystem das Dokument und gibt es als XML formatierte Nachricht aus Der XSLT Converter extrahiert das Dokument aus der XML Nachricht 4 Der File Connector schreibt das Dokument in das Dateisystem lt xml version 1 0 encoding UTF 8 gt lt Query type select gt lt Document maskID 1234567 gt lt Query gt 14 4 Dialog ITA Archiv Connector Grundkonfiguration Authentifiz
367. lt equal gt lt property name siemens ad bereichsarchiv lieferbelnr gt lt literal value 0123456789 datatype String gt lt equal gt lt and gt lt Condition gt lt Command gt lt Command Type Create DetailedResult truel false gt lt Entities gt lt Entity gt lt Type gt siemens ad bereichsarchiv Document lt Type gt lt Properties gt lt Property lt Property lt Property lt Property lt Property lt Property lt Property lt Property lt Property Name ixos dms Archiveld gt 4G lt Property gt Name siemens ad bereichsarchiv sysname gt GSS Ausfuhrnachweis lt Property gt Name siemens ad bereichsarchiv orgkrit1 gt SIX lt Property gt Name siemens ad bereichsarchiv orgkrit2 gt A1234567 lt Property gt Name siemens ad bereichsarchiv orgkrit3 gt AuD lt Property gt Name siemens ad bereichsarchiv fk_systyp gt 11 lt Property gt Name siemens ad bereichsarchiv fk land gt DE lt Property gt Name siemens ad bereichsarchiv fk _modul gt V lt Property gt Name siemens ad bereichsarchiv fk_dokart gt Ausfuhrnachweis Papier lt Property gt lt Property Name ixos bai LinkedIds MultiValue true gt lt Value gt gss SSIXXX01234567895 lt Value gt lt Property gt lt Properties gt lt Components gt lt Component gt lt Name gt data lt Name gt lt Format gt application pdf lt Format gt lt Data gt lt Base64 kodierte Bin rdaten lt Data gt lt Component gt
368. lt field gt lt fieldName gt lt fieldName gt lt field gt lt fields gt lt conditions gt lt condition gt lt leftValue gt Gartenmoebel KategorieNr lt leftValue gt lt operation gt lt operation gt lt rightValue gt Kategorien Kategorienummer lt rightValue gt lt condition gt lt conditions gt lt table gt lt tables gt lt query gt lt queries gt inubit 6 1 Workbench Process Engine Systemkonnektor Guide 05 09 2013 72 Database Connector XML Querys Struktur und Beispiele 6 4 5 Datens tze einf gen Insert SOL XMLQuery 05 09 2013 Um einer Tabelle einen Datensatz hinzuzuf gen verwenden Sie ein Insert NS ERT NTO addresses name address phone fax VAL UES Georg Miller Hauptstrasse 7 253263 253264 lt xml version 1 0 encoding ISO 8859 1 gt lt queries gt lt query type insert gt lt tables gt lt table gt lt tableNames gt lt tableName gt addresses lt tableName gt lt tableNames gt lt fields gt lt field gt lt fieldName gt name lt fieldName gt lt fieldValue gt Georg Miller lt fieldValue gt lt field gt lt field gt lt fieldName gt address lt fieldName gt lt fieldValue gt Hauptstrasse 7 lt fieldValue gt lt field gt lt field gt lt fieldName gt phone lt fieldName gt lt fieldValue gt 253263 lt fieldValue gt lt field gt lt field gt lt fieldNa
369. lvariablen mit Hilfe des Variablen Mappings dynamisch ndern Siehe Workflow Variablen und Mappings Workbench Benutzer Guide Kap 14 S 383 Input Connector URL Parameter die ein HTTP Input Connector an einen HTTP Input Listener Ubergeben hat konnen Sie am Watchpoint vor dem HTTP Input Listener anzeigen inubit 6 1 Workbench Process Engine Systemkonnektor Guide HTTP Connector 147 Header setzen und anzeigen accept text html image dl TestHttpListener cache control no cache connection keep alive E host localhost 8000 ISCurrentTime 1210251308543 15GlobalProcessId 67 1SModuleId 2495982 xml ISModuleName TestHttpListener 15ProcessId 67 15ServerName optix intra inubit d ISUserName root estHttpListener BEE DEE EE Medium Output Connector Auch die Parameter die ein HTTP Output Connector z B an einen HTTP Input Listener bergeben hat sind am Watchpoint vor dem HTTP Input Listener sichtbar werden die Workflow variablen angezeia TestHttpListener Text EDI Lei l lexType 3E 0Aa 0As04 0A 0 hipaymentRe xml D NT nA ne aR A Ah Mann mn nn en en 12 2 Header setzen und anzeigen Header statisch setzen Sie k nnen Request und Response Header beim Anlegen bzw Bearbeiten Ihres HTTP Connectors definieren Siehe Input Listener Connector HTTP Header Konfiguration Workbench Process Engine Systemkonnektor Guide Kap 12 S 149 Input Connector HTTP
370. m Workflows mit Start Stopbytes versehen an den konfigurierten Host und Port Siehe P Nachrichten mit Start Stopbyte Begrenzung verarbeiten Neue Features Kap 37 2 S 393 Suche nach der Nachricht in der R ckanwort vom Server und Analyse der Start Stopbytes Die Start Stopbytes werden aus der eintreffenden Nachricht entfernt Die in der Nachricht enthaltenen Nutzdaten werden an das nachste Modul im Workflow ubergeben Das Socket wird geschlossen Bei nicht konfigurierter Start Stopbyte Sequenz a f Der Konnektor sendet die Nachricht des vorhergehenden Moduls im Workflow Client ohne Start Stopbytes an den konfigurierten Server und Port Der Client schlie t die Verbindung zum Server Der Server schickt seine Nachricht ohne die Start Stopbytes und schlie t ebenfalls die Verbindung Der Client erkennt es als Ende der Nachricht wenn die Verbindung vom Server geschlossen wurde Diese Nachricht wird an die nachfolgenden Module im Workflow bergeben und der Workflow wird weiterbearbeitet Das Socket wird geschlossen Output Connector Der Konnektor stellt eine Verbindung zum konfigurierten Host und Port her Bei konfigurierter Start Stopbyte Sequenz 05 09 2013 inubit 6 1 Neue Features TCP IP Connector 393 IP Nachrichten mit Start Stopbyte Begrenzung verarbeiten a Der Konnektor sendet die Nachricht des vorhergehenden Moduls im Workflow Client mit Start Stop
371. m sun jndi fscontext RefFS ContextFactory WebLogic ContextProviderUrl t3 localhost 7001 ContextUrlPrefixes lt empty gt NamingContextFactory weblogic jndi WLInitialContextFactory Weitere JNDI Eigenschaften Geben Sie beliebige JNDI Properties als Property Wert Paare an com sonicsw jndi mfcontex t com sonicsw jndi mfcontext domain Domain2 idleTimeout 6000 Mehrere Properties trennen Sie mit jeweils einem Leerzeichen Bei Problemen wenden Sie sich an den Systemadministrator Ihres JMS Providers inubit 6 1 Workbench Process Engine Systemkonnektor Guide 05 09 2013 192 JMS Connector Dialogbeschreibungen Mitteilungstyp 05 09 2013 Nachrichten k nnen in folgenden Formaten versendet empfangen werden TextMessage Der Payload sind Daten die als Zeichenkette gespeichert wurden Zum Austausch von einfachen Textnachrichten und komplexer Zeichendaten wie XML Dokumente ObjectMessage bertr gt als Payload ein serialisierbares Java Object Zum Austausch von Java Objekten BytesMessage Der Payload wird als Byte Array gespeichert N tzlich f r den Austausch von Daten im nativen Format einer Applikation und f r den Fall dass JMS als Transportmittel zwischen zwei Systemen verwendet wird bei denen der JMS Client den Payload Typ der Nachrichten nicht kennt StreamMessage Sequenz primitiver Java Typen Das Nachrichtenobjekt berwacht deren Anordnung und Typen im Strom Datenkonvertierung
372. me gt fax lt fieldName gt lt fieldValue gt 253264 lt fieldValue gt lt field gt lt fields gt lt table gt lt tables gt lt query gt lt queries gt inubit 6 1 Workbench Process Engine Systemkonnektor Guide Database Connector 73 XML Querys Struktur und Beispiele 6 4 6 Datens tze aktualisieren Update Um bestehende Datens tze in einer Tabelle zu aktualisieren verwenden Sie das Update SQL UPDATE addresses SET address Hauptstrasse 8 WHERE name Georg Miller XMLQuery lt xml version 1 0 encoding 1S0 8859 1 gt lt queries gt lt query type update gt lt tables gt lt table gt lt tableNames gt lt tableName gt addresses lt tableName gt lt tableNames gt lt fields gt lt field gt lt fieldName gt address lt fieldName gt lt fieldValue gt Hauptstrasse 8 lt fieldValue gt lt field gt lt fields gt lt conditions gt lt condition gt lt leftValue gt name lt leftValue gt lt operation gt lt operation gt lt rightValue gt Georg Miller lt rightValue gt lt condition gt lt conditions gt lt table gt lt tables gt lt query gt lt queries gt inubit 6 1 Workbench Process Engine Systemkonnektor Guide 05 09 2013 74 Database Connector XML Querys Struktur und Beispiele 6 4 7 UpdateOrlnsert Dieses SQL Statemen t bildet die SQL Statements Insert und Update ab Damit wird versucht einen Datensatz
373. messageEncoding l sst sich das Content Transfer Encoding beeinflussen Standard ist binary 2 Die MIME Nachricht wird optional signiert ber die versteckte Property messageDigest l sst sich der Digest Algorithmus der S MIME Signatur ndern Unterst tzt werden SHA1 Standard SHA384 SHA512 und SHA256 3 Die MIME Nachricht wird optional verschl sselt 4 Die MIME Nachricht wird ber das HTTP Protokoll gesendet inubit 6 1 Workbench Process Engine Systemkonnektor Guide 05 09 2013 34 AS2 Connector Empfangen Senden und Pr fen von AS2 Nachrichten nur f r iS 5 3 Falls das Content Transfer Encoding nicht unterst tzt wird kann es ab iS Build 5 3 0 108 mit der versteckten Moduleigenschaft skipHTTPEncoding true abgeschaltet werden 3 2 2 Beispielworkflows Die folgenden Workflows illustrieren das Versenden und Empfangen einer AS2 Nachricht und ihrer Empfangsbest tigung Message Disposition Notification MDN SendMessageRequireMDN ReceiveMDN Sender Eer Recipient ReceiveMessages StoreMessages SendMDN Die Module sind folgenderma en konfiguriert 1 SendMessagesRequireMDN Der Output Connector verschl sselt die zu bertragenden Daten mit dem ffentlichen Schl ssel des Empf ngers sendet diese ab und fordert eine asynchrone MDN als Best tigung dass die Nachricht angekommen ist Die Nachricht enth lt u a eine ID die in einem Verzeichnis gespeichert wird weil sie noch zur Identifikation de
374. mgebung muss installiert sein Ein Selenium Remote Control Server muss installiert sein Ein Web Browser muss installiert sein Ef Informationen ber Selenium finden Sie unter folgenden Links Selenium Download http seleniumhq org download Selenium Remote Control Server http seleniumhg org docs 05 selenium _rc html Selenium Documentation http seleniumhq org docs Selenium Reference mit allen Test Befehlen http release seleniumhg org selenium core 0 8 2 reference html Siehe auch inubit 6 1 Workbench Process Engine Systemkonnektor Guide 05 09 2013 358 Selenium Connector Funktionsprinzip 33 1 Funktionsprinzip Eingangsnachricht 05 09 2013 Systemkonnektoren Workbench Process Engine Systemkonnektor Guide Kap 1 S 19 Module anlegen Workbench Benutzer Guide Kap 3 3 S 129 Technical Workflow Diagramme Workbench Benutzer Guide Kap 12 S 311 Der Selenium Connector verbindet sich mit dem Selenium Remote Control Server um einen auf lokalen oder entfernten Rechnern installierten Web Browser zu steuern Der Server startet stoppt den Browser und fungiert f r den Browser als HTTP Proxy Q Selenium Connector Der Selenium Connector erwartet eine XML Eingangsnachricht die z B folgenderma en aussieht lt xml version 1 0 encoding UTF 8 gt lt script gt lt base url gt http www google de lt base url gt lt suite gt lt command gt lt a
375. mkonnektor Guide Systemkonnektoren 23 Dialogbeschreibungen Wenn die Option markiert ist dann verhalten sich Systemkonnektoren folgenderma en Input Connector Startet zum angegebenen Zeitpunkt bzw im angegebenen Intervall und st t damit die Verarbeitung des Technical Workflows an Output Connector Sendet Nachrichten zum definierten Zeitpunkt bzw Intervall an die Zielapplikation Bis dahin werden die Nachrichten zwischengespeichert Wenn ein Systemkonnektor in einem Intervall gestartet wird das k rzer ist als die Ausf hrung des Workflows z B Intervall 10 s Ausf hrung 45 s dann verh lt sich der Workflow folgenderma en Wenn der Workflow parallel geschaltet ist dann wird er im angegebenen Intervall gestartet Falls die maximale Anzahl m glicher paralleler Ausf hrungen erreicht ist dann wird die weitere Bearbeitung in die Queue gestellt Wenn der Workflow nicht parallelisiert ist und zum Zeitpunkt seines n chsten Aufrufs noch l uft dann wird der Workflow nicht erneut gestartet Tage Ein Systemkonnektor kann folgenderma en aktiviert werden t glich w chentlich Auswahl eines oder mehrerer Wochentage monatlich Auswahl eines oder mehrere Tage eines Monats Uhrzeit Startzeit zu welcher der Prozess an dem angegeben Tag gestartet werden soll Wenn ein Intervall aktiviert ist dann wird der Vorgang in einem anzugebenden zeitlichen Abstand erlaubt z B alle 5 Minuten Um das Wieder
376. mmen mit der Lizenz f r den MSMQ Connector von der Bosch Software Innovations GmbH 22 2 Ein und Ausgangsnachrichten erstellen 05 09 2013 Die Ein und Ausgangsnachrichten erstellen Sie mit Hilfe eines Templates und eines XSLT Converters So gehen Sie vor 1 2 3 Erstellen Sie einen XSLT Converter ffnen Sie im Bereich XML Zieldatei das Men W hlen Sie ffnen von gt Repository Der Repository Explorer ffnet sich ffnen Sie das Verzeichnis Global gt System gt Mapping Templates gt MSMO Connector inubit 6 1 Workbench Process Engine Systemkonnektor Guide MSMQ Connector 227 Dialog MSMQ Connector Eigenschaften Markieren Sie eine der folgenden Dateien Eingangsnachricht erstellen MSMO_Input xsd Ausgangsnachricht erstellen MSMO_Output xsd Klicken Sie auf OK Der Explorer schlie t sich und das Template wird angezeigt Bilden Sie Ihre Eingangsnachricht auf die Template Struktur ab um eine Nachricht im erforderlichen Format zu erzeugen Siehe XSLT Converter Data Converter Workbench Process Engine Modul Guide Kap 5 S 139 22 3 Dialog MSMQ Connector Eigenschaften Einstellungen Authentifizierung Verbindungstest In diesem Dialog haben Sie folgende Optionen Server IP Adresse oder Hostname des MSMQ Servers zu dem die Verbindung aufgebaut werden soll Warteschlange Name der Warteschlange auf dem MSMQ Server Dom ne N
377. munity Der Community String public wird h ufig als Standard verwendet Sollte ein anderer String verwendet werden tragen Sie ihn hier ein Moderne Netzwerkkomponenten k nnen zu mehreren Communities geh ren Fragen Sie Ihren Administrator nach dem g ltigen Community String Operation GET fordert einen Datensatz an Der Datensatz enth lt die Daten zur Konfiguration einer Netzwerkkomponente Der SNMP Connector bermittelt als Antwort die Daten die f r dieses Ereignis im Handbuch der Netzwerkkomponente angegeben sind GETNEXT Fordert solange Datens tze an bis das Ende einer Liste mit Datens tzen erreicht ist Diese Operation wird benutzt wenn sich die Konfiguration einer Netzwerkkomponente ber mehrere Datens tze erstreckt SET Verschickt einen Datensatz zur Konfiguration einer Netzwerkkomponente Die Netzwerkkomponenten reagiert mit einem Datensatz der das Ergebnis der Konfiguration enth lt TRAP Automatisch ausgel ste Benachrichtigung ber ein Ereignis bei einer Uberwachten Komponente F r die Variablenbindung wird eine Tabelle mit Paaren aus OID und Werten aufgebaut Diese Tabelle ist nur f r den Input SNMP Connectoren verf gbar Die Tabelle bietet ein Kontextmen zum Hinzuf gen und L schen von OIDs inubit 6 1 Workbench Process Engine Systemkonnektor Guide SNMP Connector 369 Dialog SNMP Connector Eigenschaften Erfragen Sie die OID und den Wert f r die gew nschte Aktion bei W Ih
378. n Einstellungen m Adresse Servername oder IP Adresse des AS 400 Systems Benutzer Benutzername f r den Zugang des AS 400 Systems Passwort Passwort f r das AS 400 System Programmname Name des Programms ohne Erweiterung das gestartet werden soll Erweiterter Debugmode 05 09 2013 inubit 6 1 Workbench Process Engine Systemkonnektor Guide AS 400 Connector 29 Dialog AS 400 Connector Eigenschaften Wenn markiert dann wird die Debug Ausgabe des AS 400 Systems zu den Debug Ausgaben der inubit Process Engine hinzugef gt Verbindungstest m Verbindung testen Zum Testen ob die Verbindung mit Ihren Angaben erfolgreich aufgebaut werden kann inubit 6 1 Workbench Process Engine Systemkonnektor Guide 05 09 2013 30 AS 400 Connector Dialog AS 400 Connector Eigenschaften 05 09 2013 inubit 6 1 Workbench Process Engine Systemkonnektor Guide 3 Connector Verwendung 31 Dieser Abschnitt erl utert die folgenden Themen m Modulvariablen des AS2 Connectors S 32 m Empfangen Senden und Pr fen von AS2 Nachrichten S 33 m Dialogbeschreibungen S 36 Der AS2 Connector versendet und empf ngt Gesch ftsnachrichten und Empfangsbest tigungen gem dem Applicability Statement 2 AS2 AS2 beschreibt wie Gesch ftsnachrichten sicher ber das HTTP Protokoll in einem Peer to Peer Netzwerk ausgetauscht werden AS2 definiert wie die Verbindung hergestellt Gesch ftsnachrichten va
379. n Daten aus einem Portlet k nnen f r alle Portlets oder f r ein einzelnes Portlet auf derselben Portalseite verf gbar gemacht werden Um die Daten aller Portlets auf derselben Portalseite zug nglich zu machen geben Sie hier keine ID an Parameter Trennzeichen Standardm ig werden Parameter Werte Paare in einer URL durch die Zeichen und amp getrennt z B example org search Parameterl Wertl amp Parameter2 Wert2 Falls Sie einen anderen Portalserver als Liferay verwenden und dieser ein anderes Trennzeichen fordert geben Sie das Zeichen ein Lastverteilung Verteilt die Last der Workflow Ausf hrung auf mehrere inubit Process Engines wenn hier die URLs von deren SOAP Servlets angegeben sind Die URLs der SOAP Servlets haben folgendes Muster http lt rechnername gt 8000 ibis servlet IBISSoapServlet und entsprechen den URLs die beim Login an der inubit Workbench angezeigt werden Auf allen inubit Process Engines muss der Technical Workflow vorhanden sein den der aktuelle Web Application Connector aufruft inubit 6 1 Workbench Process Engine Systemkonnektor Guide Web Application Connector Dialogbeschreibungen Die Ausf hrung der Workflows wird im Round Robin Verfahren auf alle angegebenen Rechner verteilt Dabei wird f r eine neue Session der jeweils n chste Rechner gew hlt Siehe Server Trace Log aktivieren und konfigurieren Process Engine Administrator und Entwickler Guide Kap
380. n Process Engine Administrator und Entwickler Guide Kap 3 3 S 57 Es werden die jUDDI Registry 2 0 und Nsure 3 0 von Novell installiert In diesem Dialog haben Sie folgende Optionen URL W hlen Sie eine UDDI Registry aus oder tragen Sie eine URL ein Authorization URL Muss bei Nutzung einer UDDI 3 0 angegeben werden Wenn Sie die mitgelieferte UDDI 3 0 nutzen wird diese URL automatisch gesetzt UDDI V2 UDDI V3 Um die Version der ausgewahlten UDDI anzugeben Wenn Sie eine mitgelieferte UDDI ausgew hlt haben wird die korrekte Version automatisch angegeben Benutzername G ltiger Benutzer der UDDI Bei Auswahl einer mitgelieferten UDDI wird der Benutzername automatisch gesetzt Passwort G ltiges Passwort der UDDI Bei Auswahl einer mitgelieferten UDDI wird das Passwort automatisch gesetzt tModel publizieren Wenn markiert dann wird WSDL Datei als tModel publiziert tModel Key inubit 6 1 Workbench Process Engine Systemkonnektor Guide 05 09 2013 468 Web Services Connector Dialogbeschreibungen Web Service Implementierung publizieren Wird nach dem Publizieren von der UDDI Registry zur ckgeliefert Beschreibung Geben Sie eine Beschreibung Ihres Web Service ein Business Service publizieren Markieren Sie diese Option um die WSDL Datei als Business Service zu publizieren Service Key Wird nach dem Publizieren von der UDDI Registry zur ckgeliefert Business Key Repr sentiert die Business Grup
381. n die mit einem Doppelpunkt vom Rechnernamen getrennt wird beispielsweise MyServer 1234 Middleware Name Hier wird blicherweise die Zeichenkette rvsmw benutzt Wenn Sie einen anderen Namen f r die Middleware vergeben haben bernehmen Sie diesen hier Anmeldung Geben Sie hier die Benutzernamen an mit dem Sie sich bei der Middleware anmelden Gro und Kleinschreibung wird unterschieden Passwort Geben Sie hier Ihr Passwort ein Dateiname inubit 6 1 Workbench Process Engine Systemkonnektor Guide 05 09 2013 234 OFTP Connector Dialog OFTP Datenaustausch Konfiguration 05 09 2013 Der Name wird f r die OFTP bertragung benutzt und muss dem Empf nger bekannt gemacht werden damit dieser auf die Datei zugreifen kann Im Dateinamen k nnen Sie Wildcards oder regul re Ausdr cke verwenden Wildcards Fragezeichen Steht f r genau ein beliebiges Zeichen Asterisk Steht f r Null bis n beliebige Zeichen Die Wildcards k nnen in beliebiger Kombination und H ufigkeit benutzt werden Wenn Wildcards angegeben sind dann holt z B ein Input Connector nur Dateien die dem angegebenen Wert entsprechen alle anderen Dateien werden ignoriert Um alle Dateien zu empfangen geben Sie ein Regul re Ausdr cke Regul re Ausdr cke m ssen in Schr gstriche eingeschlossen werden Z B d d d d d d d qd F r Informationen ber regul re Ausdr cke siehe z B http
382. n ob die Verbindung mit Ihren Angaben erfolgreich aufgebaut werden kann inubit 6 1 Workbench Process Engine Systemkonnektor Guide 05 09 2013 482 WebSphere MO Connector Dialog WebSphere Message Queue Connector 05 09 2013 inubit 6 1 Workbench Process Engine Systemkonnektor Guide E EI A SE Connector Verwendung Verbindungskosten reduzieren Konnektortypen Dieser Abschnitt erl utert die folgenden Themen m Voraussetzungen f r den Betrieb S 484 m Lesebest tigungen abholen und versenden S 485 m Dialogbeschreibungen S 485 Ein X 400 SE Connector empf ngt und versendet Nachrichten auf Basis des internationalen Standards X 400 ber X 400 werden Nachrichten in einem geschlossenen Rechnernetz ausgetauscht Sowohl Absender als auch Empf nger der Nachricht besitzen X 400 Mailboxen in diesem Netz Alle Nachrichten werden grunds tzlich ber diese X 400 Mailboxen vermittelt d h eine Nachricht wird zu der X 400 Mailbox des Senders geschickt von dort an die X 400 Mailbox des Empf ngers bermittelt und vom Empf nger abgeholt In der inubit Software werden die Nachrichten von einem Isode Client an die X 400 Mailbox bermittelt der zus tzlich installiert werden muss Falls Ihr Provider die Verbindungen zu Ihrer X 400 Mailbox pro angefangene Minute oder pro Login berechnet ist es sinnvoll die folgenden Ma nahmen zu ber cksichtigen um die Verbindungskosten zu reduzieren Abholung von Nachr
383. n welches zu dem Event geh rt und gibt dieses Gesch ftsobjekt aus Wenn das Event ein Delete war wird nur der Prim rschl ssel ausgegeben Das verarbeitete Event wird in die Event Archiv Tabelle verschoben 1 Eventtabelle einrichten In diese Tabelle werden alle Ereignisse Insert Delete Update Select geschrieben die in einer berwachten Datenbanktabelle auftreten 2 Trigger setzen Die SQL Trigger m ssen auf alle Tabellen gesetzt werden in denen Events berwacht werden sollen Sobald in einer berwachten Tabelle z B ein Insert passiert l st der Trigger aus und schreibt das Event in die Eventtabelle 3 DBO Input Connector erstellen Der DBO Input Connector liest das Event aus der Eventtabelle bergibt das betroffene Geschaftsobjekt dem Workflow und st t damit die Workflowausf hrung an 4 Optional Tabelle zur Archivierung einrichten Bereits verarbeitete Events k nnen in einer Archiv Tabelle gespeichert werden So gehen Sie vor 1 Eventtabelle erstellen F r Oracle mit Sequence CREATE TABLE S EVENTS ID NUMBER 10 0 DEFAULT 0 NOT NULL IS PLUGIN ID VARCHAR2 10 DEFAULT NOT NULL PK1 VARCHAR2 100 DEFAULT NOT NULL PK2 VARCHAR2 100 DEFAULT NULL PK3 VARCHAR2 50 DEFAULT NULL PK4 VARCHAR2 50 DEFAULT NULL PK5 VARCHAR2 50 DEFAULT NULL PK6 VARCHAR2 50 DEFAULT NULL PK7 VARCHAR2 50 DEFAULT NULL PK8
384. n AS2 Output Connector Alternativ k nnen Sie explizit angeben dass Sie asynchrone und oder signierte Empfangsbest tigungen erwarten Signierte Empfangsbest tigung erforderlich Falls diese Option aktiviert ist muss der Empf nger die zur ckgesendete Empfangsbest tigung signieren und der MDN Listener pr ft die Signatur Asynchrone MDN inubit 6 1 Workbench Process Engine Systemkonnektor Guide AS2 Connector 41 Dialogbeschreibungen Asynchrone Empfangsbest tigungen werden zeitlich unabh ngig von der Nachricht versendet Zum Empfangen ben tigen Sie einen Workflow mit einem AS2 Input Listener Geben Sie die URL an an welche die Empfangsbest tigung geschickt werden soll Die URL wird zusammen mit der Nachricht unverschl sselt ber HTTP versendet 3 3 11 Dialog HTTP S Server Konfiguration Nachrichtenversand mit Output Connector In diesem Dialog geben Sie die Einstellungen des Servers an an den die AS2 Nachrichten geschickt werden sollen Konfiguration des Servers m URL SSL Adresse des Servers z B http www example com Zum Konfigurieren der Server bzw Client Authentifizierung ffnet den Dialog SSL Konfiguration Workbench Process Engine Systemkonnektor Guide Kap 1 1 4 S 24 Authentifizierung Wenn f r den Zugang zum Server eine Authentifizierung notwendig ist markieren Sie die Checkbox und geben Login und Passwort an das Sie von Ihrem Gesch ftspartner f r diesen Serv
385. n Editor der im Applikationsprofil Generic Application bzw Script Editor angegeben ist Siehe Applikationsprofile Process Engine Administrator und Entwickler Guide Kap 11 1 S 145 inubit 6 1 Workbench Process Engine Systemkonnektor Guide Execution Connector 121 Dialog Execution Connector Eigenschaften Pr fung des R ckgabewertes Erwarteter Wert Numerischer Wert m Wenn der angegebene und der tats chliche Ruckgabewert gleich sind dann wird die Workflow Ausf hrung fortgesetzt m Wenn ein anderer Wert als der angegebene zur ckgegeben wird dann wird der Fehlercode der aufgerufenen Applikation XML formatiert z B lt ExitValue gt value lt ExitValue gt an den Workflow bergeben Wenn kein erwarteter Wert angegeben ist l uft der Workflow grunds tzlich weiter f Um sicherzustellen dass fehlerhafte Ausf hrungen immer an den Q Workflow gemeldet werden geben Sie 0 ein denn Fehlercodes sind immer ungleich Null Verwendung der Ein und Eingabenachricht verwenden AUSBENBSHACHEIEHBEN nur beim Medium Output Connector Wenn markiert dann wird die Eingangsnachricht des Execution Connectors an die externe Applikation weitergeleitet Ausgabenachricht verwenden nur beim Input Medium Connector Wenn markiert dann wird die Ausgangsnachricht der externen Anwendung an den Execution Connector bergeben und von diesem an den Workflow weitergeleitet Fehlerausgang
386. n Fenster die Konfiguration der lokalen Station angeben Die Konfigurationsdaten m ssen mit denen bereinstimmen die Sie in Ihrer rvs Administrator Konsole angegeben haben Die lokale Station muss immer den Namen LOC in Gro buchstaben haben Die ersten beiden Optionsgruppen sind die folgenden Odette ID Dies ist eine eindeutige Zeichenkette die aus maximal 25 Zeichen besteht Das erste Zeichen ist immer ein O Eine Odette ID erhalten Sie unter www vda de Lokale Station Name Telefon und Bemerkungen sind optionale Felder Vergeben Sie f r Name einen beschreibenden Namen das Feld Telefon kann die Nummer des Sachbearbeiters enthalten der die Konfiguration betreut Bemerkungen kann den frei w hlbaren Namen der Station enthalten Danach folgen die Empf nger Deren Konfiguration ist abh ngig vom gew hlten Protokoll Wenn Sie LOC markiert haben steht Ihnen ein Kontextmen mit folgenden Befehlen zur Verf gung Nachbarstationen hinzuf gen Empf nger hinzuf gen Empf nger entfernen Verbindung aktivieren Dieser Abschnitt erl utert die folgenden Themen m Nachbarstation ber TCP IP S 241 m Nachbarstation ber SNA LU6 2 S 241 m Nachbarstation ber ISDN S 242 m Nachbarstation ber X 25 S 242 inubit 6 1 Workbench Process Engine Systemkonnektor Guide 05 09 2013 237 238 OFTP Connector Dialog Stationen Nachbarstation hinzuf gen 05 09 2013
387. n Nachricht mit allen PIP IDs vorher eingegangener Nachrichten verglichen Behandlung von Anh ngen Um bei einem Output Connector RosettaNet Attachments zu Attachments verwenden m ssen diese Attachments durch drei durchnummerierte Workflowvariablen beschrieben sein X beginnend bei 0 RNAttachment X Typ base64Binary enth lt die Daten des Attachments inubit 6 1 Workbench Process Engine Systemkonnektor Guide 05 09 2013 312 RosettaNet HTTPS Connector Beispiel Workflow RosettaNet Nachrichten erzeugen RNAttachmentContent ID X Typ xs string enth lt die eindeutige Idenfikation unique identifier des Attachments die Sie z B mittels com inubit ibis xsltext Misc generieren lassen k nnen RNAttachmentContent Type X Typ xs string MIME Content Type des Attachments z B text xml Bei einem Input Connector k nnen Sie Anh nge in das Dateisystem schreiben Siehe Behandlung von Anh ngen Workbench Process Engine Systemkonnektor Guide Kap 29 S 320 29 2 Beispiel Workflow RosettaNet Nachrichten erzeugen Create_PIP_specific_Payload Create Headers SendRosettaNetMessage xml xml xml xml Der abgebildete Workflow erzeugt eine RosettaNet Nachricht und bergibt diese mit Hilfe des Workflow Connectors SendRosettaNetMessage zum Versenden an den n chsten Workflow Siehe Beispiel Workflow RosettaNet Nachrichten versenden Workbench Process Engine Systemkonnektor Guide
388. n Single Sign On auf Webservern unter Verwendung des Berechtigungsnachweises der Windows Benutzeranmeldung Wenn Sie diese Methode w hlen m ssen Sie auch die Dom ne angeben an der Sie sich anmelden m chten Benutzername Passwort Zugangsdaten des Benutzers mit dem Sie sich am WebDAV Server anmelden m chten Der Benutzer muss Zugriffsrechte entsprechend der ausgew hlten WebDAV Methode besitzen Dom ne Nur aktiv wenn Sie die Methode NT gew hlt haben Name des Verwaltungsbereichs an dem Sie sich anmelden m chten inubit 6 1 Workbench Process Engine Systemkonnektor Guide 05 09 2013 476 WebDAV Connector Dialog WebDAV Connector Fehlerbehandlung HTTP Statuscode gt 300 in XML umwandeln Wenn aktiviert werden alle HTTP Statuscodes gt 300 als XML geformt Verbindungstest m Verbindung testen Zum Testen ob die Verbindung mit Ihren Angaben erfolgreich aufgebaut werden kann 05 09 2013 inubit 6 1 Workbench Process Engine Systemkonnektor Guide BP EA Websphere MQ Connector 477 Verwendung Dieser Abschnitt erlautert die folgenden Themen m Voraussetzungen S 477 m Dialog WebSphere Message Queue Connector S 478 Konnektortypen 42 1 Voraussetzungen Der WebSphere MQ Connector verbindet die IBM WebSphere MQSeries Software mit der inubit Process Engine Abh ngig von seiner Konfiguration sendet oder empf ngt der Konnektor Nachrichten Input Connectors Holt Nachrichten von
389. n der WebDAV Spezifikation unter http www webdav org specs rfc2518 html Geben Sie den Methodennamen ein oder w hlen Sie eine WebDAV Methode aus der Liste COPY Kopiert eine Ressource der Name wird als URI im Request angegeben GET Fordert die im URI genannte Ressource an POST Sendet den Request Body an den Server und erzeugt eine Ressource mit dem Namen der als URI im Request angegeben ist PUT Erzeugt eine neue Ressource mit dem im Request angegebenen Namen MOVE Verschiebt eine Ressource der Name wird als URI im Request angegeben DELETE L schte die Collection oder Ressource deren Name im Request angegeben ist MKCOL Erzeugt eine neue Collection mit dem im Request angegeben Namen PROPFIND Liest die Properties einer Ressource PROPPATCH ndert und l scht mehrere Eigenschaften einer Ressource in einem atomaren Akt LOCK Reserviert eine Ressource oder eine Collection sodass diese f r den Schreibzugriff anderer Autoren gesperrt ist und exklusiv bearbeitet werden kann Wenn der Request erfolgreich war dann erh lt der Client ein Lock Token das zum Aufheben der Sperre wieder vorgewiesen werden muss UNLOCK Entfernt die Sperre einer Ressource oder Collection sodass diese auch von anderen Autoren bearbeitet werden kann SEARCH L st eine Suche auf dem WebDAV Server aus Die Suchanfrage wird im Body des Requests definiert inubit 6 1 Workbench Process Engine Systemkonne
390. nal Edition einseizen ne 189 18 1 2 JMS Connector in Enterprise Enterprise Plus Edition mit beliebigem JMS basierten Queuing Server ln EEE N E A ETE E OA EEE E A TAA ETA E EA 190 N T ele e eene E 190 18 2 1 Dialog Verbindungskonfiguration sereisas iA EEEE 191 18 2 2 Dialog kommuntkatonsmodell A 193 18 2 3 Dialog Nachrichten Selektor uusnsnnnennennnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnennnnnnnnnnnnnnnnnnnnnn nn 196 18 2 4 Dialog Zus tzliche Eigenschaften 197 19 LDAP C nnector 2 20000 Hnn SEENEN EEEESEEEREEEEEEEEEEEENEEERSEAAEEEEEEEEEAEEEEEEEKEASEEEEEEEAEEEEERNEEEE RENEA ENa KEEN 199 19 1 Funktionsprinzip EE 199 19 2 DSMLv2 Anweisungen in Requests nn 200 CN A ET 201 19 2 2 lee ET 202 CC RTE 203 19 2 4 Delete annehmen dees alec ann edad ae a a 203 19 3 Dialog LDAP Connector Eigenschaften AA 203 20 Livelink POMS Connector unsessnnnnennennnnnnennnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnennnnnnnnnsnnnnnnnnnsnnnn nennen nennen nnnnnnnnnnnnnnn 205 20 1 JAR D teien installieren seniii a T REENERT Eddie 205 20 2 Inhalt und Struktur der Eingangs und Ausgangsnachrichten 206 20 21 Kommandos EE 207 202 2 ale lu TEE 207 Eu E TE 208 20 2 3 1 Entity Eigenschaften 2244sennnnnnnnnennnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnn rn 209 20 2 3 2 E Le ele E 210 20 2 3 3 Entity Gomponents u een 210 20 24 Beispiel f r Eing ngsnachricht u u su
391. nd anzeigen Technical Workflow Diagramme Workbench Benutzer Guide Kap 12 S 311 SSL Verbindung und Server Authentifizierung konfigurieren Process Engine Administrator und Entwickler Guide Kap 5 1 S 61 Parameter setzen und anzeigen Workbench Process Engine Systemkonnektor Guide Kap 12 1 S 146 Header setzen und anzeigen Workbench Process Engine Systemkonnektor Guide Kap 12 2 S 147 12 1 Parameter setzen und anzeigen Parameter setzen Konnektortyp Methode Parameter sind beliebige Name Wert Paare und werden abh ngig vom Konnektortyp wie folgt bergeben Parameter bergabe Input Connector GET Als Parameter der Server URL z B http localhost 8000 ibis servlet IBISHTTPUploadServlet HTTPinputCon PAR1 1234 amp PAR2 abc Die Server URL ndern Sie im Dialog HTTP Connector Eigenschaften Workbench Process Engine Systemkonnektor Guide Kap 12 3 S 149 Medium Output POST Connector Parameter anzeigen 05 09 2013 Als Parameter im Request Body z B Par1 1234 amp Par2 abc Sie definieren diese Parameter beim Anlegen bzw Bearbeiten eines Medium oder Output Connectors Siehe HTTP Post Konfiguration Workbench Process Engine Systemkonnektor Guide Kap 12 S 151 Alle Parameter stehen w hrend der Workflow Ausf hrung als Modulvariablen zur Verf gung Die Modulvariablen sind nach folgendem Muster benannt lt Key gt lt Value gt Sie k nnen die Modu
392. nd benannt Sie k nnen an den Namen des Anhangs das Datum den Zeitstempel oder die Prozess ID anh ngen Datum Sie k nnen das Datum unterschiedlich formatiert ausgeben Als Angabe ohne Datumsformat wird aus name STimeStamp xml die Angabe name 06082008 151047 xml erzeugt dabei ist name Anhangname 12122002 Datum im Format ddMMyyyy 151047 Zeit im Format hhmnss Als Angabe mit Datumsformat hh wird aus name _ STimeStamp hh xml die Angabe Name 11 xml erzeugt Bei der Angabe mit Datumsformat ddMM wird aus Name STimeStamp ddMM xml die Angabe Name 2309 xml erzeugt inubit 6 1 Workbench Process Engine Systemkonnektor Guide 05 09 2013 222 Mail Connector Dialogbeschreibungen Zeitstempel Der Zeitstempel enth lt zus tzlich eine Angabe in Millisekunden Die Angabe name TimeStamp ddMMyyyy HHmmss SSS xml erzeugt name _12122002 151304 027 xml Prozess ID Um die Prozess ID auszugeben geben Sie den Anhangnamen im folgenden Format an name_ PID sProcessid xml zus tzlichen Textanhang eingeben Sie k nnen zus tzlich Text eingeben der als Anhang bermittelt wird 21 2 6 Dialog SMTP Connector Eigenschaften Grundeinstellungen Nachricht 05 09 2013 Output Connector In diesem Dialog legen Sie die Zugangsdaten f r den SMTP Server und Eigenschaften der Nachrichten fest Protokoll SMTP Protokoll zum Senden und Weiterleiten von E Mails SMTPS SMTP ber SSL
393. nd deren Werte in der Tabelle Login Modul Optionen ein 5 Klicken Sie auf Fertig stellen um den Dialog zu schlie en 15 4 Dialog JAAS Connector Eigenschaften In diesem Dialog geben Sie an wie die Benutzerkontodaten dem Konnektor zur Verf gung stehen und gegen welches System diese validiert werden sollen Login Modul m com sun security auth module JndiLoginModule Zum Validieren von Benutzerkontodaten gegen einen LDAP oder NIS Verzeichnisdienst E org jaaslounge ntlm NtlmLoginModule Zum Validieren von Benutzerkontodaten gegen einen NT Domainkontroller oder gegen den Microsoft Verzeichnisdienst Active Directory auf einem Windows Betriebssystem Benutzername Geben Sie an wie der Benutzername dem JAAS Connector bergeben werden soll a D Der Benutzername stammt aus einem Element in der Eingangsnachricht Das Element wird ber einen XPath Ausdruck ausgew hlt 05 09 2013 inubit 6 1 Workbench Process Engine Systemkonnektor Guide JAAS Connector 171 Dialog JAAS Connector Eigenschaften Um das Element auszuw hlen klicken Sie auf XML Element ausw hlen laden eine Beispielnachricht und navigieren zu dem Element Der XPath Ausdruck wird danach im Feld Benutzername angezeigt Wenn der XPath mehrfach in einem XML Dokument vorkommt dann wird nur das erste Vorkommen des XPath ausgewertet nachfolgende Vorkommen werden ignoriert a V Der Benutzername wird aus einer Workflow Variablen g
394. nde nicht enthalten ist werden alle Nachrichten der Queue zeilenweise bis zum Ende der Queue gelesen Der MQ Connector f gt den String mqsende nicht ein Sie m ssen manuell sicher stellen dass dieser String als letzte Zeile enthalten ist Nachricht zu XML konvertieren Markieren Sie diese Option nur wenn sichergestellt ist dass jede Zeile die vom MQ Connector gelesen wird eine syntaktisch korrekte XML Nachricht ist Die XML Nachricht wird durch einen internen Parser gepr ft bei einer fehlerhaften Nachricht wird ein Fehler erzeugt Erstellt Nachrichten die alle gelesenen Zeilen enthalten Jede Zeile ist eine XML Nachricht mit dem Aufbau lt MOGET gt Eine syntaktisch korrekte XML Nachricht lt MOGET gt inubit 6 1 Workbench Process Engine Systemkonnektor Guide WebSphere MO Connector 481 Dialog WebSphere Message Queue Connector u Commit Methode Das Commit stellt sicher dass sich die Message Queue in einem konsistenten Zustand befindet nach jeder Nachricht Das Commit wird nach jeder Nachricht durchgef hrt Diese Methode stellt sicher dass nach jedem Abholen einer Nachricht der Queue Manager in konsistentem Zustand ist Diese Option kann die Performance beeintr chtigen beim Verbindungsabbau Erst wenn alle Nachrichten eines Auftrags von der Queue geholt wurden wird ein Commit durchgef hrt Diese Methode ist performanter Verbindungstest m Verbindung testen Zum Teste
395. nderes Verzeichnis konfiguriert haben werden hier die eingehenden Nachrichten abgelegt Virtueller Dateiname nicht beim Input Connector Virtual dataset name VDSN Unter diesem Namen wird die Datei versendet Wird kein Wert angegeben so wird der VDSN Name aus dem Originaldateinamen gebildet Dateibeschreibung nicht beim Input Connector N here Erl uterung des virtuellen Dateinamens Label nicht beim Input Connector Zur Kennzeichnung von Dateien die in der gleichen Gruppe versendet werden sollen Externe JobID nicht beim Input Connector inubit 6 1 Workbench Process Engine Systemkonnektor Guide OFTP2 Connector 257 Dialog OFTP Datenaustausch Konfiguration Externe Kennung des Jobs Konvertierungstabelle Zur Auswahl von Datenformaten links Quellformat rechts Zielformat Empf ngerstations ID nicht beim Input Connector Eine Stations ID SID einer Nachbarstation kann bis zu 16 Zeichen umfassen Diese ID wird nur lokal genutzt Die ID ist frei w hlbar und kann aus Zahlen und Buchstaben bestehen Diese SID muss zuerst in der rvsEVO Software bzw ber den Dialog Stationen angelegt werden und kann dann hier bernommen werden Wenn Sie die Nachbarstation ber den Dialog Stationen ausw hlen wird deren ID automatisch bernommen Stationen Der Dialog Stationen kann nur aufgerufen werden wenn bereits g ltige Verbindungsdaten zu einer rvsEVO Installation im Dialogabschnitt
396. ndes XML Element f r ein einzelnes SQL Statement Kann mit dem Attribut type subselect als Subquery in einer Hauptabfrage verwendet werden und mehrfach auftre ten Attribute Pflichtfeld zul ssige Werte Erl uterung Alias Nein Beliebiger Bezeich ner Type Nein subselect Gibt an dass es sich um eine Subquery handelt lt tableNames gt Umschlie endes XML Element f r alle Tabellennamen die im SQL Statement abgefragt werden lt tableName gt Tabellenname der im SQL Statement abgefragt wird Kann mehrfach auftreten Entspricht dem FROM Teil eines SQL Statements Attribute Pflichtfeld zul ssige Werte Erl uterung alias Nein Beliebiger Bezeich Alias Name der Tabelle ner lt fields gt Umschlie endes XML Element f r alle im SQL Statement zu verwendenden Spaltennamen lt field gt 05 09 2013 inubit 6 1 Workbench Process Engine Systemkonnektor Guide Database Connector 67 XML Querys Struktur und Beispiele XML Element f r den Namen der im SQL Statement abgefragten Tabellenspalte Kann mehrfach auftreten Entspricht dem Select Teil eines SQL Statements Attribute Pflichtfeld zul ssige Werte Erl uterung Alias Nein Beliebiger Bezeich Alias Name der Spalte ner lt fieldName gt Name einer im SQL Statement zu verwendenden Tabellenspalte lt fieldValue gt Werte f r einzelne Felder oder der Name einer Subquery nur INSERT UPDATE Attribute Pfli
397. ndig neu gesendet werden sondern nur von sogenannten Aufsetzpunkten kann hier bestimmt werden nach wie viel empfangenen Bl cken ein Aufsetzpunkt erstellt wird Die Anzahl der Aufsetzpunkte hat Einfluss auf Performance und Speicherverbrauch benutzen Sie daher f r stabile Verbindungen eine kleine Zahl und f r st ranf llige Verbindungen eine gro e Der Standard ist 0 Wenn Sie hier einen Wert setzen wollen benutzen Sie den Wert des globalen Parameters RECVBLOCKS wie im Handbuch der verwendeten OFTP Middleware beschrieben Gesendete Blockanzahl Die Bedeutung ist gleich der in der Option Empfangene Blockanzahl Der globale Parameter hei t hier SENDBLOCKS inubit 6 1 Workbench Process Engine Systemkonnektor Guide OFTP Connector 239 Dialog Stationen Kompression Diese Option ist eine Combobox Sie k nnen zwischen drei Modi w hlen ODETTE Die Bl cke werden an die OFTP Middleware bertragen und dort nach dem Odette Verfahren komprimiert NONE Die Datenbl cke werden nicht komprimiert GNU Die Datenbl cke werden bereits in der inubit Process Engine mit GNU ZIP gzip komprimiert und dann an die OFTP Middleware bergeben VDSN Zeichenmenge Diese Option ist eine Combobox Sie k nnen unter verschiedenen Zeichensatzen w hlen ALL Es gibt keine Einschr nkungen bei der Zeichenmenge ODETTE alle Gro buchstaben Ziffern und die Sonderzeichen amp CHECK RE Erlaubt wie bei AL
398. ne Systemkonnektor Guide OFTP Connector 235 Dialog OFTP Datenaustausch Konfiguration und Buchstaben bestehen Diese SID muss zuerst in der rvs Software angelegt werden und kann dann hier bernommen werden Stationen Sie k nnen den Dialog Stationen nur aufrufen wenn Sie zuvor g ltige Verbindungsdaten zu einer OFTP Middleware im Dialogabschnitt Grundeinstellungen eingegeben haben Textdatei W hlen Sie diese Option wenn der OFTP Connector auf einem anderen Betriebssystem ausgef hrt wird als die Middleware Mit dieser Option wird eine automatische Konvertierung aktiviert welche die unterschiedlichen Betriebssysteme erkennt und die ben tigten Steuerzeichen entsprechend setzt Windows Dateien z B haben am Ende jeder Zeile ein Carriage Return Zeichen und ein Line Feed Zeichen w hrend bei UNIX Systemen am Ende der Zeile nur ein Line Feed Zeichen steht Lu Deaktivieren Sie diese Option zum bertragen bin rer Dateien Datei auf dem Server l schen Nach der bertragung wird die Datei auf dem rvs Server gel scht wenn diese Option ausgew hlt ist p Synchron nur beim Output Connector Wenn die Checkbox markiert ist wird der synchrone Daten bertragungsmodus aktiviert RVS Evo Markieren Sie diese Option wenn Sie die rvs Software RVS Evolution statt der Classic Version verwenden Format nur bei Output Connector Geben Sie hier die Formatinformation fur die Datei an die Sie be
399. ne Applikation zu bergeben Nach ihrer Ausf hrung schreibt diese Applikation das Ergebnis in dieselbe Datei Nutzen Sie inputFile und outputFile wenn zwei WY verschiedene Dateien verwendet werden sollen File und InputFile schlie en sich gegenseitig aus XPath Pfadangabe bergibt einen Knotenwert aus der XML Eingangsnachricht an die aufgerufene Applikation Ein Klick auf diesen Parameter ffnet den XPath Assistenten mit dem Sie XPath Ausdr cke zum Auslesen des Knotenwertes erstellen k nnen Siehe XPath Assistent Workbench Benutzer Guide Kap 1 17 S 73 Property Propertyname bergibt eine Moduleigenschaft ScriptFile bergibt das Skript aus dem Feld Skript InputFile bergibt eine Eingangsnachricht an die aufgerufene Applikation ohne diese nach der Ausf hrung wieder auszulesen Z B Befehl cmd exe Argumente C ScriptFile cmd InputFile Script type 31 gt inputMessageDuplicated dat OutputFile inubit 6 1 Workbench Process Engine Systemkonnektor Guide 05 09 2013 120 Execution Connector Dialog Execution Connector Eigenschaften Umgebungsvariablen Systemvariablen an Prozess bergeben Skript 05 09 2013 bergibt der aufgerufenen Applikation eine Datei in welche die Applikation nach ihrer Ausf hrung das Ergebnis schreibt Dieser Platzhalter wird meist zusammen mit ScriptFile genutzt z B Befehl cmd exe
400. nector inubit 6 1 Workbench Process Engine Systemkonnektor Guide 05 09 2013 324 RosettaNet HTTPS Connector Dialogbeschreibungen Asynchroner Versand dr m Asynchron versenden Empfangsbest tigung Aktiviert den Versand asynchroner Empfangsbest tigungen Siehe Beispiel Workflow Nachrichten empfangen und Best tigung senden Workbench Process Engine Systemkonnektor Guide Kap 29 4 S 316 29 5 3 Dialog S MIME Konfiguration Input Connector In diesem Dialog geben Sie die Informationen an die n tig sind um verschl sselte und oder signierte Eingangsnachrichten zu entschl sseln bzw zu pr fen Sie ben tigen eine Keystore Datei die Ihren privaten Schl ssel und WY den ffentlichen Schl ssel Ihres Gesch ftspartners enth lt Keystore Konfiguration Klicken Sie auf den Button um Ihren Keystore zu laden S MIME Entschl sselung Zum Aktivieren Deaktivieren der Entschl sselung Alias Zur Auswahl des Alias unter dem der ben tigte private Schl ssel im Keystore gespeichert ist a Passwort Passwort f r den gew hlten Schl ssel S MIME Signaturpr fung Zum Aktivieren Deaktivieren der Signaturpr fung Alias Zur Auswahl des Alias unter dem der ben tigte ffentliche Schl ssel im Keystore gespeichert ist 29 5 4 Dialog Verbindungsdaten f r Gesch ftsnachrichten Input Connector 05 09 2013 inubit 6 1 Workbench Process Engine Systemkonnektor Guide Grundkonfiguration
401. nector 259 Dialog Stationen 24 6 Dialog Stationen Dieser Abschnitt erl utert die folgenden Themen m Lokale Station S 259 m Nachbarstationen S 260 m Empf nger S 267 Wenn Sie den Stationen Dialog aufrufen verbindet sich der OFTP2 Connector ber die von Ihnen angegebenen Grundeinstellungen mit der rvsEVO Installation und erh lt dort die Konfigurationsdaten die im Stationen Dialog angezeigt werden Beachten Sie dass Einstellungen im Dialog Stationen die Q Konfiguration in der rvsEVO Installation ndern wenn Sie den Dialog mit OK beenden 24 6 1 Lokale Station LOC LOC ist die lokale Stationsdatei Wenn Sie diesen Eintrag ausw hlen k nnen Sie im rechten Fenster die Konfiguration der lokalen Station angeben Die Konfigurationsdaten m ssen mit denen bereinstimmen die Sie in Ihrer rvsEVO Administrator Konsole angegeben haben Die lokale Station muss immer den Namen LOC in Q Gro buchstaben haben Wenn Sie LOC markiert haben steht Ihnen ein Kontextmen mit folgenden Befehlen zur Verf gung Nachbarstationen hinzuf gen Empf nger hinzuf gen Empf nger entfernen Verbindung aktivieren Allgemeine Stationsparameter Der Bereich Lokale Station bzw Nachbarstation enth lt neben der RvsSid Pflicht Angaben zur Station wie Name Telefon Unternehmen Ort Stra e Kontaktperson E Mail Bereich OFTP Im Bereich
402. nektor Guide 109 ECH Exchange Connector Verwendung Dieser Abschnitt erl utert die folgenden Themen Installationsvoraussetzungen S 110 m Exchange Connector verwenden S 110 m Dialogbeschreibungen S 111 Der Exchange Connector verbindet einen Exchange Server ber Intranet Internet mit der inubit Software Mit Hilfe des Exchange Connectors k nnen Sie folgende Funktionen des Exchange Servers nutzen Mails abholen versenden Es k nnen alle eine bestimmte Anzahl Mails oder nur ungelesene Mails abgeholt werden Aufgaben abholen erstellen Postf cher auslesen Erzeugt eine Liste aller existierenden Postf cher und liest Abwesenheitsnotizen aus wenn vorhanden Kontakte auslesen anlegen Verf gbarkeit abfragen Kalendereintr ge abholen Termine anlegen Eintr ge l schen Eintr ge k nnen sofort gel scht oder in den Ordner gel schte Objekte verschoben werden Eintr ge verschieben Eintr ge k nnen in andere Ordner verschoben werden z B E Mails von der Inbox in einen anderen Ordner Siehe auch Systemkonnektoren Workbench Process Engine Systemkonnektor Guide Kap 1 S 19 Module anlegen Workbench Benutzer Guide Kap 3 3 S 129 Technical Workflow Diagramme Workbench Benutzer Guide Kap 12 S 311 inubit 6 1 Workbench Process Engine Systemkonnektor Guide 05 09 2013 110 Exchange Installation 8 1 inubit BPM Su Connector svoraussetzungen Installationsvoraussetzungen
403. nektor Guide 05 09 2013 54 Business Object Connector Querymodus verwenden Attribut Beschreibung M gliche Werte outputObjects Verhindert die Ausgabe von Objekten im e true Objekte ausgeben Resultset Standard false Objekte nicht ausgeben outputlds Unterdr ckt die Ausgabe der technischen true Objekt Id ausgeben Standard Id bo Objectld Standard false Objekt Id nicht ausgeben z B zur Web Service Ansteuerung commitCount Legt das Commit Intervall f r Batch Ope rationen fest 50 Commit nach 50 Objekten 25 Commit nach 25 Objekten 0 Commit am Ende der Modulausf hrung Standard autoCommit Commit nach jeder Operation pageNum Paging Legt die zu lesende Seite in Be m 0 kein Paging Standard gebenen Wert fest PageSize Legt die Anzahl der Eintrage pro Seite 0 kein Paging Standard beim Paging fest positiver ganzzahliger Wert order Legt die Sortierung innerhalb des Result Asc aufsteigend sets fest Bei selektierten ComplexTypes Desc absteigend wird nach bo Objectld bei selektierten ee SimpleTypes nach dem SimpleType Wert z E SE sortiert g Das Attribut order kann auch mit einer expliziten Elementliste genutzt werden orderBy Legt die Sortierung innerhalb des Result Element sets mit expliziten Elementen des Com Sortierung plexTypes fest Mehrere Sortierungen werden mit Kommas getrennt Beispiel orderBy MyElement1 Asc bo Objectld Desc ou
404. nen Web Service anbieten Workbench Process Engine Systemkonnektor Guide Kap 40 5 1 S 427 Ziehen Sie das Root Element der eingelesenen Nachricht aus dem Bereich targetNamespace in der Schema Ansicht auf das Element xsl template im Bereich XML Ziel rechts oben Tragen Sie in der Zeile mit dem XML Ziel Element wsc lt Name Ihrer Operation gt im Bereich XML Quelle links oben den Text der Request Nachricht ein Publizieren Sie das Modul Dieser Web Service Medium Connector sendet die vom soeben angelegten XSLT Converter generierten Aufrufe an einen Web Service So gehen Sie vor 1 Legen Sie einen neuen Web Services Connector an benennen Sie ihn und klicken Sie auf Weiter um zum n chsten Register zu gelangen W hlen Sie auf dem Register System Connector Eigenschaften f r Verwendung den Eintrag Web Service aufrufen W hlen Sie Aktiv als Connector Status und klicken Sie zwei Mal auf Weiter um zum Register Modul Editor zu gelangen Siehe Dialog Aufzurufender Web Service Workbench Process Engine Systemkonnektor Guide Kap 40 16 2 S 453 Geben Sie im Bereich WSDL Daten die URL zur WSDL des aufzurufenden Services an a Klicken Sie im Register Aufzurufender Service am rechten Ende der Zeile auf das Icon und w hlen Sie Publizierte Services anzeigen Im Web Browser ffnet sich eine Liste aller Web Services b
405. nes Attributs oder einer Assoziation und R ckgabe der Knoteninhalte bzw des Attributs als XML Struktur bzw XML Element mit Datentyp 35 6 1 Objektdaten ber die Knoten ID abfragen So gehen Sie vor 1 Erstellen Sie in einem Technical Workflow einen Solution Center Connector und benennen Sie diesen Wechseln Sie auf die Seite SC Connector Einstellungen W hlen Sie den Modus Objektdaten abfragen Klicken Sie am Ende des Feldes Knoten auf den Button Knoten ausw hlen Navigieren Sie in Ihrer Business Solution zu dem Knoten den Sie auslesen wollen Klicken Sie auf Fertigstellen Setzen Sie den Startpoint vor den Solution Center Connector Starten Sie den Test ohne Datei 35 6 2 Objektdaten ber eine XPath Anfrage abfragen 05 09 2013 So gehen Sie vor 1 2 es Erstellen Sie einen Solution Center Connector Konfigurieren Sie allgemeinen Moduleigenschaften und die System Connector Eigenschaften des Solution Center Connector Wechseln Sie auf das Register SC Connector Eigenschaften Wahlen Sie den Modus Objektdaten abfragen Klicken Sie auf das Icon neben dem XPath Feld Navigieren Sie im Solution Center Explorer zu dem gew nschten Knoten und best tigen Sie die Auswahl mit OK inubit 6 1 Workbench Process Engine Systemkonnektor Guide Solution Center Connector 379 Beispiel Objektdaten abfragen Eigenschaften des Moduls XPathWithXSDAndGET bearbeit
406. ng DC inubit DC com gt lt attr name objectclass gt lt value gt person lt value gt lt attr gt lt attr name objectclass gt lt value gt organizationalPerson lt value gt lt attr gt lt attr name sn gt lt value gt Johnson lt value gt lt attr gt lt attr name givenName gt lt value gt Alice lt value gt lt attr gt lt attr name title gt lt value gt Software Design Engineer lt value gt lt attr gt lt addRequest gt Zum L schen von Daten auf dem LDAP Server wird die Anweisung lt delRequest gt verwendet Die Anweisung l scht das Objekt Alice aus der LDAP Datenbank lt delRequest dn cn Alice ou Marketing dc inubit dc com gt 19 3 Dialog LDAP Connector Eigenschaften In diesem Dialog haben Sie folgende Optionen inubit 6 1 Workbench Process Engine Systemkonnektor Guide 05 09 2013 204 LDAP Connector Dialog LDAP Connector Eigenschaften LDAP Server Lu Authentifizierung Namensdienst Lu Weitere Einstellungen 05 09 2013 Verbindungstest URL Ersetzen Sie lt hostname gt durch den Namen des LDAP Servers Wenn der Verbindungstest mit dieser Portnummer fehlschl gt erfragen Sie die Portnummer des LDAP Servers bei dem Administrator des LDAP Servers Connection Pooling Aktivieren Sie diese Option um bestehende Verbindungen zum LDAP Server wiederzuverwenden Anonymes Login W hlen Sie diese Option wenn
407. ng vom Web Services Listener zum soeben angelegten XSLT Converter Das Reply Modul sendet die vom XSLT Converter generierte Antwort Nachricht an den Web Service Aufrufer Client Wenn Sie den Web Service Aufrufer ber einen Technical Workflow implementiert haben dann ist dies der Callback Listener des aufrufenden Workflows Alternativ zu einem Reply Modul k nnen Sie einen Medium Output Web Services Connector so konfigurieren dass er die asynchrone Antwort eines Web Services an einen Callback Listener sendet Weitere Informationen finden Sie im Abschnitt Register inubit 6 1 Workbench Process Engine Systemkonnektor Guide Web Services Connector 429 Asynchrone Web Services Aufzurufender Service Workbench Process Engine Systemkonnektor Guide Kap 40 16 3 2 S 455 So gehen Sie vor 1 Legen Sie ein neues Reply Modul an und benennen Sie es Lassen Sie alle voreingestellten Werte unver ndert Klicken Sie auf Fertigstellen Publizieren Sie das Modul Ziehen Sie eine Verbindung vom XSLT Converter zum Reply Modul Wenn Sie alle drei Module konfiguriert und verbunden haben publizieren Sie den Workflow Wies 2 gt Als n chstes erstellen Sie einen Workflow zum Aufrufen eines asynchronen Web Services Siehe Asynchronen Web Service aufrufen Workbench Process Engine Systemkonnektor Guide Kap 40 5 2 S 429 40 5 2 Asynchronen Web Service aufrufen A XSLT Converter zum Erstellen eine
408. ngsbest tigung wird von der lokalen Station an den Gesch ftspartner gesendet Standardm ig ist die Option IMMEDIATE vorausgew hlt Die folgenden M glichkeiten stehen zur Verf gung NEVER Es wird keine Empfangsbest tigung gesendet inubit 6 1 Workbench Process Engine Systemkonnektor Guide 05 09 2013 240 OFTP Connector Dialog Stationen 05 09 2013 A NORMAL Beim Empfang einer Nachricht wird eine Empfangsbest tigung gesendet Wenn die Verbindung noch besteht wird die Best tigung sofort gesendet Wenn die Verbindung bereits abgebaut wurde wird die Best tigung beim n chsten Verbindungsaufbau gesendet SYNC Die Empfangsbest tigung wird ber dieselbe Verbindung gesendet ber welche die Nachricht eingegangen ist Das Bestehen der Verbindung wird dabei erzwungen Es wird gepr ft ob die Empfangsbest tigung erfolgreich versendet wurde erst dann kann die Verbindung geschlossen werden IMMEDIATE Die Empfangsbest tigung wird sofort gesendet Sollte die Verbindung bereits beendet worden sein wird sie f r die Empfangsbest tigung erneut aufgebaut HOLD Die Empfangsbest tigung wird erst gesendet wenn sie explizit von einem Operator in der OFTP Middleware freigegeben wurde Besteht die Verbindung noch so wird die Empfangsbest tigung sofort gesendet Wenn die aktuelle Verbindung bereits abgebaut wurde wird die Empfangsbest tigung gesendet wenn das n chste Mal eine Verbindung erstellt wurde
409. ngsnachricht unver ndert eingetroffen ist 29 5 7 Dialog Verbindungsdaten f r Empfangsbest tigungen Input Connector Grundkonfiguration m Server URL 05 09 2013 inubit 6 1 Workbench Process Engine Systemkonnektor Guide RosettaNet HTTPS Connector 327 Dialogbeschreibungen URL und Port des Servlets welches auf RosettaNet Nachrichten wartet SSL Der Button ffnet den Dialog SSL Konfiguration Workbench Process Engine Systemkonnektor Guide Kap 1 1 4 S 24 Authentifizierung m Authentifizierung erforderlich Markieren Sie diese Option wenn der Server eine Authentifizierung fordert Geben Sie dann den Account ein den der Connector fur die Authentifizierung verwenden soll Benutzername Benutzername fur die Authentifizierung Passwort Passwort fur die Authentifizierung HTTP Header Konfiguration ber den Header k nnen Informationen wie z B Dateigr e HTTP Server und User Agent Kennung oder MIME Typ zwischen Client und HTTP Server Ubertragen werden Der Button Header Liste ffnet einen Dialog in dem Sie Name Wert Paare als Header definieren k nnen Si Informationen ber zul ssige Header finden Sie in der HTTP Spezifikation siehe http www w3 org Protocols HTTP 1 1 rfc2616 pdf Verbindungstest m Verbindung testen Zum Testen ob die Verbindung mit Ihren Angaben erfolgreich aufgebaut werden kann 29 5 8 Dialog RosettaNet Verbindungsdaten Output Connector Gr
410. ninstanz wird an dieser Stelle ebenfalls test String verwendet Attribut lt result resultString gt Die Variable enth lt das Ergebnis des Methodenaufrufs Elementname lt param gt Der Methode werden zus tzlich zwei Parameter bergeben inubit 6 1 Workbench Process Engine Systemkonnektor Guide Java Reflection Connector 179 Beispiel Methodenaufruf Attribut type int Gibt den Parametertyp an hier int Der Wert des Parameters folgt als Kindelement Beim ersten Parameter ist der Wert des Parameters 1 Beim zweiten Parameter wurde kein konkreter Parameterwert angegeben Stattdessen wird der Wert der Variablen SstringLength verwendet object stringLength Enth lt das Ergebnis des vorhergehenden Methodenaufrufs Die Variable wird auch hier wieder mit Zeichen und Variablenname referenziert Attribut name Name des Parameters um an anderer Stelle wieder auf diesen Parameter im XML zugreifen zu k nnen Optional Achten Sie bei der Vergabe von Referenznamen darauf dass A diese innerhalb des XML eindeutig sind Wenn ein Referenzname mehrfach verwendet wird dann wird Inhalt der Variablen bei der nachsten Deklaration Uberschrieben Referenznamen werden global deklariert und sind damit innerhalb des gesamten lt reflection gt Elements verf gbar 4 Ergebnis und XML Ausgangsnachricht lt result value of SresultString gt Uber das Element lt result gt wird die Ausgab
411. nn mehrere Anh nge existieren dann m ssen Sie im Feld Nummer des Anhangs angeben welcher Anhang bertragen werden soll inubit 6 1 Workbench Process Engine Systemkonnektor Guide X 400 SE Connector 489 Dialogbeschreibungen Beachten Sie dass der Inhalt einer X 400 Nachricht als Anhang behandelt wird Max Anzahl Nachrichten Nur bei Ausgabeformat XML Maximale Anzahl von Nachrichten die eingelesen werden Falls ein Wert kleiner oder gleich Null gew hlt wird werden so viele Nachrichten abgeholt wie verf gbar sind Inklusive Anh nge Nur bei Ausgabeformat XML Wenn markiert dann werden auch Anh nge bertragen Wenn nicht markiert dann werden nur die Header Informationen abgeholt Beachten Sie dass der Inhalt einer X 400 Nachricht als Anhang behandelt wird Inhalte immer Base64 kodieren Nur bei Ausgabeformat XML Um Bin rdaten korrekt weiterzuleiten z B als Zip oder PDF Dateien 8 bit Text Anh nge unkodiert abholen Um Nachrichten ohne feste Zeichenkodierung als Raw Daten weiterzuleiten Die Nachrichten werden ohne Konvertierung aus dem Text Anhang bernommen Nachrichten berspringen die Fehler beim Abholen erzeugen Wenn gesetzt werden alle XML Nachrichten bei denen beim Abholen Fehler auftreten ignoriert und auf dem Server belassen Wenn nicht gesetzt bricht das Abholen der Nachrichten mit einem Fehler ab 43 3 3 Dialog Nachrichtenoptionen f r den
412. nnector wird immer als Mediumkonnektor eingesetzt Siehe auch Systemkonnektoren Workbench Process Engine Systemkonnektor Guide Kap 1 S 19 Module anlegen Workbench Benutzer Guide Kap 3 3 S 129 Technical Workflow Diagramme Workbench Benutzer Guide Kap 12 S 311 20 1 JAR Dateien installieren Sie m ssen folgende externe j ar Dateien auf der inubit Process Engine im Verzeichnis lt inubit installdir gt server lib ext installieren Die Dateien erhalten Sie vom Hersteller des PDMS m dmsclient jar jiaik_javax_crypto jar jaik_jce full jar jaik_jsse jar jaik_ssl jar ixosBase jar ixosCat jar jhttp jar jiaik jar inubit 6 1 Workbench Process Engine Systemkonnektor Guide 05 09 2013 206 Livelink PDMS Connector Inhalt und Struktur der Eingangs und Ausgangsnachrichten jsec jar ot commons httpclient jar spheon jsoap jar w3c_http jar Siehe Treiber installieren Process Engine Administrator und Entwickler Guide Kap 3 4 S 57 E EE 20 2 Inhalt und Struktur der Eingangs und Ausgangsnachrichten Struktur der Eingangsnachricht 05 09 2013 Dieser Abschnitt erl utert die folgenden Themen m Kommandos S 207 m Bedingungen S 207 a Entit ten S 208 Als Eingangsnachricht ben tigt der Livelink Connector eine XML Datei mit folgendem Inhalt Kommandos zur Steuerung der Aktionen am Livelink Archive Server Entit ten als Vorgaben f r anzulegende Objekt
413. nnen 134 11 2 2 Dialog FTP Kommandos ausf hren san 137 11 2 3 Dialog Input Dateinamen definieren u 44444Hssnnnnnnnennnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnn nn 138 11 2 4 Dialog Output Dateinamen defmteren AA 141 12 HTIP D DEEG ee Dee See ee 145 12 1 Parameter setzen und anzeigen cceeccccceeeeecceeeeeeeceeeeesneccceeeeceeaeeeneensaeeeeeensaceeesesseaaeeeeeetecteenedeaaae 146 12 2 Header setzen und anzeigen e KEREEEEEENEEREENEEERREEEEEERREEEEEEENREEEEN KEREN EARNAN ANAT ANARA ANTE En 147 12 3 Dialog HTTP Connector Eigenschaften A 149 13 in bit IS Gonnector 2 0 su000 Ran en nnnnneennnnnnneennn he anna en anna ann nn RE haha anne neun 153 13 1 Thin Clients als Clients iriiri anii EAE E E E EA R AE 153 13 2 inubit Process Engine als Client uussrssnnneenennnnnnnnnennnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnennnnnnnr rn 154 13 3 DielogbeSChrelb lu TEE 155 13 3 1 Dialog Authentifiziefung une neaalin 155 13 3 2 Dialog nde EE 156 13 3 3 Dialog Merbundungsdaten nn 156 13 3 4 Dial6g Inputr D teifen a ee ee ne een 157 13 3 Dialog Outp t Datellen ET 158 WA Mu el 161 14 1 Voraussetzung f r den Betrieb Treiber installieren 244444nnnnnnnnennnnnnnnnnnnennnnnnnnnennnnnnnnn nn 161 14 2 Dokumente in ITA Archivsystem einf gen Insert nn 162 14 3 Dokumente aus ITA Archivsystem abholen Select u4unsnnnnnnnnnnnnnnnnnnnnnn
414. nnnnnnnnnnnnnnnnnnn nenn 164 14 4 Dialog ITA Archiv Connector sessirnir AEE ANERE nennen nennen 165 15 JAAS Connector 0 42 44 2400er aneian EAA aAA AAA corte stueeeettesaoneesteestiaeesvestieetstectieresteesaaes 167 15 1 Beispielszenario Liste von Benutzerkonten berpr fen uussssssnssssnennnnnnennnnennennnnennnennnnn nn 168 15 2 Beispielszenario Benutzerdaten ber Task Formulare validieren ccccccccccecessseeeeseeseeeeeeeeeeeeeeeeeess 169 lee ie nel AEA aA a 170 15 4 Dialog JAAS Connector Eigenschaften 170 16 Java Reflection Connector uesnnssennennnnnennnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnsnnnnnnnnnsnnnnnnrnsnnnnenrnsnnnnnrnssn nennen 173 16 1 Eingangsnachricht erstellen u nee 173 16 2 Eigenen Methodenaufruf erzeugen rn 174 16 3 Beispiel Metbodenauff A 176 16 4 Attributliste insisi Gi Bar eier REN EE l n 180 05 09 2013 inubit 6 1 Workbench Process Engine Systemkonnektor Guide Inhaltsverzeichnis 16 5 Dialog Java Reflection Connector Eigenschaften 180 47 JOA 6X 1 11 14 E 181 17 1 Funktonsprinzip 22 222 een ana ie aan Hein ea 181 17 2 Eingangsnachricht erstellen u na 182 17 3 Beispiel Eingangsnachricht nn 184 17 4 Dialog J2EE Connector Architecture Adapter A 185 SE e EE 187 18 1 Zugriff auf JMS basierten Queuing Server konfigurieren 2424442s2nnnnnnennnnnnennennnnnnnnnnnnnn nennen 188 18 1 1 JMS Connector in Entry Standard oder Professio
415. ns ad bereichsarchiv Document lt Type gt lt Id gt aabqfd4m4gsequf2heae3gmnjexgo lt Id gt 1 lt Version gt lt Version gt 1 lt Properties gt lt Notes gt lt Annotations gt lt Components gt Entity gt Entities gt Inhalt in eckigen Klammern ist optional Die Id 1 ist momentan nur als R ckgabewert implementiert Entity Eigenschaft Feld Beschreibung Type Bedingt Die Dokumentenklasse des anzulegenden Entities Der Typ ist nur beim Neuanlegen Kommando Create relevant Bei Up date wird der Typ nicht beachtet ID Optional Legt neue Entitaten mit allen Ubergebenen Eigenschaften auf dem Livelink Archive Server an Version Optional Wie Create aber nur dann wenn Entitaten noch nicht existie ren Ob Entitaten schon vorhanden sind wird mittels der Bedin gung auf dem Livelink Archive Server berpr ft inubit 6 1 Workbench Process Engine Systemkonnektor Guide 05 09 2013 210 Livelink PDMS Connector Inhalt und Struktur der Eingangs und Ausgangsnachrichten 20 2 3 2 Entity Properties Entity Properties Feld Entity Properties beschreiben die Entit t n her Die Properties m ssen im Livelink Archive Server f r die entsprechende Dokumentenklasse lt Type gt definiert sein Es m ssen nur die Properties aufgef hrt werden die bergeben werden sollen lt Entities gt lt Entity gt lt Properties gt lt Property Name siemens ad bereichsarchiv
416. ns installieren Process Engine Administrator und Entwickler Guide Kap 20 2 1 S 295 inubit 6 1 Workbench Process Engine Systemkonnektor Guide 05 09 2013 182 JCA Connector Eingangsnachricht erstellen d inubit BPM Suite oO Business Software Der JCA Connector bertragt Parameterwerte mit Hilfe des Resource Adapter zur Verarbeitung an die konfigurierte entfernte Applikation 1 Ein JCA Connector erwartet eine Eingangsnachricht mit den Parameterwerten Die Eingangsnachricht erstellen Sie in einem XSLT Converter mit Hilfe des JCA Connector Explorers Der JCA Connector verbindet sich mit dem Resource Adapter und leitet die Parameterwerte an diesen weiter Der Resource Adapter stellt das JCA Interface f r den JCA Connector zur Verf gung und ist mit der zu integrierenden Applikation verbunden Der Resource Adapter leitet die Parameter zur Verarbeitung an die Applikation weiter Wenn die Applikation bei der Bearbeitung der Parameter R ckgabewerte erzeugt dann werden diese ber den Resource Adapter an den JCA Connector bergeben Der JCA Connector gibt die R ckgabewerte als XML basierte Nachricht aus 17 2 Eingangsnachricht erstellen 05 09 2013 Zum Erstellen einer Eingangsnachricht verwenden Sie den JCA Connector Explorer Beim Erstellen legen Sie eine InteractionSpec Klasse und ein Record Datensatzobjekt fest So gehen Sie vor 1 2 3 Erstellen Sie einen XSLT Converter ffnen Sie im B
417. ns xsi http www w3 0rg 200 1 XMLSchema nstance xmins fpm E fpm Contract br id 83f8ec52 0693 4441 9a00 50f9bc063afc br assodiation fpm Contract xsi type fpm SalesContract Properties of dass sys base gt sys node dbid 6787 sys node uuid 83f8ec52 0693 4441 9a00 50fSbc063afc d sys store identifier SpacesStore 9 sys store protocol workspace G Properties of dass cm cmobject i cm created 2011 09 07T09 59 19 898 02 00 i cm creator root 9 cm modified 2011 09 077 10 03 38 086 02 00 i cm modifier root i cm name 2011_09 07_SCs gt cm title 2011_09_07_SCs Properties of dass fpm Contract 9 fpm Checked true d fpm ContractNumber SC_2011_09 0741 Properties of dass fpm SalesContract fpm PurchaseDate 2011 09 07 DT geng emgeet TEE Se Haben Sie eine Process Solution erstellt und die Klassen im WY Bereich Bewegungsdaten des Process BODs erstellt erscheinen die Klassennamen nicht direkt als Tag sondern im Attribut xsi type Dasselbe trifft f r abstrakte Klassen zu 35 7 Beispiel Objektdaten aktualisieren Dieser Abschnitt erl utert die folgenden Themen m Objektdaten ber die Knoten ID aktualisieren S 381 m Objektdaten ber eine XPath Anfrage aktualisieren S 381 Verwendung Adressieren eines Knotens und optional R ckgabe des ge nderten Knoteninhalts als XML Struktur Mit dieser Operation k nnen Sie anhand des XSD Schemas auch WY neue Objekte
418. nsatz des Quell respektive Zielbetriebssystems bereinstimmt Es gibt jeweils die M glichkeit die Nachricht in den Zeichensatz ASCII oder EBCDIC zu konvertieren Der Zeichensatz ASCII wird bei Windows und UNIX Betriebssystemen eingesetzt EBCDIC ist der Standard f r OS 400 und OS 390 Siehe Dialog Stationen Workbench Process Engine Systemkonnektor Guide Kap 23 6 S 236 Daten bertragungsmodi Workbench Process Engine Systemkonnektor Guide Kap 23 3 S 231 23 6 Dialog Stationen 05 09 2013 Dieser Abschnitt erl utert die folgenden Themen m Nachbarstationen S 237 m Empf nger S 245 Der Dialog Stationen l sst sich nur aufrufen wenn zuvor g ltige Verbindungsdaten zu einer OFTP Middleware im Dialogabschnitt Grundeinstellungen eingegeben wurden Wenn Sie den Stationen Dialog aufrufen verbindet sich der OFTP Connector Uber die von inubit 6 1 Workbench Process Engine Systemkonnektor Guide LOC 23 6 1 Nachbarstationen OFTP Connector Dialog Stationen Ihnen angegebenen Grundeinstellungen mit der OFTP Middleware und erh lt dort die Konfigurationsdaten die im Stationen Dialog angezeigt werden Beachten Sie dass Einstellungen im Dialog Stationen die Konfiguration in der OFTP Middleware ndern wenn Sie den Dialog mit OK beenden LOC ist die lokale Stationsdatei Wenn Sie diesen Eintrag ausw hlen k nnen Sie im rechte
419. nsnnnecsencainessntzannnnascndsannoancheceetnasnvdannsenndnsdstnarethenanensaecasnesnnbian 405 39 1 Modulvariablen des Web Application Connectors ccceccecceeeeeeeeeeeeeccnaaaeaeeeeeeeeeeeteseececcnasaeeeeeess 406 39 2 Informationen aus Portlet Instanzen abfragen 406 39 3 Dialogbeschreib ngen u aan 408 39 3 1 Dialog Web Applikation u miele E a adaa 408 39 3 2 Dialog Interne Ressourcen nn ann 411 39 3 3 Dialog Rechteverwaltung 444 404444 RR Reannnesnnsnnsernnnennanesnhnennnnnnhnen nennen 412 05 09 2013 inubit 6 1 Workbench Process Engine Systemkonnektor Guide Inhaltsverzeichnis 13 40 Web Services Connector 4 40000000 una naar 413 40 1 Funktionsprinzip eines Web Services nenn 414 40 2 Modulvariablen des Web Services Connectors 2uussnnsennnnnnnnnnnennnnnnnnnennnnnnnnnnnnnnnnnnnnnnnnnnnnnn nn 416 40 2 1 Web Services Input Listener Connechor nennen 416 40 2 2 Web Services Output Connector een 416 40 2 3 Anh nge und Bin rdaten behandeln AA 416 40 3 Web Service anbieten uuessnnseennsssnnnnnnennnnnnnnennnnnnnnennnnnnnnnnnnnnnnnnneennnnnnnneennnnnnnnennnnnnnerennnnnnn nn 417 40 4 Web Service aufrufen eege are nn ana 421 40 5 Asynchrone Web Services aan nennen den na ae 425 40 5 1 Asynchronen Web Service anbieten ccccccccecccceeeseeneceeseeeaneceeeeeseneeeeseeeaceeaeesdeanaeeeseeeaasaaeeteees 427 40 5 2 Asynchronen Web Service auf
420. nte in IDoc gt ADRMASO2 IDOC BEGIN 1 EDI_DC40 SEGME seo Z B ELADRMAS SEGME ee an ne nn _ un Mn An Pr Connection Pool nur bei Verwendung als Medium Output Connector unabh ngig von Kommunikationsart Max Anzahl von Verbindungen Max Anzahl von Verbindungen im Connection Pool Beachten Sie die OSS Notes 314530 und 316877 zum Einrichten externer Verbindungen im SAP System und oder SAP Gateway Max Verbindungswartezeit Legt die max Wartezeit auf eine verf gbare Verbindung fest in Millisekunden Wenn nach der angegebenen Zeit keine Verbindung verf gbar ist wird eine JCo Exception mit dem Key JCO_ERROR_RESSOURCE geworfen Standard sind 30000 Millisekunden 30 Sekunden Verbindungs Timeout Dieses Timeout betrifft nur pooled connections Verbindungen die im Connection Pool freigegeben sind und zur Wiederverwendung offen gehalten werden Es betrifft keine Verbindungen die aktuell verwendet werden Eine pooled connection wird geschlossen wenn sie nach Ablauf der angegebenen Zeit nicht aktiviert wurde Angabe in Millisekunden Standard sind 600000 Millisekunden 10 Min inubit 6 1 Workbench Process Engine Systemkonnektor Guide SAP Connector 341 Dialog SAP Connector Eigenschaften Verbindungstest m Verbindung testen Zum Testen ob die Verbindung mit Ihren Angaben erfolgreich aufgebaut werden kann Metadaten Cache m Aktualisieren Zum aktualisie
421. ntextknoten kann insbesondere bei gro en Datenmengen deutlich l nger dauern als eine Abfrage mit Kontextknoten 10 a Deaktivieren Sie die Option Kontextknoten verwenden b Klicken Sie auf das Icon neben dem XPath Feld und w hlen Sie Knoten ausw hlen c Navigieren Sie im Solution Center Explorer zu dem Vaterknoten unter dem der neue Knoten angelegt werden soll und best tigen Sie die Auswahl mit OK Referenz ber XPath C Kontextknoten verwenden Kontextknoten ID Kontextknoten Typ XPath y soluti ns bfm3 Bus inessFoundati n m title E Business Foundati n bfm3 Pr cessBOHome m title FleetManagementHomepage bfm3 ProcessBO cm title Tragen Sie in das Feld Anzahl der Knotenebenen den gew nschten Wert ein Siehe Anzahl der Knotenebenen Workbench Process Engine Systemkonnektor Guide Kap 35 S 386 Setzen Sie den Startpoint vor den XSLT Converter und starten Sie den Test ohne Datei Pr fen Sie in der Ergebnisdatei oder im Solution Center Explorer ob das Objekt korrekt angelegt wurde 35 6 Beispiel Objektdaten abfragen Dieser Abschnitt erl utert die folgenden Themen inubit 6 1 Workbench Process Engine Systemkonnektor Guide 05 09 2013 378 Solution Center Connector Beispiel Objektdaten abfragen Objekt ber die Knoten ID erzeugen S 375 Objekt ber eine XPath Anfrage erzeugen S 376 Verwendung Adressieren eines Knotens ei
422. nubit 6 1 Workbench Process Engine Systemkonnektor Guide 05 09 2013 46 Backup Connector Dialog Backup Connector Eigenschaften 05 09 2013 inubit 6 1 Workbench Process Engine Systemkonnektor Guide Business Object Connector Verwendung 5 1 Funktionsprinzip Dieser Abschnitt erl utert die folgenden Themen m Funktionsprinzip S 47 Objektmodus verwenden S 48 Querymodus verwenden S 51 Stammdatenreferenzen aktualisieren und l schen S 57 Dialog Business Object Connector Einstellungen S 57 Der Business Object Connector BO Connector erm glicht es XML basierte Gesch ftsobjekte die in Ihren Technical Workflows verarbeitet werden in einer relationalen Datenbank zu verwalten Der BO Connector bernimmt das Speichern und Laden der Gesch ftsobjekte in der Datenbank transparent f r den Entwickler und erzeugt die geeigneten SQL Statements f r die gew hlte Datenbank Damit erfordert ein Wechsel der Datenbank keine nderungen am Technical Workflow mehr es reicht eine andere Datenbank im Modulassistenten zu konfigurieren Siehe auch Systemkonnektoren Workbench Process Engine Systemkonnektor Guide Kap 1 S 19 Module anlegen Workbench Benutzer Guide Kap 3 3 S 129 Technical Workflow Diagramme Workbench Benutzer Guide Kap 12 S 311 Der BO Connector bildet die Strukturen der Gesch ftsobjekte auf die relationalen Strukturen der Datenbank ab F r dieses Mapping ben
423. ob die Verbindung mit Ihren Angaben erfolgreich aufgebaut werden kann Nur Input Medium und Output Connector 05 09 2013 inubit 6 1 Workbench Process Engine Systemkonnektor Guide 33 in IS Connector Ke Verwendung Dieser Abschnitt erl utert die folgenden Themen Thin Clients als Clients S 153 m inubit Process Engine als Client S 154 m Dialogbeschreibungen S 155 Der inubit IS Connector kann Daten von einem Client empfangen und damit die Verarbeitung eines Workflows anstoRen oder von einem Workflow verarbeitete Nachrichten an einen Client senden Dabei werden neben den Nachrichten auch die Variablen Ubertragen F r die Kommunikation mit Clients verwenden inubit IS Connectoren das Thin Client Interface Clients k nnen z B Thin Clients oder weitere inubit Process Engines sein Siehe auch Systemkonnektoren Workbench Process Engine Systemkonnektor Guide Kap 1 S 19 Module anlegen Workbench Benutzer Guide Kap 3 3 S 129 Technical Workflow Diagramme Workbench Benutzer Guide Kap 12 S 311 13 1 Thin Clients als Clients Wenn sich die inubit Process Engine zentral im Internet befindet z B im ASP Betrieb oder eine direkte Anbindung an Unternehmensanwendungen nicht m glich oder gew nscht ist k nnen Sie Thin Clients entwickeln die f r die Kommunikation zwischen Quell bzw Zielapplikationen mit der inubit Process Engine sorgen In diesem Szenario fragt der Thin Client Daten au
424. odul aus um den Callback Listener zu konfigurieren Servicename Dieses Feld ist mit dem Namen des Moduls vorbelegt Namensraum Dieses Feld ist mit einem Namensraum vorbelegt der aus dem Modulnamen erzeugt wird WSDL Bindung Zur Auswahl einer bereits vorhanden WSDL Bindung oder zum Anlegen einer neuen WSDL Bindung Typ Zur Auswahl des SOAP Messaging Protokolls an welches der Web Service gebunden wird Bindungs Stil Mit Ihrer Auswahl legen Sie die Struktur der SOAP Messages fest documentiliteral Der Body der SOAP Messages enth lt ein XML Element mit den Daten der SOAP Message Die Struktur dieses XML Elements wird durch ein entsprechendes XML Schema Element definiert rpc literal Eine RPC SOAP Message entspricht einem Methoden Aufruf mit Operationsnamen und einzelnen Parametern mit simplen Datentypen Der Body enth lt den Operationsnamen aus dem Unterelement Darunter sind die einzelnen Teile der WSDL Message aufgef hrt deren Struktur ist durch XML Schema Typen definiert rpc encoded Entspricht dem rpc literal Stil mit dem Unterschied dass der Typ der Nachrichtenteile explizit durch das Attribut xsd type festgelegt wird Eine englischsprachige Diskussion der Vor und Nachteile von WSDL Stilen finden Sie unter http www ibm com developerworks webservices library ws whichwsdl Vorhandene WSDL bernehmenj integrieren Aktivieren Sie diese Option um eine bereits vorhandene WSDL zu nutzen Die fo
425. odule ein die z B die zu verwendenden Web Service Aufrufparameter aus einer Datenbank auslesen und an den XSLT Converter bergeben Im XSLT Converter bilden Sie diese Parameter dann auf Teile der SOAP Nachricht ab Wenn eine Webservice Response einen Set Cookie Header enth lt wird deren Inhalt in eine XML Variable WSCallerCookies mit folgender Struktur geschrieben Setzen von Session Cookies lt Cookies gt lt Ceokie uni http 2 192 168 1 nanes vivers soap session domain 192 168 109 1 path version 0 gt 678E5BDC 52FC 4E38 B975 6880792AF6FA lt Cookie gt lt Cookies gt 05 09 2013 inubit 6 1 Workbench Process Engine Systemkonnektor Guide Web Services Connector 425 Asynchrone Web Services m uri aufgerufene URL ohne den Pfad name Name des Cookies m domain Name der Domain f r die das Cookie gilt m path Pfad Pfadpr fix f r den das Cookie g ltig ist m ports kommaseparierte Port Liste per Default nicht gesetzt version 0 Verwendung der Netscape Syntax 1 Verwendung der Syntax nach RFC 2965 2109 Standard Nachfolgende Webservice Aufrufe lesen die WSCallerCookies Variable Fur den Webservice Aufruf werden die entsprechenden Cookies automatisch gesetzt Dabei m ssen Domain Path des Cookies und des aufgerufenen Web Services bereinstimmen Wenn Sie ber Workflows mehrere aufeinander folgende Webservice Aufrufe implementiert haben und wenn diese Aufru
426. om SAP System aufgerufen und erh lt von diesem ein IDoc das IDoc wird von nachfolgenden Modulen im Workflow verarbeitet Medium Output BAPI RFC Connector Der SAP Connector ruft eine Funktion auf dem SAP System auf Mit einem XSLT Converter Modul und dem SAP Explorer wird der XML Request erstellt den das vom SAP Connector anzuspre chende BAPI erwartet Der XML Request enth lt den Namen der aufzurufenden Funktion sowie Parameter und Werte Der XSLT Converter bergibt den XML Request an den Connec tor der SAP Connector ruft damit die Funktion auf dem SAP Sys tem auf dann wird die Funktion dort ausgef hrt Das Ergebnis er h lt der SAP Connector und gibt es an das nachfolgende Modul weiter IDoc Lu Der SAP Connector erh lt als Eingangsnachricht ein oder meh rere IDocs Der SAP Connector verbindet sich mit dem SAP Sys tem und sendet die IDocs Wurde SAP seitig eine Erweiterung an der R ckgabestruktur einer Funktion vorgenommen so zeigt der SAP Explorer weiterhin die alte Struktur an Ein Neustart der iS behebt das Problem inubit 6 1 Workbench Process Engine Systemkonnektor Guide 05 09 2013 332 SAP Connector XML Request Response erstellen 30 3 XML Request Response erstellen Wenn Sie den SAP Connector mit einer der Kommunikationsarten BAPI RFC oder IDoc verwenden ben tigen Sie eine konforme XML Response bzw einen entsprechenden XML Request Zum Erstellen verwenden Sie einen XSLT Converter und
427. on WS Security um die geforderten Zertifikate zu importieren Siehe Dialog WS Security Konfiguration Workbench Process Engine Systemkonnektor Guide Kap 40 16 8 S 470 WS Reliable Messaging nur Input Listener Connector Bei asynchroner Web Service Kommunikation Wenn markiert dann wird das WS Reliable Messaging Protokoll zur sicheren bertragung der Web Service Calls an die inubit Software genutzt inubit 6 1 Workbench Process Engine Systemkonnektor Guide Web Services Connector 461 Dialogbeschreibungen Der erfolgreiche Empfang eines Requests wird best tigt sobald die Nachricht in dem Workflow angekommen ist in dem der Input Listener Connector verwendet wird Bei synchroner Web Service Kommunikation Fur die gesicherte Ubertragung ist WS Reliable Messaging nicht erforderlich weil der Empfang der Web Service Response den Empfang des Calls signalisiert Der Einsatz von WS Reliable Messaging ist trotzdem m glich um die korrekte Abarbeitungsreihenfolge von Calls sicherzustellen Siehe Dialog WS Reliable Messaging Konfiguration Workbench Process Engine Systemkonnektor Guide Kap 40 16 9 S 471 Validierung Die Validierung ist n tzlich in Testphasen Beachten Sie jedoch WY dass die Validierung Performance kostet Es kann daher sinnvoll sein die Validierung im Produktivsystem abzuschalten Anfragenachricht validieren Input Listener Connector Wenn markiert dann werden
428. on bearbeiten siehe die Option Anzahl der einzulesenden Nachrichten Falls nicht markiert l uft der Nachrichten Empfang asynchron ab und Nachrichten werden an den Workflow bergeben sobald sie eingetroffen sind Anzahl der einzulesenden Nachrichten inubit 6 1 Workbench Process Engine Systemkonnektor Guide JMS Connector 195 Dialogbeschreibungen Wenn der synchrone Modus markiert ist legt die Anzahl der einzulesenden Nachrichten fest wie viele Nachrichten parallel und synchron aus der Queue abgeholt und verarbeitet werden k nnen der Standardwert ist 1 Dies geschieht in Abh ngigkeit von der am Workflow eingestellten Anzahl paralleler Prozesse Die folgenden Optionen werden angezeigt wenn Sie als Kommunikationsmodell Publish Subscribe gew hlt haben Topic Name Ein Topic ist eine Zeichenkette welche die Art der Daten beschreibt die in einem Publish Subscribe System publiziert sind Der Topic Name bezeichnet ein Objekt das vom JMS Provider erzeugt und beim JNDI Server registriert wurde Der JMS Connector durchsucht den JNDI Server nach dem angegebenen Topic Name und erh lt eine Referenz auf das Objekt Klasse f r den Verbindungsaufbau Name einer Connection Factory Diese ConnectionFactory ist ein Objekt das ein Client benutzt um eine Verbindung mit dem JMS Provider zu erstellen Das Objekt wird vom JMS Provider erzeugt beim JNDI Server registriert Der JMS Connector durchsucht den JNDI Server na
429. onfiguration 44ussrsnnneeennnnnnnnnnnennnnnnnnnennnnnnnnnennnnnnnnnnnnn nennen 41 inubit 6 1 Workbench Process Engine Systemkonnektor Guide 05 09 2013 3 4 Inhaltsverzeichnis A Backup Connector 0 0n 2400Rra ee anna ern EENS DEES 43 4 1 Dialog Backup Connector Eigenschaften AA 43 5 Business Object Connector uusneesnnnnsnnnennnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnernnsnnnnennnsnnnnnnnnsnnnnnerrssnnnnnnrsssnnnnrrssnnnnrrrnsnnen 47 9 1 Funktisnsprinzip usa ei Ban en ee 47 5 2 Objektmodus verwenden sn 48 b31Createilodateiielete Operattonen rn 49 E e ele EE 50 5 3 Quenymodus verwenden un Hann re E ah 51 5 3 1 Unterst tzte Query AttribUte nennen 53 5 3 2 Ergebnis einer Datenbankabfrage schreiben und einlesen nn 55 5 4 Stammdatenreferenzen aktualisieren und l schen 4444s444444nnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnn 57 5 5 Dialog Business Object Connector Einstellungen 0 0 2 cee eeeee eee eene cette eenneeeeeeeeaeeeeeeteeeeeeeeneeeeeeea 57 6 Database ton netto eesgeeEe deet Ee ASAKA BENA a ee 61 6 1 Metadaten Eet EE 62 6 2 Statische SQL Query erstellen naida Eaa AAAA na aaa ANAL NAA ANANN NAAA ANE a NAA a 62 6 3 Dynamische XML Query erstellen 44ss4444444HRnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnn natt 63 6 4 XML Querys Struktur und Beispiele cccccceeceeccccceeeeencceeeeteenaeeeeeesenaeceeeeeeaaeeeeseanaeee
430. onfigurierten Nachbarstation aufgebaut werden kann 23 6 1 8 Entfernen Wenn Sie eine Nachbarstation markieren k nnen Sie aus dem Kontextmen die Option Entfernen ausw hlen Wenn Sie diese Option w hlen wird die ausgew hlte Nachbarstation ah sofort entfernt Das L schen der Nachbarstation wird direkt durchgef hrt ohne dass Sie den Stationen Dialog best tigen m ssen Diese Ver nderung l scht auch die ausgew hlte Nachbarstation in der rvs Software 23 6 2 Empf nger Dieser Abschnitt erl utert die folgenden Themen m X 25 Empf nger konfigurieren S 246 a ISDN Empf nger konfigurieren S 247 a TCP IP Empf nger konfigurieren S 248 a SNA LU6 2 Empf nger konfigurieren S 248 Ein Empf nger ist eine Verbindungskonfiguration die auf einem der Protokolle X 25 up 2 TCP IP oder ISDN beruht Wenn Sie den Stationen Dialog aufrufen und links den Eintrag LOC ausw hlen werden auf der rechten Seite des Dialogs alle Empf nger aufgelistet Sie k nnen Empf nger hinzuf gen und entfernen Empf nger entfernen Wenn Sie diese Option ausw hlen k nnen Sie aus der Liste aller konfigurierten Empf nger ausw hlen welchen Sie entfernen wollen Vergewissern Sie sich dass ber den Empf nger den Sie l schen WY wollen keine Nachrichten mehr ausgetauscht werden inubit 6 1 Workbench Process Engine Systemkonnektor Guide 05 09 2013 246 OFTP Connector Dialog Stationen
431. onnector 441 Operationen eines Web Services erstellen Wenn n tig k nnen Sie den Typ des Nachrichten Teils anpassen Bei Bindungs Stil RPC encoded und RPCl literal Sie m ssen Nachrichten Teile f r die Ein und R ckgabe Nachrichten definieren So gehen Sie vor a Markieren Sie in der Baumansicht den Parameter dem Sie einen Nachrichtenteil hinzuf gen m chten b ffnen Sie das Kontextmen und w hlen Sie Nachrichten Teil hinzuf gen Der folgende Dialog ffnet sich L Neuer Nachrichtenteil Name E mailAddress Typ xsistring v ve 4 aaae a ee c Geben Sie den Namen und Typ ein d Schlie en Sie den Dialog Der Nachrichten Teil wird unterhalb des dazugeh rigen Parameters angezeigt z B H 8 ExampleWebServicesBinding 7 at SayHello 2 39 Eingabe X E mailAddress string s CR R ckgabe satie 4 be nna 4 Vorlage verwenden optional Zum Typisieren der Parameter k nnen Sie einfache oder komplexe Datentypen aus einer existierenden Schema Datei per Drag n Drop verwenden Auch die Operation k nnen Sie aus anderen WSDL Dateien per Dragon Drop bernehmen Klicken Sie auf Vorlage am unteren Rand des Editors Die Vorlagen Palette ffnet sich inubit 6 1 Workbench Process Engine Systemkonnektor Guide 05 09 2013 442 Web Services Connector PartnerLinks berschreiben Eigenschaften Web Service Editor Bereitgestellter Service XML Schemas WSDL E
432. onnektor Guide Kap 29 4 S 316 Versand der Empfangsbest tigung Wenn markiert dann werden asynchrone Empfangsbest tigungen versendet inubit 6 1 Workbench Process Engine Systemkonnektor Guide 05 09 2013 326 RosettaNet HTTPS Connector Dialogbeschreibungen 29 5 6 Dialog S MIME Konfiguration In diesem Dialog geben Sie die Informationen an die n tig sind um Ausgangsnachrichten zu verschl sseln bzw zu signieren Sie ben tigen eine Keystore Datei die Ihren privaten Schlussel enthalt Keystore Konfiguration Klicken Sie auf den Button um Ihren Keystore zu laden S MIME Verschlusselung Zum Aktivieren Deaktivieren der Verschl sselung Alias Zur Auswahl des Alias unter dem der private Schl ssel der zum Verschl sseln verwendet wird im Keystore gespeichert ist Verschl sselungsverfahren Zur Auswahl des Verschl sselungsverfahrens Payload Container verschl sseln Payload verschl sseln Siehe RNIF Core Specification Seite 43 ff S MIME Signierung Zum Aktivieren Deaktivieren der Signierung Alias Zur Auswahl des Alias unter dem der private Schl ssel der zum Signieren verwendet wird im Keystore gespeichert ist Passwort Passwort f r den privaten Schl ssel MIC Verfahren Zur Auswahl des Message Integrity Check Verfahrens Mit diesem Verfahren wird eine Pr fsumme ber die Ausgangsnachricht erstellt Anhand dieser Pr fsumme kann der Empf nger pr fen ob die Ausga
433. onnektor Guide 05 09 2013 128 File Connector Dialogbeschreibungen Input Connector in der Mitte eines Workflows Wenn die Datei nicht existiert wird die Ausf hrung mit einer leeren Nachricht fortgesetzt Es wird kein Log Eintrag erzeugt Erzeuge XML Ausgangsnachricht mit der Statusinformation dar ber dass die Datei existiert und leer ist ansonsten Abbruch des Workflows Pr ft ob eine passende Datei mit einer Gr e 0 vorhanden ist Wenn ja wird eine XML Datei mit dem Element lt FileExists gt mit dem Wert true ausgegeben In jedem anderen Fall wird die Workflow Ausf hrung mit einem Fehler abgebrochen Die Eingabedatei wird nicht ausgegeben Erzeuge XML Ausgangsnachricht mit der Statusinformation dar ber ob die Datei existiert oder nicht Pr ft ob eine geeignete Datei vorhanden ist oder nicht Ausgegeben wird eine XML Datei mit dem Element lt FileExists gt und dem Wert false wenn die angegebene Datei nicht existiert bzw true wenn die angegebene Datei existiert Die Eingabedatei wird nicht ausgegeben Erzeuge XML Ausgangsnachricht mit der Statusinformation dar ber dass die Datei nicht existiert ansonsten Abbruch des Workflows Pr ft ob eine passende Datei vorhanden ist Wenn nicht wird eine XML Datei mit dem Element lt FileExists gt und dem Wert false ausgegeben In jedem anderen Fall wird die Workflow Ausf hrung mit einem Fehler abgebrochen Die Eingabedatei wird
434. onnektor Guide 05 09 2013 88 Database Connector Dialogbeschreibungen Root Element XML Wurzelelement Datentyp Liest den Datentyp der Tabellenspalten in der Datenbank aus Typ Bezeichner Liest die Tabellenspaltennamen aus Spaltenbreite Maximale L nge eines Feld in der Tabellenspalte Dezimalstellen Zeigt an wie viele Stellen hinter dem Komma Werte maximal haben d rfen die in einer Spalte mit Gleitkommazahlen enthalten ist NULL Werte Liest aus welche Tabellenspalten leere Eintr ge haben d rfen Bemerkungen Liest aus zu welchen Tabellenspalten Kommentare existieren 6 5 3 Dialog Statische SQL Query In diesem Dialog definieren Sie die statische Query Die Abfrage darf nur ein SQL Statement enthalten 6 5 4 Dialog Ergebnis der Query Format des Ergebnisses 05 09 2013 In diesem Dialog legen Sie fest wie das Ergebnis der Query formatiert werden soll Mit Hilfe der Vorschau k nnen Sie die Formatierung berpr fen Textwerte aus der Datenbank trimmen Bei Textfeldern werden vorlaufende und nachfolgende Leerzeichen gel scht Leerzeichen die nicht am Anfang oder am Ende eines Textfeldes stehen werden ignoriert NULL Werte durch Attribut kennzeichnen Damit ist es m glich in der Ausgabe Nachricht zwischen einem leeren Wert und dem Wert NULL zu unterscheiden Der Wert NULL wird mit dem Attribut Value null true gekennzeichnet Ergebnis immer mit ResultSets Tag umh llen inubit
435. or an 2 Aktivieren Sie beim Database Connector im Dialog Datenbankverbindungen und Query Typ Workbench Process Engine Systemkonnektor Guide Kap 6 5 1 S 84 im Bereich Funktion die Option Statische Query ausf hren inubit 6 1 Workbench Process Engine Systemkonnektor Guide 7 8 Database Connector 63 Dynamische XML Query erstellen Klicken Sie auf Weiter Der Dialog Statische SQL Query Workbench Process Engine Systemkonnektor Guide Kap 6 5 3 S 88 wird angezeigt Geben Sie die SQL Query ein Klicken Sie auf Weiter Der Dialog Ergebnis der Query Workbench Process Engine Systemkonnektor Guide Kap 6 5 4 S 88 wird angezeigt Legen Sie fest wie das Ergebnis der SQL Query ausgegeben werden soll Beenden Sie den Assistenten mit Fertig stellen Publizieren und aktivieren Sie den Technical Workflow Bei der Ausf hrung des Database Connectors wird die SQL Query an die Datenbank gesendet 6 3 Dynamische XML Query erstellen berblick Um XML Querys zur Ausf hrungszeit dynamisch zu erzeugen ben tigen Sie einen XSLT Converter den Sie mit Ihrem Database Connector verbinden Creates_XML Query DB_C DynamicSelect Der XSLT Converter konvertiert die XML basierte Eingangsnachricht mit Hilfe eines XSLT Stylesheets in eine XML Query und bergibt die XML Query zur Ausf hrung an den Database Connector Voraussetzungen Folgende Daten liegen vor Met
436. ort konfigurieren Sie definieren f r jede zul ssige HTTP Methode mit der die Ressource angefragt werden kann die von der Ressource zur ckgelieferte Antwort a Konfigurieren Sie f r die verf gbaren Anfrage Typen die Antwortdaten Siehe Dialog Konfiguration der Antwort Workbench Process Engine Systemkonnektor Guide Kap 27 8 2 S 300 Die hier konfigurierten Werte k nnen im Workflow dynamisch ber das ndern entsprechender Variablen ge ndert werden Siehe Modulvariablen des REST Connectors Workbench Process Engine Systemkonnektor Guide Kap 27 1 S 288 inubit 6 1 Workbench Process Engine Systemkonnektor Guide 05 09 2013 294 REST Connector Ressource anbieten Bei Ressourcen mit mehreren unterst tzten Methoden ist die Variable Q restConnector requestMethod besonders wichtig da anhand des Wertes dieser Variable im Workflow verzweigt werden kann um die jeweilige Methode zu implementieren Beispiel f r Sammel Ressource Beispiel f r Einzel Ressource aus Sammlung Bei eingehenden Requests mit HTML Form Daten und dem Content Type application x www form urlencoded werden die Form 05 09 2013 inubit 6 1 Workbench Process Engine Systemkonnektor Guide REST Connector 295 Verf gbare Input Connectoren anzeigen Daten automatisch in ein XML Dokument gesetzt Dieses XML Dokument wird zur Eingangsnachricht des Workflows 27 5 Verf gbare Input Connecto
437. ot group username test w rde der Befehl dann z B folgenderma en lauten ftpo gt CWD ftproot group username test 11 2 3 Dialog Input Dateinamen definieren Modus 05 09 2013 Input Connector Dieser Dialog bietet folgende Optionen Dateimodus Pro Ausf hrung wird eine Datei im angegebenen Verzeichnis gelesen wenn deren Name dem Muster entspricht das im Feld Datei gt Name angegeben ist Welche Datei gelesen wird h ngt von Ihren Angaben bei Lesereihenfolge ab Verzeichnismodus Es werden alle Dateien im angegebenen Verzeichnis gelesen wenn deren Dateinamen dem Muster entsprechen das im Feld Datei gt Name angegeben ist Im Verzeichnismodus wird immer eine Ausgangsnachricht im IBISDirectory XML Format erzeugt d h der Technical Workflow startet in jedem Fall inubit 6 1 Workbench Process Engine Systemkonnektor Guide FTP Connector 139 Dialogbeschreibungen Der Verzeichnismodus ist nicht rekursiv d h Unterverzeichnisse des angegebenen Verzeichnisses werden nicht gelesen Verzeichnis Name Absoluter Pfad zu dem Verzeichnis aus dem der FTP Connector Dateien Ubertragen soll Wenn Sie Dateien direkt aus dem Home Verzeichnis Ihres FTP Servers bertragen wollen lassen Sie das Feld leer Datei m Mit Wildcard Wenn Sie diese Option w hlen k nnen Sie den vollst ndigen Dateinamen angeben oder im Dateinamen eine Wildcard benutzen mit xm1 werden dann zZ B alle XML
438. oten die abgefragt erzeugt ge ndert oder gel scht werden sollen Modus m Objektdaten abfragen Zum Lesen eines Business Objekts einer Business Solution Objekt erzeugen Zum Erzeugen eines Business Objekts in einer Business Solution Objektdaten aktualisieren Zum Aktualisieren eines Business Objekts einer Business Solution Objekt l schen Zum L schen eines Business Objekts einer Business Solution Objekt Knoten Bei Modus Objektdaten abfragen Objektdaten aktualisieren Objekt l schen Zum Ermitteln der gew nschten Knoten Es stehen zwei Verfahren zur Auswahl Referenz ber Knoten ID Zum Eintragen oder Ausw hlen der Knoten ID des Knotens in der Business Solution den Sie auslesen aktualisieren oder l schen wollen Im Feld Knoten erscheint anschlie end die ermittelte Knoten ID Referenz ber XPath Aus Performance Gr nden sollten Sie einen Kontextknoten LA verwenden ab dem die XPath Suche startet Kontextnoten verwenden Aktivieren Sie diese Checkbox um die Kontextknoten ID angeben zu k nnen W hlen Sie zuerst die Kontextknoten ID damit der Kontextknoten Typ automatisch gesetzt wird 05 09 2013 inubit 6 1 Workbench Process Engine Systemkonnektor Guide Solution Center Connector 385 Dialog SC Connector Einstellungen Kontextknoten ID ID des Knotens ab dem die XPath Abfrage startet Kontextknoten Typ Der Typ des Kontextknoten wird automatisch ermittelt wenn S
439. oten ID des Vaterknotens in der Business Solution unter dem Sie das neue Objekt anlegen wollen Im Feld Vaterknoten erscheint anschlie end die ermittelte ID des Vaterknotens Referenz ber XPath inubit 6 1 Workbench Process Engine Systemkonnektor Guide 05 09 2013 386 Solution Center Connector Dialog SC Connector Einstellungen Lu Bereich Objekt Daten zur ckgeben Aus Performance Gr nden sollten Sie einen Kontextknoten verwenden ab dem die XPath Suche startet 05 09 2013 Kontextnoten verwenden Aktivieren Sie diese Checkbox um die Kontextknoten ID angeben zu k nnen W hlen Sie zuerst die Kontextknoten ID damit der Kontextknoten Typ automatisch gesetzt wird Kontextknoten ID ID des Knotens ab dem die XPath Abfrage startet Kontextknoten Typ Der Typ des Kontextknoten wird automatisch ermittelt wenn Sie die Kontextknoten ID ermitteln XPath Mit diesem XPath Ausdruck k nnen Sie den Vaterknoten eines neuen Business Objekts referenzieren Innerhalb des Ausdrucks k nnen Sie Workflow Variablen verwenden Falls Sie einen Kontextknoten angegeben haben wird der XPath Ausdruck relativ zum angegebenen Knoten ausgef hrt Geben Sie an ob Objektdaten zur ckgeliefert werden sollen Im Modus Objektdaten abfragen ist diese Option nicht deaktivierbar Es stehen zwei Optionen zur Auswahl Anzahl der Knotenebenen Geben Sie an wie viele Knotenebenen unterhalb des e
440. pe in dem der Service zur Verf gung steht Name Service Name der beim LateBinding als Suchparameter genutzt wird Beschreibung Geben Sie eine Beschreibung Ihres Web Service ein Bindungsbeschreibung Geben Sie eine Beschreibung der Bindungsart ein WSDL URL URL des Web Service die das UDDI beim LateBinding zur ckgibt tModel Key Wird nach dem Publizieren von der UDDI Registry zur ckgeliefert Siehe uddi xml org f r weitere Beschreibungen 40 16 7 Dialog WS Security Konfiguration Service Authentifizierung 05 09 2013 Input Listener Connector In diesem Dialog haben Sie folgende Optionen Die Authentifizierung des Service ist immer n tig wenn WS Security verwendet werden soll Der Zertifikat Handshake garantiert dem Service Konsumenten dass er den angeforderten Service erreicht hat Die Zertifikate werden gleichzeitig zur Verschl sselung der Nachricht verwendet Passwort Geben Sie das Passwort Ihres privaten Schl ssels an Keystore Zum Laden der Keystore Datei jks mit dem privaten Schl ssel Sobald die Datei geladen ist wird die G ltigkeit des Schl ssels angezeigt inubit 6 1 Workbench Process Engine Systemkonnektor Guide Web Services Connector 469 Dialogbeschreibungen Consumer Authentifizierung m Sichere Session herstellen WS Secure Conversation Stellt einen Security Kontext her der ein einmalige Authentifizierung erm glicht Wenn ein authentifizierter Service Konsument d
441. piel werden alle Daten von Georg Miller gel scht SQL DELETE FROM addresses WHERE name Georg Miller XMLQuery lt xml version 1 0 encoding 1S0 8859 1 gt lt queries gt lt query type delete gt lt tables gt lt table gt lt tableNames gt lt tableName gt addresses lt tableName gt lt tableNames gt lt conditions gt lt condition gt lt leftValue gt name lt leftValue gt lt operation gt lt operation gt lt rightValue gt Georg Miller lt rightValue gt lt condition gt lt conditions gt lt table gt lt tables gt lt query gt lt queries gt 6 4 9 Mehrere SQL Statements in einer Abfrage XML Query Dynamische XML Querys k nnen mehrere Statements enthalten lt xml version 1 0 encoding ISO 8859 1 gt lt queries gt lt query type insert gt lt tables gt lt table gt lt tableNames gt inubit 6 1 Workbench Process Engine Systemkonnektor Guide 05 09 2013 75 76 Database Connector XML Querys Struktur und Beispiele lt tableName gt eins lt tableName gt lt tableN lt fields gt ames gt lt field gt lt fiel dName gt id lt fie l lt fie dName gt dValue gt 1 lt fie dValue gt lt field gt lt field gt LdName gt meldung lt fieldName gt lt fiel lt fiel ldValue gt spie braten k cheln lt fieldValue gt lt field gt lt field gt dName gt datum lt fieldName gt lt fie
442. plication octet stream als generischen Inhalts Typ z B lt soapenv Envelope xmlns xmime http www w3 org 2005 05 xmlmime gt lt soapenv Body gt lt operationA gt lt imageData xmime contentType image jpeg gt lt imageData gt lt pdfData xmime contentType application pdf gt lt pdfData gt lt operationA gt lt soapenv Body gt lt soapenv Envelope gt Legen Sie im Workflow folgende Variablen fur die Daten des imageData Elements und des pdfData Elements an und definieren Sie deren Werte inubit 6 1 Workbench Process Engine Systemkonnektor Guide Web Services Connector 449 Bin rdaten als Attachments mit MTOM bertragen Variablen f r die Daten des imageData Elements Name Typ Wert WSAttachment O xs base64Binary Bild Daten WSAttachmentName 0 xs String imageData entspricht dem Namen des Nachrich ten Elements Variablen f r die Daten des pdfData Elements Name Typ Wert WSAttachment 1 xs base64Binary PDF Daten WSAttachmentName 1 xs String pdfData entspricht dem Namen des Nachrich ten Elements Die Variablen enthalten die Namen der zu referenzierenden Nachrichten Elementen und die konkreten Daten Siehe auch Abbildungsregeln f r das Variablen Mapping erstellen Workbench Benutzer Guide Kap 14 8 S 397 Variablen definieren Workbench Benutzer Guide Kap 14 1 S 384 Sie k nnen einen File Connector zum Einlesen
443. r Bereitgestellter Service nnsssannnsnansnannnnnannannnnnnnnnannnnnnnnnannnnnnnnnannnnnnnnnnnnnnn 454 40 16 3 2 Register Aufzurufender Service nuassussnnnnnnonnnnnnnnonnnnnnnnnannnnnnnnnannnnnnnnnannnnnnnnnannn nn 455 AN e Oe E TEE 457 40 16 3 4 Register WSDL Editor ne 457 40 16 3 9 Register ErWeltert yeciscdecctasacecgecvi gavedeevia tetova nee esse 457 inubit 6 1 Workbench Process Engine Systemkonnektor Guide 05 09 2013 14 Inhaltsverzeichnis 40 16 3 6 Register SOAP Nachrichten us2000mmnnananonnnnnnannonnnnnnnnnonnnnnnnnannnnnnnnnonnnnnnanennnn nn 463 40 16 4 Dialog Web Genice Emmstellungen cece ceecee eee eete eee eeeeiieeeeeee teense eeteeeeeeesaeeeenetea 463 40 16 5 Dialog UDDI Browser 466 40 16 6 Dialog UDDI Dateneinstellungen 0000 cece e ee eene tere erent eter ee taeeeeeeesaeeeeeeeeaeeeeeeeenaeeeeeeaas 467 40 16 7 Dialog WS Security Konfiguration 4444sssnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnn anne 468 40 16 8 Dialog WS Security Konfiguration anne 470 40 16 9 Dialog WS Reliable Messaging Konfiguration 24444unnssnnnnnnennnnnnennnnnnnnnnnennnnnnnnn nn 471 40 16 10 Dialog Namensr ume bearbeiten 471 41 WebDAV CGopnpnectot szecxNeENEEESNENSEELEESEEAESEEEEEEENREAEEE NEES EEEEEEEREE E EE NESEEEEEEEEEEESECEER NEEN NEGER KEEN 473 41 1 Dialog WebDAV Connector
444. r PIP Spezifikation zu finden F r den PIP 3A2 z B ist der Rollenname des Absenders Customer und der des Empf ngers Product Supplier Servicename Absender Servicename Empf nger Nur Output Connector Die Bezeichnungen sind von RosettaNet spezifiziert und f r jeden PIP festgelegt F r den PIP 3A1 sind die Werte z B in der Tabelle 4 1 zu finden Business Aktivit t Die Bezeichnungen f r Business Activities sind von RosettaNet spezifiziert und f r jeden PIP festgelegt blicherweise ist die Bezeichnung f r eine Business Activity in der Tabelle 3 1 der PIP Spezifikation zu finden F r den PIP 3A2 ist dies z B Request Price and Availability Business Aktion Die Bezeichnungen sind von RosettaNet spezifiziert und f r jeden PIP festgelegt blicherweise ist die Bezeichnung f r eine Business Action in der Tabelle 4 2 der PIP Spezifikation zu finden F r den PIP 3A2 ist dies z B je nach Aktion entweder Price and Availability Request Action oder Price and Availability Response Action Verwendungszweck Nur Output Connector F gt dem Service Header der Nachricht einen Hinweis ber die Art der Nachricht hinzu lt GlobalUsageCode gt Test lt GlobalUsageCode gt oder lt GlobalUsageCode gt Production lt GlobalUsageCode gt RosettaNet spezifiziert nicht wie ein Geschaftspartner mit diesem Element verfahren muss 29 5 2 Dialog Asynchrone Empfangsbest tigung nur Input Con
445. r die gew nschte IP Nachricht beginnt z B 0x0b f r HL7 Nachrichten 05 09 2013 394 TCP IP Connector Dialogbeschreibung HL7 Nachrichtenempfang Lu 5 Tragen Sie im Feld Stopbyte Sequenz die Bytefolge ein mit der die gew nschte IP Nachricht endet z B 0x1c0x0d f r HL7 Nachrichten 6 Schlie en Sie den Dialog mit Fertig stellen Publizieren Sie den Konnektor um die Einstellungen zu bernehmen Der TCP IP Connector kann mit Hilfe der Option zum Pr fen auf Start Stopbyte Begrenzung zum Empfang von HL7 Nachrichten genutzt werden Um die HL7 Nachrichten in XML zu konvertieren k nnen Sie als nachfolgendes Modul im Workflow einen EDI Format Adapter verwenden Siehe EDI Adapter Format Adapter Workbench Process Engine Modul Guide Kap 7 S 163 Eine HL7 Nachricht besteht aus dem Header MSH und den Datensegmenten Start und Stopbytes begrenzen den HL7 Datenstrom und sind notwendig da das Dateiende nicht eindeutig das Nachrichtenende markiert Fur die HL7 Nachrichtentrennung werden folgende Standard Start Stop Bytes genutzt Start 0x0b Stop 0x1c0x0d 37 3 Dialogbeschreibung Konfiguration 05 09 2013 Servername Input Listener Connector IP Adresse der Netzwerkschnittstelle unter welcher der TCP IP Connector erreichbar ist Medium Output Connector IP Adresse der Netzwerkschnittstelle an welche die Nachricht geschickt werden soll Port
446. r Anfrage konfigurieren Ein Workflow der einen asynchronen Web Service anfordern soll muss mindestens aus folgenden Modulen bestehen Modul zum Erstellen des Aufrufs z B ein XSLT Converter oder das Variablen Mapping Asynchroner Web Service Medium Connector zum Senden des Aufrufs Web Services Callback Listener zum asynchronen Entgegennehmen der vom aufgerufenen Web Services gesendeten Antwort Zwischen dem aufrufenden Web Services Connector und dem Web Services Callback Listener k nnen Sie beliebige Module einf gen Die Module des aufrufenden und des aufgerufenen Web Services m ssen Sie in zwei verschiedenen Workflows anlegen Dieser XSLT Converter erstellt Anfragen an einen Web Service So gehen Sie vor 1 Legen Sie in einem neuen Workflow einen neuen XSLT Converter an und benennen Sie ihn inubit 6 1 Workbench Process Engine Systemkonnektor Guide 05 09 2013 430 Web Services Connector Asynchrone Web Services Asynchronen Web Service Medium Connector anlegen 05 09 2013 Klicken Sie auf Weiter um zum Register XSLT Converter Eigenschaften zu gelangen Aktivieren Sie die Checkbox Eingangsnachricht ignorieren Klicken Sie auf Weiter um zum Modul Editor zu gelangen ffnen Sie im Fensterbereich XML Zieldatei einen Web Services Explorer W hlen Sie als Modul den oben definierten Web Services Listener und als Operation die Request Operation Siehe Asynchro
447. r Eigenschaften die Checkbox Eingangsnachricht ignorieren 4 Passen Sie das XSLT Stylesheet so an dass die Nachricht als Ergebnis des Mappings folgende Struktur hat Eigenschaften XSLT Converter E ER H Q var Stylesheet XML Quelle XML Ziel x 1 stylesheet http www w3 org 1999 XSL Transform d i xsl http www w3 org 200 1 XMLSchema lt a xs xs d i exdude result prefixes 2 0 d i version 8 E xsl param name oo document E xsl output method xml encoding UTF 8 Sf EL x 1 template OpenOfficeConnector CH E OOWriter InputDocument Soo document d xsl value of CH oa Print 1 d i pages Canon iR C3580 PCL6 d i printerName 10 B A ae BB A Q ergebnis des Mappings Ausfiihrungszet in Miliseku Name Typ Ela a OOWriter gt InputDocument gt Print pages 1 printerName Canon iR C3580 PCL6 a n niati nee N en m ee en nenn GERIET _ Ann Als Attribute sind nur der Name des Druckers im Attribut printerName und die zu druckende n Seite n im Attribut pages zul ssig Einzelne zu druckende Seiten trennen Sie durch ein Komma Die erste und die letzte Seite eines Druckbereichs verbinden Sie durch einen Bindestrich 5 Verbinden Sie das Assign Modul mit dem XSLT Converter 6 Erstellen Sie einen OpenOffice Connector 7 Verbinden Sie den XSLT Converter mit dem OpenOffice Conn
448. r Guide Kap 3 3 S 129 Technical Workflow Diagramme Workbench Benutzer Guide Kap 12 S 311 15 1 Beispielszenario Liste von Benutzerkonten berpr fen 05 09 2013 Failed Out Ee otherwise Data Input Validation True Failed Delivery EiI amp Splitting In P ErrorNotExists Authentication True Out Ein Programm sammelt regelm ig Benutzerkontodaten Benutzername Passwort und fasst diese in einer XML Datei zusammen Der Input File Connector Daten Input bergibt diese Datei an den Demultiplexer Validation Der Demultiplexer splittet die XML Datei erstellt pro Login Passwort Paar eine neue XML Datei und bergibt diese dem JAAS Connector Authentication inubit 6 1 Workbench Process Engine Systemkonnektor Guide 15 2 JAAS Connector 169 Beispielszenario Benutzerdaten ber Task Formulare validieren Der JAAS Connector validiert jedes Login Passwort Paar Wenn die Validierung scheitert wird ein Error Element hinzugef gt Die Ausgabedatei wird dem Demultiplexer True Failed Delivery bergeben Der Demultiplexer ist so konfiguriert dass alle Dateien mit einem Error Element bei denen die Validierung gescheitert ist an den Output File Connector Failed Out bergeben werden und alle anderen an den Output File Connector True Out Beispielszenario Benutzerdaten ber Task Formulare validieren Trigger Joiner Account Yalidation Form Yalidation Der abgebildete Work
449. r Konnektor automatisch auf den Standardwert zur ck Ein sehr lange ablaufender Test wird durch die hier gesetzte Timeout Beschr nkung vorzeitig unterbrochen Screenshot im Fehlerfall erzeugen Wenn markiert dann wird im Fehlerfall ein Screenshot in Form einer base64 kodierten png Datei als error screenshot Element in die XML Ausgangsnachricht geschrieben Sie k nnen z B ber ein Decoder Modul als nachfolgendes Modul im Workflow die base64 kodierte Screenshot Datei in ein Bin rformat berf hren und ber einen Output File Connector an eine Zielapplikation bergeben Verbindung testen Zum Testen ob die Verbindung mit Ihren Angaben erfolgreich aufgebaut werden kann inubit 6 1 Workbench Process Engine Systemkonnektor Guide 05 09 2013 362 Selenium Connector Dialog Selenium Connector Eigenschaften 05 09 2013 inubit 6 1 Workbench Process Engine Systemkonnektor Guide By SNMP Connector Verwendung Konnektortypen 34 1 Funktionsprinzip 363 Dieser Abschnitt erlautert die folgenden Themen m Funktionsprinzip S 363 m Beispiel Medium Connector S 365 m Beispiel Input Connector S 367 m Dialog SNMP Connector Eigenschaften S 368 Mit dem SNMP Connector k nnen Netzwerkkomponenten wie Server Router Switches oder Drucker von einem zentralen SNMP Server berwacht und konfiguriert werden Bei der berwachung von Netzwerkkomponenten kann die Fehlererkennung und die Fehlerbena
450. r Liste angezeigt wird dann geben Sie deren vollst ndigen Namen z B java lang StringBuffer in das Textfeld ein 5 Klicken Sie auf Weiter Es wird versucht die entsprechende Klasse aus dem Classpath zu laden Wenn die Klasse geladen werden konnte ffnet sich der n chste Dialog 6 Constructor angeben Wenn alle aufzurufenden Methoden statisch sind dann entf llt die Auswahl eines geeigneten Constructors der Klasse Falls mindestens ein Methodenaufruf nicht statisch ist dann m ssen Sie einen Klassen Constructor angeben a W hlen Sie im Baum den Knoten Constructor aus b ffnen Sie das Kontextmen und w hlen Sie Constructor hinzuf gen c W hlen Sie einen passenden Constructor aus d Klicken Sie auf OK Der Dialog schlie t sich Der Constructor wird eingef gt Unterhalb des Constructorknotens werden die Parameter angezeigt 7 Methode einf gen a W hlen Sie im Baum den Knoten Methods aus b ffnen Sie das Kontextmen und w hlen Sie Methode hinzuf gen Ein Dialog ffnet sich c W hlen Sie alle Methoden die aufgerufen werden sollen d Klicken Sie auf OK um zur ck in die Baumansicht zu gelangen Die gew hlten Methoden wurden hinzugef gt und alle Parameter unterhalb der Methodenknoten gesetzt 8 Parameterwerte setzen Um einen vollst ndigen Methodenaufruf absetzen zu k nnen m ssen Sie die Parameter mit konkreten Werten f llen a Markieren Sie ein
451. r MDN ben tigt wird die Adresse an welche die MDN gesendet werden soll eine Pr fsumme ber den Nachrichten Inhalt 2 ReceiveMessages Der Input Listener Connector wartet auf den Eingang der Nachricht Sobald diese eintrifft entschl sselt er diese mit seinem privaten Schl ssel und startet den Workflow 3 StoreMessages Der File Connector speichert die Nachricht beim Empf nger 4 SendMDN Der Output Connector erstellt automatisch die MDN wenn eine angefordert wurde 05 09 2013 inubit 6 1 Workbench Process Engine Systemkonnektor Guide AS2 Connector 35 Empfangen Senden und Pr fen von AS2 Nachrichten Die MDN enth lt die ID der Nachricht eine Pr fsumme ber den Nachrichteninhalt und eine Signatur Die Signatur wurde mit dem privaten Schl ssel des Nachrichten Empf ngers erstellt und garantiert dass die Best tigung wirklich vom Nachrichten Empf nger kommt ID Adresse und Pr fsumme werden ber Variablen automatisch vom Input zum Output Connector bertragen Der Output Connector schickt die MDN an den Absender zur ck Die MDN wird automatisch entsprechend den Anforderungen des Absenders hier Output Connector SendMessagesRequireMDN synchron oder asynchron zur ck gesendet 5 ReceiveMDN Der Input Listener wartet auf die MDN Sobald diese eintrifft wird die darin enthaltene ID in demselben Verzeichnis gespeichert in dem die ID bereits beim Versenden der Nachricht gespeichert wurde Die ID wird genutzt
452. rbeitet Kommandotypen Die folgende Tabelle gibt einen berblick ber die einzelnen Kommandotypen Kommando Beschreibung Create Legt neue Entit ten mit allen bergebenen Eigenschaften auf dem Livelink Archive Server an CreatelfNotExists Wie Create aber nur dann wenn Entit ten noch nicht existieren Ob Enti t ten schon vorhanden sind wird mittels der Bedingung auf dem Livelink Ar chive Server berpr ft 20 2 2 Bedingungen Abh ngig vom Kommando muss die Eingangsnachricht eine Such Bedingung enthalten Diese Bedingung wird in Form einer where Klausel aufgestellt Dabei wird f r die wnere Klausel die Livelink PDMS Query Language verwendet Einen Einstieg in die Livelink Query Language LGQL finden Sie unter https ecommunities belgium be ecomfrsupport help _en_US websbroker sr_Iql html inubit 6 1 Workbench Process Engine Systemkonnektor Guide 05 09 2013 208 Livelink PDMS Connector Inhalt und Struktur der Eingangs und Ausgangsnachrichten Bedingung f r spezifische Eigenschaft Bedingung f r spezifische Eigenschaft und Dokumentenklasse Bedingung f r Dokument ID 20 2 3 Entit ten 05 09 2013 lt and gt lt equal gt lt property name ixos dms Id gt lt literal value aaps44v2vy6uqvorzmcje3enjexgo datatype String gt lt equal gt lt and gt lt and gt lt equal casesensitive true gt lt property name ixos bai LinkId gt lt literal v
453. rbindungen etc die genutzt werden um die Datenbankverbindung abh ngig von Ihrer verwendeten Datenbank zu konfigurieren Die Parameter definieren Sie als Name Wert Paare inubit 6 1 Workbench Process Engine Systemkonnektor Guide 05 09 2013 86 Database Connector Dialogbeschreibungen Verbindungstest Funktion 05 09 2013 Einstellungen Verbindung testen Zum Testen ob die Verbindung mit Ihren Angaben erfolgreich aufgebaut werden kann Mit der Auswahl legen Sie fest welche Aufgabe der Database Connector ausf hren soll Eingangsnachricht als Query ausf hren Der Database Connector f hrt Abfragen aus Eingangsnachrichten aus Wenn m glich werden sogenannte prepared statements erzeugt Wenn die Eingangsnachricht mehrere Abfragen enth lt dann wird berpr ft ob diese denselben Typ haben und auf dieselben Tabellenspalten zugreifen Wenn ja dann wird ein Befehl erzeugt der mehrfach ausgef hrt wird Dieses Vorgehen erh ht die Performance Siehe Dynamische XML Query erstellen Workbench Process Engine Systemkonnektor Guide Kap 6 3 S 63 Statische Query ausf hren Der Database Connector f hrt eine fest definierte Abfrage aus Die Abfrage geben Sie im Dialog Statische SQL Query Workbench Process Engine Systemkonnektor Guide Kap 6 5 3 S 88 ein Siehe Statische SQL Query erstellen Workbench Process Engine Systemkonnektor Guide Kap 6 2 S 62 Metadaten lesen Der D
454. rden kann inubit 6 1 Workbench Process Engine Systemkonnektor Guide 05 09 2013 488 X 400 SE Connector Dialogbeschreibungen 43 3 2 Dialog Datenweitergabe konfigurieren Nachrichtenfilter Lesereihenfolge Konfiguration des Ausgangsformates 05 09 2013 Input Connector In diesem Dialog konfigurieren Sie Filter und eine Lesereihenfolge f r einzulesende Nachrichten sowie das Nachrichtenformat das an das n chste Modul weitergegeben wird Filter hinzuf gen Button Der Button f gt eine Filter Option f r Eingangsnachrichten ein Sie k nnen den Absender und den Betreff der abzuholenden Nachrichten mit den Bedingungen enth lt enth lt nicht filtern Nachrichten nach dem Lesen l schen Wenn markiert werden die Nachrichten nach dem Abholen aus der X 400 Box gel scht Wenn mehr als eine Nachricht bertragen wird legen Sie fest welche Nachrichten zuerst bertragen werden und in welcher Reihenfolge Die Option Alphabetisch sortiert nach der Betreffzeile die Option Chronologisch sortiert nach dem Datum Ausgabeformat DATA Die abgeholte Nachricht wird unver ndert ausgegeben XML Die Nachricht wird in das IBISX400 Format konvertiert und ausgegeben Das XML Schema sowie eine Beispielnachricht f r dieses Format finden Sie im inubit Repository im Verzeichnis Global System Mapping Templates X 400 SE Connector Nummer des Anhangs Nur bei Ausgabeformat DATA We
455. rden sollen Siehe Schritt 7 im Abschnitt Objekt ber eine XPath Anfrage erzeugen Workbench Process Engine Systemkonnektor Guide Kap 35 S 376 vu e W hlen Sie anstelle des Vaterknotens den Knoten den Sie W bearbeiten wollen 7 Aktivieren Sie die Option Objektdaten zur ckgeben 8 Tragen Sie in das Feld Anzahl der Knotenebenen den gew nschten Wert ein Siehe Anzahl der Knotenebenen Workbench Process Engine Systemkonnektor Guide Kap 35 S 386 9 Setzen Sie den Startpoint vor den XSLT Converter und starten Sie den Test ohne Datei 10 Pr fen Sie in der Ergebnisdatei oder im Solution Center Explorer ob die Objektdaten korrekt ge ndert wurden 35 8 Beispiel Objekt l schen Dieser Abschnitt erl utert die folgenden Themen 05 09 2013 inubit 6 1 Workbench Process Engine Systemkonnektor Guide Solution Center Connector 383 Beispiel Objekt l schen Objekt ber die Knoten ID l schen S 383 Objekt ber eine XPath Anfrage l schen S 383 Verwendung Adressieren und L schen eines Knotens und optional R ckgabe der Daten des Vaterknotens des gel schten Objekts 35 8 1 Objekt ber die Knoten ID l schen So gehen Sie vor 1 x a SS Erstellen Sie in einem Technical Workflow einen Solution Center Connector und benennen Sie diesen Wechseln Sie auf die Seite SC Connector Einstellungen W hlen Sie den Modus Objekt l schen Klicken Sie am Ende
456. rem Administrator erfragen oder entnehmen Sie diese den Handb chern der jeweiligen Netzwerkkomponenten Trap Konfiguration Nur bei Auswahl der Operation TRAP Absender IP IP Adresse oder Hostname des Rechners der SNMP Traps sendet Absender OID OID des Ger tes welche den Trap generiert Die OID spezifiziert um welchen SNMP Agenten es sich handelt F r Informationen zum Object Identifier siehe O D Workbench Process Engine Systemkonnektor Guide Kap 34 S 364 Allgemeine ID Allgemeine Trap ID W hlen Sie unter den sieben m glichen Trap IDs die entsprechende aus Falls es sich um eine firmenspezifische Trap ID handelt bertragen Sie diese in das n chste Feld Spezifische ID Spezifische ID Firmenspezifische Trap ID falls es sich um eine firmenspezifischen Trap handelt Lu Erfragen Sie bei Bedarf die OID und andere Angaben f r de Trap Konfiguration bei Ihrem System Administrator Verbindungstest m Verbindung testen Zum Testen ob die Verbindung mit Ihren Angaben erfolgreich aufgebaut werden kann inubit 6 1 Workbench Process Engine Systemkonnektor Guide 05 09 2013 370 SNMP Connector Dialog SNMP Connector Eigenschaften 05 09 2013 inubit 6 1 Workbench Process Engine Systemkonnektor Guide EL Solution Center Connector Verwendung Voraussetzungen 35 1 Funktionsprinzip 371 Dieser Abschnitt erl utert die folgenden Themen Funktionsp
457. ren Name dem Muster entspricht das im Feld Datei gt Name angegeben ist Welche Datei gelesen wird h ngt von Ihren Angaben bei Lesereihenfolge ab Verzeichnismodus Es werden alle Dateien im angegebenen Verzeichnis gelesen wenn deren Dateinamen dem Muster entsprechen das im Feld Datei gt Name angegeben ist Im Verzeichnismodus wird immer eine Ausgangsnachricht XML erzeugt d h der Technical Workflow startet in jedem Fall Damit ist es z B m glich hinter einem File Input Connector mit WY einem Demultiplexer o a auf den jeweiligen Zustand der Datei zu reagieren Verzeichnis Name Pfad zum Verzeichnis aus dem Dateien gelesen werden sollen Der Pfad kann absolut oder relativ zum Verzeichnis lt inubit installdir gt server Tomcat bin angegeben werden Datei m Name Dateiname Optional mit Wildcard bzw regularem Ausdruck Si Siehe http www regular expressions info tutorial html Invertieren Wenn markiert dann wird das Muster das f r den Dateinamen angegeben wurde umgekehrt Damit werden alle Dateien gelesen deren Name dem Muster nicht entspricht Mit Wildcard Wenn markiert dann k nnen Sie beim Eingeben des Dateinamens eine Wildcard Asterisk verwenden oder den Dateinamen vollst ndig eingeben Mit regul rem Ausdruck Wenn markiert dann k nnen Sie mit Hilfe eines regul ren Ausdrucks ein Muster angeben dem die Dateinamen der einzulesenden Dateien entsprechen m
458. ren anzeigen Sie k nnen sich eine Liste aller in inubit Workbench erstellten verf gbaren aktiven und inaktiven REST Input Konnektoren anzeigen lassen So gehen Sie vor 1 W hlen Sie einen REST Input Listener Connector aus und ffnen Sie diesen zum Bearbeiten 2 Klicken Sie im Dialog Konfiguration der Ressource Workbench Process Engine Systemkonnektor Guide Kap 27 8 1 S 298 im Bereich Bereitgestellte Ressourcen neben der URL auf sl 3 W hlen Sie die Option Alle REST Input Konnektoren auflisten Ein Dialog ffnet sich das eine Liste aller angelegten Input Connectoren anzeigt In der Liste wird der Name des Konnektors der entsprechende Workflow der Pfad f r die Ressource und die f r den Konnektor verf gbaren HTTP Methoden aufgef hrt Dar ber hinaus k nnen Sie sich eine Liste aller angebotenen REST Services im Web Browser anzeigen lassen http localhost 8000 ibis rest rc method OPTIONS 27 6 Publizierte Ressourcen anzeigen Sie k nnen sich eine Liste mit allen publizierten und aktivierten Ressourcen anzeigen lassen So gehen Sie vor 1 W hlen Sie einen REST Input Listener Connector aus und ffnen Sie diesen zum Bearbeiten inubit 6 1 Workbench Process Engine Systemkonnektor Guide 05 09 2013 296 REST Connector Ressource aufrufen 2 Klicken Sie im Dialog Konfiguration der Ressource Workbench Process Engine Systemkonnektor Guide Kap 27 8 1 S 298 im Ber
459. ren des Metadaten Cache inklusive aller BAPI und IDoc Strukturen Wird der Metadaten Cache aktualisiert sind alle SAP Systemkonnektoren betroffen die das gleiche Gateway verwenden inubit 6 1 Workbench Process Engine Systemkonnektor Guide 05 09 2013 342 SAP Connector Dialog SAP Connector Eigenschaften 05 09 2013 inubit 6 1 Workbench Process Engine Systemkonnektor Guide E Secrypt Connector 343 Verwendung Voraussetzung 31 1 Funktionsprinzip Dokumente signieren Signaturen pr fen Dieser Abschnitt erl utert die folgenden Themen m Funktionsprinzip S 343 m Beispiel Workflow S 344 m Modulvariablen S 345 m Dialog Secrypt Connector Eigenschaften S 345 Ein Secrypt Connector bietet folgende Funktionen Dokumente mit einer elektronischen Signatur versehen Elektronische Signaturen von Dokumenten pr fen Sie haben Zugriff auf einen Secrypt Signatur und Verifier Server Siehe auch Systemkonnektoren Workbench Process Engine Systemkonnektor Guide Kap 1 S 19 Module anlegen Workbench Benutzer Guide Kap 3 3 S 129 Technical Workflow Diagramme Workbench Benutzer Guide Kap 12 S 311 Der Secrypt Connector kopiert das zu signierende Dokument in ein definiertes Eingangsverzeichnis des Secrypt DigiSeal Servers Der Secrypt DigiSeal Server signiert das Dokument und verschiebt es in ein definiertes Ausgangsverzeichnis Das Ergebnis der Aktion Dokument
460. ring testString This is a test string to be parsed and manipulated String resultString testString subString 1 testString length Siehe Listing Workbench Process Engine Systemkonnektor Guide Kap 16 S 176 Ein und Ausgangsnachrichten Struktur Workbench Process Engine Systemkonnektor Guide Kap 16 S 177 Eingangsnachricht erstellen Workbench Process Engine Systemkonnektor Guide Kap 16 1 S 173 Die Ausgangsnachricht enthalt den Wert der Variablen resultString his is a test string to be parsed and manipulated Methode mit einfachen Parametern auf einer Klasseninstanz aufrufen encoding UTF 8 gt inubit 6 1 Workbench Process Engine Systemkonnektor Guide Listing oo N Ui VG WN H CH 2 3 VO OO JO UI Bs 9 lt reflection gt Java Reflection Connector Beispiel Methodenaufruf lt first declare class instance gt lt object name testString gt lt java lang String gt This is a test string to be parsed and manipulated lt java lang String gt lt object gt lt in this example java lang String substring 1 testString length is called gt lt the result is stored in the variable resultString gt lt length object StestString result stringLength gt lt substring object testString result resultString gt lt param type int gt lt int gt 1 lt int gt lt param gt lt param
461. rinzip S 371 Moduleigenschaften S 372 Objekt XML Daten erzeugen S 373 Verwenden von XPath Anfragen S 373 Beispiel Objekt erzeugen S 375 Beispiel Objektdaten abfragen S 377 Beispiel Objektdaten aktualisieren S 380 Beispiel Objekt l schen S 382 Dialog SC Connector Einstellungen S 384 Mit dem Solution Center Connector k nnen Sie lesend und schreibend aus Technical Workflows der inubit Software heraus auf Business Objekte einer Business Solution zugreifen die in einem Solution Center liegen Siehe auch Systemkonnektoren Workbench Process Engine Systemkonnektor Guide Kap 1 S 19 Module anlegen Workbench Benutzer Guide Kap 3 3 S 129 Technical Workflow Diagramme Workbench Benutzer Guide Kap 12 S 311 Sie haben das Solution Center erfolgreich installiert und konfiguriert Sie haben die Verbindung der inubit Workbench zum Solution Center konfiguriert Der Solution Center Connector greift lesend oder schreibend auf das Business Objekt in Ihrer Business Solution im Solution Center zu oder legt es neu an ndern Lesen und L schen Das Business Objekt wird ber die Knoten ID oder eine XPath Abfrage definiert inubit 6 1 Workbench Process Engine Systemkonnektor Guide 05 09 2013 372 Solution Center Connector Moduleigenschaften Anlegen Der Solution Center Connector erh lt eine Eingangsnachricht in der das zu erstellende Objekt definiert ist Der Vaterknoten
462. rkflow weiter Siehe auch Systemkonnektoren Workbench Process Engine Systemkonnektor Guide Kap 1 S 19 Module anlegen Workbench Benutzer Guide Kap 3 3 S 129 Technical Workflow Diagramme Workbench Benutzer Guide Kap 12 S 311 inubit 6 1 Workbench Process Engine Systemkonnektor Guide 05 09 2013 288 REST Connector Modulvariablen des REST Connectors 27 1 Modulvariablen des REST Connectors Input Listener Connector 05 09 2013 Bei der Ausf hrung eines REST Connectors werden abh ngig vom Konnektor Typ folgende Variablen gesetzt und stehen im weiteren Verlauf der Workflow Ausf hrung zur Verf gung F r die Daten der empfangenen Anfrage werden folgende Variablen gesetzt restConnector requestMethod Enth lt den Namen der HTTP Methode der Anfrage restConnector requestHeaders Enth lt die Header Daten der Anfrage Nachricht restConnector requestQueryParams Enth lt die Werte der Query Parameter aus der Anfrage URL Diese werden in eine XML Struktur berf hrt und jeder Parameter wird in ein XML Element umgesetzt restConnector requestResourcePath Enth lt den Pfad der angeforderten Ressource Die Variable enth lt z B bei der Anfrage URL http 1localhost 8000 ibis rest rc orders 123 den Wert orders 123 restConnector requestURITemplateParam x Enth lt die Inhalte von dynamischen Pfadbestandteilen der Anfrage URL x steht dabei jeweils f r den in geschweiften
463. rnate Dialekt Datenbank URL Wird vorbelegt wenn Sie eine vorkonfigurierte Datenbank gew hlt haben Geben Sie den Host den Port und den Datenbanknamen an Benutzer Passwort Eingabe ist abh ngig von Ihrer Datenbank Connection Pooling Aktiviert das Connection Pooling inubit 6 1 Workbench Process Engine Systemkonnektor Guide Business Object Connector 59 Dialog Business Object Connector Einstellungen Wenn das Connection Pooling aktiviert ist werden physische Verbindungen zu einer Datenbank wiederverwendet Dies beschleunigt die Abarbeitung der Abfragen Die Verbindungen werden nach ihrer Verwendung nicht abgebaut sondern gespeichert und sind f r nachfolgende Zugriffe verf gbar So muss nicht bei jedem Zugriff auf die Datenbank erneut zeitintensiv eine Verbindung aufgebaut werden Der Button Einstellungen ffnet den Dialog Datenbank Connection Pooling Workbench Process Engine Systemkonnektor Guide Kap 6 5 5 S 90 zur Konfiguration des Connection Poolings Verbindungstest m Verbindung testen Zum Testen ob die Verbindung mit Ihren Angaben erfolgreich aufgebaut werden kann inubit 6 1 Workbench Process Engine Systemkonnektor Guide 05 09 2013 60 Business Object Connector Dialog Business Object Connector Einstellungen 05 09 2013 inubit 6 1 Workbench Process Engine Systemkonnektor Guide 0 Database Connector u Verwendung Dieser Abschnitt erl utert die folgenden Them
464. rotokoll f r den Zugriff auf Dateien ber IP Netzwerke Typ Wenn Sie f r den Zugriff auf den Server keine Authentifizierung ben tigen markieren Sie Anonym Wenn Sie als Protokoll repository gew hlt haben steht auch der Typ Mit Benutzer Gruppe des Workflows zur Auswahl Der VFS Connector authentifiziert sich dann mit den Login Daten des Workflows Login Passwort Wenn f r Ihren Server eine Authentifizierung notwendig ist geben Sie hier die erforderlichen Login Daten ein Normalerweise wird die Art der Passwortversendung zwischen Server und Client ausgehandelt Sie k nnen jedoch bei Bedarf die Unterst tzung von Klartextpassw rtern f r alle CIFS Verbindungen manuell deaktivieren Dazu erstellen Sie ein neues Java System Property namens jeifs smb client disablePlainTextPasswords mit dem Wert true siehe Java System Properties Process Engine Administrator und Entwickler Guide Kap 2 2 10 9 S 44 Beachten Sie dass eine Fehlermeldung geworfen wird falls nach der Deaktivierung ein Server explizit Klartextpassw rter verlangt Server Konfiguration Oo Servername Domainname des Servers z B xyz inubit com Port cifs Die Standardportnummer ist 445 ftp Die Standardportnummer ist 21 Standard cifs Stellt bei Bedarf die Standardportnummer 445 wieder ein ftp Stellt bei Bedarf die Standardportnummer 21 wieder ein Windows Dom ne nur cifs Name der Windows Dom ne fa
465. rs ein 4 Klicken Sie auf Truststore oder Zertifikat hinzuf gen um das Zertifikat des Web Services Providers mit dem ffentlichen Schl ssel hinzuzuf gen 5 Schlie en Sie den Dialog mit OK 6 Geben Sie in der WSDL den Alias f r das Zertifikat des eben hinzugef gten Web Service Providers an Die Abbildung zeigt das zu ndernde Element inubit 6 1 Workbench Process Engine Systemkonnektor Guide 05 09 2013 354 Security Token Service Connector Web Services Provider an STS Connector registrieren ES Moduleigenschaften bearbeiten Security Token Service WS Trust Konfigurieren Sie die Authentifizierungsm glichkeiten an dem STS und geben Sie die gesch tzten Service Provider an Die ffentlichen Zertifikate der Service Provider werden zentral am STS hinterle und m ssen der Version 3 mit SubjectKeyIdentifier entsprechen HAA gt wsdl definitions d wsp http schemas xmlsoap org ws 2004 09 policy d i sp http schemas xmlsoap org ws 2005 07 securitypolicy d t qi httpif schemas message com Message ar wsdl http schemas xmlsoap org wsdl ir wsx http schemas xmlsoap org ws 2004 09 mex a wsal0 http www w3 org 2005 08 addressing ir wsu http doc oasis open org wss 2004 01 joasis 200401 wss wssecurity utility 1 0 gt ar i0 http xmlsoap org DAB it soapenc http schemas xmlsoap org soapsencoding t tns http tempuri org a xsd http www w3 org 2001 xMLSc
466. rtragen wollen Text Textdateien im ASCII Format u Feste S tze Dateien die feste Satzl ngen enthalten Variable S tze Dateien deren Satzl ngen variabel sind Die maximale Satzlange setzen Sie uber die Modulvariable RvsRecordLength Gi Siehe rvs Dokumentation Unstrukturiert W hlen Sie diese Option wenn Sie bin re Dateien Ubertragen wollen inubit 6 1 Workbench Process Engine Systemkonnektor Guide 05 09 2013 236 OFTP Connector Dialog Stationen VFTyp Code In Code Out nur bei Output Connector Mit dem VFTyp bestimmen Sie wie die Dateien vor der bertragung konvertiert werden sollen Die Konvertierung ist nur auf Dateien mit festem oder variablem Format anwendbar siehe Option Format ber dieser Option Sie k nnen zwischen den Optionen Text Variable oder Speziell w hlen Text Die Datei wird nicht konvertiert Die Datei muss bereits dem Format entsprechen und ber die Satzl ngen verf gen die vom Gesch ftspartner erwartet werden Variable Wenn Sie diese Option w hlen wird die Datei auf Grundlage eines in rvs angegebenen Standardwertes konvertiert Speziell Mit dieser Option wird die Datei in ein spezielles Format gewandelt das f r die bertragung im FT SINIX Modus gebraucht wird File Transfer Siemens UNIX nur bei Output Connector Mit den Optionen Code In und Code out k nnen Sie die Nachricht so konvertieren dass sie mit dem Zeiche
467. rufen kann Siehe Funktionsprinzip des STS Connectors Workbench Process Engine Systemkonnektor Guide Kap 32 1 S 350 Voraussetzungen m Sie ben tigen einen Truststore mit dem ffentlichen Schl ssel des STS oder dessen Zertifikat a Web Services Provider Web Service Consumer und STS sind in der inubit Software realisiert Um mit einem externen Consumer einen Web Service aufzurufen WY der Uber einen STS der inubit Software abgesichert ist konfigurieren Sie dessen Sicherheitseinstellungen entsprechend den Angaben des Herstellers So gehen Sie vor 1 ffnen Sie den Web Services Connector Ihres Web Services Consumers zum Bearbeiten 05 09 2013 inubit 6 1 Workbench Process Engine Systemkonnektor Guide Web Services Connector 439 STS gesicherten Web Service Provider aufrufen 2 Geben Sie im Register Aufzurufender Service die URL an unter der die WSDL des STS gesicherten Web Service Providers verf gbar ist Eigenschaften Web Service Editor Aufzurufender Service Erweitert SOAP Nachrichten WSDL Daten WSDL laden von Datei URL UDDI URL http localhost 8000 ibis ws mySecuredService wsdl i ee ae a 3 Laden Sie die WSDL Klicken Sie im Register Erweitert im Bereich W3C Standards auf den Button WS Security Der Dialog WS Security Konfiguration ffnet sich 5 Importieren Sie den Truststore des STS oder dessen Zertifikat Der darin enthaltenen
468. ruten nenn nnnn nn 429 40 6 Web Services Provider durch Security Token Service absichern 433 40 7 Schl sselpaar f r WS Security erstellen 444404444440Hnnnennnnnnnnennnnnnnnnnnnnnnnnnennnnnnnnnennnnnnennn ann 434 40 7 1 Selbstsigniertes Schl sselpaar erstellen 434 40 7 2 Extern signiertes Schl sselpaar erstellen nn nn 435 40 8 Schl sselpaare f r WS Trust erstellen nennen 436 40 8 1 Selbstsigniertes Security Token Service STS Schl sselpaar erstellen 437 40 8 2 Selbstsigniertes Service Schl sselpaar erstellen 437 40 9 STS gesicherten Web Service Provider aufrufen nn 438 40 10 Operationen eines Web Services erstellen 440 40 11 P rtnerLinks berschreiben u e en eisen 442 40 12 Web Service in UDDI publizieren 443 40 13 Aktive Web Services anzeigen nn 444 40 14 SOAP Nachrichten protokollieren nenn 445 40 15 Bin rdaten als Attachments mit MTOM bertragen uuusnssensnennssnnnnnennnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnn nenn 446 40 15 1 Nachrichten mit bin ren Attachments versenden nn 446 40 15 2 Nachrichten mit bin ren Attachments empfangen nn 449 40 16 Dialogbeschreib ngen 5 u222 ee a Beni 451 40 16 1 Dialog Bereitgestellter Web Service uummmnnnsnonnnnnannnonnnnnnnnnnnnnnnnnnnonnnnnnnnnannnnnnnnnnnnnnnn nn 451 40 16 2 Dialog Aufzurufender Web Gerice nn 453 40 16 3 Web Service Editor und Register 453 40 16 3 1 Registe
469. rwenden Wildcards Fragezeichen Steht f r genau ein beliebiges Zeichen Asterisk Steht f r Null bis n beliebige Zeichen Die Wildcards k nnen in beliebiger Kombination und H ufigkeit benutzt werden Wenn Wildcards angegeben sind dann holt z B ein Input Connector nur Dateien die dem angegebenen Wert entsprechen alle anderen Dateien werden ignoriert Um alle Dateien zu empfangen geben Sie ein Regul re Ausdr cke Regul re Ausdr cke m ssen in Schr gstriche eingeschlossen werden Z B d d d d d d d qd F r Informationen ber regul re Ausdr cke siehe z B http www perl com doc manual htmi pod perlre html oder http www regular expressions info tutorial html Windows Das Windows Betriebssystem erm glicht es Dateien auszublenden Wenn ausgeblendete Dateien einem Wildcard Kriterium gen gen werden sie auch bertragen Stellen Sie sicher dass die Dateien die Sie im Verzeichnis des Explorers sehen k nnen auch alle Dateien sind die hier enthalten sind Blenden Sie dazu alle Dateien ein im Explorer Optionen Extras Ordneroptionen Inbox Unterverzeichnis nicht beim Output Connector Geben Sie den Verzeichnisnamen an den Sie in rvsEVO unter Inbox angelegt haben und in das die eingehenden Dateien abgelegt werden sollen Der Ordner Inbox ist identisch mit dem Ordner lt rvsEVO installdir gt files inbox auf dem rvsEVO Server Wenn Sie kein a
470. rzeichnis lt iS installdir gt documentation jsdoc index html inubit 6 1 Workbench Process Engine Systemkonnektor Guide 17 Tipps Hinweise und Links in der Dokumentation O A Tipps bieten n tzliche Informationen f r das Arbeiten mit der Software Hinweise sollten Sie unbedingt lesen und beachten Das Nichtbeachten kann den Verlust von Daten oder schwerwiegende Systemprobleme verursachen Verweise auf eine andere Textstelle in der Dokumentation sind mit einem Pfeil gekennzeichnet Links auf Webseiten erkennen Sie an dem nebenstehenden Symbol Weitere Informationen und Support Pressemitteilungen und Whitepapers stehen auf unserer Website www bosch si com f r Sie zum Download bereit F r weitere Informationen ber die Software oder bei Fragen zu ihrem Einsatz nutzen Sie folgende Kontaktm glichkeiten Telefon 49 30 72 61 12 112 SupportSystem https support bosch si com Viel Erfolg beim Arbeiten mit der Software w nscht Ihnen das Team der Bosch Software Innovations GmbH inubit 6 1 Workbench Process Engine Systemkonnektor Guide 05 09 2013 18 05 09 2013 inubit 6 1 Workbench Process Engine Systemkonnektor Guide 19 Des Systemkonnektoren Verwendung Dieser Abschnitt erl utert die folgenden Themen m Dialogbeschreibungen S 19 Systemkonnektoren verbinden Quell bzw Zielapplikationen mit der inubit Process Engine und leiten Nachrichten ohne Transformation durch
471. rzeugten aktualisierten oder gel schten Objekts zur ckgegeben werden sollen 0 Nur die Attribute br id br association und xsi type des bearbeiteten Objekts werden zur ckgegeben 1 Alle Attribute und Properties des bearbeiteten Objekts werden zur ckgegeben 2 n Alle Daten des bearbeiteten Objekts sowie der angegebenen Ebenen unterhalb des bearbeiteten Objekts werden zur ckgegeben 1 wird automatisch gesetzt wenn die Option Komplette Struktur zur ckgeben gew hlt wurde Komplette Struktur zur ckgeben liefert die vollst ndige XML Struktur aller Objekte zur ck inubit 6 1 Workbench Process Engine Systemkonnektor Guide BEY solution Center Logger Si Dieser Abschnitt erl utert die folgenden Themen m Funktionsprinzip S 387 m Eigene Event Typen erstellen S 388 a Dialog SC Logger Einstellungen S 388 Verwendung Erstellen von Ereignisobjekten an bestimmten Stellen einer Process Solution Siehe auch Systemkonnektoren Workbench Process Engine Systemkonnektor Guide Kap 1 S 19 Module anlegen Workbench Benutzer Guide Kap 3 3 S 129 Technical Workflow Diagramme Workbench Benutzer Guide Kap 12 S 311 36 1 Funktionsprinzip Solution Center Logger einf gen Wahrend des Deployments eines Solution Center Prozessmodell BPDs wird beim Generieren des Workflows f r jedes Start Zwischen und Endereignis je ein Solution Center Logger erstellt Nach je
472. s Verfahren ist in Bezug auf den OFTP Connector halb synchron weil die Best tigung versendet wird bevor der OFTP Connector best tigen kann dass die Nachricht auf der inubit Process Engine vorliegt Das L schen beendeter Jobs Nachrichtenempfang muss unterdr ckt werden Einstellung setparm CMDDELETE 0 im rvs Synchrone Ubertragung mit Input Listener Connector Die Empfangsbestatigung wird verschickt wenn sie vollstandig auf der inubit Process Engine eingetroffen ist In der Konfiguration der Nachbarstation muss der Parameter EERP_out auf HOLD IMMEDIATE gesetzt werden Siehe Parameter EERP_out im Abschnitt Nachbarstationen Workbench Process Engine Systemkonnektor Guide Kap 23 6 1 S 237 Der Job Nachrichtenempfang bleibt aktiv bis die Empfangsbest tigung EERP_out gesendet wurde Synchrone bertragung mit Output Connector Setzen Sie beim Konfigurieren des Connectors ein Timeout damit im Fehlerfall keine Blockade durch das Warten entsteht Ber cksichtigen Sie bei dem Wert die Nachrichtengr e und den bertragungsweg Kontrollieren Sie die Konfiguration der Gegenstelle Wenn dort die EERP Nachricht auf hold steht kann es auch zu einer Blockade kommen Siehe OFTP als Listener betreiben Workbench Process Engine Systemkonnektor Guide Kap 23 S 230 Send Job bei erfolgreichem fehlgeschlagenem Senden rvs_is_ send Bevor der Timeout des OFTP Connectors fur das Abholen der EERP Nachricht von mindes
473. s einer Quellapplikation ab sendet sie zur Verarbeitung an einen Input Listener inubit IS Connector und st t damit den Workflow an Am Ende des Workflows legt ein Output Listener inubit IS Connector die Ergebnisdaten in einem Export Verzeichnis ab Ein anderer Thin Client kann diese Daten per Datei Download abholen und diese an die Zielapplikation weiter geben inubit 6 1 Workbench Process Engine Systemkonnektor Guide 05 09 2013 154 inubit IS Connector inubit Process Engine als Client Source inubit BPM Suite oO Target application oe application O 13 2 inubit Process Engine als Client In einer verteilten Umgebung mit mehreren inubit Process Engines kommunizieren diese Uber inubit IS Connectoren miteinander inubit BPM Suite o a Ki ER CX Y Die Abbildung zeigt wie mit Hilfe einer zentralen inubit Process Engine und unter Einsatz aller Typen der inubit IS Connectoren Workflows auf verschiedenen inubit Process Engines ausgef hrt werden k nnen Dabei haben die inubit IS Connectoren abh ngig von ihrer Konfiguration folgende Funktionen 05 09 2013 inubit 6 1 Workbench Process Engine Systemkonnektor Guide inubit IS Connector 155 Dialogbeschreibungen Der Input inubit IS Connector vom Typ Input Listener erh lt von einem Output inubit IS Connector auf einer entfernten inubit Process Engine Daten zur Verarbeitung Der Output Listener inubit IS Connector legt verarbeitete Daten im Export Verze
474. s tomcat storepass inubit 40 8 2 Selbstsigniertes Service Schl sselpaar erstellen Verwendung Zur Authentifizierung eines Clients an einem STS gesicherten Web Service So gehen Sie vor 1 Generieren Sie ein Schl sselpaar mit der SubjectKeyldentifier Erweiterung inubit 6 1 Workbench Process Engine Systemkonnektor Guide 05 09 2013 438 Web Services Connector STS gesicherten Web Service Provider aufrufen Setzen Sie dazu die Optionen gem Ihren Anforderungen openssl req x509 days 9999 nodes newkey rsa 2048 subj C myCountry ST myState L myCity O myOrganization OU myDepartment CN myServerName keyout SecuredService key out SecuredService crt extensions vi Ca 2 Konvertieren Sie das im Schritt 1 generierte Schl sselpaar in das PKCS12 Format um es in den Java Keystore importieren zu k nnen Dabei m ssen Sie ein Passwort vergeben openssl pkcs12 export in SecuredService crt inkey SecuredService key out SecuredService pl2 3 Importieren Sie die PKCS12 Datei in den Java Keystore keytool importkeystore srckeystore SecuredService pl2 srcestoretype pkcs12 srcalias 1 srcstorepass inubit destkeystore SecuredService keystore jks destalias tomcat deststorepass lt yourPassword gt 40 9 STS gesicherten Web Service Provider aufrufen Dieser Abschnitt erl utert wie Sie einen Web Service Consumer konfigurieren damit dieser einen STS gesicherten Web Service Provider auf
475. sage Queue Connector 05 09 2013 a A Lu bernehmen Sie immer den Standard 5 Beim Output Connector hat diese Option keine Auswirkung Nur Nachrichten Header lesen Nur beim Input Connector Option Zeilenweise empfangen ist nicht aktiviert Die Ausgangsnachricht des MQ Connectors enthalt die erste Nachricht der Message Queue Zusatzlich werden die Header Informationen dieser Nachricht als Modulvariablen ausgegeben Option Zeilenweise empfangen ist aktiviert Der MQ Connector liest zeilenweise aus der Message Queue bis zu einer Zeile mit dem String mqsende Die Ausgangsnachricht besteht aus allen Zeilen bis zu diesem String Die Header Informationen werden der Nachricht mit dem String mqsende entnommen Wenn keine der Nachrichten diesen String enth lt dann werden alle Zeilen aller Nachrichten aus der Queue gelesen Die Header Informationen stammen dann aus der letzten Nachricht und die Ausgangsnachricht enth lt alle Zeilen aller Nachrichten aus der Message Queue Zeilenweise empfangen versenden bertr gt die Nachricht zeilenweise dabei wird jede Zeile einer Nachricht als eigene Nachricht behandelt und bertragen Beim Versenden von Nachrichten in diesem Modus ist es wichtig dass die letzte Zeile in der Nachricht der String mqsende ist Dieser String gew hrleistet beim Zeilenweise Empfangen dass nur die erste Nachricht in der Queue bis zum Ende gelesen wird Wenn der String mqse
476. sbeschr nkungen sind g ltig daher ist es z B ein Fehler wenn eine JMS Applikation versucht einen Double Wert als short Wert zu lesen Siehe auch die JMS Spezifikation Version 1 1 Abschnitt Message Selector unter http java sun com products jms docs html Beispiel 21 ABCDEFGH32 345 Besteht aus folgenden drei Feldern Integer 21 String ABCDEFGH Float 32 345 Wenn die Datenstruktur unbekannt ist dann kann die generische Methode readObject verwendet werden um das nachste Objekt im Strom zuruckzugeben Wenn die Datenstruktur bekannt ist dann kann der JMS Client den Objekttyp auf den zugegriffen werden soll angeben MapMessage Der Payload einer MapMessage wird als eine Menge von Name Werte Paaren gespeichert Der Name ist eine Zeichenkette und der Wert ist typisiert Wird verwendet um Schl ssel Werte zu bertragen die sich von einer Nachricht zur anderen ndern k nnen Beispiel NumberOfCopies 5 Dabei ist NumberOfCopies der Schl ssel und 5 der Wert inubit 6 1 Workbench Process Engine Systemkonnektor Guide JMS Connector 193 Dialogbeschreibungen Die Daten werden ber die Methode getMapNames aufgerufen welche ein Java Enumeration Objekt zur ck gibt Mit der Methode hasMoreElements k nnen Sie ber eine MapMessage iterieren Zeichensatzkodierung W hlen Sie eine Kodierung aus der Liste aus Authentifizierung m Anonymer Login Zu markieren wenn der JMS Provider keine Auth
477. sen Sie die inubit Process Engine neu starten Um eine Adabas Datenbank einzusetzen kopieren Sie die Treiberklasse direkt in das Verzeichnis lt inubit installdir gt server JBoss server default lib bzw lt inubit installdir gt server webapps ibis WEB INF 11 9 Benutzer Passwort Eingabe ist abh ngig von Ihrer Datenbank Spezielles Kodierung verwenden Wenn Sie keinen anderen Zeichensatz angeben wird standardm ig UTF8 benutzt Connection Pooling Aktiviert das Connection Pooling Wenn das Connection Pooling aktiviert ist werden physische Verbindungen zu einer Datenbank wiederverwendet Dies beschleunigt die Abarbeitung der Abfragen Die Verbindungen werden nach ihrer Verwendung nicht abgebaut sondern gespeichert und sind fur nachfolgende Zugriffe verfugbar So muss nicht bei jedem Zugriff auf die Datenbank erneut zeitintensiv eine Verbindung aufgebaut werden F r Oracle Datenbanken m ssen Sie die Option Typerkennung Q cachen ebenfalls aktivieren wenn Sie das Connection Pooling aktiviert haben Siehe Typerkennung cachen Workbench Process Engine Systemkonnektor Guide Kap 6 S 86 Der Button Einstellungen ffnet den Dialog Datenbank Connection Pooling Workbench Process Engine Systemkonnektor Guide Kap 6 5 5 S 90 zur Konfiguration des Connection Poolings Spezielle Verbindungsparameter Zum Erstellen von Parametern wie z B Timeouts Anzahl offener Ve
478. sen mit base64 kodiert inubit 6 1 Workbench Process Engine Systemkonnektor Guide 05 09 2013 212 Livelink PDMS Connector Inhalt und Struktur der Eingangs und Ausgangsnachrichten 05 09 2013 inubit 6 1 Workbench Process Engine Systemkonnektor Guide Livelink PDMS Connector Inhalt und Struktur der Eingangs und Ausgangsnachrichten 213 20 2 4 Beispiel f r Eingangsnachricht lt xml version 1 0 encoding utf 8 gt lt LivelinkArchivingConnector gt lt Commands gt lt Command Type CreateIfNotExists DetailedResult true false gt lt Entities gt lt Entity gt lt Type gt siemens ad bereichsarchiv Dk10007R3Lieferung lt Type gt lt Properties gt lt Property lt Property lt Property lt Property lt Property lt Property lt Property lt Property Name ixos bai LinkId gt gss SIXXX0123456789 lt Property gt Name siemens ad bereichsarchiv dokklasse gt 0007 lt Property gt Name siemens ad bereichsarchiv ik_sapsysid gt GS SPEP lt Property gt Name siemens ad bereichsarchiv fk_mandt gt S IX lt Property gt Name siemens ad bereichsarchiv lieferbelnr gt 0123456739 lt Property gt Name siemens ad bereichsarchiv lieferdat gt 9999 12 31 lt Property gt Name siemens ad bereichsarchiv ik_auftraggeber gt GSSPEPS0 lt Property gt Name siemens ad bereichsarchiv erzeugungsdat gt 2008 07 18 lt Property gt lt Properties gt lt Entity gt lt Entities gt lt Condition gt lt and gt
479. sequence Listing Abschnitt 1 von 2 inubit 6 1 Workbench Process Engine Systemkonnektor Guide 05 09 2013 103 104 Database Object Connector Dialogbeschreibungen Listing 15 UPDATE INUBIT DBO SEQUENCES SET SEQUENCE VALUE last insert id SEQUENCE_ VALUE 1 WHERE SEQUENCE TABLE i tablename AND SEQUENCE COLUMN i_ fieldname 6 SET o newid last_insert_id 17 END IF 8 END 19 DELIMITER 20 DROP TABLE IF EXISTS INUBIT DBO SEQUENCES 21 CREATE TABLE INUBIT DBO SEQUENCES 22 SEQUENCE TABLE VARCHAR 64 NOT NULL 23 SEQUENCE COLUMN VARCHAR 64 NOT NULL 24 SEQUENCE VALUE INT 10 UNSIGNED NOT NULL 25 PRIMARY KEY SEQUENCE TABLE SEQUENCE COLUMN 26 ENGINE MyISAM DEFAULT CHARSET latinl Listing Abschnitt 2 von 2 7 6 Dialogbeschreibungen Dieser Abschnitt erlautert die folgenden Themen a Dialog Datenbankeinstellungen S 104 m Dialog Datenbank Connection Pooling S 107 m Dialog DBO Konfigurationsdatei S 107 7 6 1 Dialog Datenbankeinstellungen Datenbankverbindung m Voreinstellung Zur Auswahl einer vorkonfigurierten Datenbank um die
480. sgef hrten nderungen werden r ckg ngig gemacht Fehler berspringen Wenn aktiviert dann werden Datenbankanfragen auch ausgef hrt nachdem ein Fehler aufgetreten ist Werte aus der Query trimmen Bei Werten in Feldern und Bedingungen werden alle vorlaufenden und nachfolgenden Leerzeichen gel scht Leerzeichen innerhalb eines Wertes oder einer Bedingung werden nicht bearbeitet In diesem Dialog legen Sie fest welche Informationen ber die Datenbank ausgegeben werden sollen Diese Metadaten werden als XML Nachricht ausgegeben dabei wird f r jedes Metadatum ein XML Element erzeugt Sie k nnen die Namen dieser Elemente und des Wurzelelements angeben Die Namen m ssen folgenden Regeln entsprechen Namen k nnen Buchstaben Ziffern und andere Zeichen enthalten Namen d rfen nicht mit einer Zahl oder einem Satzzeichen beginnen Namen d rfen nicht mit xml XML Xml etc beginnen Namen d rfen keine Leerzeichen enthalten Wenn ein Name unzul ssig ist dann erh lt das Element den Namen InvalidXmITag Die Metadaten werden als Wert des name Attributs ausgegeben Mit einem Klick auf den Button Vorschau erzeugen erhalten Sie eine Vorschau auf das Ausgabeformat der Metadaten Nur diese Tabelle Standardm ig werden die Daten aller Tabellen im Schema ausgelesen Mit dieser Option k nne Sie das Auslesen der Metadaten auf eine Tabelle beschr nken inubit 6 1 Workbench Process Engine Systemk
481. spartners steht 23 6 1 5 Virtual Virtuelle Nachbarstation Mit einer virtuellen Station kann eine Anwendung oder ein Benutzer konfiguriert werden Wird eine Nachricht f r eine virtuelle Station empfangen wird diese Nachricht lokal an den Benutzer oder das Programm weitergereicht Ebenso kann eine virtuelle Station auch Nachrichten senden Dazu wird die Nachricht vom Benutzer oder Programm an die OFTP Middleware bergeben Diese versendet die Nachricht und tr gt als Absender die virtuelle Station ein Auch inubit 6 1 Workbench Process Engine Systemkonnektor Guide 05 09 2013 244 OFTP Connector Dialog Stationen 23 6 1 6 Routed Station 05 09 2013 virtuelle Stationen sind eindeutig adressierbar da sie die eindeutige Odette ID haben F r Gesch ftspartner stellen sich virtuelle Stationen wie Stationen dar die routed sind Da nur die Odette ID bei einer virtuellen Station wichtig ist k nnen die Felder Name Telefon Bemerkungen mit Daten gef llt werden die f r die Administration wichtig sind wie beispielsweise Name und Telefonnummer des Sachbearbeiters Wenn Sie eine Nachbarstation markieren k nnen Sie aus dem Kontextmen die Option Routed Station hinzuf gen ausw hlen Nachrichten an eine und von einer Routed Station werden von der Nachbarstation weitergeleitet unter der sie angeordnet sind Die konkrete Adresse einer Routed Station ist f r Gesch ftspartner transparent Wenn Sie eine Routed Stat
482. ssen Sie das Passwort f r WY den privaten Schlussel bzw den Keystore eingeben Verbindungstest m Verbindung testen Zum Testen ob die Verbindung mit Ihren Angaben erfolgreich aufgebaut werden kann 11 2 2 Dialog FTP Kommandos ausf hren Nur bei Auswahl von FTP und FTPS inubit 6 1 Workbench Process Engine Systemkonnektor Guide 05 09 2013 138 FTP Connector Dialogbeschreibungen gt In diesem Dialog k nnen Sie einen oder mehrere Befehle angeben die vor oder nach der Datei bertragung ausgef hrt werden sollen Es k nnen z B vor dem bertragen Verzeichnisse angelegt oder Dateien gel scht werden Die Befehle m ssen der standardisierten Syntax entsprechen siehe z B http www networksorcery com enp protocol ftp htm Die Befehle m ssen in Gro buchstaben geschrieben werden Bei mehreren Befehlen steht jeder Befehl in einer eigenen Zeile Verwenden Sie nicht die Befehle delete mkdir get und put Diese Befehle erzeugen Fehler Bei Verzeichniswechsel Wenn Sie sich bei einem FTP Server anmelden wird danach das f r Sie angelegte Home Verzeichnis angezeigt Dies ist blicherweise ein Verzeichnis wie z B ftproot group username Als Benutzer Sehen Sie allerdings nur Ihr Verzeichnis username Einige FTP Server sind so konfiguriert dass beim Wechseln in ein hierarchisch darunter liegendes Verzeichnis absolute Pfadangaben verlangt werden F r den Wechsel in ein Unterverzeichnis ftpro
483. stemkonnektor Guide Kap 24 3 S 253 24 3 Dateniibertragungsmodi Der OFTP2 Connector unterst tzt folgende Daten bertragungsmodi Asynchrone bertragung mit Input Connector Der Input Connector holt die Daten entsprechend der Konfiguration im Dialog Zeitgesteuerte Verarbeitung Workbench Process Engine Systemkonnektor Guide Kap 1 1 3 S 22 rvsEVO sendet eine Best tigung EERP wenn die Verbindung weiter besteht oder beim n chsten Verbindungsaufbau Dies entspricht der Option Normal f r den Parameter EERP_out Siehe Parameter EERP_out im Abschnitt Nachbarstationen Workbench Process Engine Systemkonnektor Guide Kap 24 6 2 S 260 Die Best tigung garantiert dem Absender der Nachricht nicht Q dass die Nachricht auf der inubit Process Engine angekommen ist Achten Sie darauf dass die zul ssige Gr e der Datenbank im Verlauf des Betriebs nicht berschritten wird Wenn Sie mehr Informationen als den Dateinamen erhalten m chten dann m ssen Sie die rvsEVO Konfiguration entsprechend ndern Synchrone bertragung durch rvsEVO mit Input Listener Connector inubit 6 1 Workbench Process Engine Systemkonnektor Guide 05 09 2013 254 OFTP2 Connector rvsEVO Monitoring 24 4 rvsEVO Monitoring 05 09 2013 rvsEVO best tigt per EERP out den Empfang der Nachricht Dieses Verfahren ist in Bezug auf den OFTP2 Connector halb synchron weil die Best tigung versendet wird bevor der OFTP2
484. stf cher Repository gt Global gt System gt Mapping Templates gt Exchange Connector gt Moveltems xsd Jeder Exchange Connector kann auf genau ein Postfach zugreifen um mehrere Postf cher auszulesen verwenden Sie das Variablen Mapping Damit k nnen Sie die Eigenschaft exchange getmails mailbox des Exchange Connectors zum Abholen von Mails dynamisch berschreiben Siehe Workflow Variablen und Mappings Workbench Benutzer Guide Kap 14 S 383 8 3 Dialogbeschreibungen Dieser Abschnitt erl utert die folgenden Themen a Dialog Allgemeine Einstellungen S 112 m Dialog Mails abholen S 112 inubit 6 1 Workbench Process Engine Systemkonnektor Guide 05 09 2013 112 Exchange Connector Dialogbeschreibungen Dialog Eintr ge verschieben S 114 Weitere Aktionen konfigurieren S 114 8 3 1 Dialog Allgemeine Einstellungen Einstellungen 8 3 2 Dialog Mails abholen Aktion Nachrichten abholen 05 09 2013 Dieser Dialog bietet folgende Optionen Dom ne Name der Verwaltungsstruktur im Windows Netzwerk an der Sie sich mit den Zugangsdaten aus den Feldern Benutzer Passwort anmelden m chten CDO Server IP Adresse oder Hostname des Microsoft Windows Servers auf dem Microsoft CDO und J Integra for Exchange installiert sind Exchange Server IP Adresse bzw Hostname des Microsoft Exchange Servers zu dem die Verbindung
485. system Das folgende Listing finden Sie im Repository unter Global gt System gt Mapping Templates gt ITA Archiv Connector gt QueryInsert xmi lt xml version 1 0 encoding UTF 8 gt lt Query type insert gt lt Document maskID 4711 date 2009 03 13T11 45 00 gt lt Representations gt lt Representation description Std rep type ASCII gt lt Part gt lt Data gt MyDocument lt Data gt lt Part gt lt Representation gt lt Representations gt lt Document gt lt Query gt Das folgende Listing zeigt wie Sie beim Einf gen eines Dokumentes Deskriptoren hinzuf gen lt xml version 1 0 encoding UTF 8 gt lt Query type insert gt lt Document maskID 4711 gt lt Descriptors gt lt Descriptor id 1234 gt lt Value type String gt mydoc txt lt Value gt lt Descriptor gt inubit 6 1 Workbench Process Engine Systemkonnektor Guide 05 09 2013 164 ITA Connector Dokumente aus ITA Archivsystem abholen Select lt Descriptor id 2345 gt lt Value type String gt Head lt Value gt lt Descriptor gt lt Descriptor id 3456 gt lt Value type Integer gt 123 lt Value gt lt Descriptor gt lt Descriptor id 4567 gt lt Value type Date gt 2006 09 15 lt Value gt lt Descriptor gt lt Descriptors gt lt Representations gt lt Representation type ASCII description Invoice gt
486. t lt query gt lt query type delete gt lt tables gt lt table gt lt tableNames gt lt tableName gt eins lt tableName gt lt tableNames gt lt table gt lt tables gt lt query gt lt queries gt inubit 6 1 Workbench Process Engine Systemkonnektor Guide 05 09 2013 77 78 Database Connector XML Querys Struktur und Beispiele 6 4 10 SQL Statements direkt bergeben Force XMLQuery 05 09 2013 lt xml version 1 0 encoding ISO 8859 1 gt lt xsl stylesheet xmlns xsl http www w3 org 1999 XSL Transform version 1 0 gt lt xsl output method xml encoding ISO 8859 1 gt lt xsl template match gt lt queries gt lt query type select properties force gt lt value gt create table trade user id user NUMBER 20 0 PRIMARY KEY since user NUMBER 15 0 lastlogin_ user NUMBER 15 0 sex user NUMBER 1 0 language _ user VARCHAR2 5 title user VARCHAR2 4000 firstname user VARCHAR2 200 lastname_user VARCHAR2 200 company user NUMBER 20 0 function user VARCHAR2 4000 street user VARCHAR2 4000 zip_ user VARCHAR2 4000 land_user VARCHAR2 4000 city_ user VARCHAR2 4000 phone user VARCHAR2 4000 mobile user VARCHAR2 4000 fax_user VARCHAR2 4000 email user VARCHAR2 200 NOT NULL UNIQUE web user VARCHAR2 4000 via user VARCHAR2 4000 enable user NUMBER 2 0 comment user VARCHAR2 4000 abbo_news user NUMBER 1 0 abbo mail us
487. t Frankfurt Main d PLZ 60000 G Rechnungsadresse land DE bo ObjectId 245 iG Ko tar Bitte mit Geschenkverpackung E G Waren bo Objectid 246 G Buch ISBN 3776622148 bo ObjectId 247 D Buch ISBN 3551551677 bo ObjectId 248 Titel Harry Potter und der Stein der Weisen Anzahl 1 g PreisEUR 29 9 GP Lieferdatum 2010 09 04 5 3 Querymodus verwenden Dieser Abschnitt erl utert die folgenden Themen Unterst tzte Query Attribute Workbench Process Engine Systemkonnektor Guide Kap 5 S 53 Im Querymodus werden die Operationen ausgef hrt die in der Eingangsnachricht des BO Connectors definiert sind inubit 6 1 Workbench Process Engine Systemkonnektor Guide 05 09 2013 52 Business Object Connector Querymodus verwenden Pfad des Mapping Templates Operationen definieren Beispiel f r Eingangsnachricht 05 09 2013 Zum Erstellen der Eingangsnachricht ben tigen Sie einen XSLT Converter Der XSLT Converter erstellt die Eingangsnachricht auf Basis eines Mapping Templates und bergibt diese an den BO Connector Das Mapping Template finden Sie im Repository unter Global gt System gt Mapping Templates gt Business Object Connector gt BO Queries xml In jeder Eingangsnachricht k nnen mehrere Operationen definiert werden auch Operationen mit unterschiedlichen Typen wie z B CREATE und DELETE Die Operation
488. t es existiert kein Timeout inubit 6 1 Workbench Process Engine Systemkonnektor Guide 05 09 2013 248 OFTP Connector Dialog Stationen Aktiv Die unter LOC konfigurierten Empf nger werden mit dieser Checkbox aktiviert 23 6 2 3 TCP IP Empf nger konfigurieren IP Adresse Geben Sie die IP Adresse oder den Rechnernamen Ihres ISDN Routers an Port Geben Sie die Portnummer an ber die Nachrichten empfangen werden Max Eingangssessions Maximale Anzahl von parallelen Eingangssessions mit 1 wird auf den globalen Wert des Parameters MAXSESSIONS zugegriffen Max Ausgangssessions Maximale Anzahl von parallelen Ausgangssessions mit 1 wird auf den globalen Wert des Parameters MAXSESSIONS zugegriffen Aktiv Die unter LOC konfigurierten Empf nger werden mit dieser Checkbox aktiviert 23 6 2 4 SNA LU6 2 Empf nger konfigurieren 05 09 2013 Mit der Logical Unit LU Type 6 2 kann der parallele Aufbau von Verbindungen einer einzelnen Logical Unit zu mehreren Anwendungsprogrammen erreicht werden VectorPosition Ein Datensegment in einer SNA Message wird auch als Vektor bezeichnet Ein SNA Vektor besteht aus einem L ngenfeld einem Typfeld und vektorspezifischen Daten Der Standardwert ist 2 LU Name Name der Logischen Einheit logical unit LU Netzwerk ID Die Netzwerk ID auch NETID spezifiziert ein SNA Netzwerk Es ist eine ein bis achtstellige alphanumerische Zeichenkette TP
489. t ob die Empfangsbest tigung erfolgreich versendet wurde erst dann kann die Verbindung geschlossen werden HOLD Die Empfangsbest tigung wird erst gesendet wenn sie explizit von einem Operator in der rvsEVO Installation freigegeben wurde Besteht die Verbindung noch so wird die Empfangsbest tigung sofort gesendet Wenn die aktuelle Verbindung bereits abgebaut wurde wird die Empfangsbest tigung gesendet wenn das n chste Mal eine Verbindung erstellt wurde Der OFTP2 Connector erteilt die Freigabe f r die rvsEVO Installation selbst ndig es ist keine Interaktion eines Operators erforderlich RoutingSync Die OFTP2 Session zwischen dem Router und dem Sender wird so lange aufrecht erhalten bis die Empfangsbest tigung vom Empf nger angekommen ist um diese dann in derselben OFTP2 Session an den Sender zur ckzusenden Neighbour Station Name Telefon Bemerkungen und Netzwerk sind optionale Felder Geben Sie hier an wer die Konfiguration der Nachbarstationen pflegt Line Type Autodial Wenn diese Option ausgew hlt ist baut rvsEVO automatisch eine Verbindung auf wenn eine Nachricht zu senden ist Parallele Session Der Standard ist 1 Sicherheit OFTP Version Dieser Parameter muss nur gesetzt werden wenn der Partner nicht in der Lage ist die Protokollversion auszuhandeln SFIDDESC als Dateiname Start File ID Description Wird anstatt VDSN als Dateiname f r die bertragung verwend
490. t 8000 ibis rest sqlshop orders Auftrag mit der Nr 1234 host 8000 ibis rest sqlshop orders 1234 http local inubit 6 1 Workbench Process Engine Systemkonnektor Guide REST Connector 291 REST Funktionsprinzip Repr sentationen Jede Ressource kann verschiedene Repr sentationen haben d h der Kunde kann z B durch eine XML Struktur mit den Kundenstammdaten oder durch eine Visitenkarte im vcard Format repr sentiert sein Zwischen Client und Server muss ein gemeinsames Verst ndnis ber die Bedeutung der Repr sentation durch die Verwendung von XML vorhanden sein Repr sentationen k nnen auf weitere Ressourcen verweisen die ihrerseits wieder Repr sentationen liefern die wiederum auf Ressourcen verweisen k nnen Wenn ein Client einem Link in einer Repr sentation folgt gelangt er zu einer anderen Ressource Beispiele f r Reprasentationen Repr sentation eines Kunden durch seine Stammdaten lt CUSTOMER gt lt ID gt 4 lt ID gt lt FIRSTNAME gt Heinz lt FIRSTNAME gt lt LASTNAME gt Mustermann lt LASTNAME gt lt STREET gt Musterstra e 13 lt STREET gt lt CITY gt Musterstadt lt CITY gt lt CUSTOMER gt T Repr sentation einer Kundenliste mit Verlinkungen auf die einzelnen Kunden als weitere Ressourcen lt CUSTOMERList gt
491. t Service Request und Token Al 5 6 Sendet Service Response Service Consumer Service Provider Die Absicherung der Kommunikation zwischen Service Consumer und Provider ber einen STS funktioniert folgenderma en 1 Service Provider bietet Web Service an und nutzt STS Der Service Provider bietet eine Dienstleistung Uber einen Web Service an Der Web Service ist Uber einen STS gesichert Ein Web Service Aufruf ist nur zul ssig wenn der Aufruf ein g ltiges Token des STS enth lt Wenn der Provider eine Anfrage von einem Consumer erh lt dann wird zuerst die G ltigkeit des Tokens gepr ft Je nach Typ des Tokens pr ft der Provider die G ltigkeit ber Zertifikate 05 09 2013 inubit 6 1 Workbench Process Engine Systemkonnektor Guide Security Token Service Connector 351 Funktionsprinzip des STS Connectors 2 Service Consumer m chte Service nutzen Um den Service aufrufen zu k nnen ben tigt der Consumer dessen Interface Beschreibung die so genannte WSDL Datei Diese WSDL Datei kann er direkt von dem Service Provider oder von einem Verzeichnisdienst wie UDDI anfordern In der WSDL Datei sind die Sicherheitsanforderungen beschrieben die der Consumer erf llen muss um den Dienst nutzen zu k nnen Unter anderem ist angegeben gegen ber welchem STS sich der Consumer authentifizieren muss Da der Consumer nun die Adresse des STS kennt kann er diesen aufrufen und sich dort authentifizieren 3 STS Provider pr ft
492. t condition type AND gt lt leftValue gt status lt leftValue gt lt operation gt lt operation gt lt rightValue gt F lt rightValue gt lt condition gt lt conditions gt lt table gt lt tables gt 6 4 12 Stored Procedures aufrufen Call XML SQL In einer Stored Procedure k nnen ganze Abl ufe von Anweisungen unter einem Namen gespeichert auf dem Datenbankserver zur Verf gung gestellt und ausgef hrt werden Das folgende Beispiel illustriert den Aufruf von Stored Procedures mit Hilfe des Elements lt method name NAME gt mit und ohne Parameter bergabe lt xml version 1 0 encoding ISO 8859 1 gt lt xsl stylesheet xmins xsl http www w3 org 1999 XSL Transform version 1 0 gt inubit 6 1 Workbench Process Engine Systemkonnektor Guide 05 09 2013 82 Database Connector XML Querys Struktur und Beispiele lt xsl output method xml1 encoding ISO 8859 1 gt lt xsl template match gt lt queries gt lt query type call gt lt method name TESTPROC_WITHOUTPARAM gt lt query gt lt query type call gt lt method name TESTPROC_IN gt lt parameter direction IN type DECIMAL gt 2 lt parameter gt lt method gt lt query gt lt query type call gt lt method name TESTPROC OUT gt lt parameter direction OUT type VARCHAR gt lt method gt lt query gt lt query type call gt lt method name
493. t das Ergebnis als SOAP Response an den Servicekonsumenten zur ck Web Services ber UDDI Alternativ k nnen Sie einen Web Service auch ber ein Service anbieten abrufen Verzeichnis UDDI anbieten abrufen Servicebroker Servicekonsument SOAP oder XML Serviceanbieter Ein Serviceanbieter ver ffentlicht die Beschreibungen seines Web Services als WSDL Datei in einer UDDI a Die WSDL Datei beschreibt die Operationen Daten und Austauschprotokolle die der Web Service anbietet Diese Informationen sind maschinenlesbar Die UDDI fungiert als Servicebroker und erm glicht es Servicekonsumenten Web Services zu finden Ein Servicekonsument 1 durchsucht die UDDI und w hlt den gew nschten Web Service aus 2 wird dynamisch an den Serviceanbieter gebunden 3 erstellt auf Basis der Informationen aus der WSDL Datei einen SOAP Request um damit auf eine Operation zuzugreifen die der Web Service bietet Der Web Service bearbeitet den SOAP Request und sendet das Ergebnis als SOAP Response an den Servicekonsumenten zur ck inubit 6 1 Workbench Process Engine Systemkonnektor Guide 05 09 2013 416 Web Services Connector Modulvariablen des Web Services Connectors 40 2 Modulvariablen des Web Services Connectors 40 2 1 Web Services Input Listener Connector Ein Web Services Input Listener Connector setzt folgende Modulvariablen Name Erl uterung httpheader request SOAPAction Zweck des Requests
494. t definiert Der Konnektor erwartet dann eine Eingangsnachricht im XML Format mit folgender Struktur lt PKCS7 gt lt Content gt Inhalt von ABC txt base64 kodiert lt Content gt lt Signature gt Inhalt von ABC txt p7s base64 kodiert lt Signature gt lt PKCS7 gt Eingangsdatenkonfiguration Fur die korrekte Verarbeitung m ssen Sie angeben wie die Eingangsnachrichten vorliegen Bin rdaten Zum Einlesen von bin ren Eingangsdokumenten z B von PDF Dateien Base64 Zu markieren wenn die Eingangsdokumente base64 kodiert vorliegen weil sie z B aus XML extrahiert wurden Signiertes MIME nur im Modus Pr fen Zu markieren wenn es sich bei den Eingangsdaten um signierte MIME Nachrichten gem RFC 1847 handelt XML Zum Einlesen von Eingangsdokumenten die in XML Dateien eingebettet sind Geben Sie den XPath zu dem XML Knoten an der das Dokument enth lt Alternativ nutzen Sie die Schaltfl che XML Knoten ausw hlen um zu diesem Knoten im XML Dokument zu navigieren Ausgangsdatenkonfiguration Die folgenden Optionen werden nur beim Signieren von Eingangsdokumenten angezeigt F r die korrekte Verarbeitung m ssen Sie angeben wie die signierten Dokumente ausgegeben werden sollen Bin rdaten Gibt das Eingangsdokument bin r aus Base64 Gibt die Eingangsdokumente base64 kodiert aus XML Bettet die Eingangsdokumente in eine XML Datei ein in
495. t einem der mitgelieferten Templates in einem XSLT Converter den Sie mit den Exchange Connector verbinden inubit 6 1 Workbench Process Engine Systemkonnektor Guide Aktion Exchange Connector 111 Dialogbeschreibungen Die folgende Tabelle gibt f r jede Aktion an ob ein Template n tig ist und wenn ja welches Template Mails abholen Keine Eingangsnachricht Mails versenden E Mails m ssen in einem g ltigen MIME Format vorliegen Repository gt Global gt System gt Mapping Templates gt MIME Adapter Template f r IBISMIME Format Postf cher auslesen Keine Eingangsnachricht Aufgaben abholen erstellen Repository gt Global gt System gt Mapping Templates gt Exchange Connector GetTasks xsd bzw CreateTasks xsd Kontakte auslesen anlegen Repository gt Global gt System gt Mapping Templates gt Exchange Connector GetContacts xsd bzw CreateContacts xsd Verf gbarkeit abfragen Repository unter Global gt System gt Mapping Templates gt Exchange Connector gt GetFreeBusy xsd Kalendereintr ge abholen Termine anlegen Repository gt Global gt System gt Mapping Templates gt Exchange Connector GetAppointments xsd bzw CreateAppointments xds Eintr ge l schen Repository gt Global gt System gt Mapping Templates gt Exchange Connector gt Deleteltems xsd Eintr ge verschieben Zugriff auf mehrere Po
496. ta archive Umgebungsvariablen Execution Connector Eigenschaften Systemvariablen an Prozess bergeben Skript bin sh if d 17 the mkdir 1 cat Verwendung der Ein und Ausgabenachrichten Eingabenachricht verwenden Ausgabenachricht verwenden Fehlerausgang verwenden Eras A Puffergr e f rdieEingabenachricht _ R ckgabewert als XML zur ckliefern _ Tee 9 4 Dialog Execution Connector Eigenschaften In diesem Dialog konfigurieren Sie den Aufruf der externen Applikation Externer Befehl m Befehl Pfad und Name der aufzurufenden Applikation 05 09 2013 inubit 6 1 Workbench Process Engine Systemkonnektor Guide Execution Connector 119 Dialog Execution Connector Eigenschaften Die aufzurufende Applikation muss auf demselben Rechner installiert sein wie der Applikationsserver JBoss Tomcat Der Pfad kann relativ zum Applikationsserver oder absolut angegeben werden Nicht termininierende Befehle gef hrden die Stabilit t der A inubit Process Engine Beispiel cmd ohne C zum Beenden des Befehls nach der Ausf hrung Parameter Parameter mit denen die externe Applikation aufgerufen werden soll Mehrere Argumente trennen Sie durch Leerzeichen ber den Button rechts neben dem Argumente Feld k nnen Sie folgende Platzhalter eingeben File Um die Eingangsnachricht als tempor re Datei an die aufgerufe
497. teiname die erste Zahl ist das Datum im Format ddmmyyyy die Zahl hinter dem Bindestrich gibt die Zeit in Format hhmmss an Zeitstempel Der Zeitstempel ist genauso angelegt wie der Datumsstempel siehe oben Es wird dazu noch eine Angabe in Millisekunden hinzugef gt Wenn Sie den Dateinamen folgenderma en angegeben file TimeStamp ddMMyyyy HHmmss SSS xml entsteht beispielsweise der folgende Dateiname als Name der Ausgabedatei file 12122012 151304 027 xml Die dreistellige letzte Zahl gibt die Millisekunden an Prozess ID Die Prozess ID ist die eindeutige Zahl die f r eine Workflow Ausf hrung angelegt wird Um der Ausgabedatei die Prozess ID der Workflow Ausf hrung mitzugeben geben Sie den Dateinamen im folgenden Format an file PID_ ProcessId xml Es entsteht z B der folgende Dateiname als Name der Ausgabedatei file PID_18 xml In Verbindung mit Fehlende Verzeichnisse erzeugen k nnen Sie z B tages oder monatsbezogene Archivstrukturen f r Nachrichten anlegen Erzeuge fehlende Verzeichnisse Erzeugt alle nicht existierenden Verzeichnisse aus der Pfadangabe Datei nur bei Eingangsformat Daten Name Auch im Dateinamen k nnen Sie Wildcards verwenden und Zeitstempel sowie Prozess ID einf gen lassen siehe Option Verzeichnis gt Name inubit 6 1 Workbench Process Engine Systemkonnektor Guide File Connector 131 Dialogbeschreibungen Wildcard Inhalt des vorher a
498. ten XSLT Converter 8 E R A Q XSLT Stylesheet RequestGen XML Quelle XML Ziel amp x 1 stylesheet http www w3 org 1999 XSL Transform ig xsl http www w3 org 200 1 XMLSchema daR xs 2 0 a version H xsl output method xml encoding UTF 8 Sf E A xs1 template 3 6 isns Envelope http schemas xmlsoap org soap envelope d i isns CH isns Header CH oa isns Body http 192 168 0 223 8000 ibis ws 1296231490009 ProvideWebService d wer gt Comment gt wsc SayHello Say Hello input of operation SayHello 16 B GB Quelvariabien Wert 4 13 t B R Q Web Services Explorer targetNamespace isns http schemas xmlsoap org soap envelope L Ka Dieser Dialog zeigt alle Schema Elemente an Die Struktur entspricht der Instanz weiche das XML Schema abbilden soll Um die interne Schemastruktur anzuzeigen wechseln Sie in die Baum Ansicht isns Envelope 1 1c E isns Header 1 E Ke 1 1c B Name Typ usyaq eag nn pam EN h Publizieren Sie den XSLT Eemeren 3 Testen a Setzen Sie im Technical Workflow einen Startpunkt an den XSLT Converter und w hlen Sie im Kontextmen Test ohne Datei starten b ffnen Sie nach dem Test den Watchpoint hinter dem Web Services Connector um das Ergebnis die SOAP Response anzuzeigen Um dynamische Web Service Aufrufe zu erzeugen f gen Sie vor dem XSLT Converter weitere M
499. ten Meist nicht angegeben Wenn Sie Facilities und Benutzerdaten angeben m chten dann als HEX Code Die Daten werden nur f r X 25 ber ISDN bertragungen ben tigt wenn Ihr X 25 Provider dies fordert 23 6 1 4 Nachbarstation ber X 25 05 09 2013 Terminal Kennung Auch Terminal ID genannt Eindeutige Nummer Ihres ISDN Endger ts X 25 ist ein internationaler Telekommunikationsstandard der von der Internationalen Fernmeldeunion verabschiedet wurde Weitere Informationen finden Sie unter www itu int X 25 Adresse Jeder Rechner der in einem X 25 Netzwerk kommunizieren soll muss eine X 25 konforme Adresse haben Eine X 25 Adresse ist eine Folge von Ziffern Die ersten Ziffern geben den L ndercode an die darauffolgenden Ziffern bestimmen das Netzwerk innerhalb des Landes und die letzten Ziffern die Rechnernummer Unteradresse Wenn unter einem Anschluss mehrere Rechner existieren Subnetz dann bestimmen die letzten drei Ziffern der X 25 Adresse den Rechner im Subnetz Facilities Meist nicht angegeben Benutzerdaten Meist nicht angegeben inubit 6 1 Workbench Process Engine Systemkonnektor Guide OFTP Connector 243 Dialog Stationen Wenn Sie Facilities und Benutzerdaten angeben m chten WY dann als HEX Code Die Daten werden nur f r X 25 ber ISDN bertragungen ben tigt wenn Ihr X 25 Provider dies fordert Timeout Zeit in Sekunden nach welcher der Versuch eine
500. ten Objektdaten beim Er zeugen Aktualisieren oder L schen eines Objektes 05 09 2013 inubit 6 1 Workbench Process Engine Systemkonnektor Guide Solution Center Connector 373 Objekt XML Daten erzeugen Name Erl uterung OutputDepth Anzahl der zuruckgegebenen Knotenebenen 35 3 Objekt XML Daten erzeugen Beim Erstellen eines Business Object Diagramms BOD generiert die inubit Software automatisch ein XSD Schema des Diagramms und speichert es im Repository Ordner SolutionCenter BODSchemas des Benutzers der das BOD erstellt hat Diese Schemas k nnen Sie nutzen um mit einem XSLT Converter eine Eingangsnachricht zum Erzeugen oder Aktualisieren eines Objekts zu erstellen 35 4 Verwenden von XPath Anfragen Verwendung Flexibler Zugriff auf Daten einer Business Solution oder Process Solution im Solution Center Aufruf XPath Abfrage ber den Solution Center Connector Setzen Sie die Parameter auf dem Register SC Connector Einstellungen XPath Geben Sie den XPath direkt in das Feld XPath ein oder w hlen Sie den gew nschten Knoten aus Der korrekte XPath wird automatisch in das XPath Feld eingetragen Kontextknoten verwenden Knoten ID Optional w hlen Sie einen Kontextknoten aus Die Knoten ID wird automatisch eingetragen Die XPath Abfrage wird ab diesem Knoten ausgef hrt XPath Abfrage ber die Moduleigenschaften des Solution Center Connectors Konfigurieren Sie den Solution Center Connector inubit 6
501. ten Queuing Server konfigurieren Zugriff auf JMS basierten Queuing Server konfigurieren m JMS Connector in Entry Standard oder Professional Edition einsetzen S 189 a JMS Connector in Enterprise Enterprise Plus Edition mit beliebigem JMS basierten Queuing Server einsetzen S 190 bersicht F r den Einsatz des JMS Connectors ben tigen Sie einen JMS basierten Applikationsserver mit Queuing Schnittstelle wie z B den integrierten JBoss der inubit Enterprise Edition Wie Sie den Zugriff auf diesen JMS basierten Applikationsserver konfigurieren h ngt davon ab welche inubit Edition Sie nutzen 05 09 2013 JMS Client iS n Tun ibis_jboss_provider jar _ provider jar JMS Provider JMS Provider JMS Client iS provider jar inubit Process Engine mit Tomcat Entry Standard oder Professional Edition Sie k nnen den JBoss Applikationsserver einer entfernten Enterprise oder Enterprise Plus Edition oder einen beliebigen anderen JMS basierten Queuing Server nutzen In beiden F llen ben tigen Sie eine zus tzliche jar Datei als Kommunikationsbr cke Siehe JMS Connector in Entry Standard oder Professional Edition einsetzen Workbench Process Engine Systemkonnektor Guide Kap 18 1 1 S 189 inubit Process Engine mit JBoss Enterprise oder Enterprise Plus Edition inubit 6 1 Workbench Process Engine Systemkonnektor Guide JMS Connector Zugriff auf JMS basierten Queuing
502. ten als Inhalt eines Elements vom Typ xsd base64binary enthalten sein m ssen Ef Siehe http www w3 org TR 2005 REC soap12 mtom 20050125 40 15 1 Nachrichten mit bin ren Attachments versenden 05 09 2013 Sie k nnen Bin rdaten mit MTOM als Anh nge von SOAP Nachrichten versenden Bei einem Medium Output Connector erfolgt der Versand innerhalb der ausgehenden Nachricht inubit 6 1 Workbench Process Engine Systemkonnektor Guide Web Services Connector 447 Bin rdaten als Attachments mit MTOM bertragen Bei einem Input Listener Connector erfolgt der Versand innerhalb der Response als Ausgangsnachricht Bei einem Input Listener Connector der mit dem Metro Q Framework d h nicht im Kompatibilit tsmodus betrieben wird wird die Antwort nur dann MTOM kodiert wenn der Web Service Consumer seine MTOM Unterst tzung explizit signalisiert hat Der Web Service Consumer kann seine Unterst tzung durch das Senden eines MTOM Requests signalisieren oder indem im Accept HTTP Header der Eintrag application xop xml hinzugef gt wird Falls Sie den Input Listener mit einem Medium Output Connector der inubit Software aufrufen und eine MTOM kodierte Antwort erwarten m ssen Sie bei dem Medium Output Connector die Option MTOM Anh nge f r Antwort Nachricht aktivieren markieren Die Option finden Sie Register Erweitert Workbench Process Engine Systemkonnektor Guide Kap 40 16 3 5 S 457 Wenn d
503. tennamen nicht den Konventionen von XML Elementen entsprechen werden die Elemente mit InvalidXmITag angelegt und der Spaltenname wird als Wert des Attributs Name ausgegeben inubit 6 1 Workbench Process Engine Systemkonnektor Guide 05 09 2013 90 Database Connector Dialogbeschreibungen Vorschau Benutzerdefiniert Alternativ konnen Sie zur Ausgabe eine Java Klasse nutzen welche das SQL Ergebnis nach XML umformt Geben Sie den kompletten Namen ein Die Java Klasse muss das Interface com inubit ibis utils query ResultSetOutput im SDK enthalten implementieren Zeilennummer Wenn markiert dann wird bei den Elementen ROW und COLUMN das Attribut ID mit dem Wert der jeweiligen laufenden Nummer ausgegeben 2 B lt ResultSet gt lt Row id 1 gt lt Column id 1 gt Name lt Column gt lt Column id 2 gt Street lt Column gt lt Row gt Mit einem Klick auf den Button Vorschau erzeugen erhalten Sie eine Vorschau auf das Ausgabeformat der Query 6 5 5 Dialog Datenbank Connection Pooling Lu Verbindungspooling 05 09 2013 In diesem Dialog konfigurieren Sie das Connection Pooling Wenn das Connection Pooling aktiviert ist werden physische Verbindungen zu einer Datenbank wiederverwendet Dies beschleunigt die Abarbeitung der Abfragen Die Verbindungen werden nach ihrer Verwendung nicht abgebaut sondern gespeichert und sind f r nachfolgende Zugriffe verf gbar So muss nicht
504. tens 60 Sekunden ablauft aktiviert der OFTP Connector die Partnerstation und versucht die EERP Nachricht abzuholen Erst wenn dies fehlschl gt gilt das Senden als fehlgeschlagen So wird ausgeschlossen dass eine Nachricht die korrekt Ubertragen wurde als fehlerhaft angesehen und erneut gesendet wird weil die EERP Nachricht wegen einer Unterbrechung der Verbindung nicht abgeholt werden konnte inubit 6 1 Workbench Process Engine Systemkonnektor Guide OFTP Connector 233 rvs Monitoring 23 4 rvs Monitoring Mit dem Kommandozeilentool StartCLI k nnen Sie u a die Verbindung der inubit Process Engine mit dem rvs Server pr fen Optionen Option Information ae Verbindung der inubit Process Engine mit dem rvs Server pr fen rhost rvs Host rlogin rvs Login rmwname Name der rvs Middleware rpassword rvs Passwort Siehe Remote berwachung mit Command Line Interface StartCLI Process Engine Administrator und Entwickler Guide Kap 7 10 S 117 23 5 Dialog OFTP Datenaustausch Konfiguration Der Dialog zur Datenaustausch Konfiguration unterscheidet sich fur die verschiedenen Konnektortypen Grundeinstellungen m Middleware Serveradresse Geben Sie hier die Rechnernamen oder die IP Nummer an beispielsweise MyServer oder 123 456 7 8 Bei der Eingabe m ssen Sie die Anf hrungsstriche weg lassen Wenn die RMI Registry nicht auf Port 1099 l uft geben Sie die Portnummer a
505. tifizierungsinformationen mitzugeben SSL ffnet einen Dialog in dem Sie die Daten f r eine sichere Verbindung angeben Aus UDDI ermitteln Um den Web Service ber den UDDI Browser zu suchen und zu laden Publizierte Services anzeigen ffnet eine Webseite mit einer Liste aller aktiven Web Services der inubit Process Engine UDDI Falls die WSDL Datei in einer UDDI publiziert ist w hlen Sie die Option UDDI und klicken Sie auf UDDI Aufruf konfigurieren um den UDDI Browser zu ffnen Siehe Dialog UDDI Browser Workbench Process Engine Systemkonnektor Guide Kap 40 16 5 S 466 WSDL Datei laden L dt die angegebene WSDL in den Konnektor und zeigt sie an Editor WSDL In diesem Bereich wird die geladene WSDL angezeigt Sie k nnen diese bearbeiten speichern und durchsuchen inubit 6 1 Workbench Process Engine Systemkonnektor Guide 05 09 2013 456 Web Services Connector Dialogbeschreibungen Web Service Authentifizierung erforderlich Lu Antwort asynchron empfangen separate Antwort Adresse 05 09 2013 mitschicken Service Port Name und Port des aufzurufenden Web Services der aus der Liste ausgew hlt wurde Adresse Eine WSDL Datei kann mehr als eine Adresse enthalten W hlen Sie die Adresse aus unter welcher der Web Service aufgerufen werden soll Button SSL ffnet den Dialog SSL Konfiguration Workbench Process Engine Systemkonnektor Guide
506. tig einteilen H Anzahl 1 G PreisEUR 29 90 Kommentar Bitte Liefertermin bis Weihnachten best tigen va Buch ISBN 3551551677 Reggie ae Ai ege mea ae oy in inubit 6 1 Workbench Process Engine Systemkonnektor Guide 05 09 2013 50 Business Object Connector Objektmodus verwenden Beispiel f r Ausgangsnachricht Sg In diesem Dialog werden die Nachricht oben und die aktuell vorhandenen Workflow Variablen unten angezeigt Sie k nnen die Nachricht und die Workflow Variablen speichern um diese in weiteren Tests wiederzuverwenden a BD Nachricht HBAR Bestellung bestelldatum 20 10 10 26 bo ObjectId 303 xmins bo http inubit com bo Ela Lieferadresse land DE bo ObjectId 304 9 Name Alice Schmid 9 Stra e Walnussgasse 42 Ort Frankfurt Main PLZ 60000 Ela Rechnungsadresse land DE bo ObjectId 305 gt Name Robert Schmid 9 Stra e Haselnussweg 3 S Ort Frankfurt Main PLZ 61240 9 Kommentar Bitte mit Geschenkverpackung Ela Waren bo ObjectId 306 Ela Buch ISBN 3776622148 bo ObjectId 307 9 Titel Vom Gl ck der Faulheit Lebensenergie richtig einteilen 9 Anzahl 1 9 PreisEUR 29 90 gt Kommentar Bitte Liefertermin bis Weihnachten best tigen gea Buch ISBN 3551551677 bo ObjectId 308 at N ET 5 2 2 Read Operationen Bei Read Operationen erwartet der BO Connector als Eingangsnachri
507. tigt der BO Connector ein XML Schema in dem die Strukturen und Beziehungen der XML basierten Gesch ftsobjekte beschrieben sind Das XML Schema kann entweder ber das HTTP Protokoll angesprochen oder im Repository gespeichert werden Beim ersten Hinzuf gen eines Gesch ftsobjekte werden Tabellen f r das Gesch ftsobjekte entsprechend dem XML Schema in der Datenbank erzeugt inubit 6 1 Workbench Process Engine Systemkonnektor Guide 05 09 2013 48 Business Object Connector Objektmodus verwenden Objekt und Querymodus Objekt Identifikatoren Sie k nnen den BO Connector in folgenden Modi nutzen Objektmodus Die auszuf hrende Operation wird im BO Connector festgelegt Das Gesch ftsobjekte kann direkt als komplexes XML Element an den BO Connector bergeben werden Siehe Objektmodus verwenden Workbench Process Engine Systemkonnektor Guide Kap 5 2 S 48 Querymodus Im Querymodus k nnen Sie bei jeder Ausf hrung des Konnektors mehrere und unterschiedliche Typen von Operationen ausf hren lassen Die auszuf hrenden Operationen sind in der Eingangsnachricht des Konnektors definiert Siehe Querymodus verwenden Workbench Process Engine Systemkonnektor Guide Kap 5 3 S 51 Mit dem Objekt Identifikator wird das gew nschte Gesch ftsobjekt in der Datenbank adressiert 5 2 _ Objektmodus verwenden berblick 05 09 2013 Create Update Delete Operationen S 49 Read Operationen S 50
508. tiviert X 25 Geschlossene Benutzergruppe ISDN und X 25 bieten die M glichkeit eine geschlossene Benutzergruppe zu bilden Alle Teilnehmer die zu einer solchen Gruppe geh ren k nnen untereinander ber das ffentliche Telekommunikationsnetz kommunizieren Verbindungsanforderungen an Gruppenmitglieder von Teilnehmern die nicht Mitglied der geschlossenen Benutzergruppe sind werden von der Vermittlungsstelle abgewiesen Standard deaktiviert XOT steht f r X 25 over TCP X 25 ist ein internationaler Telekommunikationsstandard der von der Internationalen Fernmeldeunion verabschiedet wurde Siehe XOT Empf nger konfigurieren Workbench Process Engine Systemkonnektor Guide Kap 24 6 3 3 S 269 Weitere Informationen finden Sie unter http www itu int m X 25 Adresse Jeder Rechner der in einem X 25 Netzwerk kommunizieren soll muss eine X 25 konforme Adresse haben Eine X 25 Adresse ist eine Folge von Ziffern Die ersten Ziffern geben den Landercode an die darauffolgenden Ziffern bestimmen das Netzwerk innerhalb des Landes und die letzten Ziffern die Rechnernummer X 25 Facilities Meist nicht angegeben X 25 Benutzerdaten Meist nicht angegeben inubit 6 1 Workbench Process Engine Systemkonnektor Guide 24 6 2 4 Virtuelle Station Verwendung Pflichtparameter OFTP2 Connector 265 Dialog Stationen Wenn Sie Facilities und Benutzerdaten angeben m chten dann als HEX Code
509. tput Connector PUT Schreibt die Nachricht in die angegebene Message Queue Sicherheit m UserlD Benutzerkennung zur Authentifizierung beim WebSphere MQ Server Passwort Zur angegebenen Benutzerkennung geh riges Passwort Nachrichtenkonfiguration m Priorit t Standard ist MOPRI_ PRIORITY AS Q DEF Dieser Wert wird aus dem Attribut DefPriority bernommen Dieses Attribut ist Teil der Queue Manager Konfiguration Alternativ kann die Priorit t mit ganzzahligen Werten zwischen 0 geringste Priorit t und 9 h chste Priorit t belegt werden bernehmen Sie den Standardwert m MOPRI_ PRIORITY AS Q DEF Format Beschreibt in welchem Format die eingehende Nachricht vorliegt Der uberwiegende Teil der Anwendungen die Nachrichten Uber WebSphere MQ austauschen benutzt eines der Formate MQFMT_STRING und MQFMT_NONE MQFMT STRING Zum Abholen von Nachrichten die nur aus Zeichen besteht also TextMessage StreamMessage oder MapMessage MOFMT NONE F r ObjectMessage BytesMessage und Nachrichten ohne Body MOFMT_PCF programmable command format Fur benutzerdefinierte Datenstrukturen Warteintervall W hlen Sie beim Input Connector ein Warteintervall von 5 Millisekunden Alternativ setzen Sie eine unbegrenzte Wartezeit MQWI_UNLIMITED inubit 6 1 Workbench Process Engine Systemkonnektor Guide 05 09 2013 480 WebSphere MQ Connector Dialog WebSphere Mes
510. tputJSON Alle Elemente innerhalb des Resultsets true JSON Notation z B f r werden in JSON Notation ausgegeben AJAX Responses false XML Notation Standard outputPureJSON Die gesamte Ausgabe des true JSON Notation z B f r BO Connectors erfolgt in JSON Notation AJAX Responses Hinweis Dieses Attribut muss am Root false XML Notation Standard Element angegeben werden 05 09 2013 inubit 6 1 Workbench Process Engine Systemkonnektor Guide Business Object Connector 55 Querymodus verwenden Attribut Beschreibung M gliche Werte zipOutput Das gesamte Resultset wird mittels GZIP true komprimiertes Resultset komprimiert z B zum Backup Hinweis Dieses Attribut muss am Root Zum Wiederherstellen des Element angegeben werden Backups kann der BO Connector das komprimierte Resultset einlesen false unkomprimiertes Resultset Standard 5 3 2 Ergebnis einer Daten Verwendung Funktionsweise inubit 6 1 Workbench Process Engine bankabfrage schreiben und einlesen Der BO Connector erlaubt es das Ergebnis einer Datenbankabfrage einschlie lich der gesamten Datenbank auch komprimiert zu speichern und einzulesen Folgende Anwendungsf lle sind damit m glich Migrieren einer Datenbank von einem Datenbanksystem zu einem anderen Sichern einer Datenbank Wiederherstellen einer gesicherten Datenbank Der schreibende BO Connector schreibt das Ergebnis einer Datenbankabfrage Resultset in die Aus
511. ttribute werden ignoriert da Sie als Eingangsnachricht die im oben konfigurierten XSLT Converter angegebene Abfrage nutzen 4 Verbinden Sie den oben erstellten XSLT Converter mit dem BO Connector BO Connector zum Lesender So gehen Sie vor esicherten Daten erstellen g Erstellen und benennen Sie einen neuen BO Connector 2 Wechseln Sie auf das Register Business Object Connector Einstellungen 3 Konfigurieren Sie die Persistenz Schicht und die Verbindung zu der Datenbank in die Sie die Daten einlesen wollen Die Einstellungen f r die Objektmodus Attribute werden ignoriert da Sie als Eingangsnachricht die Ausgangsnachricht des oben konfigurierten BO Connectors nutzen 4 Verbinden Sie den oben erstellten BO Connector mit dem soeben neu erstellten BO Connector 5 4 Stammdatenreferenzen aktualisieren und l schen Stammdaten wie Adressen oder Kundendaten werden durch die Kardinalitat 0 1 oder 1 1 definiert und gesondert behandelt Wenn Sie bei einer Delete oder Update Operation f r ein Geschaftsobjekt kein Stammdatum angeben wird das Stammdatum nicht automatisch gel scht oder aktualisiert sondern nur die Referenz vom Gesch ftsobjekt zum Stammdatum gel scht oder aktualisiert 5 5 Dialog Business Object Connector Einstellungen Dieser Dialog bietet folgende Optionen Persistenzschicht Definition m XML Schema Das Schema wird ben tigt um Datenbanktabellen f r die Gesch ftsobjekte zu erstellen
512. tum der Ausgabedatei im Format yyyy MM dd T HH mm ss Nur verf gbar beim Output Connector wenn eine Datei geschrieben wird und wenn als Eingangsformat DATA gew hlt wurde WriteFileName Name der Ausgabedatei Nur verf gbar beim Output Connector wenn eine Datei geschrieben wird und als Eingangsformat DATA gew hlt wurde WriteFileDir Name des Ausgabeverzeichnisses WriteFileSize Gr e der Ausgabedatei F r Infos ber weitere Variablen und deren Verwendung siehe Workflow Variablen und Mappings Workbench Benutzer Guide Kap 14 S 383 38 2 Dialogbeschreibungen Dieser Abschnitt erl utert die folgenden Themen Dialog VFS Connector Grundkonfiguration S 398 Dialog Input Connector Konfiguration S 400 Dialog Output Connector Konfiguration S 403 38 2 1 Dialog VFS Connector Grundkonfiguration 05 09 2013 Im Dialog Grundkonfiguration konfigurieren Sie die Grundeinstellungen des VFS Connectors Diese Konfiguration m ssen Sie sowohl f r den Input als auch f r Output Connector durchf hren inubit 6 1 Workbench Process Engine Systemkonnektor Guide VFS Connector 399 Dialogbeschreibungen Protokoll Protokoll M gliche Protokolle sind Authentifizierung m cifs Common Internet File System Protokoll f r den Fernzugriff auf Dateisysteme ber ein Netzwerk repository F r den Zugriff auf das lokale inubit Repository ftp File Transfer Protocol P
513. type int object stringLength name gt lt substring gt lt so that the result can be output afterwards or reused in another method call gt lt result value of SresultString gt 20 lt reflection gt Listing Ein und Ausgangsnachrichten Struktur 1 Root Element Das Root Elemente fur alle Java Reflection Eingangsnachrichten muss lt reflection gt hei en Constructor Aufruf String testString This is a test string to be parsed and manipulated Zuerst wird die Variable testString angelegt und mit dem Wert This is a test string to be parsed and manipulated gef llt lt object name testString gt lt java lang String gt This is a test string to be parsed and manipulated lt java lang String gt lt object gt Das Element lt object gt gibt an dass es sich um die Definition einer Klasseninstanz handelt Dabei wird die Erzeugung eines Java Objektes mittels des entsprechenden Constructor Aufrufs abgebildet Kindelement von lt object gt inubit 6 1 Workbench Process Engine Systemkonnektor Guide 05 09 2013 177 178 Java Reflection Connector Beispiel Methodenaufruf 05 09 2013 Das Attribut name testString gibt der Klasseninstanz einen Referenznamen so dass diese Klasseninstanz an anderer Stelle im XML anhand des Referenznamens wiederverwendet werden kann Als Kindelement von lt object gt wird das Objekt selbst als serialisierte XML Struktur dargest
514. tzer Guide Kap 12 S 311 43 1 Voraussetzungen f r den Betrieb Zus tzliche Software Sie m ssen folgende Software installieren Isode Client Den Isode Client erhalten Sie von der Bosch Software Innovations GmbH Er steht f r verschiedene Plattformen zur Verf gung Bei der Installation unter Windows befolgen Sie folgende Anleitung Siehe Isode unter Windows installieren Workbench Process Engine Systemkonnektor Guide Kap 43 1 1 S 484 43 1 1 Isode unter Windows installieren 05 09 2013 So gehen Sie vor 1 Installieren Sie den Isode Client W hlen Sie dabei das Setup Typical Um den Pfad zum bin Verzeichnis des Isode Clients der globalen Path Variable hinzuzuf gen w hlen Sie Start gt Einstellungen gt Systemsteuerung Das Fenster Systemsteuerung wird angezeigt inubit 6 1 Workbench Process Engine Systemkonnektor Guide X 400 SE Connector 485 Lesebest tigungen abholen und versenden Doppelklicken Sie den Eintrag System Das Fenster Systemeigenschaften ffnet sich Zeigen Sie das Register Erweitert an Klicken Sie auf den Button Umgebungsvariablen Das gleichnamige Fenster ffnet sich Markieren Sie im Bereich Systemvariablen die Variable Path Klicken Sie auf Bearbeiten F gen Sie am Ende der Eintr ge ein Semikolon und dann den Pfad zum bin Verzeichnis des Isode Clients ein 43 2 Lesebest tigungen abholen und versenden
515. tzten Die Struktur der Aktionen ist in einer DTD bzw einem XML Schema beschrieben PIP Definitionen stehen als Dokumentationspaket welches u a die DTDs bzw Schemas enth lt auf den Seiten von RosettaNet zur Verf gung und k nnen von dort heruntergeladen werden PIP Bezeichnung Ein PIP Bezeichner wie z B 3A2 setzt sich folgenderma en zusammen inubit 6 1 Workbench Process Engine Systemkonnektor Guide 05 09 2013 322 RosettaNet HTTPS Connector Dialogbeschreibungen 05 09 2013 Zahl 0 7 die das Cluster spezifiziert 3 Order Management Gro buchstabe A D der das Segment angibt A Quote and Order Entry Maximal zweistellige Zahl aus dem Intervall 1 20 das den PIP angibt 2 Request Price and Availability PIP Version Wird verwendet zur berpr fung ob die Nachricht g ltig ist Es wird ein reiner Zeichenkettenvergleich durchgef hrt Es gibt Gesch ftspartner die sich darauf einigen bei langen Release oder Versionsangaben die letzen vier Stellen nicht anzugeben Verwendet einer der Partner die Release oder Versionsnummer ohne die letzten vier Stellen und der andere mit den letzten vier Stellen w rde die Nachricht als ung ltig erkannt Die zu Grunde liegende PIP Version steht in der RosettaNet Spezifikation DTD Schema Zum Laden der DTD bzw des XML Schemas welche die Aktion des PIP beschreibt Geben Sie zus tzlich an ob Sie eine DTD oder ein XML Schema laden Input
516. u u4424444444nnnnnnnnnnnennnnnnnnnnennnnnnnnnnnannnnnnnnnnneennnnnnnnnnennennnnnnnnennnn nenn 474 42 WebSphere MQ COn meth iisicsncccssasisacnstecaacieesctanainsesantnnnnnsensensetarhnksvanhadpnhaansednkavasnsasnnsdednnchetsassnshanadnneentenn 477 42 1 Voraussetzungen ee eee eee 477 42 2 Dialog WebSphere Message Queue Connector 2usr4440unnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnn 478 43 X 400 SE C nnector wisi ccscccs ec ccccsseetectecectseuscc den ceecccccdeeee staceneeestouedsweebocedeseecbaced NEEEEEEER naar nee KREE SNE 483 43 1 Voraussetzungen f r den Betrieb 2424444444400004000nH0Rnnnnnan Han nnnnnnnannnnnnnnnannnnnnnnnnnnsnnnnnnnnennnn nen 484 43 1 1 Isode unter Windows mstalleren ss nnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnn san 484 43 2 Lesebest tigungen abholen und versenden nn 485 43 3 DialogbeSChreiDUNGen nn 485 43 3 T Dialog X400 Zugangsdaten 2 4 122 me ea 486 43 3 2 Dialog Datenweitergabe konfourteren nenn 488 43 3 3 Dialog Nachrichtenoptionen f r den Versand 489 05 09 2013 inubit 6 1 Workbench Process Engine Systemkonnektor Guide D e 15 SE Hinweise zum Systemkonnektor Guide Zielgruppe Der Systemkonnektor Guide enth lt detaillierte Informationen f r Systemadministratoren Systemintegratoren und Entwickler welche die inubit Software oder Teile davon verwalten und konfigurieren Umfang der Dokumentation Die umfassende Dokument
517. ubit 6 1 Workbench Process Engine Systemkonnektor Guide 05 09 2013 348 Secrypt Connector Dialog Secrypt Connector Eigenschaften Serverseitige Pr fen Verzeichnispr fung Testet ob die angegebenen Pfade und Verzeichnisse vorhanden und schreib lesbar sind 05 09 2013 inubit 6 1 Workbench Process Engine Systemkonnektor Guide EH Security Token Service Connector Verwendung Konnektortypen Standards Dieser Abschnitt erl utert die folgenden Themen m Funktionsprinzip des STS Connectors S 350 m Web Services Provider an STS Connector registrieren S 352 m Dialog Security Token Service WS Trust S 355 Bei vielen Web Services ist es f r den Service Provider wichtig die Nutzer der Dienstleistungen zu kennen z B um die Nutzung abrechnen zu k nnen oder um den unerlaubten Zugriff zu verhindern Dazu k nnen Service Provider in der Interface Beschreibung ihres Web Services in der WSDL Datei festlegen dass sich Service Consumer gegen ber dem Service Provider authentifizieren m ssen Wenn eine gr ere Zahl von Web Services verwaltet werden soll ist es sinnvoll die Authentifizierung auszulagern und eine zentrale Authentifizierungsinstanz einen so genannten Security Token Service zu nutzen Ein STS Connector fungiert als zentrale Authentifizierungsinstanz f r Web Services Consumer und sichert die Kommunikation zwischen Service Consumer und Provider zentral auf Nachrichten und Transport
518. uery ist die Operation definiert die der ITA Connector ausfuhren soll hier Insert Die Query muss konform zu dem XML Schema des ITA Connectors sein Das XML Schema finden Sie im Repository unter Global gt WY System gt Mapping Templates gt ITA Archiv Connector gt Query xsd In demselben Verzeichnis finden Sie auch eine Beispielquery queryInsert xm1 zum Einf gen eines Dokuments 05 09 2013 inubit 6 1 Workbench Process Engine Systemkonnektor Guide Beispiel Einfaches Insert Beispiel Insert mit komplexen Deskriptoren ITA Connector 163 Dokumente in ITA Archivsystem einf gen Insert Beim Konvertieren k nnen Deskriptoren zu dem Dokument hinzuf gt werden Deskriptoren sind Informationen ber Dokumente wie z B der Dateinamen oder das Erstellungsdatum Siehe Beispiel Insert mit komplexen Deskriptoren Workbench Process Engine Systemkonnektor Guide Kap 14 S 163 4 Der ITA Connector erh lt die XML basierte Query als Eingangsnachricht und sendet diese an das ITA Archivsystem Das ITA Archivsystem archiviert das Dokument f gt die Dokumentenattribute in die Indexdatenbank ein und gibt eine Kopie des Dokuments und die Dokument ID an den ITA Connector zur ck Der ITA Connector gibt beides als Ausgangsnachricht im XML Format aus 5 Der XSLT Converter extrahiert die Dokument ID und bergibt diese an den File Connector 6 Der File Connector schreibt die Dokument ID in das Datei
519. uf L schen Eine Warnung wird angezeigt Nach Best tigung wird der PIP gel scht Register Allgemein Siehe Register Allgemein Workbench Process Engine Systemkonnektor Guide Kap 29 5 1 1 S 319 Register Not Nur Output Connector Siehe Register Not Workbench Process Engine Systemkonnektor Guide Kap 29 5 1 2 S 321 Register Neuer PIP inubit 6 1 Workbench Process Engine Systemkonnektor Guide RosettaNet HTTPS Connector 319 Dialogbeschreibungen nach Klick auf Neu Siehe Register Neuer PIP Workbench Process Engine Systemkonnektor Guide Kap 29 5 1 3 S 321 29 5 1 1 Register Allgemein In diesem Register werden alle Daten angegeben die f r Business Messages zwischen zwei Gesch ftspartnern immer gleich sind Arbeitsverzeichnis m Pfad Der Ausw hlen Button ffnet einen Dateiexplorer zum Anzeigen der empfangenen und erzeugten Nachrichten In diesem Verzeichnis wird auch die Datei gespeichert in der alle erzeugten Instance Identifier enthalten sind Ein Instance Identifier ist eine Zeichenkette mit der jede Nachricht im Kontext zweier Gesch ftspartner eindeutig gekennzeichnet wird F r den RosettaNet Input und Output Connector m ssen Sie er dasselbe Arbeitsverzeichnis angeben DTD Konfiguration Mit der Auswahl der DTDs wird der syntaktische Aufbau der Nachrichten Header bestimmt Die ben tigten DTDs k nnen von den Se
520. uf g und w hlen Sie Beispiel Inhalt f r Ziel Typ erzeugen Quelle Statischer Wert Typ XML Struktur Text DRAJ A wert 6 Neu Al Beispielinhalt f r Ziel Typ erzeugen 3 ffnen P gt EI eichern r baffen W 5 ndern Sie die Adresse in dem wsa Address Element Die WSDL des Endpunkts wird als Metadatum in die XML Struktur unterhalb von wsa Metadata eingef gt Falls die WSDL nicht ge ndert werden soll k nnen Sie das wsdl definitions Element entfernen 40 12 Web Service in UDDI publizieren Sie k nnen Ihren Web Service in einem UDDI Register publizieren Damit stellen Sie den Web Service allen Benutzern zur Verf gung die auf das gew hlte UDDI Register zugreifen k nnen Voraussetzungen Die UDDI muss installiert sein Siehe Komponenten der inubit Software nachinstallieren Process Engine Administrator und Entwickler Guide Kap 3 3 S 57 inubit 6 1 Workbench Process Engine Systemkonnektor Guide 05 09 2013 444 Web Services Connector Aktive Web Services anzeigen So gehen Sie vor 1 Zeigen Sie im Modul Editor den Web Services Input Listener an 2 Zeigen Sie das Register Erweitert an 3 Klicken Sie im Bereich UDDI auf den Button Publizieren Der Dialog UDDI Dateneinstellungen Workbench Process Engine Systemkonnektor Guide Kap 40 16 6 S 467 wird angezeigt 4 F llen Sie den Dialog aus 5 Klicken Sie auf Publizieren Der
521. undkonfiguration m Server URL URL des Servers mit dem sich der Konnektor verbinden soll m SSL inubit 6 1 Workbench Process Engine Systemkonnektor Guide 05 09 2013 328 RosettaNet HTTPS Connector Dialogbeschreibungen Dient zum Konfigurieren der Server bzw Client Authentifizierung und ffnet den Dialog SSL Konfiguration Workbench Process Engine Systemkonnektor Guide Kap 1 1 4 S 24 Authentifizierung m Authentifizierung erforderlich Markieren Sie diese Option wenn der Server eine Authentifizierung fordert Geben Sie dann den Account ein den der Connector f r die Authentifizierung verwenden soll Benutzername Benutzername f r die Authentifizierung Passwort Passwort f r die Authentifizierung HTTP Header Konfiguration ber den Header k nnen Informationen wie z B Dateigr e HTTP Server und User Agent Kennung oder MIME Typ zwischen Client und HTTP Server bertragen werden Der Button Header Liste ffnet einen Dialog in dem Sie Name Wert Paare als Header definieren k nnen Si Informationen ber zul ssige Header finden Sie in der HTTP Spezifikation siehe http www w3 org Protocols HTTP 1 1 rfc2616 pdf Verbindungstest m Verbindung testen Zum Testen ob die Verbindung mit Ihren Angaben erfolgreich aufgebaut werden kann 05 09 2013 inubit 6 1 Workbench Process Engine Systemkonnektor Guide 30 SAP Connector 329 Dieser Abschnitt erlautert die folgenden Themen
522. ur ckgegeben Falls die Option nicht aktiviert ist startet der Workflow synchron und die Antwort wird erst an den Client zur ckgeschickt nachdem das letzte Modul des Workflows ausgef hrt wurde Antwort Daten setzen Aktivieren Sie diese Option wenn Sie auf eine Anfrage kein Antwort Daten zur ckliefern wollen Wenn Sie mit POST PUT oder DELETE eine Ressource manipulieren muss nach ausgef hrter Aktion nicht unbedingt eine Antwort zur ckgesendet werden Ein Antwortcode reicht in diesem Fall Medien Typ Zeichensatz Siehe Einstellungen f r GET Anfragen Workbench Process Engine Systemkonnektor Guide Kap 27 S 301 Antwort Statuscode W hlen Sie aus was als Antwort Statuscode empfangen werden soll Um im Fehlerfall in der Response anzuzeigen dass die Anfrage Daten fehlerhaft sind kann die Variable restConnector responseStatusCode f r den Antwort Statuscode auf den HTTP Status Code 400 f r Bad Request gesetzt werden inubit 6 1 Workbench Process Engine Systemkonnektor Guide 05 09 2013 302 REST Connector Dialogbeschreibungen Allgemeine Einstellungen Antwort Daten automatisch kodieren Aktivieren Sie diese Option wenn die Antwort Daten automatisch mit einer dem Server bekannten und vom Client unterst tzten Methode kodiert werden sollen HTTP Header bearbeiten Der Button HTTP Header bearbeiten ffnet den Dialog zum Bearbeiten der Header Definition f r die verf gbaren H
523. us und Header Daten der empfangenen Antwort werden in folgende Variablen geschrieben m restConnector responseStatusCode Liefert den Antwortcode der das Ergebnis der Abfrage angibt restConnector responseStatusDescription Liefert die Beschreibung des Antwortcodes z B Internal Server Error m restConnector responseHeaders Liefert die Header Daten der Antwort Nachricht Siehe Workflow Variablen und Mappings Workbench Benutzer Guide Kap 14 S 383 27 2 REST Funktionsprinzip HTTP Ressourcen URLs REST Representational State Transfer ist ein Architektur Konzept f r Web Services das beschreibt wie Web Standards in einer Web gerechten Weise einsetzt werden k nnen REST basierte Web Services nutzen das HTTP Protokoll und die HTTP Methoden wie GET oder POST Ein Grundprinzip dieses Modells ist dass die Funktionalit t eines Web Service nicht in dessen Eigenschaften abgebildet wird sondern in Ressourcen des Service Die einzelnen Funktionen eines Dienstes werden dabei in einzeln ber URLs adressierbare Ressourcen zerlegt REST bietet damit die M glichkeit Applikationen wie z B einen Online Shop ber eine URL zu adressieren Dabei stellt jedes einzelne Objekt der Anwendung wie Artikel oder Kunde eine Ressource dar die ber eine eigene URL angesprochen wird Jede REST Ressource besitzt ber die verschiedenen HTTP Methoden eine generische Schnittstelle inubit 6 1 Workbench
524. usgef hrten File oder FTP Connectors verwenden Beispiel Ein vorher ausgef hrter File Connector wurde so konfiguriert dass im Feld Verzeichnis und Dateiname eine Datei Test xml angegeben wurde Als Ausgangsnachricht wurde vom File Connector eine Datei mit Namen Test5 xml weitergeleitet Der Wildcard Inhalt ist in diesem Fall das Zeichen 5 Wenn Sie im aktuellen Connector ebenfalls eine Wildcard angegeben haben zum Beispiel Ausgabe vm so wird an Stelle der Wildcard das Zeichen 5 eingef gt Die Ausgabe des hier konfigurierten Connectors ist daher Ausgabe3 xml Dateiname von vorher ausgef hrtem File Connector verwenden Beispiel ein vorher ausgef hrter File Connector wurde so konfiguriert das im Feld Verzeichnis und Dateiname eine Datei Test xml angegeben wurde Als Ausgangsnachricht wird vom File Connector eine Datei mit genau diesem Namen Test xml weitergeleitet Dieser Dateiname wird dann auch hier verwendet Daten an die Datei anf gen Die zu lesende Datei wird bei jeder Ausf hrung des Workflows an eine evtl bereits existierende Datei angeh ngt Dies ist z B sinnvoll um Log Daten kumulativ in einer Datei zu protokollieren Diese Option kann nicht verwendet werden wenn im Dateinamen Wildcards angegeben sind Eventuell bestehende Datei berschreiben Wenn bereits eine Datei mit demselben Namen existiert dann wird diese berschrieben Sicheres Schreiben Diese Option stellt
525. ut Connector handelt Die Variablen stehen im weiteren Ablauf des Workflows zur Verf gung Name Wert AS2Subject Wert des HTTP Headers Subject der Eingangsnachricht ASMessageMDNOptions Wert des HTTP Headers f r Disposition Notification Options der Eingangsnachricht ASMessageMIC Wert der berechneten Pr fsumme der Eingangsnachricht ASMessageMICALG Variablen des AS2 Input Connectors Name Name des Algorithmus mit dem die Pr fsumme berechnet wurde Die folgende Tabelle enth lt die Variablen die ein AS2 Input Connector bei seiner Ausf hrung setzt Wert ASMessagelD ID der eingehenden Nachricht ASMessageTo AS2 ID des Empf ngers ASMessageFrom AS2 ID des Absenders ASMessageError Fehlermeldung Fehler k nnen z B sein authentication failed Signaturpr fung der eingehenden Nachricht ist fehlgeschlagen decryption failed Entschl sselung ist fehlgeschlagen sender equals receiver Empf nger ist mit dem Absender identisch F r weitere Fehlermeldungen siehe die AS2 Spezifikation ASMessageDate Zeitstempel des Empfangs im Format EEE d MMM yyyy HH mm ss Z dabei bedeutet E Werktag Montag bis Sonntag d Tag des Monats 1 bis 31 M Kurzschreibweise des Monats y Jahr 0 bis 9 H Stunde des Tages 0 bis 23 m Minute 0 bis 59 s Sekunde 0 bis 59 Z Zeitzone Zeitzonenangabe gem RFC 822 ASMessageFailure
526. vate enterprise inubit als OID 1 3 6 1 4 1 15899 Die OID ist nur bis zum Private Enterprise Code standardisiert Die weitere Zusammensetzung der OID ist nicht genormt Es liegt bei den Systemadministratoren eine firmenspezifische Systematik zu erstellen die alle Netzwerkkomponenten erfasst und diesen Nummern zuweist Allen Managed Objects der Ger te muss ebenfalls eine Nummer zugewiesen werden Die Menge der Managed Objects also inubit 6 1 Workbench Process Engine Systemkonnektor Guide OID als Konstante und Variable Community 34 2 SNMP Connector 365 Beispiel Medium Connector der Ereignisse die durch SNMP berwachbar oder konfigurierbar sind ist ger teabh ngig und muss den jeweiligen Herstellerhandb chern entnommen werden H ufig wird den Strukturvorgaben f r den Aufbau der OID Zeichenkette aus Zahlen und Punkten nicht gefolgt da die OIDs nur firmenintern genutzt werden und daher keine eindeutige Abgrenzung gegen ber den IT Landschaften anderer Firmen bestehen muss Soll ber SNMP ein Trap oder eine Konfigurationsanweisung gesendet werden so besteht diese blicherweise aus einer OID und einem Wert Variable Jede OID kann genau die Werte bekommen die in den Herstellerangaben der Netzwerkkomponente angegeben sind Konstante Es gibt auch den Fall dass nur eine OID ohne Wert bermittelt wird Dies ist der Fall wenn ein Managed Object ber eine OID nur einen Zustand kommunizieren kann SNMP biet
527. verwenden nur beim Input Medium Connector Wenn markiert dann wird die Fehler Ausgabe der externen Anwendung an den Execution Connector und danach in den Workflow bergeben Erg nzende Einstellungen m Puffergr e f r die Eingabenachricht Anzahl der Bytes f r die Speicherreservierung Wenn Sie keine Angabe machen wird der Standard 4096 verwendet Ein gro er Wert verbraucht viel Speicher der zum Aufrufzeitpunkt angefordert wird und beschleunigt die bergabe der Eingabenachricht an die aufrufende Applikation Ein kleiner Wert verbraucht weniger Speicher Die bergabe der Eingangsnachrichten kann jedoch Zeit kosten wenn diese viel gr er als der Puffer sind und daher in Paketen mit der Gr e des Puffers bermittelt werden m ssen R ckgabewert als XML zur ckliefern inubit 6 1 Workbench Process Engine Systemkonnektor Guide 05 09 2013 122 Execution Connector Dialog Execution Connector Eigenschaften Nur sinnvoll in Kombination mit der Option Ausgabenachricht Q verwenden Der R ckgabewert wird in eine XML Struktur eingebettet und zur ckgeliefert 05 09 2013 inubit 6 1 Workbench Process Engine Systemkonnektor Guide o File Connector Verwendung Konnektortypen 123 Dieser Abschnitt erl utert die folgenden Themen m Modulvariablen des File Connectors S 123 m Dialogbeschreibungen S 124 Ein File Connector sorgt f r die Kommunikation der inubit Process Engine mit d
528. verwenden wenn die Verbindung zwischen Client und Server als sicher betrachtet werden kann Digest Verlangt ebenfalls Benutzername und Passwort Das Passwort wird verschl sselt bertragen F r die Verschl sselung werden mehrere Parameter verwendet u a zuf llig erzeugte Werte Benutzername Benutzername f r die Authentifizierung Passwort Passwort f r die Authentifizierung Portal Benutzerdaten verwenden Diese Option ist nur bei einem installierten Portal verf gbar Wenn die Option aktiviert ist ist der Zugriff auf die Ressource nur m glich wenn g ltige Portal Benutzerdaten bergeben werden Als Authentifizierungs Verfahren wird Basic verwendet Der in einem Aufruf verwendete Portal Benutzername steht bei Workflow Ausf hrung in der Variable restConnector requestAuthUser zur Verf gung Siehe Modulvariablen des REST Connectors Workbench Process Engine Systemkonnektor Guide Kap 27 1 S 288 Authentifizierung f r Zugriff auf Process Engine verwenden Passwort aus Portalkonfiguration Verwendung des internen Benutzers inubitlSPortallser vintern Unterst tzte HTTP Methoden Hier legen Sie fest dass der Konnektor nur auf bestimmt HTTP Operationen reagiert Durch die Definition des Ressourcen Typs haben Sie bereits automatisch zum jeweiligen Ressourcen Typ passende HTTP Methoden voreingestellt GET Daten der Ressource abrufen POST neue Ressource anlegen PUT Ressource aktualisieren DE
529. von Nachrichten zwischen den Kommunikationspartnern ausgetauscht Dabei k nnen die Kommunikationspartner sowohl Absender als auch Empf nger von Nachrichten sein Die zu einer Nachricht geh renden Daten werden nach ihrer Erfassung vom Absender elektronisch signiert und dann im OSCI Format an einen so genannten Intermedi r gesendet Der Intermedi r bernimmt die Funktionalit ten einer virtuellen Poststelle VPS pr ft die Signatur und die Zertifikate erstellt dar ber ein Pr fprotokoll und h lt die Nachricht im Server Postfach des Empf ngers zum Abruf bereit Der OSCI Intermedi r wird von der virtuellen Poststelle f r die Verarbeitung von OSCI Nachrichten genutzt Dabei ist die virtuelle Poststelle eine L sung um verschl sselte und signierte Nachrichten die eine Beh rde in den verschiedensten Formaten und Protokollen erh lt entgegenzunehmen zu konvertieren und zu verarbeiten Der OSCI Connector verbindet sich mit der virtuellen Poststelle und kann mit den entsprechenden Zugangsdaten OSCI Nachrichten empfangen sowie an diese senden Das entsprechende Schema Template finden Sie im inubit Repository LA im Verzeichnis Global System Mapping Templates OSCI Connector 26 3 Dialogbeschreibungen Dieser Abschnitt erl utert die folgenden Themen a Dialog Abrufen von OSCI Nachrichten am Intermedi r S 283 a Dialog Erstellen von OSCI Nachrichten am Intermedi r S 284 26 3 1 Dialog A
530. w hlten Methoden wurden hinzugef gt und alle Parameter unterhalb der Methodenknoten gesetzt 8 Parameterwerte setzen Um einen vollst ndigen Methodenaufruf absetzen zu k nnen m ssen Sie die Parameter mit konkreten Werten f llen a Markieren Sie einen Parameter b ffnen Sie das Kontextmen und w hlen Sie Wert setzen Ein Dialog ffnet sich In diesem Dialog wird der Wert f r den gew hlten Parameter gesetzt Zur Unterst tzung wird der Datentyp des Parameters angezeigt Wenn es sich bei dem Parameter um ein Java Objekt mit einem komplexen Datentyp handelt dann muss zun chst ein passender Constructor zum Erzeugen dieses Java Objektes ausgew hlt werden 9 Wenn alle Einstellungen vollst ndig sind beenden Sie den Assistenten Die Struktur der Eingangsnachricht wird erzeugt und angezeigt inubit 6 1 Workbench Process Engine Systemkonnektor Guide 05 09 2013 184 JCA Connector Beispiel Eingangsnachricht 10 Ziehen Sie die Struktur ins Stylesheet zu erstellen XSLT Template um das XSLT F r Hinweise ber die Verwendung des XSLT Converters siehe Technical Workflow erstellen 3 CSV XML konvertieren nach openTRANS Tutorials 17 3 Beispiel Eingangsnachricht Kap 4 5 S 72 Der JCA Connector stellt die Variablen cf und ix bereit die in der Eingangsnachricht verwendet Scf bietet Zugriff auf eine werden k nnen Instanz des Interfacetyps javax resource cci ConnectionFactory Six
531. w Diagramme Workbench Benutzer Guide Kap 12 S 311 inubit 6 1 Workbench Process Engine Systemkonnektor Guide 05 09 2013 330 SAP Connector SAP Java Connector JCo installieren 30 1 SAP Java Connector JCo installieren 05 09 2013 Voraussetzungen Sie ben tigen einen Zugang f r das SAP OSS oder f r SAPNet um die Installationsdateien herunterzuladen In der Installationsbeschreibung von SAP wird darauf hingewiesen dass ein JDK 1 3 oder h her ben tigt wird Bei der Installation der inubit Software wurde bereits ein passendes JRE installiert So gehen Sie vor 1 ffnen Sie einen Browser und laden Sie URL http service sap com connectors Wahlen Sie SAP Java Connector gt Download 3 Laden Sie folgende Bibliotheken herunter und entpacken Sie diese SAP IDOC Class Library z B sapidoc3 3 0 4 zip Enth lt sapidoc3 jar SAP Java Connector passend zu Ihrem Betriebssystem z B sapjco3 NTintel 3 0 5 zip Enth lt sapjco3 jar abh ngig von Ihrer Auswahl z B sapjco3 d11 Windows oder 1ibsapjco3 so Linux 4 Laden Sie die beiden jar Dateien als Treiber in die inubit Process Engine hoch Siehe Treiber installieren Process Engine Administrator und Entwickler Guide Kap 3 4 S 57 Falls Sie eine Fehlermeldung erhalten die auf das Fehlen der Middleware Schicht hinweist lesen Sie die SAP Note 684106 zu finden im SAP Marketplace und wenden Sie die dort beschriebene L sung
532. when others then Listing Abschnitt 1 von 2 05 09 2013 inubit 6 1 Workbench Process Engine Systemkonnektor Guide Database Object Connector Datenbankprozedur getNewID erstellen Listing 37 o_newid null 3 end 39 if s_owner is null then 40 raise application _error 20000 getNewID Sequence seq_ i_ fieldname or seq_ i_tablename not found else 41 raise application error 20000 getNewID Sequence s_owner seq_ i_fieldname or s_owner seq_ s_table not found D end if 43 44 end Listing Abschnitt 2 von 2 7 5 2 Datenbankprozedur getNewID fiir MySQL Da MySQL keine Sequenzen kennt wird bei MySQL eine interne Sequence Tabelle INUBIT DBO SEQUENCES verwendet Listing 1 DELIMITER 2 DROP PROCEDURE IF EXISTS getNewID CREATE PROCEDURE getNewID in i _tablename text in i fieldname text ut o newid int 6 BEGIN DECLARE entryCount INT s S OO O JO 0 FB W A ELECT COUNT INTO entryCount FROM INUB T DBO SEQUENCES WHERE EQUENCE TABLE i tablename AND SEQUENCE COLUMN i fieldname 1 IF entryCount 0 THEN create entry 12 INSERT INTO INUBIT DBO SEQUENCES SEQUENCE TABLE SEQUENCE _ COLUMN SEQUENCE VALUE Values i tablename i fieldname 0 13 SET o newid 0 14 ELSE increase
533. wie der DBO Input Connector selbst hat Beispiel Sie nutzen ein Szenario in dem ein DBO Medium Connector Gesch ftsobjekte erstellt oder modifiziert ein DBO Input Listener diese Events berwacht und ein weiterer DBO Input Listener die Event Archiv Tabelle berwacht In diesem Szenario m ssen alle drei Konnektoren dieselbe ID haben Event Listener Archiv Prozessor Nur beim Input Connector Legt die Funktion des Input Connectors fest Siehe Events mit Event Listener berwachen und archivieren Workbench Process Engine Systemkonnektor Guide Kap 7 2 S 96 Event Archiv mit Archiv Prozessor berwachen Workbench Process Engine Systemkonnektor Guide Kap 7 3 S 99 Max Anzahl von Events pro Aufruf Nur bei einem Input Connector Mit der Angabe legen Sie fest wie oft der Workflow pro Aufruf maximal gestartet werden soll Mit der Begrenzung k nnen Sie die Systemauslastung der inubit Process Engine steuern Der Workflow wird so oft gestartet bis entweder keine weiteren Events zu holen sind oder die maximale Anzahl von Events erreicht ist Im Test Modus wird der Workflow bei einem Aufruf genau einmal gestartet und liest exakt ein Event Event Tabelle Nur beim Input Connector Name der Tabelle aus welcher Events geholt werden sollen Event Archiv Tabelle Nur beim Input Connector Name der Tabelle in der verarbeitete Events archiviert werden Wenn keine Tabelle angegeben ist dann werden Events nicht arch
534. xt Die Liste der OK codes k nnen Sie vor Ausf hrung des Connectors selbst definieren indem Sie im Register Eigenschaften des Moduls das Element lt Property name ISHttpStatusCodesOk gt hinzuf gen und als Inhalt alle HTTP Codes eingeben die nicht zu einer Exception f hren sollen Geben Sie die HTTP Codes als Komma separierte Liste ein Die Web Services Technologie der inubit Software basiert auf dem Web Service Stack Metro Metro ist ein frei verf gbares Produkt des Sun Developer Networks Si Siehe auch http java sun com webservices index jsp 40 1 Funktionsprinzip eines Web Services Web Services anbieten abrufen 05 09 2013 Web Services sind Applikationen welche offene XML basierte Standards und Transportprotokolle nutzen um Daten mit Clients auszutauschen Servicekonsument SOAP oder XML Serviceanbieter Serviceanbieter stellen eine Beschreibungen ihrer Web Services als WSDL Datei zur Verf gung inubit 6 1 Workbench Process Engine Systemkonnektor Guide Web Services Connector 415 Funktionsprinzip eines Web Services Die WSDL Datei beschreibt die Operationen Daten und Austauschprotokolle die der Web Service anbietet Diese Informationen sind maschinenlesbar Servicekonsumenten erstellen auf Basis der Informationen aus der WSDL Datei einen SOAP Request um damit auf eine Operation zuzugreifen die der Web Service bietet Der Web Service bearbeitet den SOAP Request und sende
535. yCompany IS C de validity 999 keystore private keystor keypass lt yourPassword gt storepass lt yourPassword gt alias tomcat Si http docs oracle com javase 6 docs technotes tools solaris keytool html 2 Exportieren Sie die Zertifizierungsanforderung anhand des privaten Schl ssels keytool certreq v alias tomcat keystore private keystore storepass lt yourPassword gt file server request csr 3 bermitteln Sie die Zertifizierungsanforderung an eine von ihnen gew hlte Zertifizierungsstelle Certificate Authority CA wie z B D Trust Die Zertifizierungsstelle sendet ihnen ein signiertes Zertifikat f r den Web Service hier CAcert cer und ihren eigenen ffentliches Schl ssel hier public cer zur ck 4 Listen Sie alle Informationen des Service Zertifikats auf Es m ssen 509v3 und SubjectKeyldentifier angezeigt werden keytool printcert v file public cer 5 Importieren Sie das CA Zertifikat in den privaten Keystore keytool import trustcacerts alias cacert file CAcert crt keystore private keystore storepass lt yourPassword gt inubit 6 1 Workbench Process Engine Systemkonnektor Guide 05 09 2013 436 Web Services Connector Schl sselpaare f r WS Trust erstellen 6 Importieren Sie den ffentlichen Schl ssel in den privaten Keystore keytool import trustcacerts alias tomcat file public cer keystore private keystore storepass lt yourPassword gt 7 Generier
536. zeigt alle aktiven Web Services der inubit Process Engine an Input Listener Connector Operation Zur Auswahl der Operation die der Web Service anbietet Input Listener Connector Ausgangsnachricht setzen Wenn markiert dann bergibt der Konnektor den empfangenen Request an den Workflow Mit kompletter SOAP Nachricht inubit 6 1 Workbench Process Engine Systemkonnektor Guide Web Services Connector 465 Dialogbeschreibungen Wenn markiert dann wird eine vollst ndige SOAP Nachricht ausgegeben Nutzdaten Inhalt von SOAP Body Wenn markiert dann wird nur der Inhalt des SOAP Body ausgegeben Variablen Inhalt setzen Wenn markiert dann schreibt der Konnektor den empfangenen Request in die angegebene Variable Variable Zum Ausw hlen einer bereits deklarierten Variable bzw zum Anlegen einer neuen Variablen Aufzurufende Operation Medium Output Connector Operation Zur Auswahl der Operation die der Web Service aufrufen soll Die Operation ist standardm ig nicht festgelegt Es wird versucht die Operation anhand der bergebenen SOAP Nachricht zu ermitteln Eigenschaften anhand bergebener SOAP Nachricht ermitteln Die Option ist nur aktiviert wenn Sie keine Operation festgelegt haben SOAP Action Geben Sie eine SOAP Action an wenn sie nicht aus der SOAP Nachricht ermittelt werden kann oder soll Die aufzurufende Aktion liefert kein Ergebnis zur ck Aktivieren Sie die Option w
537. zerangaben f r X 25 bertragung X 25 Fenstergr e Die Fenstergr e bei X 25 ISDN Kommunikation ist die Anzahl der Pakete die ohne Best tigung verschickt werden k nnen Die Fenstergr e kann w hrend des Verbindungsaufbaus ausgehandelt werden Wir empfehlen aber von vornherein die zum Partnernetzwerk passende Fenstergr e zu konfigurieren z B den Wert 7 f r ISDN X 25 Geschlossene Benutzergruppe ISDN und X 25 bieten die M glichkeit eine geschlossene Benutzergruppe zu bilden Alle Teilnehmer die zu einer solchen Gruppe geh ren k nnen untereinander ber das ffentliche Telekommunikationsnetz kommunizieren Verbindungsanforderungen an Gruppenmitglieder von Teilnehmern die nicht Mitglied der geschlossenen Benutzergruppe sind werden von der Vermittlungsstelle abgewiesen Standard deaktiviert 24 6 3 3 XOT Empf nger konfigurieren XOT steht f r X 25 over TCP X 25 ist ein internationaler Telekommunikationsstandard der von der Internationalen Fernmeldeunion verabschiedet wurde Si Weitere Informationen finden Sie unter www itu int VectorPosition Nicht editierbar Empf nger Nummer Nicht editierbar Lokale IP Adresse IP Adresse oder Rechnername Ihres lokalen Systems Lokaler Port Port Ihres lokalen Systems Standard 1998 Router IP Adresse IP Adresse oder Rechnernamen Ihres ISDN Routers Router Port Port Ihres ISDN Routers Standard 1998 X 25 Adresse Jeder Rechner der in einem X 25 Netzwerk
538. zeugt 1 1 4 Dialog SSL Konfiguration 05 09 2013 Dieser Dialog bietet folgende Optionen zum Festlegen der SSL Einstellungen beim Verbindungsaufbau des Systemkonnektors Server Authentifizierung Wenn markiert dann muss sich der Server zu dem die Verbindung aufgebaut wird gegen ber dem Systemkonnektor identifizieren Wenn nicht markiert dann wird jeder SSL Server als vertrauensw rdig betrachtet Der Button Truststore laden ffnet einen Dateiexplorer zum Laden des Truststores mit dem ffentlichen Schl ssel des Servers F r den Truststore wird das Java Keystore Format akzeptiert f r Zertifikate das PEM oder DER Format Client Authentifizierung inubit 6 1 Workbench Process Engine Systemkonnektor Guide Systemkonnektoren 25 Dialogbeschreibungen Wenn markiert dann muss sich der Systemkonnektor gegen ber dem Server identifizieren Der Button Keystore laden ffnet einen Dateiexplorer zum Laden des Keystores mit dem privaten und dem ffentlichen Schl ssel des Client F r den Keystore wird das Java Keystore Format akzeptiert f r Zertifikate das PEM oder DER Format Um den Keystore laden zu k nnen m ssen Sie das Passwort f r W den privaten Schl ssel bzw den Keystore eingeben Die Server und Client Authentifizierung wird im Anmeldedialog der inubit Workbench und bei folgenden Systemkonnektoren angeboten inubit IS Connector Workbench Process Engine Systemkonnektor Guid
539. zierung verwenden Workbench Process Engine Systemkonnektor Guide Kap 27 S 302 inubit 6 1 Workbench Process Engine Systemkonnektor Guide REST Connector 297 Ressource aufrufen 4 W hlen Sie je nach Art der Anfrage die gew nschte HTTP Methode Siehe HTTP Methoden verwenden Workbench Process Engine Systemkonnektor Guide Kap 27 3 S 292 5 Falls Sie als Methode PUT oder POST gesetzt haben w hlen Sie jeweils eine Option aus der Liste der Medientypen und des Zeichensatzes aus Siehe Anfragedaten Workbench Process Engine Systemkonnektor Guide Kap 27 S 303 Damit legen Sie die Definition der Daten fest die verschickt werden Die Werte der Anfragedaten werden in den Content Type Header bernommen 6 Optional k nnen Sie Anpassungen im Request Header vornehmen z B wenn Sie f r Ressourcen die mehrere Repr sentationen unterst tzen die gew nschte Repr sentation der angefragten Ressource festlegen wollen Dazu nutzen Sie den Accept Header a Klicken Sie auf den Button Header bearbeiten Ein Dialog ffnet sich Standardm ig wird mit eine beliebige Repr sentation einer Ressource abgefragt b Doppelklicken Sie den Accept Header Ein weiterer Dialog ffnet sich In diesem Dialog k nnen Sie die HTTP Header definieren az a Beschreibung Accept Liste der akzeptierten Medien Ty IS HTTP Header i xj Geben Sie den Namen und den Wert des HTTP Headers
540. zu E t E R A Q XSLT Stylesheet CreateResponse XML Quelle XML Ziel amp xsl stylesheet http www w3 org 1999 XSL Transform ii xsl http www w3 org 200 1 XMLSchema en xs 2 0 Aa version ER xsl output method xml encoding UTF 8 SI E xsl template E G isns Envelope http schemas xmlsoap org soap envelope d i isns CH isns Header Ela isns Body http 192 168 0 223 8000 bis ws 1296231490009 ProvideWebService i Gat wsc output of operation SayHello i GQ Comment wsc SayHelloResponse Hello A GB quetvarablen Name Typ Wert 9235 Q Ner c users hih AppData Roaming inubit Toolset 6 0 work 1 targetNamespace isns http schemas xmlsoap org soap envelope Pas Le Dieser Dialog zeigt alle Schema Elemente an Die Struktur entspricht der Instanz welche das XML Schema abbilden soll Um die interne Schemastruktur anzuzeigen wechseln Sie in die Baum Ansicht l isns Envelope 1 1 c Envelop uayeqieag la gt a d Ela isns Body 1 1c Body ref g Publizieren Sie den XSLT Converter 3 Testen Erstellen Sie einen zweiten Web Service der Ihren soeben erstellten Web Service aufruft Siehe Web Service aufrufen Workbench Process Engine Systemkonnektor Guide Kap 40 4 S 421 4 Publizieren Sie den Technical Workflow ge E RT teg 9 PN FE nt a CTT E N Sie k nnen Ihren selbst erstellten Web Service anderen
541. zu aktualisieren Update falls dies nicht m glich ist weil der Datensatz noch nicht vorhanden ist wird der Datensatz ausgef hrt weil es we eingef gt Insert Das Update wird zuerst niger zeitintensiv ist als das Insert lt queries gt lt query type updateOrInsert gt lt tables gt lt table gt lt tableNames gt lt tableName gt OrderTable lt tableName gt lt tableNames gt lt fields gt lt field skip update gt lt fieldName gt OrderNr lt fieldName gt lt fieldValue gt Kundell lt fieldValue gt lt field gt lt field gt lt fieldName gt Kunde lt fieldName gt lt fieldValue gt 123 lt fieldValue gt lt field gt lt field gt lt fieldName gt Textl lt fieldName gt lt fieldValue gt infol lt fieldValue gt lt field gt lt field gt lt fieldName gt Text2 lt fieldName gt lt fieldValue gt info2 lt fieldValue gt lt field gt lt fields gt lt conditions gt lt condition type OR gt lt leftValue gt OrderNr lt leftValue gt lt operation gt lt operation gt lt rightValue gt Kundell lt rightValue gt lt condition gt lt conditions gt lt table gt lt tables gt lt query gt lt queries gt 05 09 2013 inubit 6 1 Workbench Process Engine Systemkonnektor Guide Database Connector XML Querys Struktur und Beispiele 6 4 8 Datens tze l schen Delete Zum L schen von Datens tzen verwenden Sie Delete Im folgenden Beis
542. zum SAP System aufgebaut die Nachricht wird verschickt und die Verbindung geschlossen Wenn man sehr viele IDocs in kurzer Zeit verarbeiten m chte ist es sinnvoll die Verbindung zum SAP System aufzubauen und alle Nachrichten auf einmal zu senden Die zu sendenden IDocs m ssen zu einer Nachricht zusammengef gt sein Multi IDoc der Beginn jedes IDoc muss durch ein XML Element eindeutig gekennzeichnet sein Das SAP Connector Modul trennt das Multi IDoc am Trennelement und schickt die einzelnen IDocs nacheinander ber denselben Verbindungsaufbau XML IDoc Trennelement inubit 6 1 Workbench Process Engine Systemkonnektor Guide 05 09 2013 340 SAP Connector Dialog SAP Connector Eigenschaften 05 09 2013 Geben Sie das XML Element inkl Pfad ein welches den Beginn einer IDoc Nachricht signalisiert Die Trennung erfolgt inkl Trennelement d h aus einer XML Struktur Root ADRMAS02 IDOC und dem Trennelement Root ADRMASO2 wird ein IDoc mit der Struktur ADRMASO2 IDOC ibis_root root tmp 27_SAP_TestWF_12022007 Datei ansehen Elemente in Multi an IDoc LEI Root E e ADRMASO2 B IDOC BEGIN 1 Datei ansehen EDI_DC40 SEGMENT 1 Im oberen Teil sehen Sie die Erg 4 E1ADRMAS SEGMENT 1 Sa ADRMASO2 Sa ADRMASO2 ADRMASO2 Sa ADRMASO2 Sie die Ergebnisdatei Der untere Teil des Dialogs zeigt die ibis_root root tmp 2 Eleme

inubit Suite: Systemkonnektor-Guide

Contents

Download Pdf Manuals

Related Search

Related Contents