Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Fonctions du transformateur de données
Cette page décrit l'ensemble supplémentaire de fonctions Jsonnet prédéfinies pour la tâche Script de transformation de données disponible dans Application Integration.
Pour utiliser les fonctions prédéfinies suivantes, vous devez importer la bibliothèque functions dans votre script. L'importation de la bibliothèque functions vous permet d'utiliser à la fois les fonctions Jsonnet standards et les fonctions prédéfinies du Transformateur de données.
Application Integration est compatible avec la bibliothèque de fonctions Jsonnet v0.20.0. Pour en savoir plus sur les fonctions standards de Jsonnet, consultez la bibliothèque standard Jsonnet.
Fonctions de tableau
Average
Syntaxe
avg(arr)
Description
Calcule la moyenne numérique de toutes les valeurs d'un tableau.
Paramètre d'entrée
arr : tableau d'entrée.
Type renvoyé
DOUBLE
Sortie
Renvoie la moyenne de toutes les valeurs du tableau.
Contains
Syntaxe
contains(arr, elem)
Description
Vérifie l'occurrence de l'élément spécifié dans un tableau.
Paramètre d'entrée
arr : tableau d'entrée.
elem : élément du tableau à rechercher.
Type renvoyé
BOOLEAN
Sortie
Renvoie TRUE si une correspondance est trouvée et FALSE dans le cas contraire.
Max Array
Syntaxe
maxArray(arr)
Description
Trouve la valeur la plus élevée d'un tableau.
Paramètre d'entrée
arr : tableau d'entrée.
Type renvoyé
Type de données du tableau d'entrée.
Sortie
Renvoie la valeur la plus élevée trouvée dans le tableau.
Min Array
Syntaxe
minArray(arr)
Description
Recherche la valeur la plus faible d'un tableau.
Paramètre d'entrée
arr : tableau d'entrée.
Type renvoyé
Type de données du tableau d'entrée.
Sortie/th>
Renvoie la valeur la plus faible trouvée dans le tableau.
Remove
Syntaxe
remove(arr, elem)
Description
Supprime l'élément spécifié d'un tableau.
Paramètre d'entrée
arr : tableau d'entrée.
elem : élément du tableau à supprimer.
Type renvoyé
Type de données du tableau d'entrée.
Sortie
Renvoie le tableau mis à jour après la suppression de l'élément spécifié.
Remove At
Syntaxe
removeAt(arr, index)
Description
Supprime un élément d'un tableau à l'index spécifié.
Paramètre d'entrée
arr : tableau d'entrée.
index : index du tableau de l'élément à supprimer.
Type renvoyé
Type de données du tableau d'entrée.
Sortie
Renvoie le tableau mis à jour après la suppression de l'élément spécifié.
Sum
Syntaxe
sum(arr)
Description
Ajoute toutes les valeurs dans un tableau.
Paramètre d'entrée
arr : tableau d'entrée.
Type renvoyé
Type de données du tableau d'entrée.
Sortie
Renvoie la somme de tous les éléments du tableau.
GroupBy
Syntaxe
groupBy(array, function)
Description
Crée un objet composé de clés générées à partir des résultats de l'exécution de chaque élément du tableau via la fonction d'itération. Par exemple, f.groupBy([1,1.3,1.8],std.floor) générerait {"1": [1,1.3,1.8]}.
Paramètre d'entrée
array : collection sur laquelle la méthode effectue des itérations.
function : fonction appelée pour chaque élément du tableau.
Type renvoyé
JSON
Sortie
Renvoie l'objet agrégé composé.
Zip
Syntaxe
zip([arrays])
Description
Crée un tableau d'éléments groupés, dont le premier contient les premiers éléments des tableaux donnés, le deuxième contient le deuxième élément des tableaux donnés, et ainsi de suite. Par exemple, f.zip([[1, "one", "I"],[2, "two", "II"],[3, "three", "III"]]) générerait [[1,2,3],["one", "two", "three"],["I", "II", "III"]].
Paramètre d'entrée
[arrays] : ce paramètre contient les tableaux à traiter.
Type renvoyé
array
Sortie
Renvoie le nouveau tableau d'éléments groupés.
Unzip
Syntaxe
unzip(array)
Description
Crée un tableau d'éléments groupés. Accepte un tableau d'éléments groupés et crée également un tableau regroupant les éléments selon leur configuration pré-zip. Par exemple, f.unzip([[1, "one", "I"],[2, "two", "II"],[3, "three", "III"]]) générerait [[1,2,3],["one", "two", "three"],["I", "II", "III"]].
Paramètre d'entrée
array : ce paramètre contient le tableau d'éléments groupés à traiter.
Type renvoyé
array
Sortie
Renvoie le nouveau tableau d'éléments groupés.
Fonctions d'agrégation
XNOR
Syntaxe
xnor(a, b)
Description
Effectue une opération logique XNOR sur les valeurs booléennes spécifiées.
Paramètre d'entrée
a: : valeur booléenne.
b: : valeur booléenne.
Type renvoyé
BOOLEAN
Sortie
Renvoie la valeur XNOR des deux valeurs booléennes données.
Xor
Syntaxe
xor(a, b)
Description
Effectue une opération logique XOR sur les valeurs booléennes spécifiées.
Paramètre d'entrée
a: : valeur booléenne.
b: : valeur booléenne.
Type renvoyé
BOOLEAN
Sortie
Renvoie la valeur XOR des deux valeurs booléennes données.
Analyse la chaîne CSV d'entrée donnée au format JSON. La première ligne sera considérée comme un en-tête. Par exemple, f.parseCsvWithHeader("index,product,company\n1,Application Integration,Google\n2,Pubsub,Google") générerait [{"index": "1", "product": "Application Integration", "company": "Google"},{"index": "2", "product": "Pubsub", "company": "Google"}].
Paramètre d'entrée
input : chaîne CSV à analyser.
delimiter : chaîne de délimiteur à utiliser. La valeur par défaut est ",".
overwrite_duplicate_headers: : option permettant d'écraser les valeurs des en-têtes en double. Si la valeur est "false", l'en-tête en double est renommé. La valeur par défaut est true.
Type renvoyé
JSON
Sortie
Renvoie la représentation JSON d'une chaîne CSV donnée.
Manifest CSV
Syntaxe
manifestCsv(json, headers = null)
Description
Convertit le JSON donné en chaîne CSV. Par exemple, f.manifestCsv([{"index": "1", "product": "Application Integration", "company": "Google"},{"index": "2", "product": "Pubsub", "company": "Google"}]) générerait index,product,company\n1,Application Integration,Google\n2,Pubsub,Google.
Paramètre d'entrée
json: : fichier JSON à convertir au format CSV.
headers: : liste d'en-têtes pour la sortie au format CSV. Si aucune valeur n'est fournie, tous les en-têtes sont utilisés.
Type renvoyé
STRING
Sortie
Renvoie la chaîne CSV à partir du JSON au format donné.
Fonctions mathématiques
Is Decimal
Syntaxe
isDecimal(num)
Description
Vérifie si le nombre donné est une valeur décimale.
Paramètre d'entrée
num: : numéro d'entrée.
Type renvoyé
BOOLEAN
Sortie
Renvoie TRUE si le nombre est décimal et FALSE dans le cas contraire.
Is Even
Syntaxe
isEven(num)
Description
Vérifie si le nombre donné est pair.
Paramètre d'entrée
num: : numéro d'entrée.
Type renvoyé
BOOLEAN
Sortie
Renvoie TRUE si le nombre est pair et FALSE dans le cas contraire.
Is Integer
Syntaxe
isInteger(num)
Description
Vérifie si le nombre donné est un entier.
Paramètre d'entrée
num: : numéro d'entrée.
Type renvoyé
BOOLEAN
Sortie
Renvoie TRUE si le nombre est un entier et FALSE dans le cas contraire.
Is Odd
Syntaxe
isOdd(num)
Description
Vérifie si le nombre donné est impair.
Paramètre d'entrée
num: : numéro d'entrée.
Type renvoyé
BOOLEAN
Sortie
Renvoie TRUE si le nombre est impair et FALSE dans le cas contraire.
Random Number
Syntaxe
randomNumber(lowerBound, upperBound)
Description
Génère un nombre réel aléatoire entre une plage spécifiée.
Paramètre d'entrée
lowerBound : valeur de la plage inférieure (incluse). La valeur par défaut est 0.
upperBound : valeur de plage supérieure (exclusive). La valeur par défaut est 1.
Type renvoyé
Nombre réel.
Sortie
Renvoie un nombre réel aléatoire compris entre lowerBound et upperBound.
Round
Syntaxe
round(input)
Description
Arrondit un nombre à l'entier le plus proche.
Paramètre d'entrée
input : valeur à arrondir.
Type renvoyé
INTEGER
Valeur renvoyée
Renvoie l'entier arrondi le plus proche.
Fonctions de chaîne
Equals Ignore Case
Syntaxe
equalsIgnoreCase(str1, str2)
Description
Compare les deux valeurs de chaîne données, quelle que soit la casse (minuscules ou majuscules).
Paramètre d'entrée
str1 : chaîne d'entrée.
str2 : chaîne d'entrée.
Type renvoyé
BOOLEAN
Sortie
Renvoie TRUE si la valeur spécifiée correspond à la valeur existante (en ignorant la casse) et FALSE dans le cas contraire.
Is Empty
Syntaxe
isEmpty(str)
Description
Vérifie si la longueur de la chaîne donnée est égale à 0.
Paramètre d'entrée
str: : chaîne d'entrée.
Type renvoyé
BOOLEAN
Sortie
Renvoie TRUE si la chaîne est vide et FALSE dans le cas contraire.
Match
Syntaxe
match(str, regexp)
Description
Récupère le résultat de mise en correspondance d'une chaîne avec une expression régulière.
Renvoie un tableau contenant toutes les sous-chaînes de str qui correspondent à l'expression régulière (regexp). Renvoie un tableau vide s'il n'y a pas de correspondance.
Trim
Syntaxe
trim(str)
Description
Supprime tous les espaces de début et de fin d'une chaîne donnée.
Paramètre d'entrée
str: : chaîne d'entrée.
Type renvoyé
STRING
Sortie
Renvoie une copie de la chaîne, en supprimant les espaces de début et de fin.
Formate un horodatage en fonction de la chaîne de format format_string spécifiée.
Paramètre d'entrée
timestamp : horodatage d'entrée.
format_string: : nouveau format d'horodatage. Consultez la section Éléments de format d'horodatage compatibles pour obtenir la liste des éléments de format pouvant être utilisés pour former la nouvelle chaîne de format d'horodatage.
timezone : fuseau horaire de l'horodatage d'entrée fourni. La valeur par défaut est UTC.
current_format: : format utilisé pour analyser l'horodatage d'entrée fourni. La valeur par défaut est E (epoch).
Type renvoyé
STRING
Sortie
Renvoie une nouvelle chaîne après la conversion de la valeur timestamp d'entrée en fonction de la valeur format_string spécifiée.
Éléments de format d'horodatage acceptés
Le tableau suivant répertorie les éléments de format acceptés pour la fonction dateFormat() :
Élément de format
Description
Exemple
YYYY
Année (4 chiffres)
2023
YY
Les deux derniers chiffres de l'année.
23
MMMM
Nom du mois en majuscules.
March
MMM
Nom abrégé du mois en majuscules.
Mar
MM
Mois, de 01 à 12.
03
M
Mois, de 1 à 12.
3
DDDD
Nom du jour en majuscules.
Monday
DDD
Nom abrégé du jour.
Mon
DD
Jour, du 01 au 31
06
D
Jour, du 1 au 31.
6
HH
Heure au format 24 heures de 00 à 23.
15
hh
Heure au format 12 heures, de 01 à 12.
03
h
Heure au format 12 heures de 1 à 12.
3
mm
Minutes, de 00 à 59.
04
m
Minutes, de 0 à 59.
4
ss
Secondes, de 00 à 59.
08
s
Secondes, de 0 à 59.
8
FFFFFFFFF
Fractions de secondes à neuf chiffres, y compris les zéros, à droite des chiffres spécifiés.
00.123456789
FFFFFFFF
Fractions de secondes à huit chiffres, y compris les zéros, à droite des chiffres spécifiés.
00.12345678
FFFFFFF
Fractions de secondes à sept chiffres, y compris les zéros, à droite des chiffres spécifiés.
00.1234567
FFFFFF
Fractions de secondes à six chiffres, y compris les zéros, à droite des chiffres spécifiés.
00.123456
FFFFF
Fractions de secondes à cinq chiffres, y compris les zéros, à droite des chiffres spécifiés.
00.12345
FFFF
Fractions de secondes à quatre chiffres, y compris les zéros, à droite des chiffres spécifiés.
00.1234
FFF
Fractions de secondes à trois chiffres, y compris les zéros, à droite des chiffres spécifiés.
00.123
FF
Fractions de secondes à deux chiffres, y compris les zéros, à droite des chiffres spécifiés.
00.12
F
Fractions de secondes à un chiffres, y compris les zéros, à droite des chiffres spécifiés.
00.1
fffffffff
Fractions de secondes à neuf chiffres,.
987654321
ffffffff
Fractions de secondes à huit chiffres.
98765432
fffffff
Fractions de secondes à sept chiffres.
9876543
ffffff
Fractions de secondes à six chiffres.
987654
fffff
Fractions de secondes à cinq chiffres.
98765
ffff
Fractions de secondes à quatre chiffres.
9876
fff
Fractions de secondes à trois chiffres.
987
ff
Fractions de secondes à deux chiffres.
98
f
Fractions de secondes un chiffre.
9
tt
Indicateur de méridien (matin ou soir). Lors du formatage, il s'agit de AM ou de PM.
PM
t
Indicateur de méridien court (matin ou soir). Correspond à am ou pm en minuscules.
pm
K
Nom du fuseau horaire
PST
kk
Fuseau horaire au format ±xx:xx.
-8:00:00
k
Fuseau horaire au format ±xxxx.
-8000
Is Leap Year
Syntaxe
isLeapYear(year)
Description
Vérifie si une année bissextile est une année bissextile.
Paramètre d'entrée
year : année d'entrée (nombre réel)
Type renvoyé
BOOLEAN
Sortie
Renvoie TRUE si l'année est bissextile et FALSE dans le cas contraire.
Now In Millis
Syntaxe
nowInMillis()
Description
Renvoie l'heure epoch Unix actuelle d'une intégration en millisecondes.
Paramètre d'entrée
Non disponible
Type renvoyé
INT64
Sortie
Renvoie l'heure epoch Unix actuelle en millisecondes.
Fonctions utilitaires
UUID
Syntaxe
uuid()
Description
Renvoie un identifiant unique universel (UUID) aléatoire sous forme de chaîne (STRING). La chaîne STRING renvoyée se compose de 32 chiffres hexadécimaux répartis dans cinq groupes séparés par des traits d'union, au format 8-4-4-4-12. Les chiffres hexadécimaux représentent 122 bits aléatoires et 6 bits fixes, conformément à la section 4.4 de la norme RFC 4122. La chaîne (STRING) renvoyée est en minuscules.
Paramètre d'entrée
Non disponible
Type renvoyé
STRING
Sortie
Renvoie l'UUID généré au format de chaîne.
Integration name
Syntaxe
getIntegrationName()
Description
Permet d'obtenir le nom de l'intégration actuelle.
Paramètre d'entrée
Non disponible
Type renvoyé
STRING
Sortie
Renvoie le nom de l'intégration actuelle.
Integration region
Syntaxe
getIntegrationRegion()
Description
Obtenir la région de l'intégration actuelle.
Paramètre d'entrée
Non disponible
Type renvoyé
STRING
Sortie
Renvoie la région de l'intégration actuelle.
Integration version ID
Syntaxe
getIntegrationVersionId()
Description
Obtenez l'ID de version d'intégration de l'intégration actuelle.
Paramètre d'entrée
Non disponible
Type renvoyé
STRING
Sortie
Renvoie l'ID de version d'intégration de l'intégration actuelle.
Integration version number
Syntaxe
getIntegrationVersionNumber()
Description
Récupère le numéro de version de l'intégration actuelle.
Paramètre d'entrée
Non disponible
Type renvoyé
NUMBER
Sortie
Renvoie le numéro de version de l'intégration actuelle.
Execution ID
Syntaxe
getExecutionId()
Description
Récupère l'ID d'exécution de l'intégration actuelle.
Paramètre d'entrée
Non disponible
Type renvoyé
STRING
Sortie
Renvoie l'ID d'exécution de l'intégration en cours.
Project ID
Syntaxe
getProjectId()
Description
Récupère l'ID de projet Google Cloud de l'intégration actuelle.
Paramètre d'entrée
Non disponible
Type renvoyé
STRING
Sortie
Renvoie l'ID de projet Google Cloud de l'intégration actuelle.
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2024/03/28 (UTC).
[{
"type": "thumb-down",
"id": "hardToUnderstand",
"label":"Hard to understand"
},{
"type": "thumb-down",
"id": "incorrectInformationOrSampleCode",
"label":"Incorrect information or sample code"
},{
"type": "thumb-down",
"id": "missingTheInformationSamplesINeed",
"label":"Missing the information/samples I need"
},{
"type": "thumb-down",
"id": "translationIssue",
"label":"Problème de traduction"
},{
"type": "thumb-down",
"id": "otherDown",
"label":"Autre"
}]
[{
"type": "thumb-up",
"id": "easyToUnderstand",
"label":"Facile à comprendre"
},{
"type": "thumb-up",
"id": "solvedMyProblem",
"label":"J'ai pu résoudre mon problème"
},{
"type": "thumb-up",
"id": "otherUp",
"label":"Autre"
}]