exportQueryResults

Gilt für

Erforderliche Rollen

Verwendung

• APPLICATION_NAME ist der Name der Profitability and Cost Management-Anwendung, für die Sie die Abfrage ausführen möchten.
• fileName ist der Name der Datei, in der die Abfrageergebnisse gespeichert werden. Dieser Parameterwert ist erforderlich, wenn der Parameterwert queryName nicht angegeben ist. Er ist optional, wenn der Parameterwert queryName angegeben ist. In diesem Fall wird der Abfragename als Name für die Datei mit Abfrageergebnissen verwendet.

  Das von Ihnen festgelegte Datenformat bestimmt das Format der Ausgabedatei. Wenn Sie dataFormat=NATIVE (Standard) verwenden, wird beim Exportprozess eine Textdatei erstellt. Wenn Sie dataFormat=COLUMNAR verwenden, werden beim Exportprozess mehrere der Reihe nach nummerierte Textdateien erstellt und in eine ZIP-Datei komprimiert.

• fileOutputOptions (optional) gibt das Ausgabeformat der Datei mit Abfrageergebnissen an. Die Standardeinstellung lautet ZIP_ONLY. Damit wird fileName.ZIP oder queryName.ZIP erstellt, und zwar abhängig davon, ob ein Wert für den Parameter fileName angegeben ist. Weitere Optionen sind TEXT_ONLY zum Erstellen der Ausgabedatei als Textdatei und ZIP_AND_TEXT zum Generieren einer Textdatei und einer ZIP-Datei.
• queryName ein optionaler Parameter ist, der eine in der Anwendung definierte Abfrage angibt. Abfragenamen, die Leerzeichen enthalten, müssen in doppelte Anführungszeichen gesetzt werden.

  Geben Sie keinen Abfragenamen an, wenn Sie alle Oracle Essbase-Daten exportieren möchten, die zur Anwendung gehören.

  Die folgenden Bedingungen können dazu führen, dass dieser Befehl eine leere Datendatei erstellt:

  • Eine unzureichend erstellte Abfrage, die keine Daten abruft.
  • Eine Abfrage, die zu viele Daten generiert. Ziehen Sie in diesem Szenario in Betracht, den Bereich der Abfrage zu verkleinern, damit weniger Daten abgerufen werden, oder die Abfrage in kleinere Abfragen aufzuteilen.

    Informationen hierzu finden Sie unter Oracle Profitability and Cost Management Cloud-Abfragen verwalten in der Dokumentation Profitability and Cost Management verwalten.

• exportOnlyLevel0Flg (optional) gibt an, ob die Abfrage nur Daten der Ebene 0 abrufen soll. Geben Sie diesen Parameterwert in Kleinbuchstaben an.

  Dieser Parameter wird ignoriert, wenn Sie alle Anwendungsdaten exportieren, ohne den Abfragenamen anzugeben.

• roundingPrecision (optional) gibt die Anzahl der Dezimalstellen (Rundungsgenauigkeit) an, die beim Exportieren von Abfrageergebnissen verwendet werden sollen. Nur anwendbar, wenn queryName angegeben ist. Der Standardwert ist 2.
• dataFormat (optional) gibt das Ausgabeformat an. Gültige Werte sind:
  • NATIVE, wobei das Abfrageergebnis als Daten im nativen Essbase-Format gepflegt wird. Das ist der Standardwert.
  • COLUMNAR, wobei Daten im nativen Essbase-Format konvertiert und in Spalten angeordnet werden, um sie leichter interpretieren und in andere Anwendungen importieren zu können.

    Mit dieser Option werden alle Essbase-Daten exportiert. Der Parameterwert queryName wird ignoriert. Sie können die Daten filtern, indem Sie den Parameterwert memberFilters festlegen.

  Hinweis:

  Der Befehl berücksichtigt die folgenden optionalen Parameter nur, wenn für dataFormat COLUMNAR angegeben ist.
• memberFilters (optional) akzeptiert eine mit JSON formatierte Zeichenfolge, um nach Dimension und nach Elementen der Ebene 0 zu filtern. Beispiel: "{\"Dim1\":[\"Mem1\"],\"Dim2\":[\"Mem21\",\"Mem22\"]}"
• includeHeader (optional) fügt Dimensionsnamen als Spaltenheader hinzu. Setzen Sie diesen Wert auf false, um Spaltenheader auszuschließen. Der Standardwert ist true.
• delimiter (optional) gibt das Trennzeichen an, das verwendet werden muss, um Dimensionselemente in der Datei mit Abfrageergebnissen zu trennen. Trennzeichen müssen in doppelte Anführungszeichen gesetzt werden. Der Standardwert ist das Leerzeichen (" ").
• keepDuplicateMemberFormat (optional) gibt an, ob das Elementformat im Essbase-Format für doppelte Elemente gedruckt werden soll, z.B. [Account]@[Accoun1]. Setzen Sie diesen Wert auf false, um nur den Elementnamen zu drucken. Der Standardwert ist true.

Beispiele

• Alle Anwendungsdaten exportieren:

  epmautomate exportQueryResults BksML12 fileName="BksML12_MyQuery1.txt" fileOutputOptions=TEXT_ONLY

• Ergebnisse einer bestimmten Abfrage exportieren:

  epmautomate exportQueryResults BksML12 queryName="My Product Query" roundingPrecision=3

• Daten der Ebene 0 im NATIVE-Datenformat exportieren:

  epmautomate exportQueryResults BksML30 fileName="BksML30_ExportLevel0-Data" fileOutputOptions=ZIP_AND_TEXT exportOnlyLevel0Flg=true

• Daten der Ebene 0 im COLUMNAR-Datenformat mit einer einzelnen Dimension und einem einzelnen Elementfilter exportieren:

  epmautomate exportQueryResults BksML30 fileName="BksML30_Level0-Data" dataFormat="COLUMNAR" memberFilters="{\"Period\":[\"December\"]}" includeHeader="true" delimiter="," roundingPrecision="3"

• Daten der Ebene 0 im COLUMNAR-Datenformat mit einer einzelnen Dimension und mehreren Elementfiltern exportieren:

  epmautomate exportQueryResults BksML30 fileName="BksML30_Level0-Data" dataFormat="COLUMNAR" memberFilters="{\"Period\":[\"November\",\"December\"]}" includeHeader="true" delimiter="," roundingPrecision="3"

• Daten der Ebene 0 im COLUMNAR-Datenformat mit mehreren Dimensionen und mehreren Elementfiltern exportieren:

  epmautomate exportQueryResults BksML30 fileName="BksML30_Level0-Data" dataFormat="COLUMNAR" memberFilters="{\"Year\":[\"2016\"],\"Period\":[\"November\",\"December\"]}" includeHeader="true" delimiter="," roundingPrecision="3"