Ziele konfigurieren

Ziele sind die Positionen auf dem Hub, an denen Dokumente empfangen werden. Diese Dokumente können von Community-Teilnehmern (zur letztendlichen Zustellung zu Community Manager) oder von Community Manager (zur letztendlichen Zustellung zu Teilnehmern) kommen.

Sie konfigurieren mindestens ein Ziel für jeden Transportprotokolltyp, über den Dokumente an den Hub gesendet werden. Sie haben z. B. ein HTTP-Ziel, um beliebige Dokumente zu empfangen, die über den HTTP- oder HTTPS-Transport gesendet werden. Wenn Ihre Community-Teilnehmer Dokumente über FTP senden, konfigurieren Sie ein FTP-Ziel.

Diese Abbildung zeigt, wie vier Ziele konfiguriert wurden, um Dokumente zu handhaben, die beim Hub eingehen. Zwei der Ziele sind für Dokumente, die von Teilnehmern gesendet werden, und die anderen zwei Ziele sind für Dokumente, die von Community Manager stammen. (Beachten Sie, dass Sie Transportprotokolle der Liste mit Transportprotokollen, die standardmäßig von WebSphere Business Integration Connect unterstützt werden, hinzufügen können.)

Abbildung 21. Transportprotokolle und zugeordnete Ziele


Führen Sie die folgenden Schritte aus, um Ihre Ziele zu konfigurieren:

  1. Klicken Sie auf Hubadmin > Hubkonfiguration > Ziele.
  2. Wenn Sie ein benutzerdefiniertes Transportprotokoll hochladen wollen, führen Sie die folgenden Schritte aus. Andernfalls fahren Sie mit Schritt 3 fort.

    1. Klicken Sie auf Transporttyp importieren.
    2. Geben Sie den Namen einer XML-Datei ein, die den Transport definiert oder verwenden Sie Durchsuchen, um zur Datei zu navigieren.
    3. Klicken Sie auf Hochladen.

    Anmerkung: Sie können über die Zielliste auch einen benutzerdefinierten Transportprotokolltyp löschen. Sie können kein Transportprotokoll löschen, das von WebSphere Business Integration Connect bereitgestellt wurde. Ebenfalls können Sie kein benutzerdefiniertes Transportprotokoll löschen, nachdem es zum Erstellen eines Ziels verwendet wurde.

  3. Klicken Sie auf Ziel erstellen.
  4. Geben Sie einen Namen für das Ziel ein. Sie könnten das Ziel z. B. HttpTarget nennen. Dies ist ein erforderliches Feld. Der Name, den Sie hier eingeben, wird in der Liste Ziele angezeigt.
  5. Geben Sie optional den Status des Ziels an. Aktiviert ist die Standardeinstellung. Ein Ziel, das aktiviert ist, ist für das Akzeptieren von Dokumenten bereit. Ein Ziel, das inaktiviert ist, kann keine Dokumente akzeptieren.
  6. Geben Sie optional eine Beschreibung für das Ziel ein.
  7. Wählen Sie einen Transport in der Liste aus. Beachten Sie, dass, wenn Sie einen benutzerdefinierten Transport importieren haben, er in der Liste angezeigt wird.

Die gezeigten Schritte sind für alle Ziele gleich. Nachdem Sie ein Ziel ausgewählt haben, werden jedoch zusätzliche Felder auf der Seite angezeigt. Die Felder variieren, abhängig vom ausgewählten Transport.

Im Folgenden werden die zusätzlichen Schritte aufgeführt, die Sie ausführen, um das Ziel basierend auf seinem Transporttyp zu konfigurieren. Nachdem Sie die transportspezifischen Informationen bereitgestellt haben, um ein benutzerdefiniertes oder ein HTTP/S-Ziel zu definieren, können Sie Konfigurationspunkte für das Ziel modifizieren. Siehe Konfigurationspunkte modifizieren.

HTTP/S-Ziel konfigurieren

Die Empfängerkomponente verfügt über ein vordefiniertes Servlet bcgreceiver, das zum Empfangen von HTTP/S-POST-Nachrichten verwendet wird. Sie erstellen ein HTTP-Ziel, um auf die vom Servlet empfangenen Nachrichten zuzugreifen.

Die folgenden Schritte beschreiben, was Sie für ein HTTP/S-Ziel angeben müssen:

  1. Geben Sie optional den Gateway-Typ an. Der Gateway-Typ definiert die Art der Übertragung. Wenn Sie z. B. einen Dokumentenaustausch testen wollen, bevor Sie ihn in die Produktion einreihen, würden Sie Test eingeben. Die Standardeinstellung ist Produktion.
  2. Geben Sie die URI für das HTTP/S-Ziel ein. Der Name muss mit bcgreceiver beginnen. Sie könnten z. B. bcgreceiver/submit eingeben. Dokumente, die beim Server über HTTP/S eingehen, würden dann an der Position bcgreceiver/submit empfangen.
  3. Ändern Sie optional die Synchronroutingwerte:

    1. Geben Sie für Max. synchrones Zeitlimit die Anzahl Millisekunden ein, die eine synchrone Verbindung geöffnet bleibt. Der Standardwert ist 600000.
    2. Geben Sie für Max. synchr. simult. Verbindungen die maximale Anzahl synchroner Verbindungen ein, die das System zulässt. Der Standardwert ist 100 für die maximale Anzahl simultaner synchroner Verbindungen.
  4. Wenn Sie die Konfigurationspunkte modifizieren wollen, oder wenn Sie ein Ziel für ein AS2-, cXML-, RNIF- oder SOAP-Dokument konfigurieren, das in einen synchronen Austausch einbezogen wird, lesen Sie Konfigurationspunkte modifizieren.

FTP-Ziel konfigurieren

Die folgenden Schritte beschreiben, was Sie für ein FTP-Ziel angeben müssen:

  1. Geben Sie in das Feld FTP-Verzeichnis das Stammverzeichnis FTP-Servers ein. Informationen zum Konfigurieren des Verzeichnisses für einen FTP-Server finden Sie in Den FTP-Server für das Empfangen von Dokumenten konfigurieren.
  2. Geben Sie optional einen Wert für Nichtänderungsintervall für Datei ein, um die Anzahl Sekunden anzugeben, die die Dateigröße unverändert bleiben muss, bevor Document Manager das Dokument zur Verarbeitung abruft. Der Standardwert ist 3 Sekunden.
  3. Geben Sie optional einen Wert für Threadanzahl ein, um die Anzahl Dokumente anzugeben, die Document Manager gleichzeitig verarbeitet. Der Standardwert 1 wird hier empfohlen.
  4. Geben Sie optional einen Wert für Ausschlussdateierw. ein, um die Dokumententypen anzugeben, die Document Manager ignorieren sollte (von der Verarbeitung ausschließen), falls er die Dokumente im FTP-Verzeichnis findet. Wenn Sie z. B. wollen, dass Document Manager Spreadsheetdateien ignoriert, dann geben Sie in diesem Fall die Erweiterung ein, die ihnen zugeordnet ist. Die Standardeinstellung ist, dass keine Dateitypen ausgeschlossen werden.

SMTP-Ziel konfigurieren

Die folgenden Schritte beschreiben, was Sie für ein SMTP-Ziel (POP3) angeben müssen:

  1. Geben Sie optional den Gateway-Typ an. Die Standardeinstellung ist Produktion.
  2. Geben Sie die Position des POP3-Servers ein, wohin E-Mails zugestellt werden.
  3. Geben Sie optional eine Portnummer ein. Wenn Sie nichts eingeben, wird der Wert 110 verwendet.
  4. Geben Sie die Benutzer-ID und das Kennwort ein, die erforderlich sind, um auf den E-Mail-Server zuzugreifen, falls eine Benutzer-ID und ein Kennwort benötigt werden.
  5. Geben Sie optional einen Wert für Zeitlimit ein, um die Anzahl Sekunden anzugeben, die das Ziel den POP3-Server auf Dokumente hin überwacht. Dieses Feld ist optional. Der Standardwert ist 1 ms.
  6. Geben Sie optional einen Wert für Threadanzahl ein, um die Anzahl Dokumente anzugeben, die Document Manager gleichzeitig verarbeitet. Der Standardwert 1 wird hier empfohlen.
  7. Wählen Sie optional die Tageszeit (Stunden und Minuten) aus, wann das SMTP-Ziel den POP3-Server nach Dokumenten abfragen soll.
  8. Wählen Sie optional die Wochentage aus, wann die Abfrage erfolgen soll. Die Standardeinstellung ist eine tägliche Abfrage.
  9. Wählen Sie optional die Tage im Monat aus, wann die Abfrage erfolgen soll. Die Standardeinstellung ist eine tägliche Abfrage.

JMS-Ziel konfigurieren

Die folgenden Schritte beschreiben, was Sie für ein JMS-Ziel angeben müssen:

  1. Geben Sie optional den Gateway-Typ an. Die Standardeinstellung ist Produktion.
  2. Geben Sie die URL-Adresse des JMS-Providers ein. Diese sollte mit dem Wert übereinstimmen, den Sie eingegeben haben (der Dateisystempfad zur .bindungs-Datei), als Sie WebSphere Business Integration Connect für JMS konfiguriert haben, wie in Den Hub für das JMS-Transportprotokoll konfigurieren beschrieben.
  3. Geben Sie die Benutzer-ID und das Kennwort ein, die erforderlich sind, um auf die JMS-Warteschlange zuzugreifen, falls eine Benutzer-ID und ein Kennwort benötigt werden.
  4. Geben Sie einen Wert für den Namen der JMS-Warteschlange ein. Dies ist ein erforderliches Feld.
  5. Geben Sie einen Wert für den JMS-Factory-Namen ein. Dies ist ein erforderliches Feld.
  6. Geben Sie optional das Provider-URL-Paket ein.
  7. Geben Sie den JNDI-Factory-Namen ein. Wenn Sie nichts eingeben, wird der Wert com.sun.jndi.fscontext.RefFSContextFactory verwendet. Dies ist ein erforderliches Feld.
  8. Geben Sie optional einen Wert für Zeitlimit ein, um die Anzahl Sekunden anzugeben, die das Ziel die JMS-Warteschlange auf Dokumente hin überwacht. Dieses Feld ist optional.
  9. Geben Sie optional einen Wert für Threadanzahl ein, um die Anzahl Dokumente anzugeben, die Document Manager gleichzeitig verarbeitet. Der Standardwert 1 wird hier empfohlen.

Wenn Sie z. B. ein JMS-Ziel konfigurieren wollen, das mit dem JMS-Konfigurationsbeispiel in "Die Konfiguration des Hubs vorbereiten" übereinstimmt, würden Sie wie folgt vorgehen:

  1. Geben Sie den Wert JMSTarget in das Feld Zielname ein.
  2. Geben Sie den Wert file:/C:/TEMP/JMS/JMS in das Feld JMS-Provider-URL ein.
  3. Geben Sie den Wert inQ in das Feld JMS-Warteschlangenname ein.
  4. Geben Sie den Wert WBICHub in das Feld JMS-Factory-Name ein.

Dateisystemziel konfigurieren

Die folgenden Schritte beschreiben, was Sie für ein Dateisystemziel angeben müssen:

  1. Geben Sie optional den Gateway-Typ an. Die Standardeinstellung ist Produktion.
  2. Geben Sie einen Wert für Dokumentstammverzeichnispfad ein, um das Verzeichnis anzugeben, in dem die Dokumente empfangen werden.
  3. Geben Sie optional einen Wert für Abfrageintervall ein, um anzugeben, wie häufig das Verzeichnis nach neuen Dokumenten abgefragt werden soll. Wenn Sie nichts eingeben, wird das Verzeichnis alle 5 Sekunden abgefragt.
  4. Geben Sie optional einen Wert für Nichtänderungsintervall für Datei ein, um die Anzahl Sekunden anzugeben, die die Dateigröße unverändert bleiben muss, bevor Document Manager das Dokument zur Verarbeitung abruft. Der Standardwert ist 3 Sekunden.
  5. Geben Sie optional einen Wert für Threadanzahl ein, um die Anzahl Dokumente anzugeben, die Document Manager gleichzeitig verarbeitet. Der Standardwert 1 wird hier empfohlen.

Konfigurationspunkte modifizieren

Für bestimmte Geschäftsprotokolle (RosettaNet, cXML, SOAP, und AS2), die in synchrone Austauschvorgänge einbezogen werden, müssen Sie einen Handler für den Konfigurationspunkt Synchronprüfung angeben. Sie können auch die Art und Weise modifizieren, wie ein HTTP/S- oder benutzerdefiniertes Ziel Dokumente verarbeitet, indem Sie einen hochgeladenen benutzerdefinierten Handler oder einen vom System bereitgestellten Prozess auf andere Konfigurationspunkte des Ziels anwenden.

Um einen benutzerdefinierten Handler auf diese Konfigurationspunkte anzuwenden, müssen Sie zuerst den Handler hochladen, wie in Benutzerdefinierte Handler hochladen beschrieben. Sie können auch einen vom System bereitgestellten Handler verwenden, der bereits verfügbar ist und nicht mehr hochgeladen werden muss.

Führen Sie die folgenden Schritte aus, um die Konfigurationspunkte zu modifizieren:

  1. Wenn Sie dabei sind, ein Ziel zu erstellen, fahren Sie mit Schritt 2 fort. Wenn Sie eine Zielkonfiguration aktualisieren, klicken Sie auf Hubadmin > Hubkonfiguration > Ziele. Klicken Sie dann auf das Lupensymbol neben dem Ziel. Klicken Sie anschließend auf das Symbol .
  2. Wenn Sie einen Handler für synchrone AS2-, cXML-, SOAP- oder RNIF-Transaktionen angeben, führen Sie die folgenden Schritte aus:

    1. Wählen Sie SyncCheck in der Liste Konfigurationspunkt-Handler aus.
    2. Fügen Sie den entsprechenden Handler der Konfigurationsliste hinzu, indem Sie den Handler in der Verfügbarkeitsliste auswählen und auf Hinzufügen klicken.

      Wiederholen Sie diesen Schritt, wenn Sie der Liste weitere Handler hinzufügen wollen. Denken Sie daran, dass Handler für Ziele in der Reihenfolge aufgerufen werden, in der sie in der Konfigurationsliste angezeigt werden. Der erste verfügbare Handler verarbeitet die Anforderung und die in der Liste nachfolgenden Handler werden nicht aufgerufen. Es empfiehlt sich, den spezifischen Handler für die Synchronprüfung, z. B. com.ibm.bcg.server.sync.As2SyncHdlr für AS2-Transaktionen, aufzulisten, bevor Sie die Standardhandler für die Synchronprüfung auflisten.

    3. Wenn Sie mit dem Definieren der Handler für dieses Ziel fertig sind, klicken Sie auf Speichern. Andernfalls fahren Sie mit Schritt 3 fort.
  3. Wählen Sie in der Liste Konfigurationspunkt-Handler den zu modifizierenden Konfigurationspunkt aus. Die Konfigurationspunkte, die für Ziele modifiziert werden können, sind Vorverarbeitung (preprocess), Synchronprüfung (syncCheck) und Nachverarbeitung (postprocess).

    Abbildung 22. Konfigurationspunkt-Handler für Ziele


  4. Führen Sie mindestens einen der folgenden Schritte für jeden Handler aus, den Sie modifizieren wollen.

    1. Fügen Sie einen Handler hinzu, indem Sie den Handler in der Verfügbarkeitsliste auswählen, und klicken Sie auf Hinzufügen. Der Handler wird in die Konfigurationsliste versetzt.
    2. Entfernen Sie einen Handler, indem Sie den Handler in der Konfigurationsliste auswählen, und klicken Sie auf Entfernen. Der Handler wird in die Verfügbarkeitsliste versetzt.
    3. Ändern Sie die Reihenfolge, in der der Handler verwendet wird, indem Sie den Handler auswählen und auf Nach oben oder Nach unten klicken.
    4. Damit ein Handler mehrfach verarbeitet werden kann, wählen Sie ihn aus, und klicken Sie dann auf Wiederholen.
    5. Konfigurieren Sie den Handler, indem Sie ihn in der Konfigurationsliste auswählen und auf Konfigurieren klicken. Die Liste der Attribute, die konfiguriert werden können, wird angezeigt.
  5. Klicken Sie auf Speichern.

Copyright IBM Corp. 1997, 2004