Passer au contenu principal
Adaptive Planning
Dernière mise à jour : 2025-11-21
ai.util

ai.util

Fonctions

Méthode
Paramètres
Retours
Description
apply( obj, config )
  • obj : Object Le destinataire des propriétés
  • config: Object La source des propriétés
Objet
Copie toutes les propriétés de config dans obj et renvoie obj.
decodeBase64( encodedBase64 )
disponible en 2018.3
  • encodedBase64 : chaîne
Une chaîne codée en Base64. E.g. dGV4dA==
String
Renvoie une chaîne Base64 décodé.
Texte
decodeHtml(encodedHtml)
disponible en 2018.3
  • encodedHtml : chaîne
Chaîne contenant des caractères réservés afin d'être traduite dans les littéraux HTML. Bonjour > [ree] > Mots<
String
Renvoie une chaîne sous forme de HTML brut.
'Bonjour <b> [il] >noms<!'
decodeUrl( encodedUrl )
disponible en 2018.3
  • encodedUrl : chaîne
Une chaîne avec une URL au format HTML. Exemple : https%3a%2f%2fwww.example.com%2ffings%2f%3rid%3d123%26more%3dwords%23hash
String
Renvoie une chaîne avec une URL brute.
https://www.example.com/fings/?id=123&more=words#hash
decrypt( encryptedText )
  • valeur ci-dessus : chaîne chiffrée précédemment générée par la fonction ai.util.encrypt().
String
Renvoie la chaîne de texte brut d'origine déchiffrée.
La fonction ai.util.decrypt() inverse le processus de chiffrement en récupérant une chaîne chiffrée (généralement un mot de passe ou une clé API stockée) et la remet à son format de texte brut d'origine afin qu'elle puisse être utilisée dans le script source de données Cloud personnalisée pour s'authentifier avec un système externe ou API.
Pour configurer cette méthode, configurez d'abord votre chiffrement par le Pretty Good Privacy (PGP). VoirConfigurer le chiffrement PGP .
encodeBase64( rawBase64 )
disponible en 2018.3
  • brutBase64 : chaîne
Une chaîne avec texte. Ex. Texte
String
Code le texte en Base64.
dGV4dA==
encodeHtml( rowHtml )
disponible en 2018.3
  • brutHtml : chaîne
Une chaîne avec du HTML brut. Ex. 'Bonjour <b> [il] >noms<!'
String
Renvoie une chaîne traduite avec des caractères réservés afin d'être utilisée dans les littéraux HTML.
Bonjour > [ree] > Mots&lt;
encodeUrl (rawUrl )
disponible en 2018.3
  • brutUrl : chaîne
Une chaîne avec une URL brute. Exemple : https://www.example.com/fings://id=123&more=words#hash
String
Renvoie une URL brute sous forme de code HTML.
https%3a%2f%2fwww.example.com%2ffings%2f%3fid%3d123%26more%3dwords%23hash
encrypt( textToEncrypt )
  • textToEncrypt : valeur de texte brut que vous souhaitez chiffrer en toute sécurité. Il s'agit généralement d'un mot de passe ou d'informations sensibles utilisé(e)s dans un appel d'API ultérieur.
String
Renvoie la représentation chiffrée de la chaîne d'entrée. Cette sortie doit être utilisée pour stocker ou transmettre des identifiants sensibles plutôt que du texte brut.
La fonction ai.util.encrypt() applique un algorithme de chiffrement (géré par la plateforme Workday Adaptive Planning ) à la chaîne de texte brut fournie. Elle est principalement utilisée dans les scripts de sources de données Cloud personnalisées (source de données Cloud personnalisée) pour protéger les identifiants avant de les stocker comme paramètres de configuration dans la configuration de intégration .
Pour configurer cette méthode, configurez d'abord votre chiffrement par le Pretty Good Privacy (PGP). VoirConfigurer le chiffrement PGP .
format ( formatString, arg1, arg2....argN )
  • formatString : chaîne de chaîne A avec des jetons de remplacement. Ex : 'il y a {0} éléments'
  • arg1 : chaîne de valeur pour remplacer le jeton {0}
  • arg2 : chaîne etc..
String
Utilisé pour définir une chaîne avec jeton et passer un nombre arbitraire d'arguments pour remplacer les jetons. Chaque jeton doit être unique et doit être incrémenté au format {0}, {1}, etc.
isDate( value )
  • value: Mixte. Valeur à tester
Boolean
Renvoie true (vrai) si la valeur transmise est un objet JavaScript Date.
isUndéfini( valeur )
  • value: Mixte. Valeur à tester
Boolean
Renvoie true (vrai) si la valeur transmise n'est pas définie.
is Définired(valeur )
  • value: Mixte. Valeur à tester
Boolean
Renvoie true (vrai) si la valeur transmise n'est pas définie.
isArray( value )
  • value: Mixte. Valeur à tester
Boolean
Renvoie true (vrai) si la valeur transmise est un tableau JavaScript, sinon renvoie false (faux).
isString( value )
  • value: Mixte. Valeur à tester
Boolean
Renvoie true (vrai) si la valeur transmise est une chaîne.
isNumber(valeur)
  • value: Mixte. Valeur à tester
Boolean
Renvoie true (vrai) si la valeur transmise est un nombre et est finie.
isbooléen(valeur)
  • value: Mixte. Valeur à tester
Boolean
Renvoie true (vrai) si la valeur transmise est vraie ou fausse.
toArray( a, i, j )
Tableau
isPrimive( value )
  • value: Mixte. Valeur à tester
Boolean
Renvoie true (vrai) si la valeur transmise est une chaîne, un nombre ou un booléen.

Exemples

//Example for ai.util.apply var sourceObj = {department:"Engineering"}; var destObj={}; ai.util.apply(destObj,sourceObj); ai.log.logInfo("Source Properties applied to Destination object: "+JSON.stringify(destObj)); // Source Properties applied to destination object: {department:Engineering} //Example for ai.util.decodeHtml var encodedHtml = "Hello &lt;b&gt; [there] &gt;words&lt;!"; var decodedvalue=ai.util.decodeHtml(encodedHtml); ai.log.logInfo("Decoded HTML is " +decodedvalue); // Decoded HTML is Hello [there] >words //Example for ai.util.encodeHtml var rawHtml = "Hello <b> [there] >words<!"; var encodedvalue=ai.util.encodeHtml(rawHtml); ai.log.logInfo("Encoded HTML is " +encodedvalue); // Encoded HTML is Hello <b> [there] >words<! //Example for ai.util.decodeBase64 var encodedBase64 = "VGhpcyBpcyBhIHNhbXBsZSB0ZXh0IGZvciBlbmNvZGluZw=="; var decodedbasevalue= ai.util.decodeBase64(encodedBase64); ai.log.logInfo("Decoded base64 is: "+decodedbasevalue); //Decoded base64 is:"This is a sample text for encoding" //Example for ai.util.encodeBase64 var rawBase64 = "This is a sample text for encoding"; var encodedbasevalue= ai.util.encodeBase64(rawBase64, ""); ai.log.logInfo("Encoded base64 is: "+encodedbasevalue); //Encoded base64 is:VGhpcyBpcyBhIHNhbXBsZSB0ZXh0IGZvciBlbmNvZGluZw== //Example for ai.util.encodeUrl var rawUrl = "https://docs.postman-echo.com/"; var encodedUrl=ai.util.encodeUrl(rawUrl); ai.log.logInfo("Encoded URL is: "+encodedUrl); //Encoded URL is: https%3a%2f%2fdocs.postman-echo.com%2f //Example for ai.util.decodeUrl var encodedUrl = "https%3a%2f%2fdocs.postman-echo.com%2f"; var decodedUrl=ai.util.decodeUrl(encodedUrl); ai.log.logInfo("Decoded URL is: "+decodedUrl); //Decoded URL is: https://docs.postman-echo.com/ //Example for ai.util.encrypt function testConnection(context) { var message = "-----BEGIN PGP MESSAGE-----" +"Version: GnuPG v2.0.14 (GNU/Linux)" +"Your Message" +"-----END PGP MESSAGE-----"; var text = ai.util.decrypt(message,'myPgp'); ai.log.logInfo("text message", text); return true; } //Example for ai.util.decrypt function testConnection(context) { var text = "Text to encrypt"; var encrypedPgpMessage = ai.util.encrypt(text,'myPgp'); ai.log.logInfo("encrypted message", encrypedPgpMessage ); return true; } //Example for ai.util.format var formatted=ai.util.format('How ar{0} you{1}',"e","?"); ai.log.logInfo("Formatted String is: "+formatted); //How are you? //Example for ai.util.isDate() var d = new Date(); var verifyIfDate=ai.util.isDate(d); ai.log.logInfo("Provided value is: "+verifyIfDate); //Provided value is: true //Example for ai.util.isUndefined var sampleValue; var verifyIfUndefined=ai.util.isUndefined(sampleValue); if (verifyIfUndefined) { ai.log.logInfo("Value is undefined"); } else { ai.log.logInfo("Value is defined"); } //Value is undefined //Example for ai.util.isDefined var sampleValue=6; var verifyIfDefined=ai.util.isDefined(sampleValue); ai.log.logInfo("verifyIfDefined: "+verifyIfDefined) if (verifyIfDefined) { ai.log.logInfo("Value is defined"); } else { ai.log.logInfo("Value is undefined"); } //Value is defined //Example for ai.util.isArray var sampleValue=["a","b"]; var verifyIfArray=ai.util.isArray(sampleValue); if (verifyIfArray) { ai.log.logInfo("Is is an Array"); } else { ai.log.logInfo("Not an Array"); } //It is an array //Example for ai.util.isString var sampleValue="123"; var verifyIfString=ai.util.isString(sampleValue); if (verifyIfString) { ai.log.logInfo("Is is a string"); } else { ai.log.logInfo("Not a string"); } //Example for ai.util.isNumber var sampleValue = {firstName:"Jon", lastName:"Doe"}; var verifyIfNumber=ai.util.isNumber(sampleValue); if (verifyIfNumber) { ai.log.logInfo("Is is a number"); } else { ai.log.logInfo("Not a number. Provided value is of type: "+typeof(sampleValue)); } //Not a number. Provided value is of type: object //Example for ai.util.isBoolean var sampleValue = true; var verifyIfBoolean=ai.util.isBoolean(sampleValue); if (verifyIfBoolean) { ai.log.logInfo("Value is Boolean"); } else { ai.log.logInfo("Not a Boolean. Provided value is of type: "+typeof(sampleValue)); } //Value is Boolean //Example for ai.util.isPrimitive var sampleValue = {firstName:"Jon", lastName:"Doe"}; var verifyIfPrimitive=ai.util.isPrimitive(sampleValue); if (verifyIfPrimitive) { ai.log.logInfo("Provided value is a Primitive Data Type"); } else { ai.log.logInfo("Provided value is not primitive: "+typeof(sampleValue)); } return true;