commandArgs.
Alle Variablen in diesem Abschnitt sind global und im gesamten Programm sichtbar.
Funktionen zum Arbeiten mit Feldern
Funktionen zum Arbeiten mit Feldern
getCurrentField() | Gibt einen Link auf das Feldobjekt zurück, das das aktuelle benutzerdefinierte Skript verwendet. |
getFieldByName(namesPath) (*) | Gibt einen Link auf das Feld zurück, für das das benutzerdefinierte Skript geöffnet wurde. Beispiel:
|
getFieldValue(namesPath) (*) | Gibt zurück:
namesPath | fieldObject:
|
setCurrentFieldValue(value, forced, onSaved) | Ändert den Wert des Felds, für das das benutzerdefinierte Skript geöffnet wurde. Parameter:
|
setFieldValue(namesPath | field, value, forced, onSaved) (*) | Ändert den Wert des Felds. Parameter:
|
save() | Schließt das Fenster, in dem das benutzerdefinierte Skript ausgeführt wird, und speichert die Änderungen. |
cancel() | Schließt das Fenster, in dem das benutzerdefinierte Skript ausgeführt wird, ohne die Änderungen zu speichern. |
(*) Bei einigen der oben aufgeführten Funktionen wird der Pfad zum Feld als Eingabeparameter angegeben. Er besteht aus dem Feldnamen und den Namen der übergeordneten Elemente (Feldgruppe, Abschnitt). Bei Tabellen, wiederholbaren Tabellen und wiederholbaren Gruppen müssen Sie die Instanznummer angeben, beginnend bei 0 (null). Beispiel: wobei [10] die Nummer der Instanz der wiederholbaren Gruppe ist. | |
Funktionen zum Arbeiten mit Datensätzen
Funktionen zum Arbeiten mit Datensätzen
addEntity(entityInfo: {cacheName, columns, values}, onResult(newId)) | Fügt dem Datensatz einen Eintrag hinzu. Parameter:
|
editEntity(entityInfo: {cacheName, columns, values}, onResult()) | Bearbeitet einen Datenbankeintrag. Parameter:
|
getDict({cacheName, filters: [{FieldName, FieldValue}], cursorPos, allowMultipleColumnResults}, onResult (param: { FieldName, FieldValue, BoldMask}[][]) ) | Führt eine Suche in einem Datensatz nach einem angegebenen Wert oder einem Teil davon durch. Gibt die Treffer als Zeichenfolgen im folgenden Format zurück: [{FieldName Parameter:
Wenn sich zum Beispiel Folgendes in einem Datensatz befindet: CompanyName: ABBYY Angenommen, es wird nach den Zeichen “ABB” gesucht. Dann wird Folgendes zurückgegeben: [ [ { FieldName: ‘CompanyName’, FieldValue: ‘ABBYY’, BoldMask: ‘11100’ }, ] ] Hinweis: Das zurückgegebene Array kann mehrere Werte enthalten, auch solche, die den Suchbedingungen anfangs nicht entsprachen. Die Suchergebnisse im Array werden nach dem BoldMask-Parameterwert in absteigender Reihenfolge sortiert (d. h. beginnend mit den Zeichenfolgen, die am besten zu den Suchbedingungen passen). |
getDictAll({cacheName, filters: {FieldName, FieldValue}}, }, onResult (param: { FieldName, FieldValue, BoldMask}[][])) | Führt eine Datenbanksuche für den vollständig angegebenen Wert aus. Gibt die Werte aller gefundenen Felder zurück. Parameter:
[ [ { FieldName: ‘CompanyName’, FieldValue: ‘ABBYY’, BoldMask: ‘11100’ }, ] ] Hinweis: Das zurückgegebene Array kann mehrere Werte enthalten, auch solche, die ursprünglich nicht den Suchbedingungen entsprachen. Die Suchergebnisse im Array werden nach dem Wert des Parameters BoldMask in absteigender Reihenfolge sortiert (d. h. beginnend mit strings, die den Suchbedingungen am besten entsprechen). |
Funktionen für die Arbeit mit dem Dokumentformular
Funktionen für die Arbeit mit dem Dokumentformular
selectRow(tablePath, rowNumber) (*) | Markiert eine Tabellenzeile als ausgewählt.
|
deselectRow(tablePath, rowNumber?) (*) | Hebt die Auswahl einer Tabellenzeile auf.
|
scrollFormToField(namesPath) (*) | Scrollt den Formular-Editor, sodass das Feld sichtbar wird.
|
getDomElementPosition(domId, onResult: (result?: {width, height, top, left, right, bottom})) | Ermittelt die Position eines Elements im Fenster des Formular-Editors und übergibt das Ergebnis an eine Callback-Funktion.
|
setStyles(styles, callback) | Fügt dem Fenster des Rahmens für benutzerdefinierte Aktionen CSS-Stile hinzu.
|
(*) Bei einigen der oben aufgeführten Funktionen wird der Pfad zum Feld als Eingabeparameter angegeben. Er umfasst den Feldnamen und die Namen der übergeordneten Elemente (Feldgruppe, Abschnitt). Bei Tabellen, wiederholbaren Tabellen und wiederholbaren Gruppen müssen Sie die Instanznummer angeben, beginnend bei null. Beispiel: wobei [10] die Nummer der Instanz der wiederholbaren Gruppe ist. | |
Eigenschaften des commandArgs-Objekts
Eigenschaften des commandArgs-Objekts
commandArgs.params.document | Document | Speichert eine Objektkopie eines geöffneten Dokuments. Diese kann verwendet werden, um auf Fehler, Felder oder Regionen im aktuellen Dokument zuzugreifen. |
commandArgs.params.currentField | (Picture | Checkmark | Checkmark Groups | FieldsGroup | Table | TextField) | Gibt einen Verweis auf ein Feldobjekt zurück, das den Status des Felds zu dem Zeitpunkt widerspiegelt, zu dem das Skript aufgerufen wird. Es ist Teil des oben angegebenen Dokuments. Hinweis: Wenn der Feldwert geändert wurde, nachdem das Skript initialisiert wurde, werden diese Änderungen nicht berücksichtigt. |
commandArgs.params.appPath | String | Der Domänenname des Servers. |
commandArgs.params.coordinates | Object | Die Koordinaten des DOM-Elements, das das benutzerdefinierte Skript aufgerufen hat. |
commandArgs.params.currentElementDomId | String | Die ID des DOM-Elements, das das benutzerdefinierte Skript aufgerufen hat. |
| Funktion | Beschreibung |
|---|---|
| commandArgs.events.addEventHandler | Fügt im globalen Kontext des benutzerdefinierten Skripts einen Ereignishandler hinzu. |
| commandArgs.events.triggerHandlers | Löst im globalen Kontext des benutzerdefinierten Skripts ein Ereignis aus. |
| commandArgs.events.removeEventHandler | Entfernt im globalen Kontext des benutzerdefinierten Skripts einen Ereignishandler. |
Feldgruppenfeld
Feldgruppenfeld
Fields | (Picture | Checkmark | Checkmark Groups | FieldsGroup | Table | TextField)[] | Schreibgeschützt | Array von Feldern |
HasTableLayout | Boolean | Schreibgeschützt | Gibt an, ob die Feldregion eine Tabelle ist. |
Caption | String | Schreibgeschützt | Benutzerdefinierter Feldname, Beschriftung |
FieldType | Number | Schreibgeschützt | Feldtyp. Möglicher Wert: 4 – Feldgruppe |
Id | Number | Schreibgeschützt | Feld-ID |
IsReadOnly | Boolean | Schreibgeschützt | Gibt an, ob Felder nicht bearbeitet werden dürfen. |
IsVisible | Boolean | Schreibgeschützt | Gibt an, ob das Feld im Datenformular sichtbar ist. |
MaxRegions | Number | Schreibgeschützt | Maximale Anzahl von Feldregionen. Wenn der Wert -1 ist, ist eine beliebige Anzahl von Regionen zulässig. |
Name | String | Schreibgeschützt | Service-Name für das Feld. |
NamePath | String[] | Schreibgeschützt | Array von Feld- und Gruppennamen, die den Pfad zum Feld bilden. |
NeedRecognize | Boolean | Lesen/Schreiben | Gibt an, ob der Feldwert aus der Region abgerufen werden soll, wenn die Regeln erneut geprüft werden. |
Regions | {
| Schreibgeschützt | Array von Regionen.
|
Sectionfeld
Sectionfeld
Fields | (Picture | Checkmark | Checkmark Groups | FieldsGroup | Table | TextField)[] | Schreibgeschützt | Array von Feldern |
Pageids | Number[] | Schreibgeschützt | Bezeichner der Seiten, auf denen sich die Section befindet. |
IsFlexible | Boolean | Schreibgeschützt | Gibt an, ob die Section flexibel ist. |
Caption | String | Schreibgeschützt | Name bzw. Beschriftung des benutzerdefinierten Felds |
FieldType | Number | Schreibgeschützt | Feldtyp. Möglicher Wert: 6 – Section |
Id | Number | Schreibgeschützt | Feld-ID |
IsReadOnly | Boolean | Schreibgeschützt | Gibt an, ob die Bearbeitung des Felds nicht zulässig ist. |
IsVisible | Boolean | Schreibgeschützt | Gibt an, ob das Feld im Datenformular sichtbar ist. |
MaxRegions | Number | Schreibgeschützt | Maximale Anzahl von Feldregionen. Wenn der Wert -1 ist, ist eine beliebige Anzahl von Regionen zulässig. |
Name | String | Schreibgeschützt | Service-Name des Felds |
NamePath | String[] | Schreibgeschützt | Array aus Feld- und Gruppennamen, die den Pfad zum Feld bilden. |
NeedRecognize | Boolean | Lesen/Schreiben | Gibt an, ob der Feldwert erneut aus der Region übernommen werden soll, wenn die Regeln noch einmal geprüft werden. |
Regions | {
| Schreibgeschützt | Array von Regionen.
|
Tabellenfeld
Tabellenfeld
Zeilen | {
| Schreibgeschützt | Liste der Tabellenzeilen. Die Parameter des Zeilenobjekts in der Tabelle:
|
Beschriftung | String | Schreibgeschützt | Name und Beschriftung des benutzerdefinierten Felds |
FieldType | Number | Schreibgeschützt | Feldtyp. Möglicher Wert: 7 – Tabelle |
ID | Number | Schreibgeschützt | Feld-ID |
IsReadOnly | Boolean | Schreibgeschützt | Gibt an, ob das Feld nicht bearbeitet werden kann. |
IsVisible | Boolean | Schreibgeschützt | Gibt an, ob das Feld im Datenformular sichtbar ist. |
MaxRegions | Number | Schreibgeschützt | Gibt an, wie viele Regionen für das Feld im Datenformular zulässig sind. -1 bedeutet, dass eine beliebige Anzahl von Regionen zulässig ist. |
Name | String | Schreibgeschützt | Servicename des Feldes. |
NamePath | String[] | Schreibgeschützt | Array von Feld- und Gruppennamen, die den Pfad zum Feld bilden. |
NeedRecognize | Boolean | Lesen/Schreiben | Gibt an, ob der Feldwert bei erneuter Regelprüfung aus der Region abgerufen werden soll. |
Regionen | {
| Schreibgeschützt | Array aus Regionen.
|
Texteingabefeld
Texteingabefeld
Flags | Number[] | Lesen/Schreiben | Array mit derselben Länge wie das Feld Value. Enthält 0 und 1. 0 – ein Zeichen in Value, das sich an derselben Position befindet wie die 0 in Flags, muss verifiziert werden. |
Vorschläge | String[] | Schreibgeschützt | Liste vorgeschlagener Feldwerte |
Value | String | Lesen/Schreiben | Feldwert |
TextType | Number | Schreibgeschützt | Typ des Textfelds. Mögliche Werte:
|
Beschriftung | String | Schreibgeschützt | Name/Beschriftung des benutzerdefinierten Felds |
FieldType | Number | Schreibgeschützt | Feldtyp. Möglicher Wert: 0 – Textfeld |
ID | Number | Schreibgeschützt | Feld-ID |
IsReadOnly | Boolean | Schreibgeschützt | Gibt an, ob das Feld nicht bearbeitet werden kann. |
IsVisible | Boolean | Schreibgeschützt | Gibt an, ob das Feld im Datenformular sichtbar ist. |
MaxRegions | Number | Schreibgeschützt | Maximale Anzahl an Feldregionen. Wenn der Wert -1 ist, sind beliebig viele Regionen zulässig. |
Name | String | Schreibgeschützt | Service-Name des Feldes. |
NamePath | String[] | Schreibgeschützt | Array von Feld- und Gruppennamen, die den Pfad zum Feld bilden. |
NeedRecognize | Boolean | Lese-/Schreibzugriff | Gibt an, ob der Feldwert aus der Region abgerufen werden soll, wenn die Regeln erneut geprüft werden. |
Regionen | {
| Schreibgeschützt | Array von Regionen.
|
IsVerified | Boolean | Lese-/Schreibzugriff | Gibt an, ob das Feld verifiziert wurde. |
NeedVerification | Boolean | Schreibgeschützt | Gibt an, ob für das Feld eine Verifizierung erforderlich ist. |
NeedDoubleVerification | Boolean | Schreibgeschützt | Gibt an, ob für das Feld eine doppelte Verifizierung erforderlich ist |
IsSummary | Boolean | Schreibgeschützt | Gibt an, ob das Feld in die Datenzusammenfassung im Datenformular einbezogen wird. |
Häkchen-Feld
Häkchen-Feld
Value | Boolean | Lese-/Schreibzugriff | Feldwert |
Beschriftung | String | Schreibgeschützt | Name/Beschriftung eines benutzerdefinierten Felds |
FieldType | Number | Schreibgeschützt | Feldtyp. Möglicher Wert: 2 – Häkchen |
ID | Number | Schreibgeschützt | Feld-ID |
IsReadOnly | Boolean | Schreibgeschützt | Gibt an, ob das Feld schreibgeschützt ist. |
IsVisible | Boolean | Schreibgeschützt | Gibt an, ob das Feld im Datenformular sichtbar ist. |
MaxRegions | Number | Schreibgeschützt | Maximale Anzahl an Feldregionen. Wenn der Wert -1 ist, ist eine beliebige Anzahl von Regionen erlaubt. |
Name | String | Schreibgeschützt | Service-Name des Feldes. |
NamePath | String[] | Schreibgeschützt | Array aus Feld- und Gruppennamen, das den Pfad zum Feld bildet. |
NeedRecognize | Boolean | Lesen/Schreiben | Gibt an, ob der Feldwert bei erneuter Regelprüfung aus der Region abgerufen werden soll. |
Regionen | {
| Schreibgeschützt | Array von Regionen.
|
IsVerified | Boolean | Lese-/Schreibzugriff | Gibt an, ob das Feld überprüft wurde. |
NeedVerification | Boolean | Schreibgeschützt | Gibt an, ob für das Feld eine Verifizierung erforderlich ist. |
NeedDoubleVerification | Boolean | Schreibgeschützt | Gibt an, ob für das Feld eine doppelte Verifizierung erforderlich ist. |
IsSummary | Boolean | Schreibgeschützt | Legt fest, ob das Feld für die Datenzusammenfassung im Datenformular verwendet wird. |
Häkchen-Gruppenfeld
Häkchen-Gruppenfeld
MaxSelectedCount | Number | Schreibgeschützt | Maximale Anzahl der ausgewählten Feldwerte. |
MinSelectedCount | Number | Schreibgeschützt | Mindestanzahl ausgewählter Feldwerte. |
Werte | Number[] | Lese-/Schreibzugriff | Feldwert. Ein Array von Datensatz-IDs, das die Liste der möglichen Feldwerte (Varianten) enthält. |
Varianten | {Id:number, Name:string}[] | Schreibgeschützt | Liste möglicher Feldwerte:
|
Beschriftung | String | Schreibgeschützt | Name und Beschriftung des benutzerdefinierten Feldes |
FieldType | Number | Schreibgeschützt | Feldtyp. Möglicher Wert: 3 – Häkchengruppe |
ID | Number | Schreibgeschützt | Feld-ID. |
IsReadOnly | Boolean | Schreibgeschützt | Gibt an, ob das Feld nicht bearbeitet werden kann. |
IsVisible | Boolean | Schreibgeschützt | Gibt an, ob das Feld im Datenformular sichtbar ist. |
MaxRegions | Number | Schreibgeschützt | Maximale Anzahl an Feldregionen. Wenn der Wert -1 ist, sind beliebig viele Regionen zulässig. |
Name | String | Schreibgeschützt | Service-Name des Feldes. |
NamePath | String[] | Schreibgeschützt | Array von Feld- und Gruppennamen, die den Pfad zum Feld bilden. |
NeedRecognize | Boolean | Lese-/Schreibzugriff | Gibt an, ob der Feldwert bei einer erneuten Überprüfung der Regeln aus der Region abgerufen werden soll. |
Regionen | {
| Schreibgeschützt | Array von Regionen.
|
IsVerified | Boolean | Lese-/Schreibzugriff | Gibt an, ob das Feld überprüft wurde. |
NeedVerification | Boolean | Schreibgeschützt | Gibt an, ob für das Feld eine Verifizierung erforderlich ist. |
NeedDoubleVerification | Boolean | Schreibgeschützt | Gibt an, ob für das Feld eine doppelte Verifizierung erforderlich ist. |
IsSummary | Boolean | Schreibgeschützt | Gibt an, ob das Feld zur Erstellung der Datenzusammenfassung im Datenformular verwendet wird. |
Bildfeld
Bildfeld
Caption | String | Schreibgeschützt | Name bzw. Beschriftung des benutzerdefinierten Felds |
FieldType | Number | Schreibgeschützt | Feldtyp. Möglicher Wert: 1 – Bild |
Id | Number | Schreibgeschützt | Feld-ID. |
IsReadOnly | Boolean | Schreibgeschützt | Gibt an, ob die Bearbeitung des Felds nicht zulässig ist. |
IsVisible | Boolean | Schreibgeschützt | Gibt an, ob das Feld im Datenformular sichtbar ist. |
MaxRegions | Number | Schreibgeschützt | Maximale Anzahl von Feldregionen. Wenn der Wert -1 ist, ist eine beliebige Anzahl von Regionen zulässig. |
Name | String | Schreibgeschützt | Service-Name des Felds. |
NamePath | String[] | Schreibgeschützt | Array aus Feld- und Gruppennamen, die den Pfad zum Feld bilden. |
Regions | {
| Schreibgeschützt | Array von Regionen.
|
Feld für wiederholbare Abschnittsgruppen
Feld für wiederholbare Abschnittsgruppen
Name | Typ | Rechte | Beschreibung |
Id | Number | Schreibgeschützt | Feld-ID |
Name | String | Schreibgeschützt | Feldname |
Sections | Section[] | Schreibgeschützt | Array aus Feldern des Typs Section |
FieldType | Number | Schreibgeschützt | Feldtyp. Möglicher Wert: 8 – wiederholbare Abschnittsgruppe. |
Eigenschaften des Dokumentobjekts
Eigenschaften des Dokumentobjekts
AssemblingErrors | {
| Schreibgeschützt | Erstellungsfehler im Dokument:
|
BatchId | Number | Schreibgeschützt | Die Paket-ID |
Fehler | {
| Schreibgeschützt | Fehler im Dokument:
|
Fields | (Section | SectionsGroup)[] | Schreibgeschützt | Liste der Abschnitte/duplizierten Abschnitte |
ID | Number | Schreibgeschützt | Dokumentbezeichner |
Index | Number | Schreibgeschützt | Index des Dokuments im Paket |
Pages | {
| Schreibgeschützt | Liste von Dokumentseiten mit den folgenden Angaben:
|
ProjectId | Number | Schreibgeschützt | Projektbezeichner |
TaskId | Number | Schreibgeschützt | Task-ID |
TemplateId | Number | Schreibgeschützt | ID der Dokumentdefinition |
TemplateName | String | Schreibgeschützt | Der Name des Definitionsdokuments |
TemplateVersion | Number | Schreibgeschützt | Definitionsversion des Dokuments |
Version | Number | Schreibgeschützt | Dokumentversion |
