{"id":1886,"date":"2022-07-08T13:16:40","date_gmt":"2022-07-08T13:16:40","guid":{"rendered":"https:\/\/logicbuilder.integroscrm.com\/help\/?page_id=1886"},"modified":"2022-07-08T15:24:08","modified_gmt":"2022-07-08T15:24:08","slug":"email-addresses","status":"publish","type":"page","link":"https:\/\/logicbuilder.integroscrm.com\/help\/email-addresses\/","title":{"rendered":"Email Addresses"},"content":{"rendered":"\n

Release date: 2021-11-06<\/span><\/p>\n\n\n\n

Cast to Entity<\/b><\/span><\/p>\n\n\n\n

Introducing a new operator Cast to Entity<\/span><\/strong> which allows you to create an Entity from the JSON or make your flowchart even more readable by putting Entity to the Variables and then reading it with Cast to Entity<\/span><\/strong><\/p>\n\n\n\n

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

Example of usage: <\/strong><\/p>\n\n\n\n

1. Creating Entity from the JSON <\/p>\n\n\n\n

For example, there is a JSON that describes an object in a similar way as Sugar Entity structure. Instead of operators Create Entity<\/span><\/strong> and Set Entity Attributes<\/span><\/strong> following with mapping fields from JSON to Sugar Entity, there is a possibility to use Cast To Entity<\/span><\/strong>. Let\u2019s say there is a JSON like this: <\/p>\n\n\n\n

{\n  \"first_name\": \"Clark\",\n  \"last_name\": \"Kent\"\n}<\/code><\/pre>\n\n\n\n
With the following flowchart, it is possible to create a new Contact record from this JSON: <\/p>\n\n\n
\"\"<\/a><\/p>\n\n\n
As a result, new Contact is added: <\/p>\n\n\n\n
\"\"<\/figure>\n\n\n\n
2. Get Entity from the Variable <\/p>\n\n\n\n
If you have dozens of links from entity<\/span><\/em> port: <\/p>\n\n\n\n
\"\"<\/figure>\n\n\n\n
\u2026 and have ever thought of how to remove them to make flowchart even more readable \u2013 now it is possible to put Entity in a Variable and then simply use this Variable through Cast To Entity<\/span><\/strong>. Put entity into variable: <\/p>\n\n\n\n
\"\"<\/figure>\n\n\n\n
And then through Get Variable<\/span><\/strong> and Cast To Entity<\/span><\/strong> use the entity whenever it is needed: <\/p>\n\n\n\n
\"\"<\/figure>\n\n\n\n
New Operators to work with Email Addresses<\/b><\/span><\/p>\n\n\n\n
Out-of-the-box field Email Address is a special type of the field, which allows setting several Email Addresses for one record and marking Email Address as Primary, Invalid, or Opt Out. New Logic Builder Release enables you to work with values in this field – to add new email addresses, remove them, update email addresses attributes, and get all Email Addresses related to the Entity: <\/p>\n\n\n\n
\"\"<\/figure>\n\n\n\n
1. Add Email Address <\/strong><\/p>\n\n\n\n
Operator Add Email Address<\/span><\/strong> allows adding new Email Address to a Record like Lead, Contact, Account, Target (out-of-the-box entities with Email Address type field or Custom Entities with email type field). <\/p>\n\n\n\n
\"\"<\/figure>\n\n\n\n
Example of usage:<\/em> <\/p>\n\n\n\n
Let\u2019s say that there are Contact details retrieved via REST and you would like to update email address based on the response. The flowchart which implements this may be like this: <\/p>\n\n\n
\"\"<\/a><\/p>\n\n\n
In the example above, Email Attributes primary\/reply to\/invalid\/opt out will be set to false. In case there is a need to set address as opted out just put Boolean<\/span><\/strong> true in the input port: <\/p>\n\n\n\n
\"\"<\/figure>\n\n\n\n
2. Remove Email Address<\/strong> <\/p>\n\n\n\n
Operator Remove Email Address<\/span><\/strong> allows removing Email Address from a Record like Lead, Contact, Account, Target (out-of-the-box entities with Email Address type field or Custom Entities with email type field). <\/p>\n\n\n\n
\"\"<\/figure>\n\n\n\n
Example of usage: <\/em><\/p>\n\n\n\n
Let\u2019s say that you would like to remove the email address and set it to the value that was received from the 3rd party system. The flowchart that implements email address change may be like this: <\/p>\n\n\n
\"\"<\/a><\/p>\n\n\n
3. Get Email Addresses<\/strong> <\/p>\n\n\n\n
Operator Get Email Addresses<\/span><\/strong> allows you to get a primary email address and an array of emails arrays (each of which consists of email address and all its attributes) related to the Entity. <\/p>\n\n\n\n
\"\"<\/figure>\n\n\n\n
Output Example: <\/strong><\/p>\n\n\n\n
Let\u2019s say there is a Lead Record with the following Email Addresses: <\/p>\n\n\n\n
\"\"<\/figure>\n\n\n\n
If you use Get Email Addresses<\/span><\/strong> from this Lead: <\/p>\n\n\n\n
\"\"<\/figure>\n\n\n\n
Output port Email addresses<\/span><\/em> contains the following data: <\/p>\n\n\n\n
Array\n(\n    [0] => Array\n        (\n            [email_address] => anastasiia.gubanovych@integroscrm.com\n            [email_address_caps] => ANASTASIIA.GUBANOVYCH@INTEGROSCRM.COM\n            [invalid_email] => 0\n            [opt_out] => 0\n            [date_created] => 2021-10-27 11:32:34\n            [date_modified] => 2021-10-27 11:32:34\n            [id] => 945e040c-3719-11ec-b821-000c29791bd4\n            [email_address_id] => 94316e1a-3719-11ec-8e57-000c29791bd4\n            [bean_id] => 945da0a2-3719-11ec-97aa-000c29791bd4\n            [bean_module] => Leads\n            [primary_address] => 1\n            [reply_to_address] => 0\n            [deleted] => 0\n        )\n\n    [1] => Array\n        (\n            [email_address] => lbsupport@integroscrm.com\n            [email_address_caps] => LBSUPPORT@INTEGROSCRM.COM\n            [invalid_email] => 0\n            [opt_out] => 1\n            [date_created] => 2021-10-27 11:32:34\n            [date_modified] => 2021-10-27 11:32:34\n            [id] => 945e4534-3719-11ec-bd31-000c29791bd4\n            [email_address_id] => 9431a448-3719-11ec-94a3-000c29791bd4\n            [bean_id] => 945da0a2-3719-11ec-97aa-000c29791bd4\n            [bean_module] => Leads\n            [primary_address] => 0\n            [reply_to_address] => 0\n            [deleted] => 0\n        )\n\n    [2] => Array\n        (\n            [email_address] => nastya@integroscrm.com\n            [email_address_caps] => NASTYA@INTEGROSCRM.COM\n            [invalid_email] => 1\n            [opt_out] => 0\n            [date_created] => 2021-10-27 11:32:34\n            [date_modified] => 2021-10-27 11:32:34\n            [id] => 945e6dfc-3719-11ec-b53f-000c29791bd4\n            [email_address_id] => 9431c536-3719-11ec-ab68-000c29791bd4\n            [bean_id] => 945da0a2-3719-11ec-97aa-000c29791bd4\n            [bean_module] => Leads\n            [primary_address] => 0\n            [reply_to_address] => 0\n            [deleted] => 0\n        )\n\n)\n<\/code><\/pre>\n\n\n\n
Output port primary email address<\/span><\/em> contains only one primary address without attributes: <\/p>\n\n\n\n
anastasiia.gubanovych@integroscrm.com<\/code><\/pre>\n\n\n\n
Following Processing of Outputs<\/em> <\/em><\/strong><\/p>\n\n\n\n
There are two options how to process results from email addresses output: <\/p>\n\n\n\n
Option 1: Use For Each Element<\/span><\/strong> to get each Email Address and then Get Array Element<\/span><\/strong> or Get Array Elements by Path<\/span><\/strong> to get needed Email Address Attribute: <\/p>\n\n\n
\"\"<\/a><\/p>\n\n\n
Option 2: Use For Each Element<\/span><\/strong> to get each Email Address and then newly added Cast To Entity<\/span><\/strong> to treat Email Address as usual Entity: <\/p>\n\n\n
\"\"<\/a><\/p>\n\n\n
Change Primary Email Address <\/strong><\/p>\n\n\n\n
Scenario 1: Set Email Address for the new record <\/em><\/p>\n\n\n\n
For the new record, you may use a field email1 to set a primary email address: <\/p>\n\n\n\n
\"\"<\/figure>\n\n\n\n
Or new operator Add Email<\/span><\/strong>: <\/p>\n\n\n\n
\"\"<\/figure>\n\n\n\n
Scenario 2: changing Email address if there is an email address<\/em> <\/p>\n\n\n\n
To completely override a Primary Email Address, first remove the current Primary Email Address and then set the new one: <\/p>\n\n\n
\"\"<\/a><\/p>\n\n\n
N.B. If there is more than one email address for the Record, removing only the Primary address as in the example above may end up with two primary addresses for the record. <\/em><\/p>\n\n\n\n
To save all email addresses and change only the primary email address (along with preserving the old primary email address), it\u2019s needed to remove all addresses, add a new one, and then return all removed emails, like this: <\/p>\n\n\n
\"\"<\/a><\/p>\n\n\n
Other Changes<\/b><\/span><\/p>\n\n\n\n
\u00b7 Removed deprecated Operators (Flex Docs, User Actions, Behavior) <\/p>\n\n\n\n
\u00b7 Removed non-numeric symbols from packages version number<\/p>\n
Click to rate this post!<\/div>
<\/div>
\n                            <\/path>\n                          <\/svg>[Total: 0<\/span>  Average: 0<\/span>]<\/span><\/div>
<\/div><\/div>
<\/div><\/div><\/div>","protected":false},"excerpt":{"rendered":"
Release date: 2021-11-06 Cast to Entity Introducing a new operator Cast to Entity which allows you to create an Entity from the JSON or make your flowchart even more readable by putting Entity to the Variables and then reading it with Cast to Entity Example of usage:  1. Creating Entity from the JSON  For example, …<\/p>\n
  Email Addresses<\/span> Read More »<\/a><\/p>\n","protected":false},"author":1,"featured_media":0,"parent":0,"menu_order":0,"comment_status":"open","ping_status":"closed","template":"","meta":{"yasr_overall_rating":0,"yasr_post_is_review":"","yasr_auto_insert_disabled":"","yasr_review_type":"","footnotes":""},"tags":[],"class_list":["post-1886","page","type-page","status-publish","hentry"],"yasr_visitor_votes":{"number_of_votes":0,"sum_votes":0,"stars_attributes":{"read_only":false,"span_bottom":false}},"_links":{"self":[{"href":"https:\/\/logicbuilder.integroscrm.com\/help\/wp-json\/wp\/v2\/pages\/1886","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/logicbuilder.integroscrm.com\/help\/wp-json\/wp\/v2\/pages"}],"about":[{"href":"https:\/\/logicbuilder.integroscrm.com\/help\/wp-json\/wp\/v2\/types\/page"}],"author":[{"embeddable":true,"href":"https:\/\/logicbuilder.integroscrm.com\/help\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/logicbuilder.integroscrm.com\/help\/wp-json\/wp\/v2\/comments?post=1886"}],"version-history":[{"count":10,"href":"https:\/\/logicbuilder.integroscrm.com\/help\/wp-json\/wp\/v2\/pages\/1886\/revisions"}],"predecessor-version":[{"id":1963,"href":"https:\/\/logicbuilder.integroscrm.com\/help\/wp-json\/wp\/v2\/pages\/1886\/revisions\/1963"}],"wp:attachment":[{"href":"https:\/\/logicbuilder.integroscrm.com\/help\/wp-json\/wp\/v2\/media?parent=1886"}],"wp:term":[{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/logicbuilder.integroscrm.com\/help\/wp-json\/wp\/v2\/tags?post=1886"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}