{"id":5181,"date":"2023-03-07T09:32:45","date_gmt":"2023-03-07T09:32:45","guid":{"rendered":"https:\/\/info.documotor.com\/?page_id=5181"},"modified":"2023-03-07T09:32:45","modified_gmt":"2023-03-07T09:32:45","slug":"custom-functions-new-ui","status":"publish","type":"page","link":"https:\/\/info.documotor.com\/?page_id=5181","title":{"rendered":"Custom Functions (New UI)"},"content":{"rendered":"\n

In DocuMotor it is possible to define custom functions. These custom functions apply the transformations defined. This guide will describe how a custom function is configured.<\/p>\n\n\n\n

It is possible to use custom functions in other transformations e.g. in Templates. When calling a custom function it is required to use #<\/code> in front of the function name. For example if a function is named fullName<\/code> it should be refered in the transformations as #fullName()<\/code>.<\/p>\n\n\n\n

The view is split into two panes, the function pane and the testing pane. The function pane, on the left, contains all functionality for the custom function itself. That is the parameters and the function transformation. The right pane, the testing pane, contains three text editors for testing if the custom function works. <\/p>\n\n\n\n

\"\"<\/figure>\n\n\n\n

The Function Pane<\/h3>\n\n\n\n

Parameters<\/h4>\n\n\n\n

To be able to pass on parameters to the custom function it is required to define the parameters in the top of the function pane. To create a parameter the user clicks the plus button to the right of the Parameters<\/strong> label. Each parameter needs a name that should be used when writing the function\u2019s transformation in the text editor below.<\/p>\n\n\n\n

\"\"<\/figure><\/div>\n\n\n\n

By Value vs By Expression<\/strong><\/p>\n\n\n\n

A parameter can either be passed as by value<\/strong> or by expression<\/strong>. When a parameter is passed by value, it is evaluated when the function is called and the result is passed to the function. When a parameter is passed by expression it is not immediately evaluated on function call and instead evaluated in the scope where it is read in the function body. To pass a parameter by value, the ByValue<\/strong> label in the parameter should be turned on, which it is if it is purple. To pass a parameter by expression the user can toggle the ByValue <\/strong>label by clicking it and it will turn grey meaning that ByValue<\/strong> is turned off. ByValue<\/strong> is always turned on by default. <\/p>\n\n\n\n

\"\"<\/figure><\/div>\n\n\n\n

Function Transformation<\/h4>\n\n\n\n

Below the parameters is a text editor where the JMES tranformation, that the custom function applies, is configured. This transformation should refer to the parameters defined above the text editor, if there is any. To refer to parameters, a #<\/code> is put in from of the parameter name.<\/p>\n\n\n\n

\"\"<\/figure><\/div>\n\n\n\n

The Testing Pane<\/h3>\n\n\n\n

Sample Data<\/h4>\n\n\n\n

The Sample Data<\/strong> text editor should contain an example of some sample data to test how to use data variables when calling the custom function.<\/p>\n\n\n\n

\"\"<\/figure><\/div>\n\n\n\n

Sample Transformation<\/h4>\n\n\n\n

The Sample Transformation<\/strong> text editor is used to test how to call the custom function. It is both possible to use hardcoded parameters or parameters from the Sample Data<\/strong> text editor. Below is an example of how to test call the function with both hardcoded parameters and parameters from the Sample Data<\/strong>.<\/p>\n\n\n\n

\"\"<\/figure><\/div>\n\n\n\n

Sample Result<\/h4>\n\n\n\n

The Sample Result<\/strong> shows the output from the Function Transformation<\/strong> in relation to how the Sample Transformation<\/strong> calls the function with hardcoded data or the Sample Data<\/strong>. The result of the above examples would look like this:<\/p>\n\n\n\n

\"\"<\/figure><\/div>\n","protected":false},"excerpt":{"rendered":"

In DocuMotor it is possible to define custom functions. These custom functions apply the transformations defined. This guide will describe how a custom function is configured. It is possible to use custom functions in other transformations e.g. in Templates. When calling a custom function it is required to use # in front of the function name. For […]<\/p>\n","protected":false},"author":17,"featured_media":0,"parent":3160,"menu_order":6,"comment_status":"closed","ping_status":"closed","template":"","meta":[],"_links":{"self":[{"href":"https:\/\/info.documotor.com\/index.php?rest_route=\/wp\/v2\/pages\/5181"}],"collection":[{"href":"https:\/\/info.documotor.com\/index.php?rest_route=\/wp\/v2\/pages"}],"about":[{"href":"https:\/\/info.documotor.com\/index.php?rest_route=\/wp\/v2\/types\/page"}],"author":[{"embeddable":true,"href":"https:\/\/info.documotor.com\/index.php?rest_route=\/wp\/v2\/users\/17"}],"replies":[{"embeddable":true,"href":"https:\/\/info.documotor.com\/index.php?rest_route=%2Fwp%2Fv2%2Fcomments&post=5181"}],"version-history":[{"count":16,"href":"https:\/\/info.documotor.com\/index.php?rest_route=\/wp\/v2\/pages\/5181\/revisions"}],"predecessor-version":[{"id":5247,"href":"https:\/\/info.documotor.com\/index.php?rest_route=\/wp\/v2\/pages\/5181\/revisions\/5247"}],"up":[{"embeddable":true,"href":"https:\/\/info.documotor.com\/index.php?rest_route=\/wp\/v2\/pages\/3160"}],"wp:attachment":[{"href":"https:\/\/info.documotor.com\/index.php?rest_route=%2Fwp%2Fv2%2Fmedia&parent=5181"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}