Dieser Abschnitt enthält Anleitungen zu den Operatortypen, die zum Auswerten logischer Ausdrücke in Dayforce verwendet werden.
Logische Ausdrücke werden von Bedingungsknoten in Workflow-Administration > Workflow-Designer ausgewertet, die sich auf diese Operatoren verlassen, um die Beziehung zwischen Datenbankfeldern und ihren Werten auszuwerten, um zu bestimmen, ob die Bedingung wahr oder falsch ist.
Operatortypen und -werte
| Operatortyp | Werte |
|---|---|
| Logisch | AND, OR, NOT |
| Vergleich | Equals, LessThan, GreaterThan, LessThanEquals, GreaterThanEquals |
| Arithmetik | +, -, *, / |
| Funktional | today(), coalesce(), maxdate(), maxvalue(), current(), HasAuthorityType(), HasRole(), employeerate(), paygraderate(), minimumwage(), getpaytypegroup(), max(name), min(name), IdFromXref() |
In der folgenden Tabelle werden die benannten Funktionen beschrieben, die in Bedingungsknoten verwendet werden können.
Hinweis: Der Parameter sessionId stellt die ID der bestehenden Sitzung dar. Der Typ ist eine Zeichenfolge, die mithilfe des reservierten Worts sessionId abgerufen wird. Dies wird in einigen der folgenden Beispiele veranschaulicht.
| Funktion | Übersicht |
|---|---|
| Heute | Gibt das aktuelle (zum Zeitpunkt des Aufrufs) Datum und die Uhrzeit auf dem Server zurück. Dies kann sich vom aktuellen Datum und der aktuellen Uhrzeit auf der Benutzerinstanz unterscheiden. |
| Coalesce | Überprüft, ob die als Parameter bereitgestellte Sammlung alle Nicht-Null-Elemente enthält und gibt diese Sammlung oder null zurück. Es werden beliebig viele Parameter akzeptiert. Zeichenfolgen, die als Sammlungen von Zeichen behandelt werden. |
| Anzahl | |
| ConvertToDate |
Konvertiert ein Datum im Zeichenfolgenformat in das DateTime-Format. Die Funktion akzeptiert drei Parameter: Jahr, Monat und Datum. Die Zeit ist immer auf Mitternacht eingestellt. Zum Beispiel wird der 16. Dezember 1956 eingegeben als ConvertToDate(1956, 12, 16) und umgewandelt in 16.12.1956 00:00:00. |
| Aktuell |
Gibt den aktuellen Datensatz einer bereitgestellten Sammlung zurück. Beispiel: |
| Datum | Konvertiert nach Möglichkeit das als Zeichenfolge in „dateString“ angegebene Datum in „DateTime“, gibt andernfalls null zurück. |
| MaxDate | Gibt den größten DateTime-Wert zurück: 23:59:59,9999999 UTC, 31. Dezember 9999. |
| HasAuthorityType | Gibt einen booleschen Wert zurück, der angibt, ob „affectedId“ die Berechtigung des Typs „authorityTypeXRefCode“ für die angegebene checkAuthorityForEmployeeId hat. |
| HasRole |
Gibt einen booleschen Wert zurück, der angibt, ob der Arbeitnehmer über den angegebenen Rollenquerverweiscode verfügt. Syntaxbeispiel
Geben Sie den entsprechenden Wert für HasRole(sessionId, <<EmployeeId>>, "CADMIN") |
| paygraderate |
Gibt den Gehaltssatz für die angegebene Parameterkombination zurück. In den Parametern können Sie angeben, welcher Satz der Entgeltstufe zurückgegeben werden soll (min, max, mid oder control). Syntaxbeispiel In diesem Beispiel hat ein Workflow, der zur Bearbeitung des Formulars „Neueinstellung“ verwendet wird, einen Bedingungsknoten, der auswertet, ob der Tarif der Neueinstellung über dem mittleren Niveau der Entgeltstufe liegt, die mit der Tätigkeit verbunden ist. Im Ausdruck des Bedingungsknotens enthält der Code der Funktion employeerate( sessionId, <<List_EmployeeEmploymentStatus.Item.EmployeeEmploymentStatusId>>, <<List_EmployeeEmploymentStatus.Item.PayTypeId>>, <<List_EmployeeEmploymentStatus.Item.BaseRate>>, <<List_EmployeeEmploymentStatus.Item.BaseSalary>>, <<List_EmployeeEmploymentStatus.Item.WorkingRateSalary>>) greaterthan paygraderate( sessionId, <<List_EmployeeWorkAssignment[currentprimary].Item.OrgUnitId>>, <<List_EmployeeEmploymentStatus.Item.PayTypeId>>, <<List_EmployeeEmploymentStatus.Item.PayClassId>>, <<List_EmployeeWorkAssignment[currentprimary].Item.DeptJobId>>, <<GlobalEffectiveStart>>, "MID") |
| minimumwage | Gibt eine Dezimalzahl zurück, die den Mindestlohn für die angegebene OrgUnitID ab dem in AsOfDate angegebenen Datum angibt. |
| maxvalue |
Gibt das größte der beiden gelieferten vergleichbaren Parameterobjekte zurück. Beispiel: |
| getpaytypegroup | Gibt den PayTypeGroupCode für die angegebene PayTypeID zurück |
| employeerate | Gibt eine Dezimalzahl zurück, die die EmployeePayRate darstellt. Wenn die angegebene EmployeeEmploymentStatusID <=0 ist, wird der WorkingRateSalary zurückgegeben. Andernfalls, wenn der angegebene PayType „Hourly“ ist, wird der BaseRate zurückgegeben, andernfalls wird BaseSalary zurückgegeben. |
| isemployeebenefitseligible | Gibt einen booleschen Wert zurück, der angibt, ob die angegebene EmployeeID für einen oder mehrere Vorteile berechtigt ist. |
| createdbenefitenrollment | Gibt einen booleschen Wert zurück, der angibt, ob der Workflow, auf den in WorkflowDataId verwiesen wird, Leistungsregistrierungen erstellt hat. |
| hascurrentprimaryworklocationchanged | Gibt einen booleschen Wert zurück, der angibt, ob sich der aktuelle primäre Arbeitsplatz geändert hat, indem die Datenbank auf den primären Arbeitsplatz von EmployeeID überprüft und mit der Liste der übermittelten EmployeeWorkAssignments verglichen wird. |
| hascurrentprimaryjobchanged |
Gibt einen Booleschen Wert zurück, der angibt, ob sich die aktuelle primäre Tätigkeit für die EmployeeID geändert hat, indem die Tätigkeit der Datenbank mit der Liste der übermittelten EmployeeWorkAssignments verglichen wird. Syntaxbeispiel HasCurrentPrimaryJobChanged(SessionId, List_EmployeeWorkAssignment.EmployeeId, |
| hasfuturerecord | Gibt einen booleschen Wert zurück, der angibt, ob die angegebene Eigenschaft im Vergleich zum Parameter GlobalEffectiveStart einen Datensatz mit einem Datum in der Zukunft hat. |
| IdFromXref |
Gibt einen ganzzahligen Wert zurück, der angibt, ob ein Datensatz, der dem von Ihnen eingegebenen Querverweiscode zugeordnet ist, für einen Arbeitnehmer gilt oder nicht. Sie können im Ausdruck zwei Argumente angeben:
Syntaxbeispiel Ein Syntaxbeispiel für diese Funktion finden Sie unter Beispiel für Funktionssyntax: IdFromXref. |
| loadIfEmpty |
Wird verwendet, um bestimmte Werte aus dem System auszuwerten, wenn im Workflow-Formular keine entsprechende Dropdown-Liste vorhanden ist. Weitere Informationen finden Sie unter Benannte Funktion „LoadIfEmpty“. |
| getEmployeeProperty |
Wird zur Bewertung einer Arbeitnehmereigenschaft verwendet. Syntaxbeispiel
Beachten Sie, dass der XRefCode in doppelte Anführungszeichen gesetzt werden muss. Sie finden einen XRefCode für eine Arbeitnehmereigenschaft im Feld Referenzcode in HR-Admin > Arbeitnehmereigenschaften. Sie können diese Funktion mit Arbeitnehmereigenschaften verwenden, die die Datentypen „Auswahlliste“, „Boolesch“, „Datum“ und „Zeichenfolge“ aufweisen. Die folgende Liste enthält ein Beispiel für jeden dieser Datentypen:
Die Funktion gibt einen Arbeitnehmereigenschaftswert zurück, sodass Sie sie mit Eigenschaften verwenden können, die so konfiguriert sind, dass sie nur einen Wert akzeptieren. Wenn die Arbeitnehmereigenschaft so konfiguriert ist, dass im Feld Zuweisungsfähig die Option Mehrere auf einmal ausgewählt ist, können Sie sie in dieser Funktion nicht verwenden. |
Beispiel für Funktionssyntax: IdFromXref
Ein Workflow verfügt über einen Bedingungsknoten, der bewertet, ob ein Arbeitnehmer einer bestimmten Gewerkschaft angehört.
Im Ausdruck des Bedingungsknotens enthält der Code der Funktion IdFromXref() (unten gelb hervorgehoben) die ID für die Gewerkschaft mit dem Referenzcode „Local 306“ aus dem Store-Namen „Unions“, um sie mit der ID der aktuellen Gewerkschaft des Arbeitnehmers zu vergleichen:
<<List_EmployeeUnion.Item.DFUnionId>> EQUALS <<IdFromXref("Unions","Local 306")>>
Wenn sie übereinstimmen, wird der Workflow vom Bedingungsknoten zum Konnektor „Wahr“ fortgesetzt:
Wenn sie nicht übereinstimmen, wird mit dem Konnektor „Falsch“ fortgefahren:
