Cette section fournit des conseils sur les types d’opérateurs utilisés pour évaluer les expressions logiques dans Dayforce.
Les expressions logiques sont évaluées par les nœuds de condition dans Administration du flux des travaux > Concepteur de flux des travaux, qui s’appuie sur ces opérateurs pour évaluer la relation entre les champs de la base de données et leurs valeurs afin de déterminer si la condition est vraie ou fausse.
Types d’opérateurs et valeurs
| Type d’opérateur | Valeurs |
|---|---|
| Logique | AND, OR, NOT |
| Comparaison | Equals, LessThan, GreaterThan, LessThanEquals, GreaterThanEquals |
| Arithmétique | +, -, *, / |
| Fonctionnel | today(), coalesce(), maxdate(), maxvalue(), current(), HasAuthorityType(), HasRole(), employeerate(), paygraderate(), minimumwage(), getpaytypegroup(), max(name), min(name), IdFromXref() |
Le tableau ci-dessous décrit les fonctions nommées qui peuvent être utilisées dans les nœuds de condition.
N. B. : Le paramètre sessionId représente l’ID de la session existante. Il est de type chaîne et est récupéré à l’aide du mot réservé sessionId, comme l’illustrent certains exemples ci-dessous.
| Fonction | Sommaire |
|---|---|
| Coalesce | Vérifie si l’ensemble fourni comme paramètre a tous les éléments non nuls et renvoie cet ensemble ou des éléments nuls. N’importe quel nombre de paramètres est accepté. Les chaînes sont traitées comme des ensembles de caractères. |
| ConvertToDate |
Convertit une date en format de chaîne au format DateTime. Cette fonction accepte trois paramètres : année, mois et date. L’heure est toujours réglée à minuit. Par exemple, le 16 décembre 1956 est saisi comme suit : ConvertToDate(1956, 12, 16) et cette date est convertie au format : 1956-12-16 00:00:00. |
| Count | |
| createdbenefitenrollment | Renvoie une valeur booléenne indiquant si le flux des travaux référencé dans WorkflowDataId a créé des inscriptions aux avantages sociaux. |
| Current |
Renvoie l’enregistrement actuel d’un ensemble fourni. Par exemple : |
| d'échéance | Si possible, convertit la date fournie sous forme de chaîne dateString en DateTime, sinon renvoie la valeur nulle. |
| employeerate | Renvoie une décimale représentant le EmployeePayRate. Si le EmployeeEmploymentStatusID fourni est <=0, il renvoie le WorkingRateSalary. Sinon, si le PayType précisé est "Hourly", il renvoie le BaseRate, sinon il renvoie BaseSalary. |
| getEmployeeProperty |
Utilisé pour évaluer la propriété d’employé. Exemple de syntaxe
Notez que le XrefCode doit être placé à l’intérieur des guillemets doubles. Vous pouvez trouver un XRefCode pour une propriété d’employé dans le champ Code de référence de la fonction Administration des RH > Propriétés de l’employé. Vous pouvez utiliser cette fonction avec les propriétés des employés qui ont des données de type liste de sélection, booléen, date, chaîne et nombre. La liste suivante contient un exemple pour chacun de ces types de données :
La fonction renvoie une seule valeur de propriété d’employé. Vous pouvez donc l’utiliser avec des propriétés configurées pour n’accepter qu’une seule valeur. Si la propriété de l’employé est configurée avec l’option Plusieurs à la fois sélectionné dans le champ Affectable, vous ne pouvez pas l’utiliser dans cette fonction. |
| getpaytypegroup | Renvoie le PayTypeGroupCode pour le PayTypeID fourni |
| HasAuthorityType | Renvoie une valeur booléenne indiquant si affectedId a un accès de type authorityTypeXRefCode pour l’élément fourni checkAuthorityForEmployeeId. |
| hascurrentprimaryjobchanged |
Renvoie une valeur booléenne indiquant si l’emploi principal actuel pour EmployeeId a changé en faisant des références croisées entre l’emploi principal de la base de données et la liste des EmployeeWorkAssignments soumis. Exemple de syntaxe HasCurrentPrimaryJobChanged(SessionId, List_EmployeeWorkAssignment.EmployeeId, |
| hascurrentprimaryworklocationchanged | Renvoie une valeur booléenne indiquant si l’emplacement de travail principal actuel a changé en consultant la base de données pour l’emplacement de travail principal de EmployeeId et en faisant des références croisées avec la liste des EmployeeWorkAssignments soumis. |
| hasfuturerecord | Renvoie une valeur booléenne indiquant si la propriété fournie a un enregistrement dans le futur par rapport au paramètre GlobalEffectiveStart. |
| HasPositionPropertyChanged |
Renvoie une valeur booléenne indiquant si une certaine entité de gestion des postes a été modifiée. Exemple de syntaxe HasPositionPropertyChanged("ChangesetPosition", "Name") Insérez les valeurs appropriées pour PMEntityName et PropertyName : HasPositionPropertyChanged(<<PMEntityName>>,<<PropertyName>>) Voici une liste des PMEntityNames et PropertyNamesdisponibles :
|
| HasRole |
Renvoie une valeur booléenne indiquant si l’employé a le code de référence croisée de rôle fourni. Exemple de syntaxe
Insérez les valeurs appropriées pour les champs HasRole(sessionId, <<EmployeeId>>, "CADMIN") |
| IdFromXref |
Renvoie une valeur entière indiquant si un enregistrement associé au code de référence croisée que vous entrez est applicable pour un employé. Vous pouvez préciser deux arguments dans l’expression :
Exemple de syntaxe Pour un exemple de syntaxe pour cette fonction, consultez Exemple de syntaxe de la fonction : IdFromXref. |
| isemployeebenefitseligible | Renvoie une valeur booléenne indiquant si l’EmployeeID fourni est admissible à un ou plusieurs avantages sociaux. |
| loadIfEmpty |
Utilisé pour évaluer des valeurs précises du système lorsqu’il n’y a pas de liste déroulante correspondante dans le formulaire de flux des travaux.Consultez Fonction nommée LoadIfEmpty. |
| MaxDate | Renvoie la plus grande valeur de date et heure : 23:59:59.9999999 UTC, 31 décembre 9999. |
| maxvalue |
Renvoie le plus grand des deux objets paramètres comparables fournis. Par exemple : |
| minimumwage | Renvoie une valeur décimale indiquant le salaire minimum pour l’unité organisationnelle fournie à la date précisée dans AsOfDate. |
| paygraderate |
Renvoie le taux de l’échelon de rémunération pour la combinaison de paramètres fournie. Dans les paramètres, vous pouvez préciser le taux de l’échelon de rémunération à retourner (minimum, maximum, moyen ou contrôle). Exemple de syntaxe Dans cet exemple, un flux des travaux utilisé pour traiter le formulaire Nouvelle embauche comporte un nœud de condition qui évalue si le taux de la nouvelle embauche est supérieur au niveau intermédiaire de l’échelon de rémunération associé au poste. Dans l’expression du nœud de condition, le code de la fonction employeerate( sessionId, <<List_EmployeeEmploymentStatus.Item.EmployeeEmploymentStatusId>>, <<List_EmployeeEmploymentStatus.Item.PayTypeId>>, <<List_EmployeeEmploymentStatus.Item.BaseRate>>, <<List_EmployeeEmploymentStatus.Item.BaseSalary>>, <<List_EmployeeEmploymentStatus.Item.WorkingRateSalary>>) Supérieur à paygraderate( sessionId, <<List_EmployeeWorkAssignment[currentprimary].Item.OrgUnitId>>, <<List_EmployeeEmploymentStatus.Item.PayTypeId>>, <<List_EmployeeEmploymentStatus.Item.PayClassId>>, <<List_EmployeeWorkAssignment[currentprimary].Item.DeptJobId>>, <<GlobalEffectiveStart>>, "MID") |
| Today | Renvoie la date et l’heure actuelles (au moment de l’appel) sur le serveur. Peut ne pas correspondre à la date et l’heure actuelles sur l’instance de l’utilisateur. |
Exemple de syntaxe de la fonction : IdFromXref
Un flux des travaux comporte un nœud de condition qui évalue si un employé appartient à un syndicat.
Dans l’expression du nœud de condition, le code de la fonction IdFromXref() (surligné en jaune ci-dessous) obtient l’ID du syndicat dont le code de référence « section locale 306 » provient du nom de magasin « Syndicats » pour le comparer à l’ID correspondant au syndicat actuel de l’employé :
<<List_EmployeeUnion.Item.DFUnionId>> EQUALS <<IdFromXref("Unions","Local 306")>>
S’ils correspondent, le flux des travaux continue à partir du nœud de condition vers le connecteur « Vrai » :
S’il n’y a pas de correspondance, le flux des travaux passe au connecteur Faux :