Créer un identifiant avec des numéros séquentiels

Prev Next

Cette fonction permet de générer un identifiant à numéro séquentiel

Qui peut utiliser cette fonctionnalité ?

À partir de la version r338, Functions est disponible en accès anticipé en production. Pour demander un accès, contactez votre responsable de la réussite client.

Pour en savoir plus, consultez le fil de discussion de la communauté ici.

La création d’un identifiant avec numéro séquentiel est configurée pour la table « Action » du modèle de données commun. Si vous souhaitez l’utiliser pour une autre table, vous devez configurer un connecteur de table Tulip pour cette table spécifique.

Screenshot 2025-07-22 at 10.59.18.png

Introduction

Les fonctions permettent à votre équipe de créer une seule fois une logique partagée ou standardisée, puis de la réutiliser dans plusieurs applications. Dans cet exemple, nous présentons des fonctions permettant de mettre à jour en masse le champ « statut » dans plusieurs ordres de travail.

Déroulement de la fonction

Flux de la fonction :Running ID flow v2.png

Démonstration

Les fonctions sont déclenchées par un déclencheur dans une application. Dans la fonction, vous pouvez définir les entrées qui doivent être fournies par le déclencheur qui appelle la fonction.

Dans cette fonction spécifique, nous avons besoin de deux entrées.Screenshot 2025-07-21 at 12.41.54.png

De plus, cette fonction dispose d’une sortie qui peut être utilisée dans l’application.

Screenshot 2025-07-21 at 12.41.59.png

La première entrée est une variable « Préfixe » et la seconde une variable « Longueur ». Ces deux variables sont fournies à l’appel de la fonction par le déclencheur. La fonction utilise ces entrées pour s’exécuter. Screenshot 2025-07-21 at 14.01.58.png

Tout d’abord, la fonction est appelée par un déclencheur. La première action après l’appel de la fonction consiste à générer un espace réservé d’identifiant de 20 caractères, ce qui correspond à la longueur d’un identifiant SAP. Si votre opération utilise des identifiants plus longs, vous pouvez modifier cet espace réservé d’identifiant pour qu’il corresponde à vos besoins.

Screenshot 2025-07-22 at 9.39.26.png

Ensuite, la fonction utilise une fonction de connexion pour récupérer le dernier identifiant comportant le préfixe spécifié dans la table pour laquelle elle est configurée.

Screenshot 2025-07-22 at 11.05.43.png

Une fois que la fonction a récupéré le dernier identifiant, elle vérifie s’il existe ou non.Screenshot 2025-07-22 at 11.07.31.png

Si l’ID n’existe pas, elle génère un nouvel ID. Pour générer un nouvel ID, la première étape consiste à définir la longueur de l’ID afin qu’elle corresponde à la valeur fournie par le champ de saisie « Longueur de l’ID ». Screenshot 2025-07-22 at 11.10.51.png

La deuxième étape consiste à générer l’identifiant proprement dit. L’action utilise le préfixe fourni, la longueur d’identifiant nouvellement spécifiée, puis incrémente le numéro de un.Screenshot 2025-07-22 at 11.13.47.png

Si le dernier identifiant récupéré existe, la fonction vérifie la longueur de l’identifiant (sans compter le préfixe).

Screenshot 2025-07-22 at 11.21.08.png

Ensuite, la fonction vérifie si la deuxième entrée, celle de la « longueur de l'identifiant », est vide.

Screenshot 2025-07-22 at 11.20.05.png

Si c’est le cas, cela signifie que l’utilisateur souhaite uniquement incrémenter le numéro de l’identifiant existant. Pour ce faire, il doit d’abord extraire le numéro de l’identifiant.

Screenshot 2025-07-22 at 11.22.54.png

Ensuite, la fonction incrémente de 1 le numéro récupéré précédemment.Screenshot 2025-07-22 at 11.24.03.png

Enfin, elle génère le nouvel identifiant. Screenshot 2025-07-22 at 11.26.43.png

Si le champ « Longueur de l’identifiant » n’était pas vide, la fonction vérifie si la longueur de l’identifiant est identique à celle du dernier identifiant.Screenshot 2025-07-22 at 11.29.40.png

Si c'est le cas, là encore, elle ne générera pas de nouvel identifiant, mais se contentera d'incrémenter l'identifiant existant de 1. La fonction extraira le numéro d'identifiant de la même manière que lorsque le champ « Longueur de l'identifiant » est vide, l'incrémentera de 1 et générera un nouvel identifiant.

Si la longueur de l’ID n’est pas identique à celle du dernier ID, la fonction générera un nouvel ID. Pour ce faire, la première étape consiste à définir la longueur de l’ID afin qu’elle corresponde à la valeur fournie dans le champ « Longueur de l’ID ». Screenshot 2025-07-22 at 11.10.51.png

La deuxième étape consiste à générer l’ID proprement dit. L’action utilise le préfixe fourni, la longueur d’ID nouvellement spécifiée, puis incrémente le nombre de 1.Screenshot 2025-07-22 at 11.13.47.png

À la fin de la fonction, une nouvelle variable d’identifiant est générée en tant que résultat de la fonction. Celle-ci peut être utilisée dans l’

Screenshot 2025-07-22 at 11.36.43.png{height="" width=""}application comme identifiant d’un nouvel enregistrement de la table.

Pour en savoir plus

Si vous souhaitez découvrir d’autres fonctions, consultez ces documents pour approfondir vos connaissances