EXPORT-Befehl

Die zu exportierenden Felder.

• Feldname Exportiert die angegebenen Felder

  Trennen Sie Feldnamen durch Leerzeichen.

  Sie können mit „AS Exportname“ für das Feld in der Exportdatei optional einen anderen Namen eingeben. Schließen Sie Exportname in Anführungszeichen ein.

  Wenn Sie nach ACLGRC (HighBond) exportieren, ist es möglich, AS mit dem Parameter DISPLAYNAME zu kombinieren. Weitere Informationen finden Sie unter Wie DISPLAYNAME mit AS beim Exportieren in das HighBond-Ergebnismodul interagiert.

• ALL Exportiert alle Felder der Tabelle.

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.

• Wählen Sie UNICODE, wenn Ihre zu exportierenden Daten Zeichen enthalten, die durch erweitertes ASCII (ANSI) nicht unterstützt werden.
• Wählen Sie Unicode nicht, wenn alle Zeichen in Ihren zu exportierenden Daten durch erweitertes ASCII (ANSI) unterstützt werden.

  Die exportierten Daten werden im erweiterten ASCII-Format (ANSI) codiert.

  Hinweis

  Alle nicht unterstützten Zeichen werden in der exportierten Datei ausgelassen.

Weitere Informationen finden Sie unter ACL-Unicode-Produkte.

Das Format oder der Zielort der Ausgabedatei mit einer der folgenden Optionen:

• ACCESS Microsoft-Access-Datenbankdatei (.mdb)

  In der Standardeinstellung werden die Daten als Unicode exportiert.

• ACLGRC Ergebnisse in HighBond
• ASCII Unformatierter ASCII-Text (.txt)
• CLIPBOARD Windows-Zwischenablage
• DBASE dBase-kompatible Datei (.dbf)
• DELIMITED Datei mit Trennzeichen (.del)
• EXCEL Microsoft-Excel-Datei (.xls), kompatibel mit Excel 1997 bis 2003
• JSON JSON-Datei (.json)
• LOTUS Lotus-123-Datei
• WDPF6 Wordperfect-6-Datei
• WORD MS-Word-Datei (.doc)
• WP Wordperfect-Datei
• XLS21 Microsoft-Excel-Datei der Version 2.1
• XLSX Microsoft-Excel-Datei (.xlsx)

  In der Standardeinstellung werden die Daten als Unicode exportiert.

• XML XML-Datei (.xml)

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.

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.

PASSWORD Zahl muss direkt vor TO oder am Ende der Zeichenfolge in der Befehlssyntax erscheinen. Das Kennwort ist ein HighBond-Zugriffstoken. Weitere Informationen finden Sie unter Ins HighBond-Ergebnismodul exportieren.

Der Zielort für den Export:

• TO Dateiname exportiert Daten in eine Datei

  Falls notwendig, können Sie einen absoluten oder einen relativen Dateipfad angeben. Der Windows-Ordner muss jedoch bereits vorhanden sein. Der Wert Dateiname muss als Zeichenfolge in Anführungszeichen angegeben werden.

• TO ACLGRC_ID Daten in das HighBond-Ergebnismodul exportieren

  Der Wert ACLGRC_ID muss die Kontrolltest-ID und, falls Sie in ein Rechenzentrum außerhalb Nordamerikas exportieren, auch den Rechenzentrum-Code enthalten. Der Wert ACLGRC_ID muss in Anführungszeichen gesetzt werden.

  Die ID-Nummer des Kontrolltests und der Rechenzentrum-Code müssen durch das @-Zeichen getrennt werden. Zum Beispiel: TO "99@eu".

  Wenn Sie die Kontrolltest-ID nicht kennen, verwenden Sie die Analytics-Benutzeroberfläche, um einen Export in das Ergebnismodul zu beginnen. Brechen Sie den Export ab, sobald Sie die Kontrolltest-ID gefunden haben. Weitere Informationen finden Sie unter Ausnahmen in ACL GRC exportieren.

  Der Rechenzentrum-Code gibt den regionalen HighBond-Server an, der als Ziel für den Datenexport bestimmt ist:

  • ap – Asien-Pazifik
  • au – Australien
  • ca – Kanada
  • eu – Europa
  • us – Nordamerika

  Sie können nur den Rechenzentrum-Code oder die Codes angeben, die für die HighBond-Instanz Ihrer Organisation gestattet sind. Das Nordamerika-Rechenzentrum ist die Standardeinstellung. Deshalb ist die Angabe von "@us" optional.

Optional

Gilt nur für den Export in das HighBond-Ergebnismodul.

Alle bestehenden Daten im Zielkontrolltest (Tabelle) werden durch die exportierten Daten überschrieben. Sie müssen in der Zielsammlung die Rolle „Fachmanager“ aufweisen, um Daten überschreiben zu können.

Wenn Sie OVERWRITE weglassen und es bereits Daten im Zielkontrolltest (Tabelle) gibt, werden die exportierten Daten an die bestehenden Daten angehängt. Weitere Informationen über das Anhängen im Ergebnismodul finden Sie in den folgenden „Bemerkungen“.

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.

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.

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.

Optional

Die Anzahl der zu verarbeitenden Datensätze:

• FIRST Verarbeitung beim ersten Datensatz beginnen, bis die angegebene Datensatzanzahl erreicht wird
• NEXT Verarbeitung beim aktuell ausgewählten Datensatz beginnen, bis die angegebene Datensatzanzahl erreicht wird

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.

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.

Optional

Gilt nur für Textdateien (ASCII) sowie Textdateien mit Trennzeichen (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 Textdateien mit Trennzeichen (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.

QUALIFIER Zeichen

Optional

Gilt nur für Textdateien mit Trennzeichen (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 ACLGRC (HighBond).

Exportiert Feldnamen als Feldnamen und Anzeigenamen als Anzeigenamen. Anzeigename werden also im Ergebnismodul 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 das HighBond-Ergebnismodul interagiert.

• Excel 2007 und später (*.xlsx) höchstens 1.048.576 Datensätze
• Excel 97 und 2003 höchstens 65.536 Datensätze

Analytics-Tabellen, die diese Höchstwerte überschreiten, werden zwar erfolgreich exportiert, jedoch werden die überzähligen Datensätze ignoriert und nicht exportiert.

• keine spezifische Feldlängenbegrenzung
• Die kombinierten Feldlängen dürfen die maximale Datensatzlänge von 32 KB

  (32.765 Zeichen in Non-Unicode Analytics, 16.382 Zeichen in Unicode Analytics) nicht überschreiten.

• für Excel 2.1, höchstens 247 Zeichen

• höchstens 64 Zeichen
• für Excel 2.1, höchstens 248 Zeichen

• Wert von TO  Dateiname entspricht keinem bestehenden Excel-Dateinamen.

Übereinstimmender Excel-Dateiname

Kein übereinstimmender Arbeitsblattname

• Wert von TO  Dateiname und Name einer bestehenden Excel-Datei sind identisch.
• WORKSHEET Arbeitsblattname entspricht keinem Arbeitsblattnamen in der Excel-Datei.

• Wert von TO  Dateiname und Name einer bestehenden Excel-Datei sind identisch.
• WORKSHEET Arbeitsblattname entspricht einem Arbeitsblattnamen in der Excel-Datei.

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.

Notwendige Berechtigungen

Um Ausnahmedaten in einen Kontrolltest in das Ergebnismodul exportieren zu können, müssen spezifische Rollenzuweisungen in HighBond oder Administrationsberechtigungen vorhanden sein:

• Benutzer, die für eine Ergebnismodul-Sammlung die Rolle „Fachmanager“ oder „Fachbenutzer“ aufweisen, können Ergebnisse in die Kontrolltests der Sammlung exportieren.

  Hinweis

  Nur Benutzer mit der Rolle „Fachmanager“ können bestehende Daten in einem Kontrolltest exportieren und überschreiben.

• HighBond-Systemadministratoren und Ergebnismodul-Administratoren erhalten in den HighBond-Organisationen, die sie administrieren, automatisch die Rolle „Fachmanager“.

Exportlimits

Auf einen Kontrolltest treffen die folgenden Grenzen zu:

• Maximal 100.000 Datensätze pro Export
• Maximal 100.000 Datensätze pro Kontrolltest
• Maximal 500 Felder pro Datensatz
• Höchstens 256 Zeichen pro Feld

Sie können Exporte mehrfach in denselben Kontrolltest durchführen, nicht aber die Gesamtgrenzen überschreiten.

Felder anhängen

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 im Ergebnismodul als zusätzliche Spalten hinzugefügt.

Die Anzeigenamen der Felder in Analytics und im Ergebnismodul 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 im Ergebnismodul der Name, der in der Konfiguration des Fragebogens festgelegt wurde.

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

Unabhängig von der von Ihnen verwendeten Vorgehensweise zur Festlegung eines Kennworts handelt es sich bei dem erforderlichen Wert des Kennworts um einen HighBond-Zugriffstoken:

• PASSWORD-Methode – Benutzer können einen Zugriffstoken erlangen, indem sie Extras HighBond-Zugriffstoken auswählen und sich dann an HighBond anmelden. Daraufhin wird ein Zugriffstoken zur Verfügung gestellt, den Benutzer kopieren und in die Aufforderung zur Kennworteingabe einfügen können.
• SET-PASSWORD-Methode – Um einen Zugriffstoken in die Befehlssyntax von SET PASSWORD in einem Analytics-Skript einzufügen, klicken Sie mit der rechten Maustaste in den Skript-Editor, wählen EinfügenHighBond-Token und melden sich an HighBond an. Ein Zugriffstoken wird an der Cursorposition in das Skript eingefügt.