Navigation überspringen FileNet-Logo
Glossar  |  Hilfeverzeichnis  
  Hilfe zu Process-Konfigurationskonsole
  Suchen  |  Index
Process Referenz  
Process-Konfigurationskonsole
Erste Schritte
Isolierte Bereiche
  Initialisieren eines isolierten Bereichs
  Herstellen der Verbindung mit einem isolierten Bereich
  Abbrechen der Verbindung mit einem isolierten Bereich
  Exportieren der Konfiguration für isolierten Bereich nach XML
  Importieren der Konfiguration aus XML
  Entfernen eines isolierten Bereichs
  Anzeigen oder Ändern der Eigenschaften isolierter Bereiche
     Konfigurieren von Optionen für die Ereignisprotokollierung
     Aktivieren oder Deaktivieren der Statistikerfassung
     Einstellen von Leistungsparametern
     Einstellen von Webanwendungseigenschaften
     Konfigurieren von Schrittprozessoren
     Festlegen von Positionen des Schrittprozessors
Warteschlangen
Roster
VWServices
Process Engine
Workflow-Datenbank
Ereignisse & Statistiken
   

Importieren der Konfiguration aus XML

Um Eigenschaften isolierter Bereiche von einem isolierten Bereich in einen anderen zu kopieren, können Sie die zuvor aus einem anderen isolierten Bereich exportierten Konfigurationseigenschaften importieren. Sie können diese Export-/Importfunktion auch zum Sichern und Wiederherstellen der Konfiguration isolierter Bereiche verwenden. Der isolierte Zielbereich muss initialisiert sein, und alle ausstehenden Änderungen müssen vor Beginn des Importvorgangs entweder übertragen oder verworfen werden. Informationen über das Exportieren von Eigenschaften finden Sie unter Exportieren von Eigenschaften isolierter Bereiche.

So importieren Sie Eigenschaften isolierter Bereiche

  1. Wählen Sie in der Process-Konfigurationskonsole den isolierten Zielbereich aus.
  2. Wählen Sie im Menü Aktion die Option Importieren aus XML-Datei, und suchen Sie die zuvor exportierte XML-Datei, die die Eigenschaften des isolierten Bereichs enthält.
  3. Wählen Sie eine der folgenden Optionen aus:
    • Überschreiben - Fügt die importierten Eigenschaften dem isolierten Zielbereich hinzu, wobei alle Warteschlangen, Roster und Ereignisprotokolle mit dem gleichen Namen im isolierten Zielbereich ersetzt werden. Wenn der isolierte Zielbereich Vorgänge enthält, die in Gebrauch sind, schlägt der Übertragungsvorgang fehl. Wenn daneben übertragene Workflows vorhanden sind, die eine Warteschlange verwenden, dann wird die betreffende Warteschlange nicht überschrieben, selbst wenn die Workflows zum Importzeitpunkt nicht ausgeführt werden.

      Diese Option eignet sich für den Import aus einer Entwicklungsumgebung in einen neu initialisierten Bereich, der für eine Produktionsumgebung bestimmt ist.

      ACHTUNG  Wenn Sie die Überschreibungsoption zum Importieren in einen Zielbereich verwenden, der bereits eine Zeitlang im Einsatz war, dann werden Objekte mit dem gleichen Namen überschrieben, was zu unerwarteten Ergebnissen führen kann.

    • Zusammenführen - Fügt die importierten Eigenschaften zu den aktuellen Eigenschaften des isolierten Zielbereichs hinzu. Wenn der isolierte Zielbereich Objekte mit dem gleichen Namen wie diejenigen im importierten isolierten (Quell-)Bereich enthält, werden die importierten Objekte verworfen.

      Bei Zielbereichen, die in Gebrauch sind, werden durch diese Option alle vorhandenen Eigenschaften im Zielbereich beibehalten, und es werden lediglich neue Eigenschaften aus dem Quellbereich hinzugefügt.

      Wenn die exportierte Quelle Systemeigenschaften enthält, wird beim Import das Importieren der Benutzerinformationen übersprungen, wenn der betreffende Benutzer nicht im Zielsystem definiert ist. Dies gilt sowohl für das Überschreiben als auch für das Zusammenführen.

  4. Am Ende des Importvorgangs können Sie auf Details klicken, um das Verlaufsprotokoll anzuzeigen.

    TIPP Wenn Sie Systemeigenschaften aus einem Nicht-Standardbereich importieren, klicken Sie auf Aktualisieren, um die Anzeige der Eigenschaften zu aktualisieren.

Ergebnis beim Importieren von Schrittprozessordefinitionen

Für das Importieren von Schrittprozessordefinitionen gelten die folgenden Regeln:

  • Eine Schrittprozessordefinition im isolierten Zielbereich kann nicht gelöscht werden.
  • Wenn eine importierte Schrittprozessordefinition einen Index besitzt, der in Konflikt mit einem vorhandenen Index im Ziel steht, dann wird dem neu importierten Schrittprozessor ein neuer Index zugewiesen.
  • In der Konfiguration müssen immer ein Standardschrittprozessor und ein Standardstartprozessor enthalten sein.
    • Bei Importen mit der Zusammenführungsoption werden der Standardschrittprozessor und der Standardstartprozessor des Ziels beibehalten.
    • Bei Importen mit der Überschreibungsoption ersetzen die Standardschritt- und -startprozessoren der Quelle die entsprechenden Schritt- und Startprozessoren des Ziels und werden zum Standard.

      HINWEIS  Wenn ein Quellschrittprozessorsatz einen Eintrag enthält, durch den die vorhandene Standardeinstellung geändert wird und der Quellsatz keinen anderen Standardschrittprozessor enthält, dann ändert der Import nichts an der vorhandenen Standardeinstellung.

Das folgende Beispiel erläutert den Import mit Überschreibung:

Isolierter Quellbereich Vorhandener isolierter Zielbereich Ergebnis
ID Typ Name
5 8 Approval HTML (FileNet)
6 4 Approval Launch HTML (FileNet)
50 2 (Def. Schritt) MyStep
55 1 (Def. Start) MyLaunch
ID Typ Name
3 8 HTML (FileNet)
4 4 Launch HTML (FileNet)
5 2 (Def. Schritt) Approval HTML (FileNet)
6 1 (Def. Start) Approval Launch HTML (FileNet)
ID Typ Name
3 8 HTML (FileNet)
4 4 Launch HTML (FileNet)
5 2 (Def. Schritt) Approval HTML (FileNet)
6 1 (Def. Start) Approval Launch HTML (FileNet)
50 2 (Def. Schritt) MyStep
55 1 (Def. Start) MyLaunch

Wenn die Quelle keinen Standard enthält und einer der Einträge den vorhandenen Standard dahingehend ändern würde, dass kein Standard mehr vorhanden ist, dann wird der vorhandene Standard nicht geändert.

Isolierter Quellbereich Vorhandener isolierter Zielbereich Ergebnis
ID Typ Name
5 8 Approval HTML (FileNet)
6 4 Approval Launch HTML (FileNet)
ID Typ Name
3 8 HTML (FileNet)
4 4 Launch HTML (FileNet)
5 2 (Def. Schritt) Approval HTML (FileNet)
6 1 (Def. Start) Approval Launch HTML (FileNet)
ID Typ Name
3 8 HTML (FileNet)
4 4 Launch HTML (FileNet)
5 2 (Def. Schritt) Approval HTML (FileNet)
6 1 (Def. Start) Approval Launch HTML (FileNet)

 

Fehlerbehebung bei Importproblemen

Wenn ein Import fehlschlägt, können Sie das Problem entweder im isolierten Quellbereich beheben und dann die Konfiguration erneut exportieren, oder Sie können das Problem im isolierten Zielbereich beheben. Sie können auch die exportierte XML-Datei direkt bearbeiten und die Objekte entfernen, die Fehler hervorrufen.

Die folgende Liste enthält häufige Fehlermeldungen beim Import.

Fehler beim Übertragen:
Feldlänge in Protokoll kann nicht geändert werden, Protokollname="DefaultEventLog, field name=F_Subject

Ursache: Die Länge des Zeichenfolgenfelds kann in einer Protokolldatei nicht geändert werden.

Lösung: Entfernen Sie entweder das F_Subject-Feld aus der Export-XML-Datei, oder entfernen Sie das F_Subject-Feld aus dem Zielbereich.

Ausnahmefehler beim Import aus Datei, Der Typ des freigelegten Felds '{xxx}' stimmt nicht mit dem vorhandenen Typ für freigelegte Felder überein.

Ursache: Der Feldtyp kann in einer Protokolldatei nicht geändert werden.

Lösung: Entfernen Sie das Feld aus der Export-XML-Datei oder wechseln Sie zu einer anderen Protokolldatei.

Die Attributwerte stimmen für F_WebServer.4 nicht überein

Ursache: Der Speicherort der Webanwendungen in der Importdatei stimmt nicht mit den entsprechenden Einstellungen im Zielbereich überein.

Lösung: Verwenden Sie entweder die Process-Konfigurationskonsole, um die URLs der Webanwendungen im Importbereich zu ändern, und exportieren Sie die Bereichseigenschaften erneut, oder ändern Sie den Zielbereich.

Ausnahmefehler beim Import aus Datei; Die Attributwerte stimmen für F_ComponentDescriptor nicht überein

Ursache: Nur für die Zusammenführungsoption: Der JAAS-Benutzer bzw. das Kennwort oder andere Einstellungen sind für den Quell- und Zielbereich bei der Adapterkonfiguration der Komponentenwarteschlange in einer CE-Vorgangswarteschlange unterschiedlich.

Lösung: Die Adapterkonfiguration der Komponentenwarteschlange muss übereinstimmen. Alternativ können Sie die Überschreibungsoption zum Ersetzen der vorhandenen Einstellungen verwenden.

Wenn Sie die XML-Datei bearbeiten, geben Sie möglicherweise Syntaxfehler ein, die zum Fehlschlagen des Importvorgangs führen. Die folgende Auflistung enthält einige häufige Fehlertypen und die zugehörigen Fehlermeldungen:

Beispiel 1: Öffnungs- bzw. Schließungsmarken ohne Gegenstück

Ausnahmefehler beim Import aus Datei. Dokument-Parser konnte nicht abgerufen werden. Der Elementtyp "ModelAttributes" muss durch die entsprechende Schließungsmarke "</ModelAttributes>" beendet werden.

... Auf den Elementtyp "Value" müssen entweder Attributspezifikationen, ">" oder "/>" folgen...

Beispiel 2: Fehlendes öffnendes Anführungszeichen in Werteklausel

...Ein öffnendes Anführungszeichen wird für das Attribut "Val" erwartet, das einem Elementtyp "Value" zugeordnet ist...

Beispiel 3: Fehlendes schließendes Anführungszeichen in Werteklausel

...Der Wert des Attributs "Val", das einem Elementtyp "Value" zugeordnet ist, darf nicht das Zeichen '<' enthalten.

Beispiel 4: Fehlendes öffnendes Anführungszeichen in Attribut

...Ein öffnendes Anführungszeichen wird für das Attribut "Length" erwartet, das einem Elementtyp “ExposedFieldDefinition“ zugeordnet ist.

Beispiel 5: Fehlendes schließendes Anführungszeichen in Attribut

Der Elementtyp "ExposedFieldDefinition" muss entweder von Attributspezifikationen, ">" oder "/>" gefolgt werden.