Java      

Java functions allow strong typing and are ideal for more structured automation.

Code your functions in Java and associate them with workflows, business rules, schedules, orchestrations, circuits, or have them as standalone functions.

Use Case: Currency Conversion Function 

This function converts amounts between currencies using live exchange rates from an external API. It helps automate quick financial calculations within workflows, avoiding manual conversions. For example, businesses can instantly convert an invoice in INR to its USD equivalent during transactions.

1. Reads the input parameters:

• from → Source currency (e.g., INR)
• to → Target currency (e.g., USD)
• amount → Amount to be converted (e.g., 100)

2. Validates the inputs:

• Ensures that all parameters are provided.
• Confirms that the amount is a valid number.

3. Connects to the exchange rate API:

• Retrieves the latest exchange rate for the given currencies.
• Handles cases where exchange rates are not available.

4. Calculates the converted value.
5. Returns the result in a clear format (e.g., 100 INR = 1.20 USD).

Sample Java Code Snippet

import com.zoho.cloud.function.Context;
import com.zoho.cloud.function.basic.*;

import java.io.BufferedReader;
import java.io.InputStreamReader;
import java.io.OutputStream;
import java.net.HttpURLConnection;
import java.net.URL;

import org.json.JSONObject;

public class Java_doc1 implements ZCFunction {

    public void runner(Context context, BasicIO basicIO) throws Exception {
        String from = (String) basicIO.getParameter("from");   
        String to = (String)  basicIO.getParameter("to");       
        String amountStr = (String) basicIO.getParameter("amount"); 

        if (from == null || to == null || amountStr == null) {
            basicIO.write("Missing parameters: 'from', 'to', or 'amount'.");
            return;
        }

        double amount;
        try {
            amount = Double.parseDouble(amountStr);
        } catch (NumberFormatException e) {
            basicIO.write("Invalid amount. Please enter a valid number.");
            return;
        }

        // Call exchange rate API
        String apiUrl = String.format("https://free.ratesdb.com/v1/rates?from=%s&to=%s", from, to);
        URL url = new URL(apiUrl);
        HttpURLConnection conn = (HttpURLConnection) url.openConnection();
        conn.setRequestMethod("GET");
        conn.setRequestProperty("User-Agent", "Java");

        int responseCode = conn.getResponseCode();
        if (responseCode != 200) {
            basicIO.write("Failed to fetch exchange rate. HTTP code: " + responseCode);
            return;
        }

        BufferedReader in = new BufferedReader(new InputStreamReader(conn.getInputStream()));
        String inputLine;
        StringBuffer responseData = new StringBuffer();
        while ((inputLine = in.readLine()) != null) {
            responseData.append(inputLine);
        }
        in.close();

        // Parse JSON response
        JSONObject json = new JSONObject(responseData.toString());
        JSONObject rates = json.getJSONObject("data").getJSONObject("rates");

        if (!rates.has(to)) {
            basicIO.write("Exchange rate not available for currency: " + to);
            return;
        }

        double rate = rates.getDouble(to);
        double convertedAmount = amount * rate;

        String result = String.format("%.2f %s = %.2f %s", amount, from, convertedAmount, to);
        basicIO.write(result);
    }
}

• config.json is a configuration file
• lib is the library to which you can upload your third-party packages. Right-click the folder to upload files.

• Only .jar files can be uploaded in the lib folder.

• Files up to 10 MB are only allowed.                                       
  

To pass the arguments of your function in the body, use the below code.   

Sample Input

{
  "from": "INR",
  "to": "USD",
  "amount": "100"
}

The function executes and displays the response in the console.

• You can upload only one zip file per function.
  

• The maximum allowed size of the zip file is 10MB.

Python 3 

Write your functions in Python and link them to workflows, business rules, schedules, and orchestrations, or use them as standalone logic. The code runs in a 3.9.16. version of the Python 3 environment. You should follow Python 3 syntax while using any features supported by Python 3.

Use Case: Password strength Checker 

This function evaluates the strength of a given password by checking its compliance with common security standards such as length, uppercase/lowercase letters, digits, and special characters.

How It Works:

1. The user inputs a password.

2. The function checks the following criteria:

• Minimum length of 8 characters

• At least one uppercase letter

• At least one lowercase letter

• At least one digit

• At least one special character (!@#$%^&*(),.?":{}|<>)

3. Based on the evaluation, it returns:

• Strong password if all conditions are met.

• Moderate password if some conditions are missing.

• Error message pointing out what is missing.

4. If the password is weak, the function suggests a randomly generated secure password.

Sample Python 3 Code Snippet

import re
import secrets
import string

def runner(context, basicIO):
    context.log.INFO("log")
    password = basicIO.getParameter("password");
    basicIO.write(check_password_strength(password));

def check_password_strength(password: str) -> None:
    strength = 0

    if len(password) >= 8:
        strength += 1
    else:
        return "Password should be at least 8 characters long."

    if re.search(r'[A-Z]', password):
        strength += 1
    else:
        return "Password should include at least one uppercase letter."

    if re.search(r'[a-z]', password):
        strength += 1
    else:
        return "Password should include at least one lowercase letter."

    if re.search(r'\d', password):
        strength += 1
    else:
        return "Password should include at least one digit."

    if re.search(r'[!@#$%^&*(),.?":{}|<>]', password):
        strength += 1
    else:
        return "Password should include at least one special character (!@#$%^&*(),.?\":{}|<>)"

    if strength == 5:
        return "Strong password!"
    elif 3 <= strength < 5:
        return "Moderate password. Try to include all types of characters."
    else:
        basicIO.write("Weak password. Consider using a stronger one.")
        suggestion = generate_secure_password()
        basicIo.write(f"Suggested strong password: {suggestion}")

def generate_secure_password(length: int = 12) -> str:
    characters = string.ascii_letters + string.digits + "!@#$%^&*()?"
    return ''.join(secrets.choice(characters) for _ in range(length))

if __name__ == "__main__":
    pwd = input("Enter a password to check its strength: ")
    check_password_strength(pwd)

Packaged Files:

Qntrl automatically packages your Python function and creates config.json and library files.

In the left panel, you can view the config.json and lib files.

• config.json is a configuration file

• lib is the library to which you can upload your third-party packages. Right-click the folder to upload files.

Specify the values of the following keys:

• path: The .js file path that contains the function code.

• action: Contains the action that your code performs. This is also the name of the main class in your .js file.

• connector: Contains the name of the connection that your function calls, if any.

Use the code below to pass the arguments of your function in the body.

Sample Input

"password": "sweri025377A"