CRMWScript
Das WScript-Objekt beinhaltet Eigenschaften und Methoden der Scripting-Engine sowie von der Datenbank oder dem aktuellen Status unabhängige Funktionalität.
Das Objekt kann nicht von außen instanziert werden und steht daher in dieser Form nur in Scripten zur Verfügung, die innerhalb des Programms aufgerufen werden.
Implementiert
AsyncDisposableDisposable
Eigenschaften
ClipboardText
get ClipboardText(): string
Setzt oder liest den Textinhalt der Zwischenablage.
set ClipboardText(val): void
Setzt oder liest den Textinhalt der Zwischenablage.
Parameter
| Parameter | Type |
|---|---|
val | string |
Rückgabewert
string
Definiert in
combitCRM.SDK.WindowsClient.v11.ts:13214
Event
get Event(): CRMEvent
Das WScript.Event-Objekt und entsprechende Unterobjekte sind global verfügbar. Die im jeweils aktuellen
Script-Kontext nicht verfügbaren Unterobjekte sind Nothing bzw. null. WScript.Event.Project ist immer verfügbar und entspricht cRM.CurrentProject.
Rückgabewert
Definiert in
combitCRM.SDK.WindowsClient.v11.ts:13231
IsDisposed
get IsDisposed(): boolean
Gibt an, ob das Objekt bereits Freigegeben wurde
Rückgabewert
boolean
Definiert in
combitCRM.SDK.WindowsClient.v11.ts:13288
Priority
get Priority(): number
Legt die Priorität des Scripts fest oder gibt diese zurück. Je höher die Priorität, desto häufiger bekommt das
Script Rechenzeit zugeteilt und umgekehrt.Die möglichen Werte liegen zwischen –2 und +2, wobei –2 die
niedrigste und +2 die höchste Priorität darstellt.
Hinweis: Kann nur in asynchronen Scripts verwendet werden.
set Priority(val): void
Legt die Priorität des Scripts fest oder gibt diese zurück. Je höher die Priorität, desto häufiger bekommt das
Script Rechenzeit zugeteilt und umgekehrt.Die möglichen Werte liegen zwischen –2 und +2, wobei –2 die
niedrigste und +2 die höchste Priorität darstellt.
Hinweis: Kann nur in asynchronen Scripts verwendet werden.
Parameter
| Parameter | Type |
|---|---|
val | number |
Rückgabewert
number
Definiert in
combitCRM.SDK.WindowsClient.v11.ts:13251
RightClicked
get RightClicked(): boolean
Gibt true zurück, wenn das Script in der Eingabemaske über einen Button ausgeführt wurde und dieser mit
der rechten Maustaste geklickt wurde.Ermöglicht die Ausführung zweier verschiedener Funktionen über
einen Button.
Rückgabewert
boolean
Definiert in
combitCRM.SDK.WindowsClient.v11.ts:13272
Terminate
get Terminate(): boolean
Gibt true zurück, wenn die Anwendung gerade beendet wird bzw. das aktive Script zum Beenden aufgefordert wird. Die Eigenschaft kann und sollte unbedingt in Verbindung mit asynchronen Scripts verwendet werden und ermöglicht ein sauberes Verlassen des Scripts.
Bitte beachten Sie dabei, dass die noch laufenden, asynchronen Scripte insgesamt 4 Sekunden Zeit haben, sich zu beenden, bevor die Beendigung erzwungen wird.Sleeps und andere Aktionen im Script sollten also keinesfalls länger als 3 Sekunden dauern, bevor wieder die.Terminate Eigenschaft geprüft und das Script dann ggf.sich so schnell wie möglich kontrolliert beenden muss.
Rückgabewert
boolean
Definiert in
combitCRM.SDK.WindowsClient.v11.ts:13282
Methoden
ActivateTitle()
ActivateTitle(windowTitle): void
Aktiviert ein Windows-Fenster über dessen Titel.
Parameter
| Parameter | Type | Description |
|---|---|---|
windowTitle | string | Der Titel (Name) des zu aktivierenden Fensters. Wenn Sie als erstes Zeichen ein "$" übergeben, muss der übergebene Titel lediglich enthalten sein, ansonsten genau übereinstimmen. |
Rückgabewert
void
Definiert in
combitCRM.SDK.WindowsClient.v11.ts:13312
ActivateTitleByClassname()
ActivateTitleByClassname(classname): void
Aktiviert ein Windows-Fenster über dessen Klassennamen.
Parameter
| Parameter | Type | Description |
|---|---|---|
classname | string | Der Klassenname des zu aktivierenden Fensters. |
Rückgabewert
void
Definiert in
combitCRM.SDK.WindowsClient.v11.ts:13322
Beep()
Beep(): void
Gibt den Standard Windows Warnton aus.
Rückgabewert
void
Definiert in
combitCRM.SDK.WindowsClient.v11.ts:13331
CheckAbortedWaitDlg()
CheckAbortedWaitDlg(): boolean
Die Methode muss zwischen StartWaitDlg(text: string, cancel: boolean) und EndWaitDlg() aufgerufen werden und gibt zurück, ob der Benutzer die Schaltfläche "Abbrechen" des Wartedialoges betätigt hat, sofern StartWaitDlg(text: string, cancel: boolean) mit Abbruch-Button angezeigt wurde.Die Methode wird vorzugsweise in Ausführungsschleifen verwendet.
Rückgabewert
boolean
Definiert in
combitCRM.SDK.WindowsClient.v11.ts:13340
Dispose()
Dispose(): void
Standardimplementierung des Dispose
Rückgabewert
void
Definiert in
combitCRM.SDK.WindowsClient.v11.ts:13481
DisposeAsync()
DisposeAsync(): Promise<void>
Standardimplementierung des AsyncDispose
Rückgabewert
Promise<void>
Definiert in
combitCRM.SDK.WindowsClient.v11.ts:13470
EndWaitDlg()
EndWaitDlg(): void
Blendet einen zuvor mit StartWaitDlg(text: string, cancel: boolean) angezeigten Wartedialog aus.
Rückgabewert
void
Definiert in
combitCRM.SDK.WindowsClient.v11.ts:13349
GetGlobalProperty()
GetGlobalProperty(name, defaultValue): string
Liest eine globale Script-Einstellung aus, die zuvor mit SetGlobalProperty(name: string, value: string) gesetzt wurde oder gibt den Standardwert zuruück.
Parameter
| Parameter | Type | Description |
|---|---|---|
name | string | Der Name der Einstellung. |
defaultValue | string | Der Standardwert der Einstellung, der zurückgegeben wird, wenn keine Einstellung mit dem angegebenen Namen existiert. |
Rückgabewert
string
Definiert in
combitCRM.SDK.WindowsClient.v11.ts:13360
GetUserProperty()
GetUserProperty(name, defaultValue): string
Liest eine benutzerspezifische Script-Einstellung aus, die zuvor mit SetUserProperty(name: string, value: string) gesetzt wurde oder gibt den Standardwert zurück.
Parameter
| Parameter | Type | Description |
|---|---|---|
name | string | Der Name der Einstellung. |
defaultValue | string | Der Standardwert der Einstellung, der zurückgegeben wird, wenn keine Einstellung mit dem angegebenen Namen existiert. |
Rückgabewert
string
Definiert in
combitCRM.SDK.WindowsClient.v11.ts:13371
SetGlobalProperty()
SetGlobalProperty(name, value): boolean
Setzt eine globale Script-Einstellung. Die Speicherung erfolgt in der Datei "global.ini" in der "cmbt_Files" Tabelle.
Parameter
| Parameter | Type | Description |
|---|---|---|
name | string | Der Name der Einstellung. |
value | string | Der (neue) Wert der Einstellung. |
Rückgabewert
boolean
Definiert in
combitCRM.SDK.WindowsClient.v11.ts:13382
SetUserProperty()
SetUserProperty(name, value): boolean
Setzt eine benutzerspezifische Script-Einstellung. Die Speicherung erfolgt in der Datei "<BENUTZER>\user_scriptvars.ini" in der "cmbt_Files" Tabelle.
Parameter
| Parameter | Type | Description |
|---|---|---|
name | string | Der Name der Einstellung. |
value | string | Der (neue) Wert der Einstellung. |
Rückgabewert
boolean
Definiert in
combitCRM.SDK.WindowsClient.v11.ts:13393
SetWaitDlgText()
SetWaitDlgText(text): void
Hiermit kann der Text in einem per StartWaitDlg gestarteten Wartedialog nachträglich geändert werden.
Parameter
| Parameter | Type | Description |
|---|---|---|
text | string | Der anzuzeigende Informationstext. |
Rückgabewert
void
Definiert in
combitCRM.SDK.WindowsClient.v11.ts:13403
Sleep()
Sleep(time): void
Hält die Ausführung des Scripts für eine anzugebende Zeit an.
Parameter
| Parameter | Type | Description |
|---|---|---|
time | number | Anzahl Millisekunden, die das Script angehalten werden soll. Sleep(1000) hält die Ausführung bspw. für 1 Sekunde an. |
Rückgabewert
void
Definiert in
combitCRM.SDK.WindowsClient.v11.ts:13413
StartWaitDlg()
StartWaitDlg(text, cancel)
StartWaitDlg(text, cancel): void
Zeigt einen Wartedialog mit einer Fortschrittsanimation sowie einem zu übergebenden Informationstext an.
Die Ausführung des Scripts wird während der Anzeige fortgeführt.Die Ausblendung erfolgt mit EndWaitDlg.
Über den zweiten Parameter kann bestimmt werden, ob der Dialog eine "Abbrechen"-Schaltfläche enthalten soll.
Wenn ja, dann kann mit CheckAbortedWaitDlg geprüft werden, ob die Schaltfläche betätigt wurde.
Reserviert: Über den dritten Parameter kann die Verzögerung bis zur Anzeige des Dialogs eingestellt werden.Standardmäßig wird eine Verzögerung von 3 Sekunden verwendet, um zu verhindern, dass schnell geöffnete und geschlossene Dialoge flackern.
Parameter
| Parameter | Type | Description |
|---|---|---|
text | string | Der anzuzeigende Informationstext. |
cancel | boolean | Anzeige einer Schaltfläche "Abbrechen. |
Rückgabewert
void
Definiert in
combitCRM.SDK.WindowsClient.v11.ts:13428
StartWaitDlg(text, cancel, initialDelay)
StartWaitDlg(
text,
cancel,
initialDelay): void
Zeigt einen Wartedialog mit einer Fortschrittsanimation sowie einem zu übergebenden Informationstext an.
Die Ausführung des Scripts wird während der Anzeige fortgeführt.Die Ausblendung erfolgt mit EndWaitDlg.
Über den zweiten Parameter kann bestimmt werden, ob der Dialog eine "Abbrechen"-Schaltfläche enthalten soll.
Wenn ja, dann kann mit CheckAbortedWaitDlg geprüft werden, ob die Schaltfläche betätigt wurde.
Reserviert: Über den dritten Parameter kann die Verzögerung bis zur Anzeige des Dialogs eingestellt werden.Standardmäßig wird eine Verzögerung von 3 Sekunden verwendet, um zu verhindern, dass schnell geöffnete und geschlossene Dialoge flackern.
Parameter
| Parameter | Type | Description |
|---|---|---|
text | string | Der anzuzeigende Informationstext. |
cancel | boolean | Anzeige einer Schaltfläche "Abbrechen. |
initialDelay | number | Reserviert, derzeit immer 0. (Optional. Verzögerung bis zur Anzeige des Dialogs in Sekunden. 0 = unmittelbare Anzeige. Der vorbelegte Wert beträgt 3 Sekunden.) |
Rückgabewert
void
Definiert in
combitCRM.SDK.WindowsClient.v11.ts:13441
WaitTitle()
WaitTitle(title, time): boolean
Methode wartet so lange, bis das Fenster mit dem übergebenen Titel gefunden wurde. Anschließend wird das gefundene Fenster aktiviert.
Parameter
| Parameter | Type | Description |
|---|---|---|
title | string | Der Titel (Name) des zu aktivierenden Fensters. Wenn Sie als erstes Zeichen ein "$" übergeben, muss der übergebene Titel lediglich enthalten sein, ansonsten genau übereinstimmen. |
time | number | Max. Wartezeit in Sekunden. -1 bedeutet unbegrenzte Wartezeit |
Rückgabewert
boolean
true Fenster wurde gefunden. false Kein Fenster gefunden.
Definiert in
combitCRM.SDK.WindowsClient.v11.ts:13464
[asyncDispose]()
asyncDispose: Promise<void>
Standardimplementierung des AsyncDispose Symbols
Rückgabewert
Promise<void>
Implementierung von
AsyncDisposable.[asyncDispose]
Definiert in
combitCRM.SDK.WindowsClient.v11.ts:13476
[dispose]()
dispose: void
Standardimplementierung des Dispose Symbols
Rückgabewert
void
Implementierung von
Disposable.[dispose]
Definiert in
combitCRM.SDK.WindowsClient.v11.ts:13487
[hasInstance]()
static hasInstance: boolean
Symbol.hasInstance welches eine benutzerdefinierte Überprüfung der 'instanceof'-Operation für Objekte ermöglicht.
Parameter
| Parameter | Type |
|---|---|
value | any |
Rückgabewert
boolean
Definiert in
combitCRM.SDK.WindowsClient.v11.ts:13495