dms.ConvertQuery

Mit diesem Job lassen sich verschiedene Anfrageformate ineinander konvertieren.

Folgende Formate werden unterstützt:

DMS — DMSQuery XML-Format
STQ — Format für gespeicherte Anfragen
ABN — Format für Abonnements

1. Eingabeparameter

Name Typ Pflicht Beschreibung

Name	Typ	Pflicht	Beschreibung
`Flags`	INT	Ja	Flags muss `0` sein
`OutputUnicode`	INT	Ja	Muss `1` sein
`Query`	STRING oder BASE64	Ja	Anfragetext
`InputFormat`	STRING	Ja	Eingabeformat: `DMS`, `STQ` oder `ABN`
`OutputFormat`	STRING	Ja	Ausgabeformat: `DMS`, `STQ` oder `ABN`
`[Name]`	STRING	Nein	Name der Anfrage (nur bei OutputFormat `STQ`)
`[QueryID]`	INT	Nein	ID der Anfrage (nur bei OutputFormat `STQ`)
`[IconID]`	INT	Nein	ID eines Icons, das im Client angezeigt wird. Default `0` (nur bei OutputFormat `STQ`)
`[DefAction]`	INT	Nein	Aktion beim Öffnen der gespeicherten Anfrage (nur bei OutputFormat `STQ`). `0` = Ausführen (Default), `1` = Bearbeiten, `2` = Anzahl ermitteln
`[GarbageMode]`	INT	Nein	`1` = Objekte aus dem Papierkorb berücksichtigen, `0` = nicht berücksichtigen (Default, nur bei OutputFormat `ABN`)

Flags

INT

Flags muss 0 sein

OutputUnicode

INT

Muss 1 sein

Query

STRING oder BASE64

Anfragetext

InputFormat

STRING

Eingabeformat: DMS, STQ oder ABN

OutputFormat

STRING

Ausgabeformat: DMS, STQ oder ABN

[Name]

STRING

Nein

Name der Anfrage (nur bei OutputFormat STQ)

[QueryID]

INT

Nein

ID der Anfrage (nur bei OutputFormat STQ)

[IconID]

INT

Nein

ID eines Icons, das im Client angezeigt wird. Default 0 (nur bei OutputFormat STQ)

[DefAction]

INT

Nein

Aktion beim Öffnen der gespeicherten Anfrage (nur bei OutputFormat STQ).
0 = Ausführen (Default), 1 = Bearbeiten, 2 = Anzahl ermitteln

[GarbageMode]

INT

Nein

1 = Objekte aus dem Papierkorb berücksichtigen, 0 = nicht berücksichtigen (Default, nur bei OutputFormat ABN)

2. Ausgabeparameter

Name Typ Abhängigkeit Beschreibung

Name	Typ	Abhängigkeit	Beschreibung
`Query`	BASE64	OutputFormat `DMS`	Anfragetext im DMSQuery XML-Format (UTF-8 kodiert)
`sQuery`	STRING	OutputFormat `STQ` / `ABN`	Anfragetext im Zielformat (ANSI-kodiert)

Query

BASE64

OutputFormat DMS

Anfragetext im DMSQuery XML-Format (UTF-8 kodiert)

sQuery

STRING

OutputFormat STQ / ABN

Anfragetext im Zielformat (ANSI-kodiert)

3. Rückgabe

(INT): 0 = Job erfolgreich, sonst Fehlercode
Vollständige Fehlerliste

Da die Anfragemöglichkeiten des DMSQuery XML-Formats über die Möglichkeiten der anderen Formate hinausgehen, bestehen folgende Limitierungen für das DMSQuery XML-Format als Eingabeformat:

Hierarchische Strukturen werden nicht unterstützt (<ParentObjects>, <ChildObjects>, <ExternalObjects> werden ignoriert).
Parameternamen müssen das Format $VARnnn$ bzw. $STATnnn$ besitzen (nnn = 000–999).
Es dürfen keine Feldgruppen innerhalb von Bedingungen verwendet werden.
Für jede Bedingung darf nur jeweils ein Wert angegeben werden.
Es können keine Bedingungen für Basisparameter und Systemfelder formuliert werden.
Gespeicherte Anfragen (STQ) im Expertenmodus können nicht konvertiert werden.