Code

Overview

The Code node provides a convenient way to add custom functionality to your Process by allowing you to access, modify, and create task parameters using JavaScript or Erlang. Although the Code node is highly efficient in speed, you may encounter a timeout error if your code is computationally intensive and takes an extended period to execute or if it includes an infinite loop. If your code requires extra processing power, you can create a dedicated microservice and call it from Corezoid. If you need further assistance, don't hesitate to contact us for custom solutions that will better fit your needs.

Settings

The Code node has the following parameters:

1. (Optional) Title and Description: Name and details of the node.

2. Code editor: Supports following programming languages:

   • Javascript: Task parameters can be found within the data object, and you can access them using dot notation.

     data.parameter_name
     

     List of supported JavaScript libraries:

     • moment v2.11.1 (example)
     • moment-timezone v2.11.1 (example)
     • CryptoJS v3.1.2 (limited)

     Available CryptoJS methods:

     • Hashing: MD5, SHA-1, SHA-512, HMAC MD5, HMAC SHA-1, HMAC SHA-256
     • Ciphers: AES, DES, Triple DES, Rabbit, RC4
     • Encoders: base64
       Below you can see an example of your code where Data is the task object, and param is one of its parameters.

     -module(node).
     -export([main/1]).
     main(Data) -> [{<<"param">>, <<"Hello World!!!">>} | Data].
     

3. Other:

   • Alert if the number of tasks in the node queue reaches the following number: Helps monitor whether the number of tasks in the node exceeds the specified threshold. When selecting the checkbox, you have to enter the needed number of tasks in the field that appears below.
   • Maximum interval, for which the task stays in the node before being forwarded: The amount of time a task is allowed to be in the node can be set in seconds, minutes, hours, and days.
     Note: The checkbox has a minimum value of 30 seconds. You can set a shorter interval by using the Unixtime function.

   

Examples

Working with date/time using moment.js

In the Code editor form of the Code node details panel, you can write your code in JavaScript using the supported libraries.

You can see the example below.

require("libs/moment.js"); 

let datetime = moment().format('MMMM Do YYYY, h:mm a');

data.message = "Hi " + data.name + ". Today is " + datetime +". What a great time to learn Corezoid!" ;

• require("libs/moment.js"): Import the moment.js library used to obtain the current date and time.
• let datetime = moment().format('MMMM Do YYYY, h:mm a'): Use the moment() method to obtain the current date and time and the format() method to convert it into a string. The resulting value is assigned to a local variable.
• data.message = "Hi " + data.name + ". Today is " + datetime +". What a great time to learn Corezoid!": Create a string using the value of the name parameter from the data object and the value of the datetime variable generated. Assign this string to data.message, which creates a new task parameter with the message key and the value of the string.

Moment-timezone

require("libs/moment-timezone.js");
data.date = moment().tz('Europe/Kiev').format("DD-MM-YYYY HH:mm:ss");

• require("libs/moment-timezone.js"): Import the moment-timezone.js library used to convert and format dates for different time zones.
• data.date = moment().tz('Europe/Kiev').format("DD-MM-YYYY HH:mm:ss"): Use the moment() method to obtain the current time, the format() method to define the desired format, and the tz() method to change the time zone to Europe/Kiev.

Hashing

• MD5

  require("libs/md5.js");
  data.md5 = CryptoJS.MD5(data.variable).toString();
  

  • data.variable: Task parameter that will be hashed.
  • data.md5: Task parameter that will store the hash.

• SHA-1

  require("libs/sha1.js");
  data.sha1 = CryptoJS.SHA1(data.variable).toString();
  

  • data.variable: Task parameter that will be hashed.
  • data.sha1: Task parameter that will store the hash.

• SHA-512

  require("libs/sha512.js"); 
  data.sha512 = CryptoJS.SHA512(data.variable).toString();
  

  • data.variable: Task parameter that will be hashed.
  • data.sha512: Task parameter that will store the hash.

• HMAC SHA-1

  require("libs/hmac-sha1.js");
  var hash = CryptoJS.HmacSHA1(data.message, data.secret);
  data.hashInHex = hash.toString(CryptoJS.enc.Hex);
  

  • data.message: Task parameter that will be hashed.
  • data.secret: Task parameter that stores the secret.
  • data.hashInHex: Task parameter that will store the hash as a hexadecimal string.

• HMAC SHA-256

  require("libs/hmac-sha256.js");
  var hash = CryptoJS.HmacSHA256(data.message, data.secret);
  data.hashInHex = hash.toString(CryptoJS.enc.Hex);
  

  • data.message: Task parameter that will be hashed.
  • data.secret: Task parameter that stores the secret.
  • data.hashInHex: Task parameter that will store the hash as a hexadecimal string.

Ciphers

• AES

  Encrypting

  require("libs/aes.js");
  data.encrypted = CryptoJS.AES.encrypt(data.message, data.password).toString();
  

  • data.message: Task parameter that will be encrypted.
  • data.password: Task parameter that contains the password.
  • data.encrypted: Task parameter that will store the encrypted string.

  Decrypting

  require("libs/aes.js");
  data.decrypted = CryptoJS.AES.decrypt(data.encrypted, data.password).toString(CryptoJS.enc.Utf8);
  

  • data.encrypted: Task parameter that will be decrypted.
  • data.password: Task parameter that contains the password.
  • data.decrypted: Task parameter that will store the decrypted string.

• DES

  Encrypting

  require("libs/tripledes.js");
  data.encrypted = CryptoJS.DES.encrypt(data.message, data.password).toString();
  

  • data.message: Task parameter that will be encrypted.
  • data.password: Task parameter that contains the password.
  • data.encrypted: Task parameter that will store the encrypted string.

  Decrypting

  require("libs/tripledes.js");
  data.decrypted = CryptoJS.DES.decrypt(data.encrypted, data.password).toString(CryptoJS.enc.Utf8);
  

  • data.encrypted: Task parameter that will be decrypted.
  • data.password: Task parameter that contains the password.
  • data.decrypted: Task parameter that will store the decrypted string.

• Triple DES

  Encrypting

  require("libs/tripledes.js");
  data.encrypted = CryptoJS.TripleDES.encrypt(data.message, data.password).toString();
  

  • data.message: Task parameter that will be encrypted.
  • data.password: Task parameter that contains the password.
  • data.encrypted: Task parameter that will store the encrypted string.

  Decrypting

  require("libs/tripledes.js");
  data.decrypted = CryptoJS.TripleDES.decrypt(data.encrypted, data.password).toString(CryptoJS.enc.Utf8);
  

  • data.encrypted: Task parameter that will be decrypted.
  • data.password: Task parameter that contains the password.
  • data.decrypted: Task parameter that will store the decrypted string.

• Rabbit
  Encrypting

  require("libs/rabbit.js");
  data.encrypted = CryptoJS.Rabbit.encrypt(data.message, data.password).toString();
  

  • data.message: Task parameter that will be encrypted.
  • data.password: Task parameter that contains the password.
  • data.encrypted: Task parameter that will store the encrypted string.

  Decrypting

  require("libs/rabbit.js");
  data.decrypted = CryptoJS.Rabbit.decrypt(data.encrypted, data.password).toString(CryptoJS.enc.Utf8);
  

  • data.encrypted: Task parameter that will be decrypted.
  • data.password: Task parameter that contains the password.
  • data.decrypted: Task parameter that will store the decrypted string.

• RC4
  Encrypting

  require("libs/rc4.js");
  data.encrypted = CryptoJS.RC4.encrypt(data.message, data.password).toString();
  

  • data.message: Task parameter that will be encrypted.
  • data.password: Task parameter that contains the password.
  • data.encrypted: Task parameter that will store the encrypted string.

  Decrypting

  require("libs/rc4.js");
  data.decrypted = CryptoJS.RC4.decrypt(data.encrypted, data.password).toString(CryptoJS.enc.Utf8);
  

  • data.encrypted: Task parameter that will be decrypted.
  • data.password: Task parameter that contains the password.
  • data.decrypted: Task parameter that will store the decrypted string.

Encoders

Base64

• Encoding

  require("libs/base64.js");
  var wordArray = CryptoJS.enc.Utf8.parse(data.variable);
  data.base64 = CryptoJS.enc.Base64.stringify(wordArray);
  

  • data.variable: Task parameter that will be encoded.
  • wordArray: Tocal variable that stores a wordArray representation of data.variable.
  • data.base64: Task parameter that will store the encoded string.

• Decoding

  require("libs/base64.js");
  var words = CryptoJS.enc.Base64.parse(data.base64);
  data.parsedStr = words.toString(CryptoJS.enc.Utf8);
  

  • data.base64: Task parameter that will be decoded.
  • words: Tocal variable that stores a wordArray representation of data.base64.
  • data.parsedStr: Task parameter that will store the decoded string.

Error handling & troubleshooting

When an error occurs in the Code node, a task goes to the auxiliary Condition output node that
is used for storing error parameters.

When an error occurs during the task processing, you may see the following error parameter names in the task.