Einleitung
DMAS-Servicekategorien
Die
DMAS-Services gliedern sich in die drei verschiedene Servicekategorien OP,
Admin und Main.
OP - Operatorfunktionalität
Bei diesen Services muss vor der
Service-Verarbeitung (Ausführung) der Kontext nicht auf eine gültige
Mandanten-Angabe geprüft werden.
Auch die Prüfung der Berechtigung
erfolgt nicht vor der Service-Verarbeitung über den Kontext. Die Prüfung
der Berechtigung erfolgt allenfalls gezielt in/während der
Service-Verarbeitung.
Admin - Adminfunktionalität
Für das Ausführen von Services der Kategorie
Admin, benötigt der Aufrufer grundsätzlich die Gruppen-Berechtigung
SysAdminRight.
Main - Hauptfunktionalität
Für das Ausführen von Services der Kategorie
Main, muss der Aufrufer lediglich als DMAS-Benutzer erfasst
sein.
Eine Ausnahmen bilden dabei die Services AddUser und
ModifyUser. Für das Ausführen dieser beiden Services muss der
Aufrufer über die Gruppen-Berechtigung SysAdminRight oder
UserAdminRight verfügen.
HISTORY_RELEVANT
Das
Ausführen von für die History relevanten Services, führt zu
(konfigurierbaren) Einträgen/Spuren im AccessLog.
Ob ein Service für
die History relevant ist, sehen Sie in der jeweiligen Service-Beschreibung
direkt hinter der Servicekategorie.
Beispiel
MINUS_USER
Die mit
FreeAccess for Minus-User markierten Services dürfen von von Minus-Usern
(Anmeldung mit User-No 0 und entsprechendem Passwort) ausgeführt
werden.
Ob ein Service mit FreeAccess for Minus-User markiert ist,
sehen Sie in der jeweiligen Service-Beschreibung direkt hinter der
Servicekategorie.
Beispiel
Arbeiten mit DMAS-Services
Aufbau eines Service
# Service: DMS.GetDocumentList definieren.
# Name des Service-Objekts im F-Script = reqDocList
«XSER(reqDocList:DMS.GetDocumentList)»
# Argumente als NamedValue-Array übergeben.
# Es soll das DMAS-Dokument mit der ID (DMAS Dokument-Nr.) 287 abgefragt werden.
«XSER(reqDocList:addArg=[{"Name":"DocumentId","Value":"287"}])»
# Service ausführen. Das Resultat wird im Result-Objekt resDocuments gespeichert.
«nXSER(reqDocList:execute>resDocuments)»
Die Services werden
gem. OpaccOXAS LiveDocumentation aufgebaut. Um Services welche man in ein
F-Script integrieren will einfach testen zu können, bietet es sich an die
OpaccOXAS LiveDocumentation parallel zum F-Script Editor offen zu
halten.
Beispiel
