Custom functions are user-defined functions that allow you to extend the functionality of TIBCO BusinessWorks. These functions can be created in Java and can be used in any BusinessWorks process to perform a specific task or to manipulate data.
Here are some key characteristics of TIBCO BusinessWorks custom functions:
- Reusability: Custom functions can be reused across multiple projects, reducing the need to create the same functionality multiple times.
- Extensibility: Custom functions can be extended to meet specific business requirements by adding new functionality.
- Configurability: Custom functions can be configured to accept input parameters and to produce output parameters that can be used in other parts of the process.
- Scalability: Custom functions can be used in high-volume environments to handle large amounts of data.
- Maintenance: Custom functions can be maintained independently of the main BusinessWorks application, making it easier to fix bugs or add new features.
Overall, TIBCO BusinessWorks custom functions provide a flexible and powerful way to extend the capabilities of the platform and to create custom integration solutions that meet specific business needs.
This section provides an overview of the available custom functions and explains how to use them in your integration projects.
We will present the purpose and functionality of each custom function, and provide examples of how they can be used in a BusinessWorks process.
By the end of this section, you should have a clear understanding of the available custom functions and how to use them effectively to meet your integration needs.
-
Custom calendar function for validating workdays and Brazilian national holidays, based on the Febraban calendar available at https://feriadosbancarios.febraban.org.br/.
-
Description: Returns a JSON string containing information about a holiday based on the provided date.
Template: getHoliday(<< date >>)
Return Type: JSON StringInput: ns:getHoliday("25/12/2024") Return: {"date":"25/12/2024","dayOfWeek":"quarta-feira","description":"Natal"} -
Description: Returns a JSON string containing information about a holiday based on the provided date.
Template: getHoliday(<< year >>)
Return Type: JSON StringInput: ns:getHolidays("2023") Return: {"holiday":[{"date":"01/01/2023","dayOfWeek":"domingo","description":"Ano Novo"},{"date":"20/02/2023","dayOfWeek":"segunda-feira","description":"Segunda-Feira de Carnaval"}, ... {"date":"25/12/2023","dayOfWeek":"segunda-feira","description":"Natal"}]} -
Description: This function takes a date as input and returns the next working day. If the input date is already a working day, the function returns that date.
Template: getWorkday(<< date >>)
Return Type: JSON StringInput: ns:getHoliday("25/12/2022") Return: {"date":"25/12/2022","dayOfWeek":"domingo","description":"Natal","workday":"26/12/2022","workdayOfWeek":"segunda-feira"}Input: ns:getWorkday("25/03/2023") Return: {"date":"25/03/2023","dayOfWeek":"sábado","workday":"27/03/2023","workdayOfWeek":"segunda-feira"}Input: ns:getWorkday("02/01/2025") Return: {"date":"02/01/2025","dayOfWeek":"quinta-feira"}
-
-
Custom-built functions for manipulating dates and times.
-
Description: Retrieves the day number within a year for a given date.
Template: extractDayOfYear(<< date >>)
Return Type: integerInput: ns:extractDayOfYear("2023-12-31") Return: 365 -
Description: Retrieves the week number within a year for a given date.
Template: extractWeekOfYear(<< date >>)
Return Type: integerInput: dt:extractWeekOfYear("2023-12-31") Return: 53 -
Description: Convert from Epoch to Human Readable Date.
Template: epochToHumanReadable(<< timestamp >>)
Return Type: stringInput: ns:epochToHumanReadable("1679332277") Return: 2023-03-20T14:11:17.017-03:0 -
Description: Convert a readable date format to an Epoch timestamp.
Template: humanReadableToEpoch(<< datetime >>)
Return Type: stringInput: ns:humanReadableToEpoch("2023-03-20T14:11:17.017-03:00") Return: 1679332277
-
-
Custom-built functions for manipulating strings.
-
Description: Obtain the line count for a given string.
Template: countLines(<< string-text >>)
Return Type: integerInput: ns:countLines("first line. second line.") Return: 2 -
Description: Obtain the words count for a given string.
Template: countWords(<< string-text >>)
Return Type: integerInput: ns:countWords("word1 word2 word3 word4") Return: 4 -
Description: Takes a string and formats it based on a given mask.
Template: maskFormatter(<< string-text >>, << mask >>)
Return Type: stringInput: ns:maskFormatter("999999999", "+55 11 #####-####") Return: +55 11 99999-9999 -
Description: Cleans a string by removing all non-alphanumeric characters and keeping only letters and numbers.
Template: normalizeText(<< string-text >>)
Return Type: stringInput: ns:normalizeText("a|b-c*d%e$f&g") Return: abcdefg -
Description: Convert accented characters to non-accented characters in a string.
Template: removeAccents(<< string-text >>)
Return Type: stringInput: ns:removeAccents("áàâãç") Return: aaac -
Description: Returns a string produced from the input string by replacing any substrings that match a given regular expression with a supplied replacement string.
Template: replace(<< input >>, << pattern >>, << replacement >>)
Return Type: stringInput: ns:replace("abc 456", "456", "def") Return: abc defInput: ns:replace("useraccount@gmail.com", "(?<=.)[^@\n](?=[^@\n]*?[^@\n]@)|(?:(?<=@.)|(?!^)\G(?=[^@\n]*$))[^.](?!\.)", "*") Return: u*********t@g***l.com -
Description: Takes a string as an input and returns a new string with the characters in the original string reversed.
Template: reverseString(<< string-text >>)
Return Type: stringInput: ns:reverseString("all you need is love") Return: evol si deen uoy lla -
Description: Returns a string constructed by concatenating all the strings in a sequence (each values separated by space), using the second argument as a separator.
Template: stringJoin(<< values >>, << separator >>)
Return Type: stringInput: ns:stringJoin("value1 value2 value3", " | ") Return: value1 | value2 | value3 -
Description: Generate universally unique identifier (UUID) v.4.
Template: uuid()
Return Type: stringInput: ns:uuid() Return: f1895673-2727-4646-9cb2-bfaf1ba9cedf
-
-
Use the TIBCO TIBCrypt library to obfuscate or deobfuscate a string or obfuscated string.
-
Description: Decrypt TIBCrypt-obfuscated password and return plain text.
Template: deObfuscate(<< obfuscate-string >>)
Return Type: stringInput: deObfuscate("#!LHdMPBLQvn2RcQatS3PefpPCe14qaeO+") Return: P4ssw0rd -
Description: Encrypt plain text and return TIBCrypt-obfuscated string.
Template: obfuscate(<< string >>)
Return Type: stringInput: deObfuscate("P4ssw0rd") Return: #!LHdMPBLQvn2RcQatS3PefpPCe14qaeO+
-
🚧 Under Construction
🚧 Under Construction
Copyright (c) 2023 jgimenes
Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.