Beispiel: Documentum hochladen

Die Hochladeaktionen von Documentum-Connector konfigurieren die Verbindung zwischen der Anwendung Datacap und dem Documentum Docbase-Repository.

Sie laden eine Datei mit einer Seite mithilfe der Aktionen von Documentum-Connector in das Documentum Docbase-Repository. Sie können in Datacap auch ein Image mit mehreren Seiten und den zugehörigen Indexwerte hochladen.

Die Beispiele in der folgenden Tabelle beschreiben die Reihenfolge, in der Sie dem Regelsatz Aktionen für dieses Hochlade-Szenario hinzufügen müssen.

Datei mit einer Seite hochladen

Tabelle 1. Reihenfolge der Aktionen zum Hochladen einer Datei mit einem einseitigen Dokument in Documentum
Aktion Beschreibung
DM_Logon("Domäne","Servername","Benutzer-ID", "Kennwort") Melden Sie den Datacap-Client am Documentum-Content-Server an, der Datacap mit dem Repository verknüpft, das Sie als Parameter angegeben.

Eine Regel mit der Aktion 'DM_Logon' muss das Documentum-Hochladeverfahren einleiten.
DM_SetContentType("tiff") Weist dem Inhaltstyp den Wert 'TIFF' für die Seite hinzu, die Sie in das Repository hochladen.
DM_SetFolderName("/MyPage") Name des Zielordners in Documentum, in den die Datei hochgeladen wird. Dieser Parameter kann der Ordnerpfad (mit Schrägstrich) oder die in Documentum festgelegte Objekt-ID des Ordners sein. Die Objekt-ID des Ordners erhalten Sie, wenn Sie die Ordner in Documentum mithilfe des Documentum-Clients anzeigen.
DM_SetObjectName("@ID") Legt den Objektnamenwert für die hochgeladene Datei fest. Wenn Sie die Datei mit dieser Aktion hochladen, wird der Dateiname in Documentum in diesen Namen geändert. Wenn beispielsweise der Dateiname beim Hochladen der Seite 'XYZ' lautete, erhält die Seite in Documentum den Namen 'XYZ'.
DM_UploadPage() Lädt die Images, die dem aktuellen Seitenobjekt der Dokumenthierarchie zugeordnet sind, in das Documentum-Repository hoch.

Datei mit mehreren Seiten hochladen

Sie können ein Einzeldokument mit mehreren TIFF-Seiten herunterladen, indem Sie die Aktion 'DM_UploadDocument' auf Dokumentebene verwenden.

Wenn Sie die Seiten des Dokuments in mehreren TIFF-Dateien zusammenführen möchten, können Sie mehrseitige Imagedateien mit einer Regel, die 'TifMerge'-Aktionen enthält, in einer Datei kombinieren. Anschließend können Sie diese mehrseitige Imagedatei einem Dokument zuweisen. Weitere Informationen zu 'TifMerge'-Aktionen finden Sie im Referenzabschnitt zu 'TifMerge'.

Sie können eine nachfolgende Regel verwenden, die die Datei mit dem mehrseitigen Dokument in ein angegebenes Documentum-Repository hochlädt.

Sie können entweder einen einzelnen Regelsatztyp mit Aktionen aus beiden Aktionsdateien erstellen oder Regeln aus verschiedenen Regelsatztypen erstellen. In beiden Fällen müssen die Aktionen folgende Reihenfolge einhalten:

Tabelle 2. Reihenfolge der Aktionen zum Hochladen einer Datei mit einem mehrseitigen Dokument in Documentum
Aktion Beschreibung
TifMerge_SetFileName("@ID",".tif") Optional: Definieren Sie den Namen der Dateien mit mehreren TIFF-Seiten, die in das Documentum-Repository hochgeladen werden.
TifMerge_MergeImages("all") Optional: Führen Sie bei der Verarbeitung alle Images der Seiten zusammen, die dem aktuellen Dokument zugeordnet sind.
DM_Logon("Domäne","Servername","Benutzer-ID", "Kennwort") Melden Sie den Datacap-Client am Documentum-Content-Server an, der Datacap mit dem Repository verknüpft, das Sie als Parameter angegeben.

Eine Regel mit der Aktion 'DM_Logon' muss das Documentum-Hochladeverfahren einleiten.
DM_SetContentType("tiff") Weist dem Inhaltstyp den Wert 'TIFF' für die Seite hinzu, die Sie in das Repository hochladen.
DM_SetFolderName("/MyPage") Name des Zielordners in Documentum, in den die Datei hochgeladen wird. Dieser Parameter kann der Ordnerpfad (mit Schrägstrich) oder die in Documentum festgelegte Objekt-ID des Ordners sein. Die Objekt-ID des Ordners erhalten Sie, wenn Sie die Ordner in Documentum mithilfe des Documentum-Clients anzeigen.
DM_SetObjectName("@ID") Gibt den Wertnamen des Objektnamens der letzten hochgeladenen Datei an. Dieses Beispiel weist den Wert in einem intelligenten Parameter zu.
DM_UploadDocument() Lädt das Dokument und dessen mehrseitige Datei in das Documentum-Repository hoch.

Im nachfolgenden Beispiel wird der Regelsatz 'ExportDocumentumByPage' (Documentum nach Seite exportieren) beschrieben. Dieser meldet sich am Documentum-Server an und lädt ein einseitiges Dokument in das Documentum-Repository hoch.

Der Regelsatz enthält die Regeln, Funktionen und Aktionen zur Anmeldung (Login) und zum Hochladen von Seiten (Page Upload). Die Login-Regel ist an die Stapelebene gebunden. Die PageUpload-Regel ist an die Seitenebene gebunden.

Die Login-Funktion meldet die Anwendung bei Documentum an. Die PageUpload-Funktion enthält Aktionen zum Festlegen des Seitenformats als TIFF und zum Definieren des Ordners, aus dem die Seite hochgeladen wird. Diese Aktionen legen auch den Objektname für die Seite fest und laden die Seite in Documentum Docbase hoch.

Regelsatz ExportDocumentumByPage

  • Login-Regel
    • Login-Funktion
      • DM_Logon("dmsrv","Benutzer-ID","Kennwort")
  • Page Upload-Regel
    • Page Upload-Funktion
      • DM_SetContentType("tiff")
      • DM_SetFolderName("/EigenesDokument")
      • DM_SetObjectName("@ID")
      • DM_UploadPage()