{"id":6774,"date":"2024-03-11T03:44:03","date_gmt":"2024-03-11T02:44:03","guid":{"rendered":"https:\/\/help.expertsender.com\/emp\/managing-data-fields\/"},"modified":"2024-03-19T13:30:43","modified_gmt":"2024-03-19T12:30:43","slug":"managing-data-fields","status":"publish","type":"es","link":"https:\/\/help.expertsender.com\/pl\/emp\/managing-data-fields\/","title":{"rendered":"Managing data fields"},"content":{"rendered":"

Every Data Field to be used in a work\ufb02ow needs to be added by clicking the Manage data \ufb01elds<\/strong> button over the work\ufb02ow events toolbar:<\/p>\n

<\/p>\n

This opens the Manage Data Fields<\/em> dialog:<\/p>\n

<\/p>\n

To add a new data \ufb01eld, use the Add new record<\/strong> button.<\/p>\n

\n
\n

Important#<\/a><\/h3>\n

The name and type of Data Fields de\ufb01ned for a work\ufb02ow need to match the names and types used with the Custom events<\/em> API call<\/a> which initiates the work\ufb02ow for a subscriber. The API call also needs to provide the exact values for the Data Fields for every subscriber.<\/p>\n<\/div>\n<\/div>\n

Once de\ufb01ned, Data Fields can be used within the work\ufb02ow settings of the following elements: Start event<\/em> and Set data event<\/em>, API call<\/em>, Execute Code<\/em>, and Data switch<\/em>. The values of Data Fields may also be used for personalization within the content of email messages used in work\ufb02ows.<\/p>\n

To insert the value of a Data Field in email message content, an API call, or the Execute Code<\/em> element, use the following personalization tag format:<\/p>\n

*[wf_datafieldname]*<\/pre>\n
For example, the OrderID\u00a0<\/em>data \ufb01eld would utilize the following personalization tag:<\/p>\n
*[wf_OrderID]*<\/pre>\n
It is also possible to use the Data Fields with the Dynamic Content syntax<\/a>:<\/p>\n
${WorkflowDataField('datafieldname')}<\/pre>\n
For example, the OrderID\u00a0<\/em>data \ufb01eld would utilize the following Dynamic Content syntax:<\/p>\n
${WorkflowDataField('OrderID')}<\/pre>\n
In the Dynamic Content mode it is also possible to check, if a Data Field was set using the following function:<\/p>\n
WorkflowDataFieldExists('datafieldname')<\/pre>\n
For example, the OrderID\u00a0<\/em>data \ufb01eld can be checked using the following Dynamic Content syntax:<\/p>\n
WorkflowDataFieldExists('OrderID')<\/pre>\n
To set the value of a workflow data field, use the following code:<\/p>\n
SetWorkflowDataField('datafieldname',dataFieldValue)<\/span><\/span><\/pre>\n
Please refer to the API documentation<\/a> for more information about triggering custom events.<\/p>\n
ready_for_translation<\/p>\n","protected":false},"author":5,"featured_media":9339,"parent":0,"menu_order":148,"template":"","format":"standard","emp-category":[129],"class_list":["post-6774","es","type-es","status-publish","format-standard","has-post-thumbnail","hentry","emp-category-workflows"],"acf":[],"_links":{"self":[{"href":"https:\/\/help.expertsender.com\/pl\/wp-json\/wp\/v2\/es\/6774","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/help.expertsender.com\/pl\/wp-json\/wp\/v2\/es"}],"about":[{"href":"https:\/\/help.expertsender.com\/pl\/wp-json\/wp\/v2\/types\/es"}],"author":[{"embeddable":true,"href":"https:\/\/help.expertsender.com\/pl\/wp-json\/wp\/v2\/users\/5"}],"version-history":[{"count":2,"href":"https:\/\/help.expertsender.com\/pl\/wp-json\/wp\/v2\/es\/6774\/revisions"}],"predecessor-version":[{"id":9341,"href":"https:\/\/help.expertsender.com\/pl\/wp-json\/wp\/v2\/es\/6774\/revisions\/9341"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/help.expertsender.com\/pl\/wp-json\/wp\/v2\/media\/9339"}],"wp:attachment":[{"href":"https:\/\/help.expertsender.com\/pl\/wp-json\/wp\/v2\/media?parent=6774"}],"wp:term":[{"taxonomy":"emp-category","embeddable":true,"href":"https:\/\/help.expertsender.com\/pl\/wp-json\/wp\/v2\/emp-category?post=6774"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}