F-Script - GetInfoScript

GetInfoScript - Basis-Informationen zu F-Script

Der Service GetInfoScript ermöglicht das Abfragen von Basis-Informationen zu einem F-Script. Dies sind Name, Kurzname und Info-Text des F-Script, unterstützte BoTypen und BoAttribute, die Information ob das F-Script Screen-Output unterstützt sowie Informationen zur Dateigrösse und zur letzten Änderung der Datei.

Argumente von GetInfoScript

	Argument	Beschreibung
1	Script	F-Script-Name oder Suchpattern. Sie können hier auch mit Wildcards (* ?) arbeiten.
2	Rückgabe-Objekt	Rückgabe-Objekt(e) mit Komma getrennt oder alle (mit *+) Beschreibung siehe Tabelle unten.
3	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 GetInfoScript

	Attribut	Beschreibung
1	Script	Name des F-Scripts.
2	SupportsScreenOutput	0/1 (Default: Leer) Gibt an, ob das F-Script eine Bildschirm-Ausgabe (z.B. in Form einer BO-Liste) unterstützt.
3	SupportsBoArgs	0/1 (Default: Leer) Gibt an, ob ein per BoTyp/BoId) übergebenes BO unterstützt wird oder nicht.
4	SupportedBoType	Unterstützter BoTyp z.B. Addr. (Default: Leer = keine Einschränkung) Dieses Attribut ist nur dann wirksam, wenn SupportsBoArgs = 1 (true) Ist hier ein BoTyp definiert, wird durch OpaccERP BackOffice das aktive BO dieses Typs zurückgegeben. Ist hier kein BoTyp definiert und ist das Attribut SupportsBoArgs = 1 (true), wird durch OpaccERP BackOffice das aktive Main-BO (gem. Kontext) zurückgegeben.
5	FileSize	Grösse der F-Script-Datei.
6	FileHash	FileHash der F-Script-Datei. (Kann beispielsweise verwendet werden, um Veränderungen am F-Script festzustellen.)
7	FileChangeTimestamp	Datum/Zeit der letzten Änderung an der F-Script-Datei.
8	Name	Text aus MLS-Text. (Default: F-Script-Name)
9	ShortName	Kurztext aus MLS-Text. (Default: F-Script-Name)
10	Info	Info-Text aus MLS-Text. (Default: F-Script-Name)

Ist im F-Script keine Subroutine /GetInfoScript vorhanden, liefert der Service die oben beschriebenen Defaultwerte zurück:

Integration F-Script

Wenn Sie die Subroutine /GetInfoScript implementieren, muss diese genau eine Zeile (Row) mit folgenden Attributen (Rückgabe-Objekten) zurückgeben:

XFAS-Head

Beschreibung

SupportsScreenOutput

Der Wert dieses Attributs ist sehr wichtig für die Ausführung eines F-Scripts.

0 (false) - Das F-Script unterstützt keine Bildschirmausgabe. Die Ausgabe erfolgt beispielsweise immer in eine PCL-Datei.

1 (true) - Das F-Script unterstützt die Bildschirmausgabe. Die Rückgabe der Attribute muss in diesem Fall über XFAS- bzw. AS-Befehle erfolgen.

Notiz

Im Falle einer Auswertung vom Typ F-Script wird dieses Attribut benötigt, um im BC 84300 die Registerkarte Übergeben zu aktivieren.

Im Falle eines OpaccExplorer-Eintrags (DeskItem) vom Typ F-Script stellt OpaccERP BackOffice die Rückgabe automatisch in Form einer BO-Tabelle dar.

SupportsBoArgs

0/1 (Default: Leer)

Gibt an, ob ein per BoTyp/BoId) übergebenes BO unterstützt wird oder nicht.

SupportedBoType

Unterstützter BO-Typ (z.B. «Addr»). Der Defaultwert dieses Attributs ist "leer".

Dieses Attribut ist nur dann wirksam, wenn SupportsBoArgs = 1 (true)

Ist hier ein BoTyp definiert, wird durch OpaccERP BackOffice das aktive BO dieses Typs zurückgegeben.

Ist hier kein BoTyp definiert und ist das Attribut SupportsBoArgs = 1 (true), wird durch OpaccERP BackOffice das aktive Main-BO (gem. Kontext) zurückgegeben.

MlsKey

Bezeichner/Name des F-Scripts.

Der MLS-Key wird gesucht und der zugehörige Text (falls gefunden und entsprechend eingepflegt) automatisch übersetzt.

Wird der MLS-Key nicht gefunden, wird 1:1 der Key zurückgegeben.

Notiz

Eigene MLS-Keys / Texte können Sie im BC 98230 erfassen/bearbeiten. Beachten Sie, dass benutzerspezifische MLS-Keys immer mit dem Prefix U. beginnen müssen.

Beispiel:

Anzeige dieses MLS-Key zur Laufzeit im BC 99009:

Beispiel:

/GetInfoScript
«XFAS(head=SupportsScreenOutput)»
«XFAS(head=SupportsBoArgs)»
«XFAS(head=SupportedBoType)»
«XFAS(head=MlsKey)»
# ---------------------------------------------------------------------------------
# SceenOutput unterstützt
«XFAS(cell=1)»
# BoArgs unterstützt
«XFAS(cell=1)»
# BOTyp geliefert werden soll
«XFAS(cell=Addr)»
# Gewünschter MLS-Key - wird dieser nicht gefunden wird der Text 1:1 zurückgegeben.
«XFAS(cell=U.ScriptReport.«CB(0)»)»
/

Notiz

Die Reihenfolge der Spalten ist nicht relevant.

Die XFAS-Head- und XFAS-Cell-Werte müssen jedoch korrespondieren.