test

Benutzerhandbuch zu Service Registry 3.1

Veröffentlichen von Objekten

    Die Veröffentlichung von Objekten in der Registry besteht aus drei Schritten.

  1. Erstellen Sie das Objekt.

  2. Fügen Sie Details und andere Objekte hinzu, indem Sie sie im Arbeitsspeicher speichern, aber nicht in der Registry veröffentlichen.

  3. Veröffentlichen Sie das Objekt in der Registry.

Sie können Objekte in der Registry veröffentlichen, wenn Sie ein Benutzerkonto erstellt und sich angemeldet haben. Um ein Benutzerkonto zu erstellen, befolgen Sie die Anweisungen unter Erstellen von Benutzerkonten.

Die erste Aufgabe beschreibt die Schritte zur Erstellung eines neuen Objektes. Im anschließenden Abschnitt werden die weiteren erforderlichen Schritte erläutert, um bestimmte Objektarten zu veröffentlichen.

Sie können sämtliche in Tabelle 2–2 aufgelisteten Objekte erstellen und veröffentlichen, mit Ausnahme der Folgenden:

In diesem Abschnitt werden die folgenden Aufgaben beschrieben:

ProcedureSo erstellen und veröffentlichen Sie ein neues Registry-Objekt

  1. Klicken Sie im linken Menübereich auf der Registerkarte "Aufgaben" auf "Neues Registry-Objekt erstellen".

  2. Wählen Sie im Bereich "Registry-Objekte" einen Objekttyp aus dem Kombinationsfeld aus, und klicken Sie auf "Hinzufügen".

    Im Bereich "Details" wird daraufhin ein Detailformular für das Objekt angezeigt.

  3. Geben Sie einen Namen im Feld "Name" ein.

  4. (Optional) Geben Sie eine Beschreibung im Feld "Beschreibung" ein.

  5. (Optional) Geben Sie einen Kommentar im Feld "Versionskommentar" ein.

  6. (Optional) Ersetzen Sie die zugewiesene eindeutige Kennung und logische eindeutige Kennung mit IDs Ihrer Wahl.

    Jede ID muss einen gültigen URN aufweisen und innerhalb Ihrer Registry-Installation eindeutig sein.

  7. Geben Sie in die Felder die dem Objekttyp entsprechenden Daten ein.

  8. Klicken Sie auf "Speichern", um das Objekt zu speichern.

    Hinweis –

    Speichern Sie die in jedem Registerkartenbereich vorgenommenen Änderungen für das Objekt, bevor Sie zur nächsten Registerkarte wechseln. Ansonsten gehen nicht gespeicherte Änderungen verloren.

  9. (Optional) Verwenden Sie die Registerkarten im Formular "Details", um zusammengesetzte Objekte hinzuzufügen und zu speichern.

  10. Klicken Sie auf "Anwenden", um das Objekt in der Registry zu veröffentlichen.

    Eine Statusmeldung zeigt an, ob der Vorgang erfolgreich war.

Nächste Schritte

Sie können das Objekt bearbeiten, bevor oder nachdem Sie es veröffentlichen, indem Sie ihm weitere Objekte hinzufügen. Tabelle 2–4 führt die Objekte auf, die Sie hinzufügen können. In den folgenden Abschnitten wird beschrieben, wie diese Objekte hinzugefügt werden.

ProcedureSo erstellen und veröffentlichen Sie ein AdhocQuery-Objekt

Ein AdhocQuery-Objekt stellt eine in einer Abfragesyntax ausgerückte Ad-hoc-Anfrage dar. AdhocQuery-Objekte werden zum Ermitteln von Registry-Objekten verwendet. AdhocQuery-Objekte erfüllen einen ähnlichen Zweck wie gespeicherte Prozeduren in relationalen Datenbanken. Beispielsweise handelt es sich bei den vordefinierten Abfragen im Suchfenster um AdhocQuery-Objekte.

  1. Führen Sie die Schritte 1 – 6 in So erstellen und veröffentlichen Sie ein neues Registry-Objekt aus. Wählen Sie in Schritt 2 "AdhocQuery" aus.

  2. (Optional) Wählen Sie einen Abfragetyp aus dem Kombinationsfeld "Abfragetyp" aus.

    "SQL-Abfrage" lautet die Standardeinstellung. Zu den weiteren unterstützten Abfragetypen zählen XQuery und die ebXML-Filterabfrage.

  3. Geben Sie den Abfragetext in das Feld "Abfragezeichenfolge" ein.

    Schließen Sie Elemente für die SQL-Abfrage in doppelten Anführungszeichen ein, die Sie normalerweise in einfachen Anführungszeichen einschließen. Bei diesen Elementen handelt es sich in der Regel um Parameterplatzhalter und Literale, die in Unterabfragen auftauchen. Geben Sie z. B. einen Parameterplatzhalter in einer Unterabfrage wie folgt an:

    (SELECT id FROM ClassificationNode WHERE path LIKE ''$objectTypePath'')

    Geben Sie sowohl einen Literal- als auch einen Parameterplatzhalter wie folgt an:

    ... AND (ro.id = s.parent AND s.name_ = 
''urn:oasis:names:tc:ebxml-regrep:profile:ws:wsdl:nameSpacesUsed'' AND 
s.value LIKE ''$nameSpacePattern'')

  4. Führen Sie die Schritte 8 – 10 in So erstellen und veröffentlichen Sie ein neues Registry-Objekt aus.

ProcedureSo erstellen und veröffentlichen Sie ein ClassificationNode-Objekt

Ein ClassificationNode-Objekt stellt ein Taxonomieelement dar, dass eine strukturelle Beziehung zu anderen Elementen in einem internen Klassifizierungsschema aufweist. Sie können ein ClassificationNode-Objekt erstellen, und es anschließend zu einem Klassifizierungsschema hinzufügen.Jedoch ist es möglicherweise einfacher über die Registerkarte "Konzepte" des ClassificationScheme-Fensters "Details" Konzepte zu erstellen.

  1. Führen Sie die Schritte 1 – 6 in So erstellen und veröffentlichen Sie ein neues Registry-Objekt aus. Wählen Sie in Schritt 2 "ClassificationNode" aus.

  2. Geben Sie für das ClassificationNode-Objekt einen Wert in das Feld "Wert" ein.

    Die Felder "Klassifizierungsschema", "Übergeordnete ID" und "Pfad" sind abgeblendet dargestellt.

  3. Führen Sie die Schritte 8 – 10 in So erstellen und veröffentlichen Sie ein neues Registry-Objekt aus.

ProcedureSo erstellen und veröffentlichen Sie ein ClassificationScheme-Objekt

Ein ClassificationScheme-Objekt stellt ein Taxonomieelement zur Klassifizierung von Objekten dar. In einem internen ClassificationScheme-Objekt sind sämtliche Taxonomieelemente in dem Registry als Concept-Instanzen festgelegt. In einem externen ClassificationScheme-Objekt sind die Werte nicht im Registry als Concept-Instanzen festgelegt, sondern werden durch ihre String-Darstellungen referenziert.

  1. Führen Sie die Schritte 1 – 6 in So erstellen und veröffentlichen Sie ein neues Registry-Objekt aus. Wählen Sie in Schritt 2 "ClassificationScheme" aus.

    Das aktivierte Kontrollkästchen "Externes ClassificationScheme" zeigt an, dass für das Schema keine Konzepte vorhanden sind. Wenn Sie zu diesem ClassificationScheme Konzepte hinzufügen, wird das Kontrollkästchen automatisch deaktiviert.

  2. Wählen Sie im Kombinationsfeld "Wertetyp" einen Wert aus:

    • Eindeutig. Gibt an, dass jeder Knoten der Taxonomie über einen eigenen ihm zugewiesenen eindeutigen Code verfügt.

    • Eingebetteter Pfad. Gibt an, dass der eindeutige Code, der den einzelnen Knoten der Taxonomie zugewiesen ist, auch als Code für diesen Pfad dient.

    • Nicht eindeutig. Zeigt an, dass Knoten nicht eindeutig sind und es erforderlich ist, den gesamten Pfad zu verwenden (vom ClassificationScheme zum betreffenden Knoten), um den Knoten zu identifizieren.

    Die Standardeinstellung lautet "Eindeutig".

  3. Führen Sie die Schritte 8 – 10 in So erstellen und veröffentlichen Sie ein neues Registry-Objekt aus.

ProcedureSo erstellen und veröffentlichen Sie ein ExternalLink-Objekt

Ein ExternalLink-Objekt gibt einen URI für Inhalte an, die sich außerhalb der Registry befinden.

  1. Führen Sie die Schritte 1 – 6 in So erstellen und veröffentlichen Sie ein neues Registry-Objekt aus. Wählen Sie in Schritt 2 "ExternalLink" aus.

    Das Feld "Objekttyp" enthält den Wert ExternalLink.

  2. (Optional) Klicken Sie auf die Schaltfläche "Konzept für Objekttyp auswählen", um einen Objekttyp für die vom URI referenzierten Daten auszuwählen.

    Erweitern Sie im Fenster zur Auswahl der Klassifizierungsknoten für Extrinsic-Objekte die Knoten bis zum gewünschten Konzept innerhalb des ExtrinsicObject-Typs. Wenn Sie auf "OK" klicken, wird der ausgewählte Typ in das Fenster "Objekttyp" übernommen.

  3. Geben Sie den URI für den externen Link in das Feld "Externer URI" ein.

  4. Führen Sie die Schritte 8 – 10 in So erstellen und veröffentlichen Sie ein neues Registry-Objekt aus.

    Hinweis –

    Wird beim Speichern eines ExternalLink-Objekts eine Fehlermeldung angezeigt, muss eine administrative Aufgabe ausgeführt werden. Weitere Informationen finden Sie unter ExternalLink oder ServiceBinding kann nicht erstellt werden.

ProcedureSo erstellen und veröffentlichen Sie ein ExtrinsicObject-Objekt

Ein ExtrinsicObject stellt Metadaten bereit, die Inhalte beschreiben, deren Typ in der Registry eigentlich bekannt ist, und daher durch zusätzliche Attribute, wie z. B. MIME-Typ, beschrieben werden muss.

Verwenden Sie ein ExtrinsicObject um unterschiedliche Dateien zu veröffentlichen. Dabei handelt es sich meistens um Webdienstelemente wie WSDL-Dateien.

Das ebXML-Registry-Profil für Web-Services ist ein OASIS-Standard, der das ebXML-Registry-Profil für Veröffentlichung, Verwaltung, Führung, Discovery und Wiederverwendung von Webdienstelemente festlegt. Service Registry implementiert dieses Profil standardmäßig. In der Praxis bedeutet dies, dass Sie die Registry beim Veröffentlichen einer WSDL-Datei auf der Registry als ExtrinsicObject-Objekt einige Metadaten für das Dokument erstellt, tatsächlich wird jedoch der Webdienst durch das Dokument erstellt. Diese Funktion wird als WSDL-Katalogisierung bezeichnet.

Um mindestens eine WSDL-Datei zu veröffentlichen, bei denen Abhängigkeiten zueinander oder zu anderen Dateien vorhanden sind (wie z. B. XSD-Dateien), erstellen Sie eine ZIP-Datei mit sämtlichen Dateien.

Ein Administrator hat die Möglichkeit, die WSDL-Katalogisierungsfunktion zu deaktivieren. Weitere Informationen finden Sie im Abschnitt Disabling the WSDL Cataloger in Service Registry 3.1 Administration Guide.

  1. Führen Sie die Schritte 1 – 6 in So erstellen und veröffentlichen Sie ein neues Registry-Objekt aus. Wählen Sie in Schritt 2 "ExtrinsicObject" oder eine der zugehörigen Untertypen aus.

    Wählen Sie z. B. WSDL aus, um mindestens eine WSDL-Datei zu veröffentlichen.

  2. (Optional) Geben Sie den MIME-Typ des Objekts in das Feld "MIME-Typ" ein. Dabei sollte es sich um einen der unter http://www.iana.org/assignments/media-types aufgelisteten Typen handeln.

    Wenn Sie eine eigenständige WSDL-Datei hochladen (eine Textdatei mit XML), geben Sie für den MIME-Typ text/xml an.

    Laden Sie eine ZIP-Datei mit mehreren WSDL-Dateien (und optional XSD-Dateien) hoch, geben Sie für den MIME-Typ application/zip an.

  3. (Optional) Aktivieren Sie das Kontrollkästchen "Ist undurchlässig", wenn der Inhalt des Objekts von der Registry nicht gelesen werden kann (z. B. wenn dieser verschlüsselt ist).

  4. Klicken Sie auf die Schaltfläche "Konzept für Objekttyp auswählen", um einen genaueren Objekttyp als ExtrinsicObject auszuwählen.

    Erweitern Sie im Fenster zur Auswahl der Klassifizierungsknoten für Extrinsic-Objekte die Knoten bis zum gewünschten Konzept innerhalb des ExtrinsicObject -Typs. Nach dem Klicken auf "OK" enthält das Fenster "Objekttyp" den von Ihnen ausgewählten Typ.

  5. Klicken Sie auf die Schaltfläche "Repository-Elementdatei auswählen...", um nach dem Repository-Element für das ExtrinsicObject zu suchen.

    1. Geben Sie im Fenster "Hochladen von Dateien" den Dateipfad im Textfeld ein, oder klicken Sie auf "Durchsuchen".

    2. Wenn Sie auf "Durchsuchen" klicken, suchen Sie die Datei im Fenster zum Durchsuchen aus, und klicken Sie auf "Öffnen".

    3. Klicken Sie im Fenster "Hochladen von Dateien" auf "Datei hochladen".

    4. Klicken Sie auf "OK".

    Die folgenden weiteren Elemente werden im Detailfenster angezeigt:

    • Das Feld mit der Inhaltsversion (grau hinterlegt)

    • Das Feld "Kommentar zur Inhaltsversion", in das Sie Text eingeben können

    • Die Schaltfläche "Repository-Element entfernen"

    • Der Link "Inhalt des Repository-Elements anzeigen"

  6. Führen Sie die Schritte 8 – 10 in So erstellen und veröffentlichen Sie ein neues Registry-Objekt aus.

Nächste Schritte

Nach dem Erstellen eines ExtrinsicObject-Objekts, das sich auf eine WSDL-Datei bezieht, können Sie dieses über die WSDL-Discovery-Abfrage suchen. Wenn Sie über die Basisabfrage nach ExtrinsicObject-Objekten vom Typ WSDL, nach Service-Objekten und nach ServiceBinding-Objekten suchen, stellen Sie fest, dass die Registry sämtliche durch die Elemente der WSDL-Datei festgelegten Objekte erstellt hat:

ProcedureSo erstellen und veröffentlichen Sie ein Federation-Objekt

Ein Federation-Objekt stellt eine zusammengeschlossene Gruppe von Registrys dar. Zu den einzigen Attributen zählen die grundlegenden RegistryObject-Attribute. Sie müssen über Administratorrechte verfügen, um ein Federation-Objekt zu erstellen.

  1. Führen Sie die Schritte 1 – 6 in So erstellen und veröffentlichen Sie ein neues Registry-Objekt aus. Wählen Sie in Schritt 2 "Federation" aus.

  2. Führen Sie die Schritte 8 – 10 in So erstellen und veröffentlichen Sie ein neues Registry-Objekt aus.

  3. Fügen Sie zusammengeschlossene Registrys zu einem Federation-Objekt hinzu, indem Sie den unter Erstellen von Beziehungen zwischen Objekten beschriebenen Anweisungen folgen. Die einzelnen Schritte lauten wie folgt:

    1. Suchen Sie den Verbund (Federation), aktivieren Sie das Kontrollkästchen "Auswählen", und klicken Sie anschließend auf "Bookmarklet".

    2. Suchen Sie die Registry, aktivieren Sie das Kontrollkästchen "Auswählen", und klicken Sie auf "Zuordnen".

    3. Wählen Sie im Bereich "Beziehung erstellen" den Verbund als Quellobjekt aus. Die Registry wird zum Zielobjekt.

    4. Legen Sie "AssociationType" auf "HasFederationMember" fest.

ProcedureSo erstellen und veröffentlichen Sie ein Organization-Objekt

Ein Organization-Objekt stellt Informationen zu einer Organisation bereit. Es kann über eine übergeordnete Organisation und mindestens eine Unterorganisation verfügen. Dieses Objekt verfügt stets über ein User-Objekt als primären Kontakt, und stellt möglicherweise Dienste bereit, indem Zuordnungen zwischen der Organisation und mindestens einem Service-Objekt erstellt werden.

  1. Führen Sie die Schritte 1 – 6 in So erstellen und veröffentlichen Sie ein neues Registry-Objekt aus. Wählen Sie in Schritt 2 "Organization" aus.

  2. (Optional) Geben Sie in die Felder für Postanschriften Werte ein.

  3. Führen Sie die Schritte 8 – 10 in So erstellen und veröffentlichen Sie ein neues Registry-Objekt aus.

    In den folgenden Abschnitten finden Sie weitere Informationen zum Hinzufügen von zusammengesetzten Objekten zu einem Organization-Objekt:

  4. Um ein Service-Objekt zu einer Organization hinzuzufügen, führen Sie die unter Erstellen von Beziehungen zwischen Objekten beschriebenen Schritte aus. Die einzelnen Schritte lauten wie folgt:

    1. Suchen Sie die Organisation, aktivieren Sie das Kontrollkästchen "Auswählen", und klicken Sie auf "Bookmarklet".

    2. Suchen Sie den Dienst, aktivieren Sie das Kontrollkästchen "Auswählen", und klicken Sie auf "Zuordnen".

    3. Wählen Sie im Bereich "Beziehung erstellen" die Organisation als Quellobjekt aus. Der Dienst wird zum Zielobjekt.

    4. Legen Sie den "AssociationType" auf "OffersService" fest.

ProcedureSo erstellen und veröffentlichen Sie ein Person- oder User-Objekt

Ein Person- oder User-Objekt stellt Informationen zu Personen und registrierten Benutzern innerhalb des Registrys bereit. Beide Objekte verfügen über identische Attribute. Ein User-Objekt ist mit einem Organization-Objekt als primären Kontakt verbunden. User-Objekte werden ebenfalls in AuditableEvent-Objekten verwendet, um den Anforderer zu identifizieren, der die AuditableEvent-Objekt generierende Anforderung gesendet hat.

Es wird empfohlen, User-Objekte mithilfe des Assistenten zur Benutzerregistrierung zu erstellen. Verwenden Sie die Webkonsole zum Erstellen von Person-Objekten, wenn Sie Metadaten zu Personen erstellen möchten, die nicht selbst auf die Registry zugreifen.

Um mehr als eine Postanschrift, E-Mail-Adresse oder Telefonnummer für eine Person einzugeben, erstellen Sie ein User-Objekt. Die Webkonsole bietet Ihnen die Möglichkeit, Postanschriften, E-Mail-Adressen und Telefonnummern als zusammengesetzte Objekte für ein User-Objekt hinzuzufügen, jedoch nicht für ein Person-Objekt.

  1. Führen Sie die Schritte 1 – 6 in So erstellen und veröffentlichen Sie ein neues Registry-Objekt aus. Wählen Sie in Schritt 2 "Person" oder "User" aus.

  2. Geben Sie in den Feldern "Personenname" Werte ein.

    Machen Sie in mindestens einem dieser Felder eine Eingabe.

    Verwenden Sie nicht das Feld "Name". Die Webkonsole ignoriert im Feld "Name" eingegebene Werte für ein Person- oder User-Objekt.

  3. Fügen Sie zusammengesetzte Objekte hinzu, wie in den folgenden Abschnitten beschrieben:

  4. Führen Sie die Schritte 8 – 10 in So erstellen und veröffentlichen Sie ein neues Registry-Objekt aus.

ProcedureSo erstellen und veröffentlichen Sie ein Registry-Objekt

Ein Registry-Objekt steht für eine Registry. Es verfügt lediglich über die grundlegenden RegistryObject-Attribute. Sie müssen als Administrator angemeldet sein, um ein Registry-Objekt zu erstellen.

  1. Führen Sie die Schritte 1 – 6 in So erstellen und veröffentlichen Sie ein neues Registry-Objekt aus. Wählen Sie in Schritt 2 "Registry" aus.

  2. Führen Sie die Schritte 8 – 10 in So erstellen und veröffentlichen Sie ein neues Registry-Objekt aus.

Nächste Schritte

Weitere Informationen zum Hinzufügen der Registry zu einem Verbund finden Sie im Abschnitt So erstellen und veröffentlichen Sie ein Federation-Objekt .

ProcedureSo erstellen und veröffentlichen Sie ein RegistryPackage-Objekt

Ein RegistryPackage-Objekt stellt eine logische Gruppierung einer beliebigen Anzahl an Registry-Objekten dar.

  1. Führen Sie die Schritte 1 – 6 in So erstellen und veröffentlichen Sie ein neues Registry-Objekt aus. Wählen Sie in Schritt 2 "RegistryPackage" aus.

  2. Führen Sie die Schritte 8 – 10 in So erstellen und veröffentlichen Sie ein neues Registry-Objekt aus.

  3. Um Objekte zum Package hinzuzufügen, folgen Sie den Anweisungen in Abschnitt Hinzufügen von Objekten zu einem Registry-Paket.

ProcedureSo erstellen und veröffentlichen Sie ein Service-Objekt

Ein Service-Objekt stellt Informationen zu einem Dienst bereit. Diese Objekt kann mindestens ein ServiceBinding-Objekt mit technischen Informationen über den Zugriff auf den Dienst enthalten.

Die gängigste Methode ein Service-Objekt zu veröffentlichen, ist die Veröffentlichung eines ExtrinsicObject-Objekts, dessen Inhalt aus mindestens einer WSDL-Datei besteht. Weitere Informationen finden Sie unter So erstellen und veröffentlichen Sie ein ExtrinsicObject-Objekt .

  1. Führen Sie die Schritte 1 – 6 in So erstellen und veröffentlichen Sie ein neues Registry-Objekt aus. Wählen Sie in Schritt 2 "Service" aus.

  2. Führen Sie die Schritte 8 – 10 in So erstellen und veröffentlichen Sie ein neues Registry-Objekt aus.

  3. Um ein ServiceBinding-Objekt zu einem Dienst hinzuzufügen, folgen Sie den Anweisungen in Abschnitt Hinzufügen einer Dienstbindung zu einem Dienst.

  4. Um ein SpecificationLink-Objekt zu einem ServiceBinding-Objekt hinzuzufügen, folgen Sie den Anweisungen in Abschnitt Hinzufügen eines Spezifizierungslinks zu einer Dienstbindung.