Bedingung

Bedingungen werden für Primus Funktionen verwendet um z.B. bestimmte Menüeinträge nur unter bestimmten Bedingungen anzuzeigen oder zu aktivieren. Es gibt mehrere Möglichkeiten Bedingungen zu definieren.

Im Abschnitt Public können Bedingungen definiert werden um sie an anderer Stelle in der Konfiguration zu nutzen. Dadurch erhöht sich die Lesbarkeit der Konfiguration und es werden Fehler durch unterschiedliche Vergleiche vermieden.

Das Tag heißt Condition, der Name der Bedingung ist das einzige Attribut, der Wert besteht aus einem oder mehreren Vergleichen. Mehrere Vergleiche können durch AND oder OR verknüpft werden. Dabei müssen die einzelnen Vergleiche in ' eingeschlossen werden.

<!--Eine Bedingung die prüft ob es sich bei dem aktuellen Dokument um eine Solid Edge Datei handelt-->
<Condition isSEDocument="'#(FILE_TYPE)==PAR' OR '#(FILE_TYPE)==ASM' OR '#(FILE_TYPE)==PSM' OR '#(FILE_TYPE)==DFT'" />

Eine Bedingung kann auch direkt in dem Parameter der TRUE oder FALSE erfordert, eingegeben werden. Beispiel:

<!--Prüfung ob der FILE_TYPE = PAR ist-->
<SAMPLE visible="'#(FILE_TYPE)==PAR'" />

Es gibt auch Bedingungen die in Primus intern bereits vordefiniert sind. Die Bedingungen geben immer TRUE oder FALSE zurück. Optional gibt es Parameter mit denen die Bedingung näher spezifiziert werden kann. Hier eine Liste der bisher bekannten:

Die Bedingung wird aufgerufen mit 'CALL(<Bedingung>)'

Beispiel:

 <SAMPLE visible="'CALL(IsCtrlKey)'" />

$(Workflow.newversioncond)

Es gibt auch die Möglichkeit eine Funktion aufzurufen die als Rückgabewert TRUE oder FALSE zurück liefert. Können oder müssen mehrere Werte angeben werden so sind diese mit dem entsprechenden Trennzeichen zu trennen. Im Attribut parameter ist dies ein |.

Bedingungen können mittels AND und OR miteinander verknüpft werden. Dabei gilt die Regel AND vor OR, ähnlich wie Punkt- vor Strichrechnung in der Mathematik. Es ist aber auch möglich die Vergleiche in Klammern zu setzen, diese Klammern kommen in der Reihenfolge zuerst.

('%EXTENSION%==.par'OR'%EXTENSION%==.asm')AND'#(Title)==''

Es wird zuerst verglichen ob es eine .par oder .asm handelt, und ob der Title leer ist.

Bei Verschachtelten Verknüpfungen kann es evtl. notwendig sein mit Klammern zu arbeiten.

<ReservationCall condition="($(Condition.isSEDocument))AND'#(WorkflowStatus)!=003'"
<-- Definition der Bedingung -->
<Condition isSEDocument="'#(FILE_TYPE)==PAR' OR '#(FILE_TYPE)==ASM' OR '#(FILE_TYPE)==PSM' OR '#(FILE_TYPE)==DFT' OR '#(FILE_TYPE)==PWD'" />

Für die Verarbeitung werden von Primus intern die Bedingungen in ihre Strings aufgelöst, was dann so aussieht:

<ReservationCall condition="('#(FILE_TYPE)==PAR' OR '#(FILE_TYPE)==ASM' OR '#(FILE_TYPE)==PSM' OR '#(FILE_TYPE)==DFT' OR '#(FILE_TYPE)==PWD')AND'#(WorkflowStatus)!=003'"

Ohne die zusätzliche Klammer um die Bedingung $(Condition.isSEDocument) würde lediglich AND vor OR gelten, was letzlich dann auf

... OR'#(FILE_TYPE)==PWD'AND'#(WorkflowStatus)!=003'

Die UND Bedingung wäre also nur bei PWDs erfüllt worden, bei keinem anderen Dateityp.

Werden Bedingungen mittels Call abgefragt, dann ist die Verwendung von Klammern nicht möglich. In dem Fall muss „ausgeklammert“ werden:

'CALL(IsNodeTypeActive stdparts)'AND'$(Condition.isCADLic)' OR 'CALL(IsProjectActive)'AND'$(Condition.isCADLic)'

Es ist möglich in Attributen die Parameter einzelner Funktionen sind, Werte mithilfe von Bedingungen zu definieren. Dies ist z.B. bei der Definition von Dateinamen wichtig. Die Bedingungen hat folgenden allgemeinen Aufbau IF('<WERT><VERGLEICHSOPERATOR><VERGLEICHSWERT'?<TRUE FALL>:<FALSE FALL>)

Ein verschachteln der IF Bedingungen ist nicht zulässig!

<!-- Wenn das FileNamePrefix leer ist, dann nimm den Counter, sonst nichts.
Wenn die Revision nicht leer ist, dann nimm - mit Revision dahinter, sonst nichts. -->
<Kommando filename_format="#(FileNamePrefix)IF('#(FileNamePrefix)=='?#(FileNameSuffix)%COUNTER%:)IF('%REVISION%!='?-%REVISION%:)" />
<!-- Macht ein Feld im Datenblatt beschreibbar (W), wenn der Benutzer Admin ist, sonst nur lesbar (R) -->
<DataSheet_Feld mode_singlesel="IF('$(Condition.isAdmin)'?W:R)" />

Die Auswertung von IF erfolgt nicht in allen Parametern, die Liste ist Möglicherweise noch unvollständig.