Vorgaben für externe Services

Um die Integration mit einem externen Dienst wie einer FileNet Image Services (IS)-Bibliothek zu ermöglichen, installieren und konfigurieren Sie einen Ressourcenadapter und anschließend konfigurieren Sie die Sitevorgaben Externe Services. Sobald ein externer Dienst aktiviert ist, kann ein Benutzer eine Datei in einem Objektspeicher ablegen, der sich in einer externen Datenbank befindet. Der Inhalt der Datei verbleibt in der externen Datenbank und kann nicht über die Anwendung ausgecheckt oder geändert werden. Die Benutzer können die Datei jedoch anzeigen und ihre Eigenschaften aktualisieren.

Um beispielsweise auf Dateien in einer FileNet IS-Bibliothek im gleichen Netzwerk zuzugreifen, installieren und konfigurieren Sie den FileNet Image Services Resource Adapter (ISRA) auf dem Application Engine-Server. In der ISRA-Konfiguration konfigurieren Sie die Resource Adapter-Deskriptoren so, dass die Eigenschaft JNDI-Name auf den symbolischen Namen (Domänenname) der FileNet Image Services-Bibliothek gesetzt ist, auf die Sie zugreifen möchten. Wenn der Bibliotheksname beispielsweise atlas:Pacific lautet, geben Sie atlas ein.

HINWEIS Bevor Sie die Einstellungen konfigurieren können, müssen Sie die entsprechende Ressourcenadapter-Software installieren.

Dienst-Name

Jeder konfigurierte externe Dienst wird zusammen mit einer kurzen Beschreibung angezeigt. Sie können einen neuen externen Dienst hinzufügen oder einen vorhandenen Dienst ändern oder löschen.

So konfigurieren Sie einen externen Referenzdienst:

  1. Wechseln Sie zu Sitevorgaben > Externe Services.
  2. Klicken Sie auf Neu hinzufügen, oder klicken Sie unter dem Namen eines vorhandenen Dienstes auf Ändern. Geben Sie die Informationen für externe Services ein, indem Sie die folgende Tabelle als Richtlinie verwenden.
    Allgemeine Informationen Beschreibung Beispiel für die Verwendung einer FileNet IS-Bibliothek als externen Dienst (nur Workplace)
    Angezeigter Dienstname Der Dienstname, der im Feld Typ des Schritts Datei auswählen angezeigt wird, wenn Sie ein Dokument hinzufügen oder auschecken. Image Service

    Image Service wird in der Spalte Typ (der Datei) angezeigt.

    Dienst-Standort für die Umleitung Das Servlet des Anbieters des externen Dienstes, das verwendet wird, um Inhalte abzurufen.

    Bei einem externen Anwenderdienst geben Sie den Namen des Servlet ein, das vom Anbieter bereitgestellt ist.

    Für IS bietet sich eine der beiden folgenden Möglichkeiten an:
    • getISContent
      (zur Verwendung des Servlets auf dem Server, der als Host für Workplace dient)
    • http://andereAppEngine:Port
      /Workplace/getISContent

      (zur Verwendung eines Servlets auf einem anderen Anwendungsserver)
    Referenzierter Inhaltstyp MIME-Typ, der vom Ressourcenanbieter bereitgestellt ist (informiert Content Engine, dass es sich um ein externes Dokument handelt und identifiziert den Typ des Dokuments) application/x-filenet-external-is

    (MIME-Typ für FileNet ISRA)

    Seite Anzeigen beim Auswählen einer Datei Dient zum Anzeigen oder Ausblenden der Option Externer Dienst im Schritt Datei auswählen, wenn Sie ein Dokument hinzufügen oder auschecken. Anzeigen

    Wählen Sie Anzeigen, um Image Services auf den Seiten des Assistenten zum Hinzufügen von neuen Dokumenten und des Assistenten zum Einchecken von Dokumenten einzubeziehen.

    Token erforderlich Dient zum Festlegen, ob ein Benutzertoken an den externen Dienst weitergegeben wird, um Zugriff zu gewähren, ohne den Benutzer zu zwingen, sich beim Dienst anzumelden. Die Standardeinstellung ist Nein. Ja

    Wählen Sie Ja, damit die Anmeldeinformationen des Benutzers automatisch an Image Services weitergegeben werden.

    Flag 'Umleitung einbeziehen' Dient zur Festlegung, ob die Einstellung der Eigenschaft IgnoreRedirect (Umleitung ignorieren) für das Dokument an die Webadresse angefügt wird. Wenn dieser Wert auf Ja gesetzt ist und die Eigenschaft IgnoreRedirect für das Dokument wahr ist, wird der Inhalt des Dokuments nicht zu einer anderen Anwendung umgeleitet, sondern im Browser angezeigt. Die Standardeinstellung ist Ja.

    Diese Einstellung interagiert mit den Einstellungen in der Datei content_redir.properties auf dem Application Engine-Server. Weitere Informationen zum Festlegen, welche Dateien in welcher Anwendung geöffnet werden sollen, finden Sie in Datei content_redir.properties.

    Ja

    Wenn dieser Wert auf Nein gesetzt ist, wird durch die Datei content_redir.properties auf dem Application Engine-Server bestimmt, ob das Dokument im Image Viewer oder im Browser geöffnet wird. Die Standardeinstellungen in dieser Datei bewirken, dass die Bildtypen (wie BMP, JPG, TIFF und COLD) zu Image Viewer umgeleitet werden.

    URI-Informationen (Schema W3C RFC 2396) Beschreibung Beispiel
    URI <Schema>:<absoluter_Pfad> Dies ist der absolute Pfad zur externen Ressource. Das Format ist Schema:absoluter_Pfad filenet:/is
    Parametrierter URI Eine klassierte Liste der Parameter, definiert durch die Parameter {0} bis {3}. Das Format ist ?query.

    Geben Sie den parametrierten URI ohne Leerzeichen oder Zeilenumbrüche ein.

    ?libraryName={0}&id={1}
    &objectType=document
    &pageNumber={2}

    Dient zum Definieren der Felder, wie in den nachstehenden Beispielen mit Bezug auf Schema RFC 2396 gezeigt.

    Anzeigename für Parameter {0} Der erste von bis zu vier Parametern, die neben den Eingabefeldern für den externen Dienst angezeigt werden, wenn Sie ein Dokument hinzufügen oder einchecken. Bibliotheksname

    Bibliotheksname ist die Feldbezeichnung. Es wird erwartet, dass der Benutzer einen Bibliotheksnamen eingibt.

    Hinweis mit optionalem Format für {0} Ein Hinweistext oder eine Beschreibung für Parameter {0}. Dieser Text wird unter dem ersten Feld angezeigt. (Beispiel: SolarImages)

    Dient zum Anzeigen dieses Textes als Hinweis unter Bibliotheksname.

    Anzeigename für Parameter {1} Der zweite von bis zu vier Parametern, die neben den Eingabefeldern für den externen Dienst angezeigt werden, wenn Sie ein Dokument hinzufügen oder einchecken. Dokument-ID

    Dokument-ID ist die Feldbezeichnung. Dieses Feld erfordert die Dokument-ID.

    Hinweis mit optionalem Format für {1} Ein Hinweistext oder eine Beschreibung für Parameter {1}. Dieser Text wird unter dem zweiten Feld angezeigt. (Beispiel: 123456)

    Dient zum Anzeigen dieses Textes als Hinweis unter Dokument-ID.

    Anzeigename für Parameter {2} Der dritte von bis zu vier Parametern, die neben den Eingabefeldern für den externen Dienst angezeigt werden, wenn Sie ein Dokument hinzufügen oder einchecken. Seitenzahl

    Seitenzahl ist die Feldbezeichnung. Bei IS gibt der Benutzer eine bestimmte Seitenzahl oder eine 0 ein, um alle Seiten abzurufen.

    Hinweis mit optionalem Format für {2} Ein Hinweistext oder eine Beschreibung für Parameter {2}. Dieser Text wird unter dem dritten Feld angezeigt. (Geben Sie eine Seitenzahl ein, oder 0, um alle Seiten abzurufen.)

    Dient zum Anzeigen dieses Textes als Hinweis unter Seitenzahl.

    Anzeigename für Parameter {3} Der vierte von bis zu vier Parametern, die neben den Eingabefeldern für den externen Dienst angezeigt werden, wenn Sie ein Dokument hinzufügen oder einchecken. Nicht für IS verwendet.
    Hinweis mit optionalem Format für {3} Ein Hinweistext oder eine Beschreibung für Parameter {3}. Dieser Text wird unter dem vierten Feld angezeigt.  
  3. Speichern Sie die Änderungen.