Formate für Import- und Exportdateien für benutzerdefinierte Dimensionen

Wenn Sie Daten für benutzerdefinierte Dimensionen importieren und exportieren, müssen Sie eine durch Komma getrennte Datei (.csv) verwenden.

Die folgende Liste enthält eine Beschreibung des Formats sowie sonstige wichtige Aspekte zum Importieren und Exportieren von Dateien:

  • Die Datei muss folgende Spalten enthalten:
    • Name: Der Name des Knotens.
    • Übergeordnet: Der Name des übergeordneten Knotens, wenn die Dimension eine Hierarchie ist. Wenn der Knoten keinen übergeordneten Knoten aufweist, muss dieses Feld leer sein.

    Hinweis:

    Der Spaltenheader für Name lautet standardmäßig Knoten. Spaltenheader für "Name" und "Übergeordnetes Element" können während der Registrierung angepasst werden.

  • Wenn die Dimension Eigenschaften aufweist, enthält die Datei eine Spalte für jede Eigenschaft. Der Spaltenheader ist der Wert, der beim Erstellen der Eigenschaft angegeben wurde. Informationen hierzu finden Sie unter Vorhandene Eigenschaften Knotentypen für benutzerdefinierte Dimensionen hinzufügen und Benutzerdefinierte Eigenschaften erstellen.
  • Sie können Konstantenspalten in Ihrer Exportdatei erstellen, bearbeiten und löschen. Informationen hierzu finden Sie im Abschnitt Konstantenschlüssel für universelle Anwendungen verwalten unter Binding-Schlüssel bearbeiten.
  • Die Konfiguration der Dimension bestimmt, ob Spalten für Knotentypen vorhanden sind und wie oberste Knoten angegeben werden. Informationen hierzu finden Sie unter Import- und Exporteinstellungen für benutzerdefinierte Dimensionen.
  • Daten werden in der Reihenfolge der Zeilen importiert. Zeilen für übergeordnete Knoten müssen vor Zeilen für untergeordnete Knoten stehen. Wenn eine Zeile für einen untergeordneten Knoten vor der Zeile des zugehörigen übergeordneten Knotens steht, kommt es beim Importieren der Datei zu einem Fehler.
  • Sie können die Spalten in der Importdatei beliebig anordnen.
  • Wenn ein Spaltenheader nicht mit den oben beschriebenen Headern übereinstimmt, wird die Spalte beim Import ignoriert.

    Tipp:

    Dies bedeutet, dass eine Importdatei Informationen enthalten kann, die nicht importiert werden. Beispiel: Eine Importdatei kann eine Spalte für Kommentare enthalten.
  • Doppelte Zeilen werden beim Import ignoriert.
  • Zeichenfolgen, die das Trennzeichen, Anführungszeichen oder Zeilenabschlusszeichen (CR/LF) für die Datei enthalten oder die mit Zeichen aus ASCII 35 und niedriger (wie z.B. Tabulatorzeichen, ! oder #) beginnen, werden in Anführungszeichen gesetzt. (Beispiel: "# Children", "Accumulated Depreciation, Equipment".)

  • Datumsangaben und Zeitstempel für unterstützte Gebietsschemas müssen eines der folgenden Java-Datumsformatmuster aufweisen:
    • Kurz

    • Standard

    • Lang

    • Mittel

    Hinweis:

    Informationen zu Java-Datums- und -Uhrzeitformaten finden Sie unter Vordefinierte Formate verwenden.

Beispiel 33-1 Importdatei für eine Dimension

Angenommen, Ihre Departments-Dimension ist wie folgt definiert:

  • Es gibt zwei Knotentypen namens "Abteilung" und "Abteilungsaggregation".
  • Beide Knotentypen verwenden die Eigenschaft Description.
  • Der Knotentyp "Abteilungsaggregation" weist eine Eigenschaft namens Company auf, die so konfiguriert wurde, dass die Abkürzung CO als Spaltenheader verwendet wird.
  • Die Dimension wurde mit den folgenden Import- und Exporteinstellungen konfiguriert:
    • TOPNODE stellt oberste Knoten dar.
    • Die Dateien können eine Spalte für Knotentypen enthalten. Der Spaltenheader lautet Knotentyp.
    • Die Dateien können eine Spalte für Typen von übergeordneten Knoten enthalten. Der Spaltenheader lautet Typ des übergeordneten Knoten.
    • Wenn die Importdatei die Spalten Knotentyp und Typ des übergeordneten Knotens nicht enthält, werden beim Import dem Knotentyp "Abteilung" untere Knoten und dem Knotentyp "Abteilungsaggregation" übergeordnete Knoten zugewiesen.

    Die in der vorherigen Liste beschriebenen Dimensionseinstellungen.

Die folgende Tabelle zeigt die ersten Zeilen einer Importdatei für die Dimension in diesem Beispiel:

Name Beschreibung Knotentyp Übergeordnet Typ des übergeordneten Knotens CO
TD Abteilung gesamt Abteilungsaggregation TOPNODE   1
100 Ressourcen Abteilung TD Abteilungsaggregation  
110 Ressourcen für Einrichtungen Abteilung 100 Abteilung  
111 Ressourcen für Region West Abteilung 100 Abteilung  

Hinweis:

Der Wert TOPNODE in der Spalte "Übergeordnet" gibt an, dass "TD" der Root-Knoten ist. Der Spaltenheader für die Eigenschaft "Company" lautet CO.