Section | |||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
...
- Method 1 - Add JavaScript to the custom.js file then upload it into your application.
- Method 2 - Add a Message Control that contains your JavaScript.
- Method 3 - Add JavaScript to the include.js file located inside the frevvo war.
Method 1
...
Upload your custom JavaScript to via the Scripts tab on the left menu inside your application. Follow these steps:
Your custom JavaScript must contain the comment // frevvo custom JavaScript as the first line of the file or the upload will not be successful. Here is an example of code that will add dashes to a Social Security number control as the user is typing it in. See Custom JavaScript Examples for information on this sample code. Notice the JavaScript comment is the first line in the script file.
Login to as a designer user. Click the Edit icon for the application where you want to use the JavaScript. Click on the Script tab located on the left menu.
Browse your hard drive for you script file, Click Upload. Your file will be uploaded and it will display with the name Custom Script even though your script file may have another name. Be Aware that existing JavaScript files will be overwritten...
If you need to modify the script, you must download it, make your modifications and then upload it again. When you download the script by clicking on the Download icon, it will be named custom.js.
Clicking on the Documentation icon brings you here.
Once you have uploaded the JavaScript, it is available for all forms/flows in the application. Remember to add the CSS class name to your form controls or your JavaScript may not work. Here is an image of an Employee Information form using an uploaded JavaScript to enter dashes in the Social Security Number field while the user is entering the data.
...
Tip |
---|
If your JavaScript does not behave as expected after upgrading your version of , it may be caused by a scrubbing of the custom.js file content by XSS protection. You may notice that all your code is on a single commented out line upon Inspection of the custom.js file. Upload an "unsrubbed" version of your custom.js file to solve the issue. In-house customers should refer to the Uploaded Custom JavaScript for Forms/Flows topic if you are planning an upgrade. |
Method 2
Follow these steps to add JavaScript to your form using the Message control:
...
Code Block |
---|
<script> /* <![CDATA[ */ code goes here /* ]]> */ </script> |
Method 3
...
Add JavaScript to the WEB-INF/rules/includes.js file located in the <frevvo-home>\tomcat\webapps\frevvo.war. Includes.js is only for including javascript into rules that run server-side. The contents of this file are included in the Rule Execution when the context initializes.
...
Here is an example of a snippet of code when added to the include.js will allow you to do something like this in a rule: DateControl?.value =MyUtil?.today();
Code Block |
---|
var MyUtil = { today: function() { var d = new Date(); var dd = d.getDate(); if (dd < 10) dd = '0' + dd; var mm = d.getMonth() + 1; if (mm < 10) mm = '0' + mm; var yyyy = d.getFullYear(); return String(mm + "-" + dd + "-" + yyyy); } } |
If you wish to inject client-side script, the only option is to append your javascript into one of the minified js files in the frevvo.war. form.pack.js is one such file and can be found iafter after unzipping the frevvo.war in the /js-revision folder (revision being the 5-digit revision number of your build).
...