F-Script

F-Script - GetInfoScriptCol

GetInfoScriptCol

Der Service GetInfoScriptCol ermöglicht das Abfragen der Attribute (Rückgabe-Objekte / Spalten) aus der Subroutine /GetInfoScriptCol eines F-Scripts.
Bei alten F-Scripts können Sie die Argumente der Subroutine /ApplicationServerAttributes abfragen.
Achtung
Achtung
Beachten Sie, dass die Verwendung von /ApplicationServerAttributes nicht mehr empfohlen wird. Wir empfehlen, bestehende F-Script nach Möglichkeit auf die neue Funktionalität umzuschreiben.
Die Rückgabe der Attribute aus /GetInfoScriptCol muss mittels XFAS erfolgen. Die Struktur der Rückgabe (-Spalten) muss dabei strikt eingehalten werden.
Argumente von GetInfoScriptCol
Wichtig
Wichtig
Die Schreibweise ist case-sensitive!
  Argument Beschreibung
1
Script
F-Script-Name
2
Column
Column (Spalte) welche abgefragt werden soll. (Siehe Rückgabe-Objekte: 1 - Column)
Per Default werden alle Columns zurückgegeben.
3
Rückgabe-Objekt
Rückgabe-Objekt(e) mit Komma getrennt oder alle (mit *+)
Beschreibung siehe Tabelle unten.
4
Sprache
Nummer der Beschriftungssprache (z.B. 54 für Englisch).
Steuert die Sprache in welcher die Rückgabe-Objekte Name, ShortName und Info zurückgegeben werden.
Attribute (Rückgabe-Objekte) von GetInfoScriptCol
Wichtig
Wichtig
Die Schreibweise ist case-sensitive!
  Attribut Beschreibung
1
Column
Name bzw. eindeutiger Bezeichner der Column.
Wichtig
Wichtig
Dieses Attribut ist zwingend!
2
DataTypeCd
Datentyp der Column. (A, X, R, N, etc.)
Wichtig
Wichtig
Dieses Attribut ist zwingend!
3
Format
Format der Column in Abhängigkeit des Datentyps. (z.B. A30)
Wichtig
Wichtig
Dieses Attribut ist zwingend!
4
RelationshipCd
Beziehung zu Business-Objekt, Code-Tabelle, etc.
  • 0 - Keine Beziehung
  • 1 - BO-Beziehung
  • 3 - Code-Beziehung (Code-Tabelle)
  • 5 - Bereichs-Beziehung (Range)
  • 7 - ApsKeyword-Beziehung
  • R - Result-Objekt-Beziehung
  • F - Filter-Beziehung
  • S - Beziehung zu Attribut/Wert Paar
  • V - VirtualAttribut-Beziehung
  • I - Installations-Datei-Beziehung
    Mittels RelationshipCd = I können Sie Referenzen auf Dateien innerhalb unserer Installations-Verzeichnisse zurückgeben. Sie müssen dafür als RelatedObject eines unserer Installations-Verzeichnisse angeben. Siehe RelatedObject.
  • 1S - Mehrere Einträge einer freien Hilfstabelle (BO: FreeTableItem)
    Sie müssen dafür als RelatedObject das BO-Attribut FreeTableItem.Value angeben.
5
RelatedObject
Referenziertes Objekt.
Beispiel: Addr.Number wenn RelationshipCd=1 - Referenziert damit auf das BO: Addr
Sie können Referenzen auf Dateien innerhalb unserer Installations-Verzeichnisse zurückgeben. Sie müssen dafür den RelationshipCd auf I setzen. Siehe RelationShipCd. Als RelatedObject können Sie dann eines unserer Installations-Verzeichnisse angeben. Dabei können Sie die Nummer (CodeValue) oder den Namen (CodeId) verwenden.
CodeValue
CodeId
11
TX
12
IP
13
TMP
21
OFFICE
22
REPORTS_TEMPLATES
23
FONTS
31
BOF_SCRIPTS
32
F_SCRIPTS
33
PRINTER_DEF
Notiz
Notiz
Wird ein DeskItem erstellt und diesem DeskItem ein F-Script mit XFAS-Resultat und entsprechender Codierung in /GetInfoScriptCol hinterlegt, lädt OpaccERP die Files zur Laufzeit aus den entsprechenden Verzeichnissen.
Enthält das XFAS-Resultat nur eine Zeile und nur eine Spalte, wird die Datei direkt angezeigt. Enthält das XFAS-Resultat mehrere Zeilen/Spalten, dann wird das Resultat wie gewohnt in einer Liste angezeigt. Über den Button Datei anzeigen können Sie sich dann die jeweilige Datei anzeigen lassen.
Die Dateien werden ins Windows Temp-Verzeichnis des Benutzers heruntergeladen. Bei Bedarf kann der Benutzer die Dateien an einem anderen Ort speichern (sofern das die gestartete Applikation zulässt). Das Temp-Verzeichnis wird von OpaccERP anschliessend geleert.
Wird ein F-Script im Kontext einer Auswertung (Word/Excel) gestartet, werden diese Dateien in das Windows Temp-Verzeichnis des Benutzers heruntergeladen Bei der Übergabe an Word/Excel werden die relativen Pfad-Angaben durch absolute Pfade (zur lokalen Datei) umgewandelt. Sie können dann in einem Makro auf diese Dateien zugreifen. Nach der Ausführung des Makros werden die lokalen Dateien wieder gelöscht.
6
RelatedIndex
Für die Referenz verwendeter Index.
Beispiel: 1 wenn das BO Addr nach Adress-Nr. referenziert werden soll.
7
RelatedContraint
Verknüpfungsbegrenzung
(Empfohlener Default: Leer lassen)
8
OnDemand
Rückgabe der Column onDemand (auf Verlangen). So deklarierte Columns werden nur zurückgegeben, wenn dies explizit verlangt wird.
Das Attribut ist für zukünftige Funktionalität vorgesehen und kann im aktuellen Kontext (F-Script) nicht genutzt werden.
9
Name
Text aus MLS-Text.
10
ShortName
Kurztext aus MLS-Text.
11
Info
Info-Text aus MLS-Text.
Beispiel:
/GetInfoScriptCol
«XFAS(heads=Column,DataTypeCd,Format,RelationshipCd,RelatedObject,RelatedIndex,RelatedConstraint)»
«XFAS(heads=OnDemand,MlsKey)»
# Werte für 1. Spalte
«XFAS(cells=MyCol1,A,100,0,,,,0,Addr.Number)»
# Werte für 2. Spalte
«XFAS(cells=MyCol2,A,100,0,,,,0,Addr.FirstName)»
# Werte für 3. Spalte
«XFAS(cells=MyCol3,A,100,0,,,,0,Addr.LastName)»
# Werte für 4. Spalte
«XFAS(cells=MyCol4,A,100,0,,,,0,Empl.Department)»
/
Wenn Sie nun aufgrund der obigen Deklaration den DataTypeCd und das Format von MyCol2 abfragen wollen, führen Sie den Service folgendermassen aus: (Beispiel aus der OpaccOXAS LiveDocumentation)
LiveDoc_02.jpg