Teil II. Werte in Geschäftsprozessen
Wie versprochen, machen wir mit den Geschäftsprozessen in Bitrix24 weiter. Heute erfahren Sie über die Werte, die man in den Vorlagen der Geschäftsprozesse hinzufügen kann.
Bei der Erstellung eines Geschäftsprozesses können Sie in den Einstellungen von Aktionen, Vorlagenparametern und Status die Texte (also die eigentlichen Werte) sowohl manuell eingeben, als auch automatisch aus Variablen, Konstanten, Dokumentenfeldern und anderen Daten auswählen.
Die Variablen, Konstanten und andere Parameter können Sie im Bereich Vorlagenparameter vorab hinzufügen, um sie später zur Auswahl zu bekommen.
Folgende Werte sind in dem Formular zwar nicht standardmäßig verfügbar, aber Sie können sie bei der Erstellung der Vorlagen manuell eingeben:
· {=Workflow:ID} – ID des Geschäftsprozesses
· {=User:ID} – ID des aktuellen Nutzers: User_ [Nutzernummer_im_Account ]
· {=Template:TargetUser} – Parameter, in dem sich die ID des Nutzers befindet, der den Geschäftsprozess gestartet hat: User_ [Nutzernummer_im_Account ]
· {=System:Now} – das aktuelle Datum und die aktuelle Uhrzeit auf dem Server
· {=System:NowLocal} – das aktuelle Datum und die aktuelle Uhrzeit des Kunden (hier wird die Zeitzone berücksichtigt)
· {=System:Date} – das aktuelle Datum ohne Uhrzeit
· {=Document:DETAIL_PAGE_URL} – ermöglicht es, den Link zur detaillierten Ansicht der Datei zu bekommen, vorausgesetzt, dass in den Einstellungen der URL der Seite zur detaillierten Ansicht korrekt ausgefüllt ist
Modifikator „_printable“
Für die Parameter und die Variablen einer Vorlage können Sie den Modifikator „_printable“ nutzen, der die Werte umwandelt, damit es für die Nutzer verständlich ist.
Ein Beispiel bei der Nutzung vom Modifikator bei der Variablen „Typ Nutzer“:
{=Variable:user}
{=Variable:user_printable}
Das Ergebnis bei dem Wert von Variablen Autor:
author
Autor
Das Ergebnis bei dem Wert von Variablen [1]:
user_1
Müller Hans [1]
Berechnung der Werte
Sie haben im System die Möglichkeit, die Werte der Parameter zu berechnen, indem Sie das Zeichen = nutzen.
Beispiel: =6^2 + {=Document:PROPERTY_NUM}/2 oder =if({Document:ID}=5, „Text1“, „Text2“).
In einem Feld kann nur ein Ausdruck genutzt werden, wenn Sie aber weitere nutzen möchten, müssen Sie den Verkettungsoperator (&) angeben und den Text in Anführungszeichen schreiben („).
Beispiel: =“Antwort:“ & (1+3) oder =“Autor: “ & {=Document:CREATED_BY} & „, “ & „Frist: “ & Dateadd({=Document:DATE_CREATE}, „1d“)
Weitere Verkettungsoperatoren, die Ihnen zur Verfügung stehen:
- + – addieren;
- – – subtrahieren;
- * – multiplizieren;
- / – teilen;
- = – gleich;
- <> – nicht gleich;
- < – weniger;
- > – mehr;
- <= – weniger oder gleich;
- >= – mehr oder gleich;
- () – Reihenfolge der Aktion;
- ^ – Potenzierung;
- % – Berechnung der Prozente
- true – wahr;
- false – falsch;
- and – und;
- or – oder, Beispiel: =if(or({=Variable:aaa}>2, {=Variable:bbb}<10), „yes“, „no“)
- not – Verneinung;
- min – der kleinste Wert;
- abs – gibt den absoluten Wert eines Arguments an;
- dateadd – fügt angegebene Anzahl von Tagen, Monaten, Jahren, Stunden, Minuten und Sekunden zu dem angegebenen Datum hinzu;Syntax: =dateadd([Anfangsdatum], [angegebene_Anzahl]);
Folgende Schreibweisen sind möglich:
y, year, years, m, month, months, d, day, days, h, hour, hours, i, min, minute, minutes, s, second, seconds.
Hier können Sie Groß-und Kleinschreibung verwenden.
Beispiel: =Dateadd({=Document:DATE_CREATE}, „-2d“), =Dateadd({=Document:DATE_CREATE}, „2 days 3 minutes“)
- datediff – hilft die Differenz zwischen zwei Datumangaben zu berechnen
Syntax: =datediff([erstes Datum], [zweites Datum], [wie wird die Differenz berechnet]);
Die Differenz kann man in verschiedenen Formaten angeben.
Beispiel: =datediff({=Variable:Variable1}, {=Variable:Variable2},’%m month, %d days‘)
- if – Bedingung
Syntax: =if([Bedingung], [das_Ergebniss_wenn_die_Bedingung_erfüllt_wird], [das_Ergebniss_wenn_die_Bedingung_nicht_erfüllt_wird]);
Beispiel: =if ({=Variable:Variable1_printable}>0, „ja“, „nein“)
- intval – gibt den Variablen den ganzen Wert zurück;
Beispiel: =intval(„234j4hv5jhv43v53jk4vt5hj4“) gibt 234 zurück
- substr – gibt den Teilstring zurück.
Wichtig! Wenn die Syntax nicht korrekt ist, wird nichts berechnet und es wird lediglich alles in Form vom Text angezeigt.
Beispiele der Verwendung von Makros
Verwendung von Variablen in den Links
In den Aktionen, wo der Tag [url] unterstützt wird, kann man eigene Variablen zur Erstellung eines Links nutzen:
[url]http://{=Variable:Domain}/{=Variable:Path}[/url]
wo {=Variable:Domain} und {=Variable:Path} die Variablen sind, die die Website und den Pfad beinhalten.
Erstellung eines direkten Links zu der Seite mit der Aufgabe
Beispiel: die Nachricht mit dem Link wird einem der Nutzer zugeschickt, in dem er aufgefordert wird, die Aufgabe innerhalb dieses Geschäftsprozesses auszuführen.
[url]http://[ intranet_domain]/company/personal/bizproc/{=Workflow:ID}/[/url]
Erstellung eines direkten Links zu der Seite mit der detaillierten Ansicht der Datei
Beispiel: der Link öffnet die detaillierte Ansicht der Datei für den Nutzer.
[url]{=Document:DETAIL_PAGE_URL}[/url]
