Page tree

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 6 Next »

This is the documentation for ConfiForms Server/Data Center app

However, this might also work for ConfiForms cloud and in most cases it does. But please see this page to understand the differences between server and cloud versions of the ConfiForms app.


In order to make it easier to integrate with other external systems, such as JIRA, for example, we have implemented so called "virtual" functions, what you can call on field values.

The notation would be: [entry.fieldname.virtual_function]

 

Useful, when you try to prepare a JSON or some other format when used together with IFTTT macro to enable integrations with other systems


As of now, the following functions are supported:

functiondescriptionexample
urlencode

Does URL encode on given value, see "urlEncode" method in

https://developer.atlassian.com/static/javadoc/confluence/4.0/reference/com/atlassian/confluence/util/GeneralUtil.html

[entry.myfield.urlencode]
escapeXML

Escapes XML on given value, see "escapeXml" method in

https://developer.atlassian.com/static/javadoc/confluence/4.0/reference/com/atlassian/confluence/util/GeneralUtil.html

 
escape

Escapes string as in "escapeForHtmlAttribute" method in

https://developer.atlassian.com/static/javadoc/confluence/4.0/reference/com/atlassian/confluence/util/GeneralUtil.html

 
formatDateTries to format date fields in the specified format, expects date format as in http://docs.oracle.com/javase/7/docs/api/java/text/SimpleDateFormat.html

[entry.myfield.formatDate(JAVA_FORMAT)]

(no quotes)

jiraDateSame as "formatDate" method above, but specifies constant dateformat pattern (yyyy-MM-dd), suitable for JIRA REST API[entry.myfield.jiraDate]
escapeJSONEscapes illegal characters in the field value to generate a valid JSON property. New lines, quotes, tabs and etc will be properly escaped[entry.myfield.escapeJSON]
asArray

Tries to create an array from the value. Useful when you want to pass ConfiForms multi-select values to JIRA. Something like

"customfield_XXXX" : [[entry.myfield.asArray]]

where "myfield" is a multi-select field type

There are variations to support other multi-select fields in JIRA

https://developer.atlassian.com/jiradev/jira-apis/jira-rest-apis/jira-rest-api-tutorials/jira-rest-api-example-create-issue#JIRARESTAPIExample-CreateIssue-MultiSelect

  • asArrayMultiSelect
  • asArrayMultiUserPicker
  • asArrayMultiGroupPicker

 

Let us know if something you want to use is missing

[entry.myfield.asArray]

If entry value is null or could not be formatted according to rules then value is returned as-is 

 

 

  • No labels