Zum Hauptinhalt wechseln
Adaptive Planning
Zuletzt aktualisiert: 2025-11-21
ai.util

ai.util

Funktionen

Methode
Parameter
Retouren
Beschreibung
Apply( obj, config)
  • obj: Object Der Empfänger der Eigenschaften
  • config: Object Die Quelle der Eigenschaften
Objekt
Kopiert alle Eigenschaften von config in obj und gibt obj zurück.
decodeBase64( encodedBase64 )
verfügbar in 2018.3
  • encodedBase64: Zeichenfolge
Eine Zeichenfolge, die als Base64 codiert ist. Beispiel: dGV4dA==
String
Gibt eine decodierte Base64-Zeichenfolge zurück.
Text
decodeHtml( encodedHtml)
verfügbar in 2018.3
  • encodedHtml: Zeichenfolge
Eine Zeichenfolge mit reservierten Zeichen, die für die Verwendung in HTML-literalen übersetzt wird. Hallo <b> [here] >worte<!
String
Gibt eine Zeichenfolge als unformatiertes HTML zurück.
'Hallo <b> [here] >worte<!'
decodeUrl( encodedUrl )
verfügbar in 2018.3
  • encodedUrl: Zeichenfolge
Eine Zeichenfolge mit einer HTML-codierten URL. Beispiel: https%3a%2f%2fwww.example.com%2ffings%2f%3fid%3d123%26more%3dwords%23hash
String
Gibt eine Zeichenfolge mit einer unformatierten URL zurück.
https://www.example.com/fings/?id=123&more=words#hash
decrypt( verschlüsseltText )
  • EncryptedText: Die verschlüsselte Zeichenfolge, die zuvor von der Funktion ai.util.encrypt() generiert wurde.
String
Gibt die ursprüngliche, entschlüsselte Nur-Text-Zeichenfolge zurück.
Die Funktion ai.util.decrypt() kehrt den Prozess um, indem sie eine verschlüsselte Zeichenfolge (in der Regel ein gespeichertes Kennwort oder einen API-Schlüssel) verwendet und sie wieder in ihr ursprüngliches Nur-Text-Format konvertiert, sodass sie im benutzerdefinierte Cloud-Datenquelle -Skript zur Authentifizierung bei einem verwendet werden kann externes System oder API.
Um diese Methode einzurichten, richten Sie zunächst Ihre PGP-Verschlüsselung ( Pretty Good Privacy ) ein. Siehe:PGP-Verschlüsselung einrichten .
encodeBase64( rawBase64 )
verfügbar in 2018.3
  • rawBase64: String
Eine Zeichenfolge mit Text. z. B Text
String
Codiert Text als Base64.
dGV4dA==
encodeHtml( RawHtml )
verfügbar in 2018.3
  • rawHtml: String
Eine Zeichenfolge mit unformatiertem HTML. z. B 'Hallo <b> [here] >worte<!'
String
Gibt eine Zeichenfolge mit reservierten Zeichen zurück, die für die Verwendung in HTML-literalen übersetzt wurde.
Hallo &lt;b&gt; [here] &gt;worte&lt;!
encodeUrl( RawUrl )
verfügbar in 2018.3
  • RawUrl: Zeichenfolge
Eine Zeichenfolge mit einer unformatierten URL. z. B. https://www.example.com/fings/id=123&more=words#hash
String
Gibt eine unformatierte URL als codiertes HTML zurück.
https%3a%2f%2fwww.example.com%2ffings%2f%3fid%3d123%26more%3dwords%23hash
encrypt( textToEncrypt )
  • textToEncrypt: Der Nur-Text-Wert, den Sie sicher verschlüsseln möchten. Dies sind in der Regel ein Kennwort oder sensible Informationen, die in einem nachfolgenden API-Aufruf verwendet werden.
String
Gibt die verschlüsselte Darstellung der Eingabezeichenfolge zurück. Diese Ausgabe sollte zum Speichern oder Übergeben sensibler Zugangsdaten anstelle von Nur-Text verwendet werden.
Die Funktion ai.util.encrypt() wendet einen Verschlüsselungsalgorithmus (verwaltet von der Workday Adaptive Planning Plattform) auf die bereitgestellte Nur-Text-Zeichenfolge an. Sie wird hauptsächlich in Skripten für benutzerdefinierte Cloud-Datenquellen (benutzerdefinierte Cloud-Datenquelle, Custom Cloud Data Source) verwendet, um Zugangsdaten zu schützen, bevor sie als Konfigurationsparameter im Integration -Setup gespeichert werden.
Um diese Methode einzurichten, richten Sie zunächst Ihre PGP-Verschlüsselung ( Pretty Good Privacy ) ein. Siehe:PGP-Verschlüsselung einrichten .
format ( formatString, arg1, arg2....argN )
  • formatString: Zeichenfolge Eine Zeichenfolge mit Ersetzungs-Token. Beispiel: "Es gibt {0} Objekte"
  • arg1: Zeichenfolge Der Wert, der das Token " {0}" ersetzen soll
  • arg2: Zeichenfolge usw.
String
Wird verwendet, um eine tokenisierte Zeichenfolge zu definieren und eine beliebige Anzahl von Argumenten zu übermitteln, um die Token zu ersetzen. Jedes Token muss eindeutig sein und muss im Format "{0}", "\{1"" usw. inkrementiert werden.
isDate(Wert)
  • value: Gemischt Der zu testende Wert
Boolesch
Gibt „true“ zurück, wenn der übergebene Wert ein JavaScript-Datumsobjekt ist.
isUndefiniert(Wert)
  • value: Gemischt Der zu testende Wert
Boolesch
Gibt "true" zurück, wenn der übergebene Wert "nicht definiert" ist.
isDefined( value )
  • value: Gemischt Der zu testende Wert
Boolesch
Gibt "true" zurück, wenn der übergebene Wert nicht "undefiniert" ist.
isArray( Wert)
  • value: Gemischt Der zu testende Wert
Boolesch
Gibt "true" zurück, wenn der übergebene Wert ein JavaScript-Array ist. Andernfalls "false".
isString(Wert)
  • value: Gemischt Der zu testende Wert
Boolesch
Gibt „true“ zurück, wenn der übergebene Wert eine Zeichenfolge ist.
isNumber(-Wert)
  • value: Gemischt Der zu testende Wert
Boolesch
Gibt „true“ zurück, wenn der übergebene Wert eine Zahl ist und begrenzt ist.
isBoolean( value )
  • value: Gemischt Der zu testende Wert
Boolesch
Gibt „true“ zurück, wenn der übergebene Wert „true“ oder „false“ ist.
toArray( a, i, j )
Array
isPrimitive( Wert)
  • value: Gemischt Der zu testende Wert
Boolesch
Gibt „true“ zurück, wenn der übergebene Wert eine Zeichenfolge, Zahl oder ein boolescher Wert ist.

Beispiele

//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;