Domino-Dokument erstellen
Verwenden Sie die Aktivität 'Dokument erstellen', um ein Dokument im Domino-Server zu erstellen.
Aktivität 'Erstellen' verwenden
- Klicken Sie im Teilfenster Projekt mit der rechten Maustaste auf Orchestrierung und klicken Sie dann auf Neue Orchestrierung, um eine Orchestrierung zu erstellen oder zu öffnen. Das Teilfenster 'Orchestrierung' wird angezeigt.
- Wählen Sie die Registerkarte Aktivitäten aus und erweitern Sie den Ordner Domino.
- Ziehen Sie die Aktivität Dokument erstellen aus dem Ordner Domino an die Orchestrierung. Die grafische Darstellung der Orchestrierung einschließlich der Prüfliste wird angezeigt.
- Im Teilfenster Prüfliste werden die Tasks aufgelistet (Zusammenfassung, Endpunkt auswählen, Konfigurieren, Eingaben zuordnen, Ausgaben zuordnen), die Sie zum Konfigurieren der abgehenden Aktivität ausführen müssen.
- Klicken Sie auf Endpunkt auswählen und wählen Sie dann einen Domino-Endpunkt aus.
Anweisungen zur Erstellung oder Bearbeitung eines Domino-Endpunkts finden Sie in Endpunkt für eine Domino-Aktivität erstellen oder bearbeiten.
- Klicken Sie in der Prüfliste auf Konfigurieren. Das Teilfenster 'Konfiguration' wird angezeigt.
- Klicken Sie auf Durchsuchen, um im Teilfenster 'Domino-Datenbanken durchsuchen' eine vorhandene Datenbank auszuwählen. Das Teilfenster 'Domino-Datenbanken durchsuchen' zeigt alle Datenbanken für den ausgewählten Endpunkt an.
- Klicken Sie auf Weiter, um im Teilfenster 'Domino-Formulare durchsuchen' ein vorhandenes Formular auszuwählen. Im Teilfenster 'Domino-Formulare durchsuchen' werden alle Formulare angezeigt, die in der ausgewählten Datenbank des Domino-Servers vorhanden sind.
Eingabenzuordnung für die Aktivität 'Erstellen' angeben
- Klicken Sie im Teilfenster Prüfliste auf Eingaben zuordnen. Die Eingabeparameter für diese bestimmte Domino-Aktivität werden unter dem Teilfenster An Aktivität angezeigt.Anmerkung: Sie müssen alle erforderlichen Eingabeparameter der Aktivität zuordnen, deren Daten aus einer vorhergehenden Aktivität stammen.Anmerkung: Verwenden Sie zum Füllen dynamisch hinzugefügter Felder des Domino-Dokuments, die nicht zur Struktur der Eingabezuordnung gehören, die Eigenschaft AdditionalFields und geben Sie die Feldnamen und Feldwerte im Abschnitt FieldDetails an.
Für Formulartypen, die für mehrere Datenbanken gleich sind, können Sie jetzt den Datenbanknamen als Teil der optionalen Parameter in 'Eingaben zuordnen' angeben. Dadurch können mit derselben Orchestrierung abgehende Operationen an verschiedenen Datenbanken ausgeführt werden. Dazu müssen Sie den Datenbanknamen im optionalen Parameter databaseName (in der nachfolgenden Tabelle beschrieben) angeben. Wenn der Parameter databaseName mit einem Wert gefüllt wird, wird die abgehende Operation an der Datenbank ausgeführt, die im Parameter databaseName angegeben ist. Wenn kein Wert angegeben ist, wird der Datenbankname, der bei der Konfiguration angegeben wurde, zur Ausführung der abgehenden Operation verwendet.
Der optionale Eingabeparameter wird in der folgenden Tabelle beschrieben:
Tabelle 1. Optionaler Parameter für den Datenbanknamen Parametername Beschreibung databaseName Gibt den Datenbanknamen an, der dynamisch in 'Eingaben zuordnen' hinzugefügt werden kann, um es einer einzelnen Orchestrierung zu ermöglichen, abgehende Operationen über mehrere Datenbanken hinweg auszuführen, die denselben Formulartyp haben. Der Domino-Connector unterstützt außerdem eine dynamische Endpunktverbindung zu einem anderen Domino-Server. Während der Laufzeit können Sie, wenn Sie dies wünschen, eine dynamische Verbindung zu einem anderen Domino-Server herstellen als dem, der auf der Endpunktseite konfiguriert ist, indem Sie die neuen optionalen Parameter in dominoConnectionProperties von 'Eingaben zuordnen' hinzufügen. Die Parameter von dominoConnectionProperties werden in der folgenden Tabelle beschrieben:Tabelle 2. Optionale Verbindungsparameter Parameter Beschreibung Parameter für dominoConnectionProperties hostName Gibt den Hostnamen oder die IP-Adresse der Maschine an, auf der der Domino-Server aktiv ist. diiopPort Gibt den DIIOP-Port (Domino Internet Inter ORB Protocol) an, über den Java™-Applets oder -Anwendungen mit CORBA per Fernzugriff auf Domino-Daten zugreifen können. Der Standardwert ist 63148. username Gibt den Benutzernamen für die Verbindung zu dem Domino-Server an. password Gibt das Kennwort zu dem Benutzernamen an, der zum Herstellen einer Verbindung zu dem Domino-Server verwendet werden soll. Parameter für connectionPool minimumConnections Gibt die niedrigste Anzahl von Verbindungen zum Domino-Server an, die von der Integrationseinheit (Integration Appliance) im Verbindungspool offen gehalten werden. Die Eingabe des Werts 0 (null) wird unterstützt. Der Standardwert ist 5. maximumConnections Gibt die höchste Anzahl von Verbindungen zum Domino-Server an, die von der Integrationseinheit (Integration Appliance) im Verbindungspool offen gehalten werden können. Die Eingabe des Werts 0 (null) bedeutet, dass die maximale Anzahl von Verbindungen unbegrenzt ist. Der Standardwert ist 25. maxIdleTime Gibt die Zeitdauer in Minuten an, die eine Verbindung zum Domino-Server im Leerlauf geöffnet sein kann, bevor sie von der Integrationseinheit (Integration Appliance) geschlossen wird. Die Angabe des Werts 0 (null) bedeutet, dass die Verbindungen geschlossen werden, wenn Sie an den Pool zurückgegeben werden (keine Leerlaufzeit). Der Standardwert ist 120 Minuten. maxWait Gibt den Zeitraum in Sekunden an, die die Integrationseinheit (Integration Appliance) auf eine Verbindung wartet, wenn alle Verbindungen im Pool abgelaufen sind. Falls nach der Wartezeit keine Verbindung angefordert wird, wird eine Ausnahmebedingung ausgelöst. Der Standardwert ist 300 Sekunden. reclaimConnections Gibt das Intervall an, in dem der Connector auf inaktive Verbindungen prüft. Inaktive Verbindungen werden zurückgefordert, bis die Mindestanzahl an Verbindungen erreicht ist, die im Parameter 'Mindestanzahl Verbindungen' angegeben ist. Der Standardwert ist 5 Minuten.
Ausgabenzuordnung für die Aktivität 'Erstellen' angeben
- Klicken Sie im Teilfenster Prüfliste auf Ausgaben zuordnen.
Die Ausgabeparameter für die Domino-Aktivität werden unter dem Teilfenster Von Aktivität angezeigt.
Die Antwort der Eigenschaft AdditionalFields wird ebenfalls im Fenster Von Aktivität angezeigt.
In der folgenden Tabelle werden einige der allgemeinen Ausgabeparameter definiert.Parametername Beschreibung UniversalID Die 'UniversalID' eines Dokuments ist eine Lese-/Schreibeigenschaft, die ein Dokument unter allen Replikaten einer Datenbank eindeutig identifiziert. In Zeichenformat ist UniversalID eine aus 32 Zeichen bestehende Kombination aus Hexadezimalziffern (0-9, A-F). Die UniversalID wird auch als eindeutige ID (uniqueID) oder Universal-ID (UNID) bezeichnet. Der Datentyp ist 'Zeichenfolge' (string). NotesID Die 'NotesID' eines Dokuments ist eine schreibgeschützte Eigenschaft und besitzt einen Hexadezimalwert von bis zu acht Zeichen, der ein Dokument in einer bestimmten Datenbank eindeutig identifiziert. Eine 'NotesID' stellt die Speicherposition eines Dokuments innerhalb einer bestimmten Datenbankdatei dar. Dokumente, bei denen es sich um gegenseitige Replikate handelt, haben daher in der Regel unterschiedliche 'NotesID'-Werte. Der Wert einer 'NotesID' ändert sich nicht, es sei denn, das Dokument wird gelöscht. Form Ein Formular (Form) liefert die äußere Struktur für die Erstellung und Anzeige von Dokumenten, die als Gestaltungselemente zum Speichern von Daten in der Datenbank fungieren. Wenn Sie Informationen in ein Formular eingeben und dieses speichern, werden diese Informationen als Dokument gespeichert. Wenn Sie das Dokument öffnen, verwendet das Dokument das Formular als Schablone, mit der die Daten bei der Anzeige eine Struktur verliehen wird. Anmerkung: Die Durchführung von Änderungen an einem Formular (beispielsweise durch Hinzufügen eines Felds) hat keine Änderungen an Dokumenten zur Folge, die zu einem früheren Zeitpunkt unter Verwendung dieses Formulars erstellt wurden, bis sie manuell oder automatisch durch einen Agenten bearbeitet und gespeichert worden sind. Wenn ein Feld aus einem Formular entfernt wird, so wird in Dokumenten, die zu einem früheren Zeitpunkt erstellt worden sind, der Wert für dieses Feld nicht entfernt.ParentDocumentUNID Die 'parentdocumentUNID' eines Dokuments ist eine schreibgeschützte Eigenschaft. Sie ist als Universal-ID des übergeordneten Elements eines Dokuments definiert, wenn es sich bei dem Dokument um ein Antwortdokument handelt. Wenn ein Dokument kein übergeordnetes Element besitzt, wird eine leere Zeichenfolge ("") zurückgegeben. Der Datentyp ist 'Zeichenfolge' (string). Anmerkung: Sie können die Ausgabeparameter der Aktivität nach Bedarf zuordnen.
Funktionsweise des Zusammenfassungsflags (Feldflag)
Wenn ein Dokument für ein Formular mit Feldern des Typs 'Authors', 'Readers' oder 'Names' erstellt wird und die Daten für diese Felder in 'Eingabe zuordnen' festgelegt werden, wird das Zusammenfassungsflag mit den richtigen Berechtigungen auf der Basis des Domino-Feldtyps eingestellt. Diese Funktion wird vom Domino-Server ab Version 8.5.3 unterstützt.
- Wenn ein Domino-Feld des Typs Authors auf einen Wert CN=SYSTEM/O=IBM eingestellt wird, lautet das Zusammenfassungsflag wie folgt: SUMMARY READ/WRITE-ACCESS NAMES "CN=SYSTEM/O=IBM".
- Wenn ein Domino-Feld des Typs Readers auf einen Wert CN=SYSTEM/O=IBM eingestellt wird, lautet das Zusammenfassungsflag wie folgt: SUMMARY READ-ACCESS NAMES "CN=SYSTEM/O=IBM".
- Wenn ein Domino-Feld des Typs Names auf einen Wert CN=SYSTEM/O=IBM eingestellt wird, lautet das Zusammenfassungsflag wie folgt: SUMMARY NAMES "CN=SYSTEM/O=IBM".