Fields and validation

The JSON configurations below can be pasted into the editor via the Import/Export popup.

Copy field to another field

This example will copy the LastName to the FirstName of a Person but only if the LastName has changed and it is not empty.

Steps:

  • Check if LastName is changed. Link output 1 because we want to check if changed = true.
  • Check if LastName is not empty. Link output 2 because we want to check if empty = false.
  • Get value of LastName field.
  • Set Value of FirstName field.

Corresponding configuration:

{"drawflow":{"Home":{"data":{"15":{"typenode":false,"outputs":{"output_1":{"connections":[{"output":"input_1","node":"19"}]}},"pos_y":199,"pos_x":26,"data":{"checksum":"1649a6c885bae2e98172410550fd3f9270642e134ab65ad3c0a69a55b970572e","basebo":"Person","confversion":"726","appversion":"2.10.0","solutiontype":"SX","undefined":"Person"},"inputs":{},"name":"Start of flow","html":"","id":15,"class":"start"},"17":{"typenode":false,"outputs":{"output_1":{"connections":[{"output":"input_1","node":"18"}]}},"pos_y":350,"pos_x":909,"data":{"elementname":"LastName","dataobject":"Target"},"inputs":{"input_1":{"connections":[{"node":"20","input":"output_2"}]}},"name":"Get field value (Static)","html":"","id":17,"class":"planonsoftware.apps.configurablebusinessrule.logic.functions.implementations.element.GetElementStatic"},"18":{"typenode":false,"outputs":{"output_1":{"connections":[]}},"pos_y":325,"pos_x":1198,"data":{"elementname":"FirstName","dataobject":"Target"},"inputs":{"input_1":{"connections":[{"node":"17","input":"output_1"}]}},"name":"Set field value","html":"","id":18,"class":"planonsoftware.apps.configurablebusinessrule.logic.functions.implementations.element.SetElement"},"19":{"typenode":false,"outputs":{"output_2":{"connections":[]},"output_1":{"connections":[{"output":"input_1","node":"20"}]}},"pos_y":321,"pos_x":312,"data":{"elementname":"LastName","dataobject":"Target"},"inputs":{"input_1":{"connections":[{"node":"15","input":"output_1"}]}},"name":"Field changed (ITE)","html":"","id":19,"class":"planonsoftware.apps.configurablebusinessrule.logic.functions.implementations.element.ElementChangedStaticIfThenElse"},"20":{"typenode":false,"outputs":{"output_2":{"connections":[{"output":"input_1","node":"17"}]},"output_1":{"connections":[]}},"pos_y":321,"pos_x":606,"data":{"elementname":"LastName","dataobject":"Target"},"inputs":{"input_1":{"connections":[{"node":"19","input":"output_1"}]}},"name":"Field empty (ITE)","html":"","id":20,"class":"planonsoftware.apps.configurablebusinessrule.logic.functions.implementations.element.ElementEmptyStaticIfThenElse"}}}}}

Copy field to another field (Convenience function)

Because the previous example needs 4 steps, it would be very laborious to do this on every copy.

A more intelligent convenience function is created to solve this. It includes all the steps from Copy field to another field and has some more options to check.

Corresponding configuration:

{"drawflow":{"Home":{"data":{"15":{"typenode":false,"outputs":{"output_1":{"connections":[{"output":"input_1","node":"21"}]}},"pos_y":199,"pos_x":26,"data":{"checksum":"011902fab020ddac16b63b08fb2ea0cef468a256e66e0ca62ea1b257b732bb86","basebo":"Person","confversion":"727","appversion":"2.10.0","solutiontype":"SX","undefined":"Person"},"inputs":{},"name":"Start of flow","html":"","id":15,"class":"start"},"21":{"typenode":false,"outputs":{"output_1":{"connections":[]}},"pos_y":237,"pos_x":323,"data":{"targetelementname":"FirstName","elementname":"LastName","targetdataobject":"Target","dataobject":"Target","sourcenotempty":"true","sourcechanged":"true"},"inputs":{"input_1":{"connections":[{"node":"15","input":"output_1"}]}},"name":"Copy value of field","html":"","id":21,"class":"planonsoftware.apps.configurablebusinessrule.logic.functions.implementations.element.CopyElement"}}}}}

This example will copy the name of the linked property to the FirstName of the person. The same Copy value of field can be used. Via the referencefield the property can be fetched and with the . (dot) notation the field of that property can be read.

Corresponding configuration:

{"drawflow":{"Home":{"data":{"15":{"typenode":false,"outputs":{"output_1":{"connections":[{"output":"input_1","node":"16"}]}},"pos_y":199,"pos_x":26,"data":{"checksum":"39ecb88e9248312e8818102dbdb4323171774b8a2278a96b1cf808cad7e9f89c","basebo":"Person","confversion":"728","appversion":"2.10.0","solutiontype":"SX","undefined":"Person"},"inputs":{},"name":"Start of flow","html":"","id":15,"class":"start"},"16":{"typenode":false,"outputs":{"output_1":{"connections":[]}},"pos_y":239,"pos_x":374,"data":{"targetelementname":"FirstName","elementname":"PropertyRef.Name","targetdataobject":"Target","dataobject":"Target","sourcenotempty":"true","sourcechanged":"false"},"inputs":{"input_1":{"connections":[{"node":"15","input":"output_1"}]}},"name":"Copy value of field","html":"","id":16,"class":"planonsoftware.apps.configurablebusinessrule.logic.functions.implementations.element.CopyElement"}}}}}

Construct email address

This example will construct the email address based on the FirstName and LastName and saves it to the email field.

Corresponding configuration:

{"drawflow":{"Home":{"data":{"15":{"typenode":false,"outputs":{"output_1":{"connections":[{"output":"input_1","node":"22"},{"output":"input_1","node":"23"}]}},"pos_y":191,"pos_x":20,"data":{"checksum":"d8727aedef454c7f0a2f25f3c9cd2c587c0c586dae290ce9b20e1c37bf7da30f","basebo":"Person","confversion":"729","appversion":"2.10.0","solutiontype":"SX","undefined":"Person"},"inputs":{},"name":"Start of flow","html":"","id":15,"class":"start"},"22":{"typenode":false,"outputs":{"output_1":{"connections":[{"output":"input_1","node":"24"}]}},"pos_y":192.33333333333334,"pos_x":386,"data":{"elementname":"FirstName","dataobject":"Target"},"inputs":{"input_1":{"connections":[{"node":"15","input":"output_1"}]}},"name":"Get field value (Static)","html":"","id":22,"class":"planonsoftware.apps.configurablebusinessrule.logic.functions.implementations.element.GetElementStatic"},"23":{"typenode":false,"outputs":{"output_1":{"connections":[{"output":"input_1","node":"24"}]}},"pos_y":479,"pos_x":384,"data":{"elementname":"LastName","dataobject":"Target"},"inputs":{"input_1":{"connections":[{"node":"15","input":"output_1"}]}},"name":"Get field value (Static)","html":"","id":23,"class":"planonsoftware.apps.configurablebusinessrule.logic.functions.implementations.element.GetElementStatic"},"24":{"typenode":false,"outputs":{"output_1":{"connections":[{"output":"input_1","node":"25"}]}},"pos_y":307,"pos_x":709,"data":{"message":"%s.%s@planonsoftware.com"},"inputs":{"input_1":{"connections":[{"node":"22","input":"output_1"},{"node":"23","input":"output_1"}]},"input_2":{"connections":[]}},"name":"Format string","html":"","id":24,"class":"planonsoftware.apps.configurablebusinessrule.logic.functions.implementations.string.Format"},"25":{"typenode":false,"outputs":{"output_1":{"connections":[]}},"pos_y":318,"pos_x":1029,"data":{"elementname":"Email","dataobject":"Target"},"inputs":{"input_1":{"connections":[{"node":"24","input":"output_1"}]}},"name":"Set field value","html":"","id":25,"class":"planonsoftware.apps.configurablebusinessrule.logic.functions.implementations.element.SetElement"}}}}}

Check postalcode

This example will check if the provided postalcode is valid on a property.

Steps:

  • Get PostalCode field value
  • Match value with regular expression ^[1-9][0-9]{3} ?(?!sa|sd|ss|SA|SD|SS)[A-Za-z]{2}$. When not matched output 2 will be executed.
  • Show an error Postal code is not valid. For Dutch users a Dutch message “Postcode is niet juist” will be shown.

<img src="../../media/image60.png width=“75%”"/>

Corresponding configuration:

{"drawflow":{"Home":{"data":{"15":{"typenode":false,"outputs":{"output_1":{"connections":[{"output":"input_1","node":"29"}]}},"pos_y":191,"pos_x":20,"data":{"checksum":"3e631fd66453527aea81cb8f17431ab380951242ff52953f2da055e728495e0d","basebo":"Property","confversion":"730","appversion":"2.10.0","solutiontype":"SX","undefined":"Property"},"inputs":{},"name":"Start of flow","html":"","id":15,"class":"start"},"28":{"typenode":false,"outputs":{"output_2":{"connections":[{"output":"input_1","node":"30"}]},"output_1":{"connections":[]}},"pos_y":323,"pos_x":627,"data":{"regex":"^[1-9][0-9]{3} ?(?!sa|sd|ss|SA|SD|SS)[A-Za-z]{2}$"},"inputs":{"input_1":{"connections":[{"node":"29","input":"output_1"}]}},"name":"MatchRegEx (ITE)","html":"","id":28,"class":"planonsoftware.apps.configurablebusinessrule.logic.functions.implementations.comparison.MatchRegExIfThenElse"},"29":{"typenode":false,"outputs":{"output_1":{"connections":[{"output":"input_1","node":"28"}]}},"pos_y":339,"pos_x":323,"data":{"elementname":"PostalCode","dataobject":"Target"},"inputs":{"input_1":{"connections":[{"node":"15","input":"output_1"}]}},"name":"Get field value (Static)","html":"","id":29,"class":"planonsoftware.apps.configurablebusinessrule.logic.functions.implementations.element.GetElementStatic"},"30":{"typenode":false,"outputs":{},"pos_y":330,"pos_x":957,"data":{"errorid":"5929","message":"Postal code is not valid.","langnld":"Postcode is niet juist"},"inputs":{"input_1":{"connections":[{"node":"28","input":"output_2"}]}},"name":"Show error","html":"","id":30,"class":"planonsoftware.apps.configurablebusinessrule.logic.functions.implementations.notification.ErrorMessage"}}}}}