System-Skriptsprache: Allgemeine Funktionen, System- und Konfigurationsfunktionen (System and Configuration functions)

Die System- und Konfigurationsfunktionen geben den Zustand des Systems sowie Eigenschaften der Konfigurationsdatenbank zurück. Zu den System- und Konfigurationsfunktionen gehören:

Grundlegende Informationen zu den allgemeinen Funktionen der System-Skriptsprache erhalten Sie im Dokument System-Skriptsprache: Allgemeine Funktionen.

databaseName

Name databaseName
Beschreibung databaseName gibt den Namen einer Datenbank zurück.
Signaturen String databaseName(Guid database)
Parameter database ist die Guid der Datenbank.
Ergebnis Der Name der Datenbank in lesbarer Form als eine Zeichenkette.
Fehlerquellen Keine.
Beispiele databaseName(event.database) gibt den Namen der Datenbank zurück, in der das Ereignis ausgelöst wurde.
Kontext ALL
Hinweise Die Datenbank-Guid wird z. B. im Ereignisparameter event.database für Ereignisse der Typen Business Entity und Programmiertes Ereignis übergeben.
Siehe auch

Folgendes Beispiel aus der Aktivitätsdefinition help.databaseName gibt den Namen einer Datenbank zurück:

function create()
{
  var p_guid := parameters.GUID;
  var r_databaseName := "";

  var databaseGuid := cast(Guid, p_guid);
  if (not isNull(databaseGuid))
    r_databaseName := databaseName(databaseGuid);
  result.DATABASE_NAME := r_databaseName;
}

 

Beispiel: Name der Datenbank in JavaScript abfragen

Folgendes Beispiel aus der in JavaScript erfassten Aktivitätsdefinition help.js.getDatabaseGuid ermittelt die Guid der Datenbank und gibt deren Namen zurück:

function create()
{
  var cisEnvironment = Java.type(„com.cisag.pgm.appserver.CisEnvironment“).getInstance();
  result.NAME = functions.databaseName(cisEnvironment.getDatabaseGuid());
}

 

memoryLevel

Name memoryLevel
Beschreibung memoryLevel gibt die aktuelle Speicherwarnstufe des Application Servers zurück.
Signaturen Number memoryLevel()

Number memoryLevel(Guid svmGuid)

Parameter svmGuid ist die Guid eines Application Servers.
Ergebnis Die aktuelle Speicherwarnstufe als eine Ganzzahl. Die möglichen Speicherwarnstufen sind im ValueSet com.cisag.sys.kernel.MemoryLevel definiert:

  1. In Ordnung
  2. Warnung
  3. Niedrig
  4. Kritisch
Fehlerquellen Keine
Beispiele valueSetDescription("com.cisag.sys.kernel.MemoryLevel", memoryLevel()) gibt die Speicherwarnstufe des aktuellen Application Servers zurück.
Kontext ALL
Hinweise Die Speicherwarnstufe wird auch in der Anwendung Systemcockpit angezeigt.
Siehe auch

Folgendes Beispiel aus der Aktivitätsdefinition help.memoryLevel gibt die Speicherwarnstufe des Application Servers zurück.

function create()
{
  var p_svmGuid := parameters.SVM_GUID;
  var r_memoryLevel := "";

  if (p_svmGuid = "")
    r_memoryLevel := valueSetDescription("com.cisag.sys.kernel.MemoryLevel", memoryLevel());
  else
    r_memoryLevel := valueSetDescription("com.cisag.sys.kernel.MemoryLevel", memoryLevel(cast(Guid, p_svmGuid)));

  result.MEMORY_LEVEL := r_memoryLevel;
}

 

objectName

Name objectName
Beschreibung objectName gibt den vollständigen technischen Namen eines Entwicklungsobjekts zurück.
Signaturen String objectName(Guid objectGuid)
Parameter objectGuid ist die Guid eines Entwicklungsobjekts.
Ergebnis Der vollständige technische Name eines Entwicklungsobjekts incl. dessen Namenspfad als eine Zeichenkette.
Fehlerquellen Keine
Beispiele objectName(event.Guid) gibt den vollständigen technischen Namen eines programmierten Ereignisses oder eines Business Entitys zurück.

substring(objectName(event.guid), lastIndexOf(objectName(event.guid), ".") + 1) gibt den technischen Namen eines programmierten Ereignisses oder eines Business Entitys ohne dessen Namensraum zurück.

Kontext ALL
Hinweise In der Repository-Datenbank sind beschreibende Daten für alle Entwicklungsobjekte hinterlegt.
Siehe auch

Folgendes Beispiel aus der Aktivitätsdefinition help.objectName gibt den vollständigen technischen Namen eines Entwicklungsobjekts zurück:

function create()
{
  var p_guid := parameters.GUID;
  var r_objectName := "";

  var objectGuid := cast(Guid, p_guid);
  if (not isNull(objectGuid))
    r_objectName := objectName(objectGuid);
  result.OBJECT_NAME := r_objectName;
}

 

serverLinkTarget

Name serverLinkTarget
Beschreibung Gibt den Namen des Ziel-Servers für Link-Attribute zurück.
Signaturen serverLinkTarget()

serverLinkTarget(Guid user)

Parameter user ist die Guid des Benutzers, für den der Ziel-Server bestimmt werden soll. Der Ziel-Server kann vom Benutzer abhängig sein.
Ergebnis Die Funktion gibt den Namen des Ziel-Servers für Link-Attribute (Verknüpfungen) als eine Zeichenkette zurück. Der Ziel-Server ist abhängig von dem Application-Server, auf dem die Funktion ausgeführt wird.
Fehlerquellen Keine.
Beispiele serverLinkTarget() gibt den Namen des Application-Servers zurück, auf dem die Funktion ausgeführt wird.

serverLinkTarget(parameters.userGuid) gibt für eine Aktivitätsdefinition mit einer Ereignisdefinition des Typs Business Entity oder Benutzeraktion den Namen des Application-Servers zurück, der für Link-Attribute für denjenigen Benutzer verwendet wird, der das Ereignis ausgelöst hat.

Kontext ALL
Hinweise In Systemen mit nur einem Application-Server ist keine weitere Konfiguration notwendig. Der Ziel-Server ist der Application-Server, auf dem die Workflow-Engine läuft.

Wenn ein System mehrere Application-Server umfasst, tragen Sie in der Anwendung Systemcockpit bei allen Application-Servern im Feld Ziel-Server für Link-Attribute einen Dialog-Application-Server ein. Dieser Server wird für alle Verknüpfungen in Workflow-E-Mails verwendet, die vom Message-Server versendet werden.

Wenn der Ziel-Server abhängig vom Benutzer ist, dann können Sie auch in der Anwendung Workflowrollen Workflowrollen-spezifische Ziel-Server zuordnen.

Siehe auch

Folgendes Beispiel aus der Aktivitätsdefinition help.serverLinkTarget gibt den Namen des Ziel-Servers für Link-Attribute zurück. Optional kann eine Benutzer-Guid als Parameter angegeben werden.

function create()
{
  var p_user := parameters.USER;
  var r_serverLinkTarget := "";

  var u := userGuid(p_user);
  if (not isNull(u))
    r_serverLinkTarget := serverLinkTarget(u);
  else
    r_serverLinkTarget := serverLinkTarget();

  result.SERVER_LINK_TARGET := r_serverLinkTarget;
}

 

serverName

Name serverName
Beschreibung serverName gibt den Namen eines Application-Servers zurück.
Signaturen String serverName(Guid server)
Parameter server ist die Guid des Servers.
Ergebnis Der Name des Servers in lesbarer Form als eine Zeichenkette.
Fehlerquellen Keine.
Beispiele serverName(cast(Guid, "01200477BA652A10B51EAD1BAA7C0000") gibt ADV600 zurück.
Kontext ALL
Hinweise Die Guid des Servers wird in der Anwendung Systemcockpit angezeigt.

Sie können auch die Funktion serverLinkTarget verwenden, um den Namen des Application-Servers, auf dem die Workflow-Engine läuft, zu ermitteln.

Siehe auch  

Folgendes Beispiel aus der Aktivitätsdefinition help.serverName gibt den Namen des Application-Servers zurück:

function create()
{
var p_guid := parameters.GUID;
var r_serverName := "";

var serverGuid := cast(Guid, p_guid);
if (not isNull(serverGuid))
r_serverName := serverName(serverGuid);

result.SERVER_NAME := r_serverName;
}

 

Beispiel: Name des Servers in JavaScript abfragen

Folgendes Beispiel aus der in JavaScript erfassten Aktivitätsdefinition help.js.getServerName ermittelt den Namen des Application Servers:

function create()
{
var serverInfo = Java.type(„com.cisag.pgm.util.ServerInfo“);
result.NAME = serverInfo.getSVMName();
}

 

systemName

Name systemName
Beschreibung systemName gibt den Namen eines Systems zurück.
Signaturen String systemName(Guid system)
Parameter system ist die Guid des Systems.
Ergebnis Der Name des Systems in lesbarer Form als eine Zeichenkette.
Fehlerquellen Keine.
Beispiele systemName(cast(Guid, "4200C7558F652A1096A3AD1BA8550000")) gibt ADV600 zurück.
Kontext ALL
Hinweise Die Guid des Systems wird in der Anwendung Systemcockpit angezeigt.
Siehe auch

Folgendes Beispiel aus der Aktivitätsdefinition help.systemName gibt den Namen eines Systems zurück:

function create()
{
var p_guid := parameters.GUID;
var r_systemName := "";

var systemGuid := cast(Guid, p_guid);
if (not isNull(systemGuid))
r_systemName := systemName(systemGuid);

result.SYSTEM_NAME := r_systemName;
}

 

Beispiel: Name des Systems in JavaScript abfragen

Folgendes Beispiel aus der in JavaScript erfassten Aktivitätsdefinition help.js.getSystemName ermittelt den Namen des aktuellen Systems:

function create()
{
var serverInfo = Java.type(„com.cisag.pgm.util.ServerInfo“);
result.NAME = serverInfo.getSystemName();
}

 

Beispiel: Entwicklungspräfix in JavaScript abfragen

Folgendes Beispiel aus der in JavaScript erfassten Aktivitätsdefinition help.js.getSystemDevelopmentPrefix ermittelt das Entwicklungspräfix des aktuellen Systems:

function create()
{
var serverInfo = Java.type(„com.cisag.pgm.util.ServerInfo“);
result.PREFIX = serverInfo.getSystemDevelopmentPrefix();
}

 

versionString

Name versionString
Beschreibung versionString gibt die Version eines Entwicklungsobjekts zurück.
Signaturen String versionString(Guid versionGuid)
Parameter „versionGuid“ ist die Versions-Guid eines Entwicklungsobjekts.
Ergebnis Die Version des Entwicklungsobjekts in lesbarer Form als eine Zeichenkette.
Fehlerquellen Keine
Beispiele versionString(versionGuid) gibt die Version des Entwicklungsobjekts mit der Versions-Guid versionGuid zurück.
Kontext ALL
Hinweise In der Repository-Datenbank sind beschreibende Daten für alle Entwicklungsobjekte hinterlegt.
Siehe auch

Folgendes Beispiel aus der Aktivitätsdefinition help.versionString gibt die Version eines Entwicklungsobjekts zurück:

function create()
{
var p_guid := parameters.GUID;
var r_versionString := "";

var versionGuid := cast(Guid, p_guid);
if (not isNull(versionGuid))
r_versionString := versionString(versionGuid);

result.VERSION_STRING := r_versionString;
}

Czy ten artykuł był pomocny?