{"id":3934,"date":"2023-09-22T07:20:35","date_gmt":"2023-09-22T06:20:35","guid":{"rendered":"https:\/\/help.expertsender.com\/?post_type=es&p=3934"},"modified":"2024-03-19T13:25:36","modified_gmt":"2024-03-19T12:25:36","slug":"setting-workflow-data-field-value","status":"publish","type":"es","link":"https:\/\/help.expertsender.com\/pl\/emp\/dynamic-content\/handling-workflow-data-fields\/setting-workflow-data-field-value\/","title":{"rendered":"Setting workflow data field value"},"content":{"rendered":"\n

Dynamic Content can be used to automatically change value of data field in workflow for currently processed subscriber, using SetWorkflowDataField method.<\/p>\n\n\n\n

Note that this method can be used only inside workflows (workflow messages, api call element, execute code element).<\/p>\n\n\n\n

Method signature:<\/p>\n\n\n\n

<\/path><\/path><\/svg><\/span>
SetWorkflowDataField<\/span>(name<\/span>,<\/span> value)<\/span><\/span><\/code><\/pre><\/div>\n\n\n\n
name parameter is name of data field.<\/p>\n\n\n\n
value parameter is new value of data field which will be set for subscriber.<\/p>\n\n\n\n
Method always returns empty string.<\/p>\n\n\n\n
value parameter will accept any object, but it is important to set appropriate value, depending on data field type. See examples below for different types of data fields.<\/p>\n\n\n\n
Boolean properties:<\/p>\n\n\n\n
<\/path><\/path><\/svg><\/span>
$<\/span>{<\/span>SetWorkflowDataField<\/span>(<\/span>'<\/span>some_boolean<\/span>'<\/span>,<\/span> <\/span>true<\/span>)<\/span>}<\/span><\/span>\n$<\/span>{<\/span>SetWorkflowDataField<\/span>(<\/span>'<\/span>some_boolean<\/span>'<\/span>,<\/span> <\/span>false<\/span>)<\/span>}<\/span><\/span><\/code><\/pre><\/div>\n\n\n\n
Text properties:<\/p>\n\n\n\n
<\/path><\/path><\/svg><\/span>
$<\/span>{<\/span>SetWorkflowDataField<\/span>(<\/span>'<\/span>some_text<\/span>'<\/span>,<\/span> <\/span>'<\/span>foobar<\/span>'<\/span>)<\/span>}<\/span><\/span><\/code><\/pre><\/div>\n\n\n\n
Number properties:<\/p>\n\n\n\n
<\/path><\/path><\/svg><\/span>
$<\/span>{<\/span>SetWorkflowDataField<\/span>(<\/span>'<\/span>some_number<\/span>'<\/span>,<\/span> <\/span>123<\/span>)<\/span>}<\/span><\/span><\/code><\/pre><\/div>\n\n\n\n
Date and DateTime properties:<\/p>\n\n\n\n
<\/path><\/path><\/svg><\/span>
$<\/span>{<\/span>SetWorkflowDataField<\/span>(<\/span>'<\/span>some_date<\/span>'<\/span>,<\/span> <\/span>'<\/span>2013-12-02<\/span>'<\/span>)<\/span>}<\/span><\/span>\n$<\/span>{<\/span>SetWorkflowDataField<\/span>(<\/span>'<\/span>some_datetime<\/span>'<\/span>,<\/span> <\/span>'<\/span>2013-12-02 10:15:00<\/span>'<\/span>)<\/span>}<\/span><\/span>\n$<\/span>{<\/span>SetWorkflowDataField<\/span>(<\/span>'<\/span>some_date<\/span>'<\/span>,<\/span> <\/span>new<\/span> <\/span>System<\/span>.<\/span>DateTime<\/span>(<\/span>2013<\/span>,<\/span> <\/span>12<\/span>,<\/span> <\/span>2<\/span>)<\/span>.<\/span>Date<\/span>)<\/span>}<\/span><\/span>\n$<\/span>{<\/span>SetWorkflowDataField<\/span>(<\/span>'<\/span>some_datetime<\/span>'<\/span>,<\/span> <\/span>new<\/span> <\/span>System<\/span>.<\/span>DateTime<\/span>(<\/span>2013<\/span>,<\/span> <\/span>12<\/span>,<\/span> <\/span>2<\/span>,<\/span> <\/span>10<\/span>,<\/span> <\/span>15<\/span>,<\/span> <\/span>0<\/span>))<\/span>}<\/span><\/span><\/code><\/pre><\/div>\n\n\n\n
NOTE: For convenience, it is possible to provide date\/datetime as a string, but it is required to use sortable (ISO) format: YYYY-MM-DD hh:mm:ss.<\/p>\n\n\n\n
All dates are treated as dates in business unit’s timezone.<\/p>\n","protected":false},"author":5,"featured_media":0,"parent":3928,"menu_order":199,"template":"","format":"standard","emp-category":[],"class_list":["post-3934","es","type-es","status-publish","format-standard","hentry"],"acf":[],"_links":{"self":[{"href":"https:\/\/help.expertsender.com\/pl\/wp-json\/wp\/v2\/es\/3934","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\/3934\/revisions"}],"predecessor-version":[{"id":8891,"href":"https:\/\/help.expertsender.com\/pl\/wp-json\/wp\/v2\/es\/3934\/revisions\/8891"}],"up":[{"embeddable":true,"href":"https:\/\/help.expertsender.com\/pl\/wp-json\/wp\/v2\/es\/3928"}],"wp:attachment":[{"href":"https:\/\/help.expertsender.com\/pl\/wp-json\/wp\/v2\/media?parent=3934"}],"wp:term":[{"taxonomy":"emp-category","embeddable":true,"href":"https:\/\/help.expertsender.com\/pl\/wp-json\/wp\/v2\/emp-category?post=3934"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}