EXPORT-Befehl
Exportiert Daten aus Analytics in das angegebene Dateiformat oder in die HighBond-Ergebnisse-App.
Syntax
EXPORT {<FIELDS> Feldname <AS Exportname> <...n>|<FIELDS> ALL} <UNICODE> Exporttyp <SCHEMA>PASSWORD Zahl TO {Dateiname|ACLGRC_ID} <OVERWRITE> <IF Test> <WHILE Test> <{FIRST Bereich|NEXT Bereich}> <APPEND> <KEEPTITLE> <SEPARATOR Zeichen> <QUALIFIER Zeichen> <WORKSHEET Arbeitsblattname> <DISPLAYNAME>
Parameter
Name | Beschreibung | |||||||
---|---|---|---|---|---|---|---|---|
FIELDS Feldname AS Exportname <...n> | FIELDS ALL |
Die zu exportierenden Felder.
|
|||||||
UNICODE Optional |
Nur in der Unicode-Edition von Analytics verfügbar. Gilt nur für Textdateien (ASCII), Textdateien mit Trennzeichen (DELIMITED) und XML-Dateien sowie Ausgabe aus der Windows-Zwischenablage (CLIPBOARD). Exportiert Analytics-Daten mit angewendeter Unicode-UTF-16-LE-Zeichencodierung.
Weitere Informationen finden Sie unter Galvanize-Unicode-Produkte. |
|||||||
Exporttyp |
Das Format oder der Zielort der Ausgabedatei mit einer der folgenden Optionen:
|
|||||||
SCHEMA Optional |
Nur für XML-Datenausgabe zutreffend. Das XML-Schema in der exportierten XML-Datei einschließen. Das XML Schema enthält Metadaten, welche die Struktur der XML-Datei, einschließlich des Datentyps der Felder, beschreibt. Nachdem die Datei exportiert wurde, können Sie die Datei mit dem Schema vergleichen. |
|||||||
PASSWORD Zahl |
Gilt nur für die HighBond-Ergebnisse-App (ACLGRC). Die zu verwendende Kennwortdefinition. Sie verwenden nicht PASSWORD Zahl, um ein tatsächliches Kennwort abzurufen oder festzulegen. Die Kennwortdefinition bezieht sich auf ein vorher angegebenes oder ein mit dem PASSWORD-, dem SET-PASSWORD-Befehl oder dem PASSWORD-Analysetag festgelegtes Kennwort. Zahl bezieht sich auf die Zahl der Kennwortdefinition. Wenn beispielsweise zuvor zwei Kennwörter in einem Skript angegeben bzw. festgelegt wurden oder falls eine Analyse geplant wurde, wird mit PASSWORD 2 angegeben, dass das zweite Kennwort verwendet wird. Weitere Informationen über die Angabe oder das Festlegen von Kennwörtern finden Sie unter: PASSWORD Zahl muss direkt vor TO oder am Ende der Zeichenfolge in der Befehlssyntax erscheinen. Das benötigte Kennwort ist ein HighBond-Zugriffstoken. Weitere Informationen finden Sie unter In die HighBond-Ergebnisse-App exportieren. Hinweis In Abhängigkeit von der Umgebung, in der das Skript ausgeführt wird, kann PASSWORD notwendig sein oder auch nicht:
|
|||||||
TO Dateiname | ACLGRC_ID |
Der Zielort für den Export:
|
|||||||
OVERWRITE Optional |
Gilt nur für die HighBond-Ergebnisse-App (ACLGRC).
Mit dem Zielkontrolltest (Tabelle) verbundene Interpretationen werden dynamisch aktualisiert, um die importierten Daten zu berücksichtigen, unabhängig davon, ob überschrieben oder angehängt wird. |
|||||||
IF Test Optional |
Ein bedingter Ausdruck, der wahr sein muss, damit ein Datensatz verarbeitet wird. Der Befehl wird nur für Datensätze ausgeführt, welche die Bedingung erfüllen. Hinweis Der IF-Parameter wird nur für Datensätze ausgewertet, die nach Anwendung von Bereichsparametern (WHILE, FIRST, NEXT) in einer Tabelle übrig sind. |
|||||||
WHILE Test Optional |
Ein bedingter Ausdruck, der wahr sein muss, damit ein Datensatz verarbeitet wird. Der Befehl wird ausgeführt, bis die Bedingung falsch ist oder das Tabellenende erreicht wurde. Hinweis Wenn Sie WHILE zusammen mit FIRST oder NEXT verwenden, endet die Datensatzverarbeitung, sobald eine Grenze erreicht wird. |
|||||||
FIRST Bereich | NEXT Bereich Optional |
Die Anzahl der zu verarbeitenden Datensätze:
Verwenden Sie Bereich, um die Anzahl der zu verarbeitenden Datensätze anzugeben. Wenn Sie FIRST und NEXT nicht angeben, werden standardmäßig alle Datensätze verarbeitet. |
|||||||
APPEND Optional |
Gilt nur für Textdateien (ASCII) sowie Textdateien mit Trennzeichen (DELIMITED). Hängt die Befehlsausgabe an das Ende einer vorhandenen Datei an, statt die Datei zu überschreiben. Hinweis Vergewissern Sie sich, dass die Struktur der Befehlsausgabe und der bestehenden Datei identisch sind:
Analytics hängt eine Ausgabe an eine bestehende Datei beliebiger Struktur an. Falls die Struktur der Ausgabe und der bestehenden Datei nicht übereinstimmen, kann die Datenintegrität verletzt sein, es können Daten fehlen oder falsch sein. |
|||||||
KEEPTITLE Optional |
Gilt nur für die Ausgabe von Textdateien (ASCII) sowie Textdateien mit Trennzeichen und Dateien mit Werten, die durch Kommas getrennt sind, (DELIMITED). Schließt die Analytics-Feldnamen in den exportierten Daten ein. Falls dies ausgelassen wird, erscheinen keine Feldnamen in der Ausgabedatei. |
|||||||
SEPARATOR Zeichen Optional |
Gilt nur für die Ausgabe von durch Trennzeichen getrennte Texte und Dateien mit Werten, die durch Kommas getrennt sind, (DELIMITED). Das Zeichen, das als Trennzeichen zwischen Feldern verwendet werden soll. Der Zeichen muss als in Anführungszeichen gesetzte Zeichenfolge angegeben werden. In der Standardeinstellung verwendet Analytics das Komma. Geben Sie kein anderes Zeichen als ein Komma an, falls Sie in eine Datei mit Werten, die durch Kommas getrennt sind, exportieren. |
|||||||
QUALIFIER Zeichen Optional |
Gilt nur für die Ausgabe von durch Trennzeichen getrennte Texte und Dateien mit Werten, die durch Kommas getrennt sind, (DELIMITED). Das Zeichen, das als Textkennzeichner zum Umschließen und Identifizieren von Feldwerten verwendet wird. Der Zeichen muss als in Anführungszeichen gesetzte Zeichenfolge angegeben werden. In der Standardeinstellung verwendet Analytics doppelte Anführungszeichen. |
|||||||
WORKSHEET Arbeitsblattname Optional |
Trifft nur auf Microsoft-Excel-Dateien zu (.xlsx). Der Name des Excel-Arbeitsblatts, das in einer neuen oder bestehenden Excel-Datei erstellt wird. Standardmäßig verwendet Analytics als Arbeitsblattnamen den Namen der Analytics-Tabelle, die Sie exportieren. Der Arbeitsblattname darf lediglich alphanumerische Zeichen oder den Unterstrich enthalten ( _ ). Sonderzeichen und Leerzeichen sind nicht erlaubt und der Name darf nicht mit einer Ziffer beginnen. Sie können den Wert in Anführungszeichen setzen, dies ist aber nicht vorgeschrieben. Einzelheiten über das Überschreiben von Excel-Arbeitsmappen und -Arbeitsblättern beim Exportieren finden Sie unter Der Parameter WORKSHEET und das Überschreiben. |
|||||||
DISPLAYNAME Optional |
Gilt nur für die HighBond-Ergebnisse-App (ACLGRC). Exportiert Feldnamen als Feldnamen und Anzeigenamen als Anzeigenamen. Anzeigename werden also in der Ergebnisse-App in Spaltenüberschriften angezeigt, ohne sich auf den tatsächlichen Feldnamen auszuwirken. DISPLAYNAME kann mit AS kombiniert werden. Weitere Informationen finden Sie unter Wie DISPLAYNAME mit AS beim Exportieren in die HighBond-Ergebnisse-App interagiert. |
Beispiele
Daten in eine Excel-.xlsx-Datei exportieren
Sie exportieren bestimmte Felder aus der Tabelle Lieferant in eine Excel-Datei (.xlsx):
OPEN Lieferant EXPORT FIELDS Lieferantennr Lieferantenname Lieferantenstadt XLSX TO "LieferantenExport"
Exportieren von Daten in eine Excel-.xlsx-Datei und Angabe eines Arbeitsblattnamens
Sie exportieren bestimmte Felder aus der Tabelle Lieferant in das Arbeitsblatt Lieferanten_US einer Excel-Datei (.xlsx):
OPEN Lieferant EXPORT FIELDS Lieferantennr Lieferantenname Lieferantenstadt XLSX TO "LieferantenExport" WORKSHEET Lieferanten_US
Alle Felder in eine Datei mit Trennzeichen exportieren
Sie exportieren alle Felder aus der Tabelle Lieferant in eine Datei mit Trennzeichen:
OPEN Lieferant EXPORT FIELDS ALL DELIMITED TO "LieferantenExport"
Alle Felder in eine Datei mit Werten, die durch Kommas getrennt sind, exportieren
Sie exportieren alle Felder aus der Tabelle Lieferant in eine Datei mit Werten, die durch Kommas getrennt sind:
OPEN Lieferant EXPORT FIELDS ALL DELIMITED TO "LieferantenExport.csv"
Daten mit GROUP in mehrere Dateien mit Trennzeichen exportieren
Sie exportieren bestimmte Felder aus der Tabelle Lieferant in zwei Dateien mit Trennzeichen:
- eine Datei mit Lieferantennamen von „A“ bis „M“
- eine Datei mit Lieferantennamen von „N“ bis „Z“
Im GROUP-Befehl testen Sie den Lieferantennamen jedes Datensatzes durch eine IF-Bedingung:
GROUP EXPORT FIELDS Lieferantennr Lieferantenname DELIMITED TO "AbisM" IF BETWEEN(UPPER(VENDOR_NAME); "A"; "M") EXPORT FIELDS Lieferantennr Lieferantenname DELIMITED TO "NbisZ" IF BETWEEN(UPPER(VENDOR_NAME); "N"; "Z") END
Daten in die HighBond-Ergebnisse-App exportieren
Sie exportieren bestimmte Felder aus der Tabelle Forderungsausnahmen in die HighBond-Ergebnisse-App. Sie überschreiben bestehende Daten im Zielkontrolltest (Tabelle):
OPEN FLL_Ausnahmen EXPORT FIELDS Nr Fälligkeit Ref Betrag Typ ACLGRC PASSWORD 1 TO "10926@us" OVERWRITE
Bemerkungen
Hinweis
Weitere Informationen über die Funktion dieses Befehls finden Sie in Hilfe für Analytics.
EXPORT mit dem GROUP-Befehl verwenden
Für die meisten Exportformate können Sie Daten mithilfe des GROUP-Befehls in mehrere Dateien gleichzeitig exportieren.
Beim Exportieren von Daten nach Microsoft Excel und Microsoft Access kann jeweils nur eine Datei erstellt werden.
In Excel exportieren
Für den Export von Daten in eine Excel-Datei gelten die folgenden Einschränkungen:
Anzahl der Datensätze |
Analytics-Tabellen, die diese Höchstwerte überschreiten, werden zwar erfolgreich exportiert, jedoch werden die überzähligen Datensätze ignoriert und nicht exportiert. |
---|---|
Länge der Felder |
|
Länge der Feldnamen |
|
Der Parameter WORKSHEET und das Überschreiben
Das Ergebnis der Verwendung oder der fehlenden Verwendung des WORKSHEET-Parameters beim Exportieren aus einer Analytics-Tabelle in eine Excel-Datei wird im Folgenden erläutert:
Zuordnung |
Beschreibung |
WORKSHEET-Parameter verwendet | WORKSHEET-Parameter nicht verwendet |
---|---|---|---|
Kein übereinstimmender Excel-Dateiname |
|
Eine neue Excel-Datei wird mit einem Arbeitsblatt und dem angegebenen Namen erstellt. | Eine neue Excel-Datei wird erstellt, die ein Arbeitsblatt mit dem Namen der exportierten Analytics-Tabelle aufweist. |
Übereinstimmender Excel-Dateiname Kein übereinstimmender Arbeitsblattname |
|
Ein Arbeitsblatt mit dem angegebenen Namen wird der bestehenden Excel-Datei hinzugefügt. | Die bestehende Excel-Datei wird durch eine neue Excel-Datei überschrieben, die ein Arbeitsblatt mit dem Namen der exportierten Analytics-Tabelle aufweist. |
Übereinstimmender Excel-Dateiname und Arbeitsblattname |
|
Ein Arbeitsblatt mit dem angegebenen Namen überschreibt das bestehende Arbeitsblatt, falls es ursprünglich durch Analytics erstellt wurde. Es erscheint eine Fehlermeldung und die Exportoperation wird abgebrochen, falls das bestehende Arbeitsblatt ursprünglich direkt in Excel erstellt wurde. |
Die bestehende Excel-Datei wird durch eine neue Excel-Datei überschrieben, die ein Arbeitsblatt mit dem Namen der exportierten Analytics-Tabelle aufweist. |
In die HighBond-Ergebnisse-App exportieren
Die folgende Tabelle enthält zusätzliche Informationen über den Export eines Kontrolltests in die Ergebnisse-App.
Element |
Details |
---|---|
Notwendige Berechtigungen |
Um Ausnahmedaten in einen Kontrolltest in die Ergebnisse-App exportieren zu können, müssen spezifische Rollenzuweisungen in HighBond oder Administrationsberechtigungen vorhanden sein:
|
Exportlimits |
Auf einen Kontrolltest treffen die folgenden Grenzen zu:
Sie können Exporte mehrfach in denselben Kontrolltest durchführen, nicht aber die Gesamtgrenzen überschreiten. |
Felder anhängen (OVERWRITE nicht angegeben) |
Unabhängig von ihrer Reihenfolge in einer Analytics-Tabelle werden exportierte Felder an bestehende Felder in einem Kontrolltest angehängt, falls sie übereinstimmende physische Feldnamen aufweisen. In Analytics handelt es sich beim physischen Feldnamen um den Namen im Tabellenlayout. Exportierte Felder, deren Name keinem bestehenden Feld entspricht, werden in der Ergebnisse-App als zusätzliche Spalten der Tabelle hinzugefügt. Die Anzeigenamen der Felder in Analytics und in der Ergebnisse-App werden nicht berücksichtigt. Falls Sie jedoch den optionalen Parameter AS Exportname verwenden, wird der Wert Exportname als physischer Feldname verwendet, solange Sie nicht DISPLAYNAME nutzen. Wenn Daten an Fragebogenfelder angehängt werden, bleibt der Anzeigename der Spalte in der Ergebnisse-App der Name, der in der Konfiguration des Fragebogens festgelegt wurde. Das Anhängen funktioniert unterschiedlich, wenn im Zielkontrolltest ein Primärschlüsselfeld angegeben wurde. Weitere Informationen finden Sie unter Ausnahmen in HighBond-Ergebnisse-App exportieren. Hinweis Wenn Sie einen Daten-Roundtrip zwischen der Ergebnisse-App und Analytics vornehmen und die Daten am Ende im der Ergebnisse-App falsch ausgerichtet sind, liegen wahrscheinlich nicht übereinstimmende Feldnamen vor. Weitere Informationen finden Sie unter Überlegungen zu Feldnamen beim Importieren und Exportieren von Daten aus Ergebnisse. |
Eine Kennwortdefinition erstellen und ein Kennwort festlegen |
PASSWORD-Befehl Wenn Sie den PASSWORD-Befehl verwenden, um die nummerierte Kennwortdefinition für die Verbindung mit HighBond anzulegen, wird kein Wert für das Kennwort spezifiziert. Deshalb wird eine Kennwortaufforderung angezeigt, wenn ein Skript versucht, eine Verbindung aufzunehmen. Weitere Informationen finden Sie unter PASSWORD-Befehl. SET-PASSWORD-Befehl Wenn Sie den SET-PASSWORD-Befehl verwenden, um die nummerierte Kennwortdefinition für die Verbindung mit HighBond anzulegen, wird ein Wert für das Kennwort spezifiziert und somit keine Kennwortaufforderung angezeigt. Dies eignet sich für Skripts, die unbeaufsichtigt ablaufen sollen. Weitere Informationen finden Sie unter SET-PASSWORD-Befehl. HighBond-Zugriffstoken beschaffen Unabhängig von Ihrer verwendeten Vorgehensweise bei der Festlegung eines Kennworts handelt es sich bei dem erforderlichen Kennwortwert um einen HighBond-Zugriffstoken, den Benutzer in Launchpad erstellen können: Achtung Das erstellte Zugriffstoken entspricht dem Konto, das zur Anmeldung an Launchpad verwendet wurde. Es empfiehlt sich unter Umständen nicht, als Skriptautor in einem Skript Ihr eigenes Zugriffstoken festzulegen, wenn das Skript durch andere Personen benutzt wird.
|
Wie DISPLAYNAME mit AS beim Exportieren in die HighBond-Ergebnisse-App interagiert
Die folgende Matrix zeigt, wie der Parameter DISPLAYNAME mit AS interagiert, falls Feldnamen von Analytics in die Ergebnisse-App exportiert werden.
Ohne AS | Mit AS | |
---|---|---|
Ohne DISPLAYNAME | Feldname und Anzeigename in der Ergebnisse-App entsprechend dem Feldnamen von Analytics. | Feldname und Anzeigename in der Ergebnisse-App entsprechen dem Anzeigenamen im AS-Parameter. |
Mit DISPLAYNAME | Feldname in der Ergebnisse-App entspricht dem Feldnamen von Analytics. Anzeigename in der Ergebnisse-App entspricht dem Anzeigenamen von Analytics. | Feldname in der Ergebnisse-App entspricht dem Feldnamen von Analytics. Anzeigename in der Ergebnisse-App entspricht dem Anzeigenamen im AS-Parameter. |