Metainformationen zur Seite
Unterschiede
Hier werden die Unterschiede zwischen zwei Versionen angezeigt.
Beide Seiten der vorigen RevisionVorhergehende ÜberarbeitungNächste Überarbeitung | Vorhergehende ÜberarbeitungNächste ÜberarbeitungBeide Seiten der Revision | ||
speedy:30_modules:script [2020/10/06 13:33] – admin | speedy:30_modules:script [2022/01/19 10:45] – speedy | ||
---|---|---|---|
Zeile 1: | Zeile 1: | ||
====== Scripting ====== | ====== Scripting ====== | ||
- | Mit Hilfe des Scripting Moduls kann speedyPDM | + | Mit Hilfe des Scripting Moduls kann speedyPDM |
Um das Scripting Modul nutzen zu können muss die Programmbibliothek modScript7.dll im speedy/ | Um das Scripting Modul nutzen zu können muss die Programmbibliothek modScript7.dll im speedy/ | ||
Sie haben die Wahl die Ereignisbehandlungsroutinen entweder in VBScript oder JScript zu schreiben. | Sie haben die Wahl die Ereignisbehandlungsroutinen entweder in VBScript oder JScript zu schreiben. | ||
Zeile 15: | Zeile 15: | ||
|swxSpeedy.*| Wird bei Aktionen innerhalb von Solidworks aufgerufen | | |swxSpeedy.*| Wird bei Aktionen innerhalb von Solidworks aufgerufen | | ||
|aisSpeedy.*| Wird bei Aktionen innerhalb von Autodesk Inventor aufgerufen | | |aisSpeedy.*| Wird bei Aktionen innerhalb von Autodesk Inventor aufgerufen | | ||
- | \\ | + | |
==== Ereignisroutinen ==== | ==== Ereignisroutinen ==== | ||
Zeile 24: | Zeile 24: | ||
| timing | | timing | ||
| handling | | handling | ||
- | | dictionary | + | | dictionary |
\\ | \\ | ||
Zeile 39: | Zeile 39: | ||
</ | </ | ||
- | Der Parameter **handling** gibt eine Information wie das Ereignis | + | Der Parameter **handling** gibt eine Information wie das Ereignis |
< | < | ||
Zeile 66: | Zeile 66: | ||
|obj_description| | | |obj_description| | | ||
|obj_class| Klassenname des Objekts (z.B. CZvContainer für Ordner). | | |obj_class| Klassenname des Objekts (z.B. CZvContainer für Ordner). | | ||
- | \\ | + | <note warning> |
+ | Die beiden Eigenschaften session.database und vault.database liefern kein Ergebnis, wenn mit dem Datenbank-Direkttreiber „MYSQL“ gearbeitet wird. | ||
+ | </ | ||
===== Globale Funktionen ===== | ===== Globale Funktionen ===== | ||
Zeile 72: | Zeile 75: | ||
==== Application - Objekt ==== | ==== Application - Objekt ==== | ||
In den Scriptfunkktionen steht das globale Object **// | In den Scriptfunkktionen steht das globale Object **// | ||
- | + | \\ | |
- | === GetSessionDb === | + | === Application.GetSessionDb === |
Gibt das ADODB.Connection Objekt der Session Datenbank zurück. \\ | Gibt das ADODB.Connection Objekt der Session Datenbank zurück. \\ | ||
+ | <note warning> | ||
- | === GetRootPath === | + | === Application.GetRootPath === |
Gibt den Root Path, wie in der dwKernel.ini eingestellt, | Gibt den Root Path, wie in der dwKernel.ini eingestellt, | ||
- | + | \\ | |
- | === GetVaultCount === | + | === Application.GetVaultCount === |
Gibt die Anzahl der Vault datenbank zurück. \\ | Gibt die Anzahl der Vault datenbank zurück. \\ | ||
- | + | \\ | |
- | === GetVaultDbAt(iIndex) === | + | === Application.GetVaultDbAt(iIndex) === |
Gibt das ADODB.Connection Object der entsprechenden Vault Datenbank zurück. \\ | Gibt das ADODB.Connection Object der entsprechenden Vault Datenbank zurück. \\ | ||
- | + | \\ | |
- | === GetVaultNameAt(iIndex) === | + | === Application.GetVaultNameAt(iIndex) === |
Gibt den Namen der Vault Datenbank zurück. \\ | Gibt den Namen der Vault Datenbank zurück. \\ | ||
- | + | \\ | |
- | === GetTempFileName === | + | === Application.GetTempFileName === |
Gibt einen temporären Dateinamen im aktuellen Temp-Verzeichnis zurück. \\ | Gibt einen temporären Dateinamen im aktuellen Temp-Verzeichnis zurück. \\ | ||
- | + | \\ | |
- | === GetTempPath === | + | === Application.GetTempPath === |
Gibt das aktuelle Temp-Verzeichnis zurück. \\ | Gibt das aktuelle Temp-Verzeichnis zurück. \\ | ||
- | + | \\ | |
- | === GetAppPath === | + | === Application.GetAppPath === |
Gibt das Installationsverzeichnis der Anwendung zurück. \\ | Gibt das Installationsverzeichnis der Anwendung zurück. \\ | ||
- | + | \\ | |
- | === ProgressStart(lMin, | + | === Application.ProgressStart(lMin, |
Beginnt einen Dialog mit Fortschrittsanzeige. \\ | Beginnt einen Dialog mit Fortschrittsanzeige. \\ | ||
- | + | \\ | |
- | === ProgressStop === | + | === Application.ProgressStop === |
Stoppt die Fortschrittsanzeige. \\ | Stoppt die Fortschrittsanzeige. \\ | ||
- | + | \\ | |
- | === ProgressText(sText) === | + | === Application.ProgressText(sText) === |
Setzt den Text in der Fortschrittsanzeige. \\ | Setzt den Text in der Fortschrittsanzeige. \\ | ||
- | + | \\ | |
- | === ProgressStep === | + | === Application.ProgressStep === |
Führt einen Schritt in der Fortschrittsanzeige aus. \\ | Führt einen Schritt in der Fortschrittsanzeige aus. \\ | ||
- | + | \\ | |
- | === Log(lSeverity, | + | === Application.Log(lSeverity, |
Protokolliert einen Text in der aktuellen Log-Datei. \\ | Protokolliert einen Text in der aktuellen Log-Datei. \\ | ||
- | + | \\ | |
- | === InvokeCommand(sCallBack, | + | === Application.InvokeCommand(sCallBack, |
Ruft einen speedy Zusatzbefehl auf. \\ | Ruft einen speedy Zusatzbefehl auf. \\ | ||
- | + | \\ | |
- | === HasCommand(sCallBack) === | + | === Application.HasCommand(sCallBack) === |
Überprüft, | Überprüft, | ||
- | + | \\ | |
- | === ConsoleExecute(sCmd, | + | === Application.ConsoleExecute(sCmd, |
Führt ein Programm/ | Führt ein Programm/ | ||
^Parameter^Beschreibung^ | ^Parameter^Beschreibung^ | ||
Zeile 126: | Zeile 130: | ||
\\ | \\ | ||
- | === DlgLookup(ByRef Result, DataName, Connection, DataSource, InitialValue, | + | === Application.DlgLookup(ByRef Result, DataName, Connection, DataSource, InitialValue, |
Öffnet einen Lookup-Dialog zur Auswahl. \\ | Öffnet einen Lookup-Dialog zur Auswahl. \\ | ||
Die Funktion gibt True bei erfolgreicher Auswahl zurück und False bei Abbruch durch den User. \\ | Die Funktion gibt True bei erfolgreicher Auswahl zurück und False bei Abbruch durch den User. \\ | ||
Zeile 138: | Zeile 142: | ||
\\ | \\ | ||
- | === EditObject(sItemId) === | + | === Application.EditObject(sItemId) === |
Bearbeitet das durch ItemId definierte Element mit dessen nativem Eigenschaften-Dialog. \\ | Bearbeitet das durch ItemId definierte Element mit dessen nativem Eigenschaften-Dialog. \\ | ||
+ | \\ | ||
- | === EditProperties(sItemId, | + | === Application.EditProperties(sItemId, |
Bearbeitet das durch ItemId definierte Element in einem vereinfachten Eigenschaften-Dialog. \\ | Bearbeitet das durch ItemId definierte Element in einem vereinfachten Eigenschaften-Dialog. \\ | ||
^Parameter^Beschreibung^ | ^Parameter^Beschreibung^ | ||
- | |sItemId| Id des zu bearbeitenden Elements ({x-x-y-y-z-z}) | | + | |sItemId |
- | |Properties| Array mit Eigenschaftennamen, | + | |Properties |
- | |bShowInvisible| Sollen auch auch unsichtbar (Größe < 0) definierte Eiegnschaften im Dialog darstellen. | | + | |bShowInvisible |
- | |sTitle| Titelzeile der Dialogüberschrift. | | + | |sTitle |
- | |sDescription| Beschreibungszeile der Dialogüberschrift. | | + | |sDescription |
- | |sProfile| Profilname unter dem die Fenstergröße in der Registry gespeichert wird. | | + | |sProfile |
- | \\ | + | |
\\ | \\ | ||
+ | |||
+ | === Application.GetDocumentPath(DocNo) === | ||
+ | Gibt den Ablagepfad des Dokuments zurück.\\ | ||
+ | \\ | ||
+ | |||
+ | === Application.DbExecute(Connection, | ||
+ | Führt das SQL-Statement auf der benannten Datenbankverbindung aus. \\ | ||
+ | Wird keine Verbindung (Connection) angegeben, wird die Datenbank der Session verwendet. \\ | ||
+ | In Multi-Vault-Umgebungen kann der Name des Vault angegeben werden, um die Datenbank des Vault zu verwenden. \\ | ||
+ | Die Funktion gibt 0 zurück, wenn kein Fehler vorliegt. \\ | ||
+ | Die Funktion liefert kein Ergebnis aus dem SQL-Statement zurück. \\ | ||
+ | < | ||
+ | |||
+ | === Application.DbQuery(Connection, | ||
+ | Führt das SQL-Abfrage auf der benannten Datenbankverbindung aus. \\ | ||
+ | Wird keine Verbindung (Connection) angegeben, wird die Datenbank der Session verwendet. \\ | ||
+ | In Multi-Vault-Umgebungen kann der Name des Vault angegeben werden, um die Datenbank des Vault zu verwenden. \\ | ||
+ | Die Funktion liefert die Werte der in der Abfrage definierten Felder in einem Array zurück. | ||
+ | < | ||
+ | |||
+ | Ergebnis: | ||
+ | 0 0 " | ||
+ | 1 1 "In Arbeit" | ||
+ | 2 2 " | ||
+ | 3 3 "Beim Kunden" | ||
+ | 4 4 "Im Bau" | ||
+ | 5 5 " | ||
+ | </ | ||
+ | |||
+ | === Application.DbLookup(Connection, | ||
+ | Mit der DbLookup-Funktion können Sie den Wert eines bestimmten Feldes (Expression) aus einer bestimmten Datensatzgruppe (einer Domäne) abrufen.\\ | ||
+ | Mit der Angabe von Criteria definieren Sie ein Suchkriterium.\\ | ||
+ | In de Praxis werden die 3 Werte zu einem SQL-Statement zusammengesetzt und der erste gefundene Wert ist das Ergebnis der Suche: \\ | ||
+ | < | ||
+ | < | ||
+ | DbLookup("", | ||
+ | DbLookup("", | ||
+ | </ | ||
+ | |||
+ | === Application.Sleep(Milliseconds) === | ||
+ | Hält die Ausführung der Anwendung an, bis das Timeout-Intervall abgelaufen ist. | ||
+ | |||
==== Clipboard - Objekt ==== | ==== Clipboard - Objekt ==== | ||
Globales Objekt mit Funktionen zur Zwischenablage. | Globales Objekt mit Funktionen zur Zwischenablage. | ||
- | === Clear === | + | === Clipboard.Clear === |
Leert die Zwischenablage | Leert die Zwischenablage | ||
- | === Copy(Text) === | + | \\ |
+ | === Clipboard.Copy(Text) === | ||
Kopiert den Text in die Zwischenablage | Kopiert den Text in die Zwischenablage | ||
- | === Paste === | + | \\ |
+ | === Clipboard.Paste === | ||
Gibt den aktuellen Text in der Zwischenablage zurück. | Gibt den aktuellen Text in der Zwischenablage zurück. | ||
<code VBScript> | <code VBScript> | ||
+ | \\ | ||
\\ | \\ | ||
\\ | \\ | ||
Zeile 251: | Zeile 299: | ||
=== Document_onBeforeImport(timing, | === Document_onBeforeImport(timing, | ||
^ Eigenschaft ^ Beschreibung ^ | ^ Eigenschaft ^ Beschreibung ^ | ||
- | |filename|Übergibt den Datei-Namen| | + | |timing | Immer kBefore | |
+ | |filename| Übergibt den Datei-Namen| | ||
=== Document_onCreate(timing, | === Document_onCreate(timing, | ||
Zeile 375: | Zeile 424: | ||
|source| Eigenschaften des Quell Dokuments. | | |source| Eigenschaften des Quell Dokuments. | | ||
|target| Eigenschaften des Ziel Dokuments. | | |target| Eigenschaften des Ziel Dokuments. | | ||
- | |dictionary| | + | |dictionary| |
==== Container-Ereignisse ==== | ==== Container-Ereignisse ==== | ||
Zeile 595: | Zeile 644: | ||
|kBefore|Zeitpunkt wann die Aktion ausgeführt werden soll(Hier unrelevant)| | |kBefore|Zeitpunkt wann die Aktion ausgeführt werden soll(Hier unrelevant)| | ||
|dictionary|Übergibt das Dictionary Objekt| | |dictionary|Übergibt das Dictionary Objekt| | ||
- | Rückgabe true oder 1: Das Dictionary enthält Eigenschaften, | + | **Rückgabe:** true oder 1 := Das Dictionary enthält Eigenschaften, |
\\ \\ | \\ \\ | ||
Zeile 603: | Zeile 652: | ||
|kBefore|Zeitpunkt wann die Aktion ausgeführt werden soll(Hier unrelevant)| | |kBefore|Zeitpunkt wann die Aktion ausgeführt werden soll(Hier unrelevant)| | ||
|dictionary|Übergibt das Dictionary Objekt| | |dictionary|Übergibt das Dictionary Objekt| | ||
+ | **Rückgabe: | ||
+ | |||
Sobald OnValidate aufgerufen wurde, wird der OnBrowse nicht mehr aufgerufen. | Sobald OnValidate aufgerufen wurde, wird der OnBrowse nicht mehr aufgerufen. | ||
- | Rückgabe 1: Das Dictionary enthält Eigenschaften, | ||
\\ \\ | \\ \\ | ||
Zeile 613: | Zeile 663: | ||
|val | Dazugehöriger Wert zur Eigenschaft. | | |val | Dazugehöriger Wert zur Eigenschaft. | | ||
|dictionary | Übergibt das Dictionary Objekt | | |dictionary | Übergibt das Dictionary Objekt | | ||
- | Rückgabe 1: Das Dictionary enthält Eigenschaften, | + | **Rückgabe:** 1 := |
\\ \\ \\ | \\ \\ \\ | ||
Zeile 627: | Zeile 677: | ||
|kBefore|Zeitpunkt wann die Aktion ausgeführt werden soll(Hier unrelevant)| | |kBefore|Zeitpunkt wann die Aktion ausgeführt werden soll(Hier unrelevant)| | ||
|dictionary|Übergibt das Dictionary Objekt| | |dictionary|Übergibt das Dictionary Objekt| | ||
- | Rückgabe true oder 1: Das Dictionary enthält Eigenschaften, | + | **Rückgabe:** true oder 1 := Das Dictionary enthält Eigenschaften, |
\\ \\ | \\ \\ | ||
Zeile 635: | Zeile 685: | ||
|kBefore|Zeitpunkt wann die Aktion ausgeführt werden soll(Hier unrelevant)| | |kBefore|Zeitpunkt wann die Aktion ausgeführt werden soll(Hier unrelevant)| | ||
|dictionary|Übergibt das Dictionary Objekt| | |dictionary|Übergibt das Dictionary Objekt| | ||
+ | **Rückgabe: | ||
+ | |||
Sobald ein OnValidate aufgerufen wurde, wird der OnBrowse nicht mehr aufgerufen. | Sobald ein OnValidate aufgerufen wurde, wird der OnBrowse nicht mehr aufgerufen. | ||
- | Rückgabe 1: Das Dictionary enthält Eigenschaften, | ||
\\ \\ \\ | \\ \\ \\ | ||
Zeile 753: | Zeile 804: | ||
|lEventTiming|Zeitpunkt wann die aktion Ausgeführt werden soll| | |lEventTiming|Zeitpunkt wann die aktion Ausgeführt werden soll| | ||
|dictionary|Übergibt das Dictionary Objekt| | |dictionary|Übergibt das Dictionary Objekt| | ||
+ | \\ | ||
+ | |||
+ | === OnFileOpen(lEventTiming, | ||
+ | Ereignis-Routine die beim öffnen einer Datei ausgeführt wird. | ||
+ | ^ Eigenschaft ^ Beschreibung ^ | ||
+ | |lEventTiming|Zeitpunkt wann die aktion Ausgeführt werden soll| | ||
+ | |dictionary|Übergibt das Dictionary Objekt| | ||
+ | |||
\\ \\ \\ | \\ \\ \\ | ||