Guide de design
Guide de design
Si votre feuille est configurée avec un flux d'approbation, vous pouvez appliquer une des formules ci-dessous pour obtenir une valeur liée au processus d'approbation.
Deux types de formules d'approbation sont actuellement pris en charge :
1. En lien avec l'ensemble du processus d'approbation
2. En lien avec une étape spécifique du processus d'approbation
Pour plus d’informations et des exemples de formules d’approbation, veuillez consulter cette page.
À propos du recalcul des formules, veuillez consulter cet article.
| Formule | Description |
|---|---|
| APPROVAL.COUNT() | Renvoie le nombre d'étapes d'approbation. |
| APPROVAL.STATUS() | Renvoie le statut d'approbation.
N: nouveau P: en cours de traitement REJ: rejeté F: terminé, en indiquant que l’approbation est finalisée lorsque tous les approbateurs sont d’accord. |
| APPROVAL.SUBMITTER() | Renvoie l'adresse e-mail de l'utilisateur qui a démarré le procession d'approbation. Est prise en charge dans les champs de sélection d'utilisateur. |
| APPROVAL.SUBMITTERNAME() | Renvoie le nom de l'utilisateur ayant démarré le processus d'approbation. |
| APPROVAL.SUBMITDATE([true]) | Renvoie la date et l'heure de démarrage d'un processus d'approbation. Est prise en charge dans les champs de type Date.
L'argument [true] est facultatif, la valeur de l'heure sera affichée en utilisant le fuseau horaire UTC+0 lorsqu'il est activé. Autrement, l'heure sera affichée selon le fuseau horaire du compte. Veuillez consulter cette section pour plus de détails. |
| APPROVAL.FINISHDATE([true]) | Renvoie la date et l'heure à laquelle un processus d'approbation se termine. Une approbation est terminée lorsque tous les approbateurs ont accepté ou qu'un d'entre eux a rejeté la demande. Est prise en charge dans les champs de type Date.
L'argument [true] est facultatif, la valeur de l'heure sera affichée en utilisant le fuseau horaire UTC+0 lorsqu'il est activé. Autrement, l'heure sera affichée selon le fuseau horaire du compte. Veuillez consulter cette section pour plus de détails. |
| Formule | Description |
|---|---|
| APPROVAL.CURRENTSTEPINDEX | Renvoie une valeur d'index représentant l'étape suivante dans le processus d'approbation.
L'indice 0 indique que le processus d'approbation n'a pas encore commencé. L'indice 1 signifie que le processus a débuté, mais qu'aucun approbateur n'a encore validé la demande. Chaque fois qu'un approbateur donne son approbation, l'indice augmente de 1. Lorsque le processus d'approbation se termine (tous les approbateurs ont approuvé / un a rejeté / annulé), l'indice revient à 0. |
Les formules suivantes doivent être précédées de APPROVAL.STEP([stepIndex]), qui indique une étape spécifique du processus d’approbation grâce à une valeur d’index.
Il ne s’agit pas d’une formule autonome, mais elle peut être utilisée avec d’autres formules d’approbation.
L’argument [stepIndex] est optionnel ; s’il n’est pas précisé, APPROVAL.CURRENTSTEPINDEX sera utilisé par défaut, ce qui représente l’étape actuelle.
Les arguments sont expliqués comme suit :
APPROVAL.STEP(-1) : dernière étape
APPROVAL.STEP() : prochaine étape. Equivalent à APPROVAL.STEP(APPROVAL.CURRENTSTEPINDEX))
APPROVAL.STEP(0) : utilisation non correcte
APPROVAL.STEP(1) : première étape
APPROVAL.STEP(2) : seconde étape
| Formule | Description |
|---|---|
| APPROVAL.STEP([stepIndex]).NAME() | Renvoie le nom de cette étape. |
| APPROVAL.STEP([stepIndex]).STATUS() | Renvoie le statut de cette étape.
N: nouveau F: terminé |
| APPROVAL.STEP([stepIndex]).USERS() | Renvoie tous les approbateurs.
Ex. : Jessica Jones|Nick Fury|Steve Rogers Est prise en charge dans les champs de Sélection d'utilisateurs multiples.(Comme les formules ne peuvent pas encore être appliquées aux champs à sélection multiple, veuillez d’abord définir la formule, puis activer les paramètres de sélection multiple.) |
| APPROVAL.STEP([stepIndex]).UNSIGNEDUSERS() | Renvoie les approbateurs qui n'ont pas validé cette étape.
Ex. : Jessica Jones|Nick Fury|Steve Rogers Est prise en charge dans les champs de sélection d'utilisateurs multiples.(Comme les formules ne peuvent pas encore être appliquées aux champs à sélection multiple, veuillez d’abord définir la formule, puis activer les paramètres de sélection multiple.) |
| APPROVAL.STEP([stepIndex]).SIGNEDUSERS() | Renvoie les approbateurs qui ont déjà validé cette étape.
Ex. :, Jessica Jones|Nick Fury|Steve Rogers Est prise en charge dans les champs de sélection d'utilisateurs multiples. (Comme les formules ne peuvent pas encore être appliquées aux champs de sélection multiple, veuillez d’abord définir la formule, puis activer les paramètres de sélection multiple.) |
| APPROVAL.STEP([stepIndex]).ISMULTI() | Renvoie True si cette étape a plusieurs approbateurs. |
| APPROVAL.STEP([stepIndex]).THRESHOLD() | Renvoie le nombre-seuil de cette étape, ou 1 si cette étape n'a qu'un seul approbateur ou qu'aucun seuil n'a été fixé. |
| APPROVAL.STEP([stepIndex]).SIGNEDCOUNT() | Renvoie le nombre d'approbateurs qui ont déjà validé cette étape. |
Dans les formules suivantes, [email] est un argument optionnel (requis dans certains cas spécifiques) qui peut être utilisé de deux manières pour récupérer les données d’approbation d’une personne précise dans une étape d’approbation comportant plusieurs utilisateurs :
1. En tant que chaîne de caractères e-mail (entre guillemets ""), par ex. : APPROVAL.STEP([stepIndex]).RESP("example@ragic.com")
2. En utilisant directement le champ E-mail ou le champ Sélection d'utilisateur, par ex. : APPROVAL.STEP([stepIndex]).RESP(A2)
Remarque :
1. L’argument [email] dans la formule n’est applicable que pour les étapes d’approbation créées après le 13/07/2021.
2. Lorsqu’une formule d’approbation comporte plusieurs arguments, si l’argument [email] n’est pas nécessaire, vous devez saisir null.
Par exemple, la formule suivante contient à la fois les arguments [email] et [true] : APPROVAL.STEP([stepIndex]).ACTIONDATE([email], [true]).
(1) Si l’argument [true] n’est pas utilisé, l’argument [email] peut être laissé vide : APPROVAL.STEP(2).ACTIONDATE().
(2) Si l’argument [true] est utilisé mais que l’argument [email] n’est pas nécessaire, vous devez saisir null : APPROVAL.STEP(1).ACTIONDATE(null, true).
Si vous n’insérez pas null et écrivez par exemple : APPROVAL.STEP(1).ACTIONDATE(true), alors true sera interprété comme l’argument [email], ce qui fera dysfonctionner la formule.
| Formule | Description |
|---|---|
| APPROVAL.STEP([stepIndex]).RESP([email]) |
Renvoie la réponse pour cette étape. (1) Étape avec un seul approbateur : l'argument [email] n'est pas nécessaire. N: Not yet, indique que cette étape n’a pas encore été acceptée ou rejetée et reste en attente.. A: Accepted, indique que l’approbateur a accepté l’approbation. A_D: Accept by Deputy, indique que le délégué de l’approbateur a accepté l’approbation. REJ: Rejected, indique que l’approbateur a rejeté l’approbation. REJ_D: Reject by Deputy, indique que le délégué de l’approbateur a rejeté l’approbation. (2) Étape avec plusieurs approbateurs Sans l'argument [email] : N: Not yet, indique que le nombre d’approbateurs ayant accepté est inférieur au nombre requis. A: Accepted, indique que le nombre d’approbateurs ayant accepté est supérieur ou égal au nombre requis. REJ: Rejected, indique que quelqu'un a rejeté l'approbation. Avec l'argument [email] : unsigned: l’approbateur n’a pas encore accepté ni rejeté. signed: l’approbateur a accepté. signed_by_deputy: l'approbation a été acceptée par le délégué de l'approbateur. rejected: l'approbateur a rejeté l'approbation. rejected_by_deputy: l’approbation a été rejetée par le délégué de l'approbateur. Pour plus de détails sur l’argument [email], veuillez cliquer ici.
|
| APPROVAL.STEP([stepIndex]).COMMENT([email]) | Renvoie le(s) commentaire(s) de(s) approbateur(s), ou rien s'il n'y a pas de commentaire.
(1) Étape avec un seul approbateur: l'argument [email] n'est pas nécessaire. Renvoie le(s) commentaire(s) de l'approbateur. (2) Étape avec plusieurs approbateurs: l'argument [email] est requis. Renvoie le(s) commentaire(s) de l'approbateur sélectionné. Pour plus de détails sur l’argument [email], veuillez cliquer ici. |
| APPROVAL.STEP([stepIndex]).SIG([email]) | Renvoie la signature de l'approbateur de cette étape.
Ex: base64 image URL. Prise en charge dans les champs de téléversement d'image. (1) Étape avec un seul approbateur: l'argument [email] n'est pas nécessaire. Renvoie la signature de l'approbateur. (2) Étape avec plusieurs approbateurs: l'argument [email] est requis. Renvoie la signature de l'approbateur sélectionné. Pour plus de détails sur l’argument [email], veuillez cliquer ici. |
| APPROVAL.STEP([stepIndex]).SIGIMG([email], [width], [height]) | Renvoie la signature numérique de l'approbateur dans cette étape dans une taille d'image prédéterminée. Les arguments "[largeur]" et "[hauteur]" sont facultatifs, les valeurs par défaut étant 300px x 150px. Cette formule peut être utilisée dans les descriptions de champ avec BBCode [formule].
Remarque : 1.Pour renvoyer une signature d’un seul approbateur dans un processus d’approbation, avec des dimensions de 600 px de longueur et 300 px de largeur, utilisez : APPROVAL.STEP([stepIndex]).SIGIMG(null, 600, 300) Attention : null ne doit pas être mis entre guillemets ( " "). 2. Le type de champ ne peut pas être un champ Image/Signature ; il doit s’agir d’un champ texte (par ex. Texte libre). Pour plus de détails sur l’argument [email], veuillez cliquer ici. |
| APPROVAL.STEP([stepIndex]).ACTIONDATE([email],[true]) |
Renvoie la date et l’heure d’acceptation ou de rejet d’une étape d’approbation spécifique. Cette formule doit être appliquée à un champ de type Date. L’argument [true] est optionnel. Lorsqu’il est utilisé, l’heure s’affiche en UTC+0. Sinon, l’heure s’affiche selon le fuseau horaire du compte. Pour une explication plus détaillée, veuillez consulter cette section. (1) Étape avec un seul approbateur: l'argument [email] n'est pas nécessaire. Renvoie la date et l’heure d’acceptation ou de rejet par l’approbateur. (2) Étape avec plusieurs approbateurs: Sans l'argument [email]: Le système renverra la date et l’heure où un approbateur a rejeté cette approbation, ou bien lorsque l’étape est entièrement approuvée (c’est-à-dire que le nombre d’approbateurs ayant approuvé atteint le seuil défini). Avec l'argument [email] : Le système renverra la date et l’heure d’acceptation ou de rejet de l’utilisateur correspondant. Pour plus de détails sur l’argument [email], veuillez cliquer ici. |
| APPROVAL.STEP([stepIndex]).COMMENTDATE([email], [true]) | Renvoie la date et l’heure à laquelle des commentaires ont été laissés par le ou les approbateurs.
L’argument [true] est optionnel. Lorsqu’il est utilisé, l’heure s’affiche en UTC+0. Sinon, l’heure s’affiche selon le fuseau horaire du compte. Pour une explication plus détaillée, veuillez consulter cette section (1) Étape avec un seul approbateur: l'argument [email] n'est pas nécessaire. Renvoie la date et l’heure auxquelles l’approbateur a laissé le commentaire. (2) Étape avec plusieurs approbateurs: l'argument [email] est requis. Renvoie la date et l’heure auxquelles un approbateur spécifique a laissé le commentaire. Pour plus de détails sur l’argument [email], veuillez consulter cette page. |
Les formules d’approbation qui renvoient un horodatage sont : APPROVAL.SUBMITDATE([true]) 、 APPROVAL.FINISHDATE([true]), APPROVAL.STEP([stepIndex]).ACTIONDATE([email],[true]) 、 APPROVAL.STEP([stepIndex]).COMMENTDATE([email],[true])
Il est recommandé d’inclure l’argument [true] lors de l’utilisation de ces formules, et d’activer l’option « Afficher selon le fuseau horaire du navigateur » dans les paramètres du champ de date.
Si l'approbation a déjà été lancée ou terminée sur votre feuille, If your sheet has already started or completed the approval process, et que vous ajoutez ensuite un champ utilisant une formule d’approbation qui renvoie une heure (par ex. APPROVAL.SUBMITDATE([true]) ou APPROVAL.STEP([stepIndex]).ACTIONDATE([email],[true])) à une feuille qui contient déjà des valeurs de type Date avec l’option "Afficher selon le fuseau horaire du navigateur", cela peut entraîner un décalage de l’heure affichée, basé sur le "fuseau horaire de votre navigateur".
Par exemple, si vous avez déjà validé une feuille le "1er août 2023 à 12 h 00", et qu’à ce moment-là le champ d’heure d’approbation n’était pas configuré pour "Afficher selon le fuseau horaire du navigateur", l’heure enregistrée était selon le "fuseau horaire de l’organisation". Si vous ajoutez ensuite un nouveau champ "Nouvelle heure d’approbation" et activez "Afficher selon le fuseau horaire du navigateur", la formule d’approbation va d’abord calculer selon le "fuseau horaire de l’entreprise", puis appliquer en plus le décalage du navigateur (par ex. UTC+8). Ainsi, l’heure affichée dans le champ "Nouvelle heure d’approbation" sera décalée de 8 heures et apparaîtra comme "1er août 2023 à 20 h 00".
Par conséquent, si vous constatez des écarts liés au fuseau horaire dans l’heure d’approbation, il suffit de désactiver l’option "Afficher selon le fuseau horaire du navigateur" pour ce champ. Ainsi, le calcul de l’heure se fera uniquement selon le "fuseau horaire de l’entreprise".
Lorsque vous cochez ou décochez l’option "Afficher selon le fuseau horaire du navigateur", le système affichera un message d’avertissement signalant que les valeurs du champ seront converties. Il est donc important de vérifier ce réglage et d’éviter de le modifier sur des champs contenant déjà des valeurs de date.
