Installation des AE Internal Webservice (JBoss)

Der AE Internal Webservice war die frühere Methode für die Kommunikation mit einem AE-System. Sie wird nur für Partner unterstützt, die noch alte Installationen und Integrationen verwalten müssen. Für neue Installationen und Integrationen ist die REST-API die neuere und bevorzugte Kommunikationstechnologie. Weitere Informationen finden Sie unter REST-API

Die Automation Engine und die Java-Komponenten (z. B. AWI) kommunizieren unter Verwendung von TLS/SSL. Diese Komponenten richten eine Verbindung zum Java-Kommunikationsprozess (JCP) ein, der vertrauenswürdige Zertifikate verwendet, um seine Identität gegenüber anderen Kommunikationspartnern nachzuweisen.

Wenn Sie von einer Zertifizierungsstelle signierte Zertifikate verwendet haben, werden die Zertifikate standardmäßig im entsprechenden Java- oder Betriebssystemspeicher gespeichert (das ist der Java-Trust Store für Java-Komponenten). In diesem Fall müssen Sie nur prüfen, ob die Root-Zertifikate bereits im jeweiligen Speicher sind.

Wenn Sie nicht die Standardspeicherorte für die relevante Komponente verwenden möchten, stellen Sie sicher, dass Sie den Parameter trustedCertFolder= in der entsprechenden Konfigurationsdatei (INI) verwenden, um den Pfad zum Ordner zu definieren, in dem die vertrauenswürdigen Zertifikate gespeichert sind.

Weitere Informationen finden Sie unter Hinweise zu TLS/SSL für Automic Automation und Verbindungen zur AE sichern (TLS/SSL).

Die AE Internal Webservice-Datei UC4WS.WAR ist im Verzeichnis IMAGE:WEBSERVICE verfügbar.

Überprüfen Sie die compatibility matrix um zu erkennen, welche Version mit Ihrem System kompatibel ist. Weitere Informationen finden Sie unter Kompatibilitätsinformationen.

Die folgenden Schritte sind für die Installation und Konfiguration des AE Internal Webservice auf einem JBoss-Anwendungsserver erforderlich:

Installation des Internal Webservice

  1. Weisen Sie einem Benutzer auf dem Host-Computer die Rolle uc4 zu. Er wird in der Datei web.xml verwendet.

    Diese Vorgehensweise hängt vom verwendeten Realm ab. Zu Testzwecken können Sie die Benutzer auch in einer Datei speichern. Weitere Informationen finden Sie auf der JBoss Community-Startseite.

  2. Kopieren Sie die Datei UC4WS.WAR in das Deploy-Verzeichnis.

  3. Nach dem Deployment wird eine Log-Meldung ausgegeben, die für die Registrierung des Internal Webservice erforderlich ist.

  4. WSDL ist verfügbar unter http://Servername:Port/uc4ws/uc4ws?wsdl.

Den Internal Webservice konfigurieren

  1. Rufen Sie auf dem Host-Computer die Web-Schnittstelle für den internen Webdienst auf (http://Server name:Port/uc4ws/admin). Weitere Informationen finden Sie unter Konfigurations-Webschnittstelle für den Internal Webservice.

  2. Geben Sie in Kommunikationsprozess (Host:Port) mindestens einen Kommunikationsprozess im Format Servername:Port an.

    Sie können auch einen Standardbenutzer mit bestimmten zugeordneten Vorgängen speichern.

  3. Legen Sie im Bereich Session Handling die Verbindungseinstellungen für den internen Webdienst fest.

Hinweis: Die Konfigurationsdatei wird überschrieben, wenn Sie die WAR-Datei erneut bereitstellen. Daher müssen Sie Ihre Konfigurationseinstellungen neu definieren. Stattdessen können Sie auch eine Kopie Ihrer Konfigurationsdatei (INI-Datei) speichern, bevor Sie das Deployment starten, und sie in den Ordner kopieren, der die Webanwendung enthält, nachdem das Deployment stattgefunden hat.

Siehe auch:

Nutzung des Webdiensts