{"id":1467,"date":"2022-03-31T18:02:52","date_gmt":"2022-03-31T18:02:52","guid":{"rendered":"https:\/\/logicbuilder.integroscrm.com\/help\/?page_id=1467"},"modified":"2022-04-13T13:17:03","modified_gmt":"2022-04-13T13:17:03","slug":"operators-links","status":"publish","type":"page","link":"https:\/\/logicbuilder.integroscrm.com\/help\/operators-links\/","title":{"rendered":"Operators & Links"},"content":{"rendered":"\n

Any logic is a set of connected operators. As when people connect constructors\u2019 bricks to build some figure, linking operators (bricks) in the right order brings you to some logic.<\/p>\n\n\n\n

Operator is a construct that performs an action, starting from simple a+b<\/em> or setting a constant to more complex like process HTML.<\/p>\n\n\n\n

Operator consists of:<\/p>\n\n\n\n

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

Operator’s Name:<\/b><\/p>\n\n\n\n

Each operator has a unique name. You can search operators in the menu by name. Commonly the name displays the action that the operator performs. <\/p>\n\n\n\n

Info Button:<\/b><\/p>\n\n\n\n

If you need additional info about the operator \u2013 what it does, what ports it has, and so on \u2013 simply click on \u2018i\u2019 button to receive information directly in Logic Builder.<\/p>\n\n\n\n

Control Ports and Control Flow Link:<\/span><\/p>\n\n\n\n

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

Triangularly shaped ports are called control ports<\/strong>. The link between them is called control flow link.<\/strong><\/p>\n\n\n\n

Simply connect output control ports with input to determine the order of operators’ execution. <\/p>\n\n\n\n

Keep in mind several rules:<\/p>\n\n\n\n

1. Control flow link only goes in one direction (except loops).<\/p>\n\n\n\n

2. If an operator has input control port<\/strong> it must<\/u><\/strong> be linked. If port is not linked \u2013 an operator won\u2019t be executed, as it is out of control flow.<\/p>\n\n\n\n

3. Output control port should be linked, except if it is the last operator of your piece of logic or it is the end of control flow.<\/p>\n\n\n\n

4. You cannot put more than one control flow link from the output control port, except operators which purpose is to divide the flow. It is operators from Control Flow section \u2013 Branch<\/span>, For Each Entity<\/span>, For each element<\/span> (these operators have several output control ports).
One control output port = one control flow link!<\/strong><\/span>
You cannot:<\/strong><\/span><\/p>\n\n\n\n

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

5. You can link more than one control flow link in the input control port only when control flow comes through one and only one of the control flow links.
Example: You can:<\/strong><\/p>\n\n\n

\"\"<\/a><\/p>\n\n\n

In this example control flow will go either through true -> Set Entity Attributes -> Send Email OR false -> Send Email, but never via both links.<\/em><\/p>\n\n\n\n

Control Flow in loops and branches<\/b><\/p>\n\n\n\n

Branch<\/span> operator has two output control ports \u2013 true<\/span> and false<\/span>. Control flow always goes through one of them based on a condition \u2013 true or false.<\/p>\n\n\n\n

Operators For Each Entity<\/span> or For Each Element<\/span> has two output control ports \u2013 loop body<\/span> and completed<\/span>. Control flow keeps coming back to this operator until all the items in the input are gone through the same path down the loop body port. When finished with all the elements, the control flow runs to the control flow link that is connected to its completed<\/span> control port.<\/p>\n\n\n

\"\"<\/a><\/p>\n\n\n

Assume that you have 2 entities in the input port Entities in For Each Entity Operator. <\/em>Control Flow will go through links 1->2->3->4->1->2->3->4->5->6<\/em><\/p>\n\n\n\n

Also For Each Entity<\/span> and For Each element<\/span> have one more control input port \u2013 break<\/span>. In case of control flow comes from break<\/span> \u2013 it will go directly on the completed<\/span> port even if there are items in the input port.<\/p>\n\n\n

\"\"<\/a><\/p>\n\n\n

In this example control flow will go through 1->2->3->4->5. After 3 we have \u2018break\u2019 which means exit the loop.<\/em><\/p>\n\n\n\n

Data Ports and Data Flow Links<\/span><\/p>\n\n\n\n

Colored (not white) ports are called Data Ports<\/strong> and a link between them is called Data Flow Link<\/strong>.<\/p>\n\n\n\n

The operator may have only data ports, without control ports. However, those operators are only executed when their outputs are eventually connected to an operator that does have control ports.<\/p>\n\n\n\n

Link data ports with data flow link. Keep in mind several rules for data flow links and ports:<\/p>\n\n\n\n

1. You can link as many as you need data flow links from data port<\/p>\n\n\n\n

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

2. You cannot submit contradictory inputs to the input data port. This means that you can link several data flow links in one data port. But you must be sure that there is the same input in any case.<\/p>\n\n\n

\"\"<\/a><\/p>\n\n\n

You cannot do something like on example above. In Get entity attributes<\/span> you will have two different entities, which will cause the flowchart work unexpectedly.<\/em><\/p>\n\n\n\n

Data Port Shapes<\/b><\/p>\n\n\n\n

There are two data port shapes:<\/p>\n\n\n\n

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

Circle – means that you have only one item in this port \u2013 field, value, entity, constant, element, etc.<\/p>\n\n\n\n

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

Square \u2013 means that you have one or more items here \u2013 several entities, several elements. Usually, you do not want to connect square ports to round ports, but this is not prohibited. E.g. when you are sure that there is only one entity in square entity port, you can connect with the circle port. Another example is if you would like to output collection or array elements into LOG.<\/p>\n\n\n\n

Data Port Colors<\/b><\/p>\n\n\n\n

The color of each port is a reminder to you what you can expect in output or what you should submit in the input. It is more like guidance, rather than a rule \u2013 you can connect ports of different colors. Please follow the guidelines for each operator to find out more about what you can input and what can be output.<\/p>\n\n\n\n

Port<\/strong><\/td>Data<\/strong><\/td>Comments<\/strong><\/td><\/tr>
\"\"<\/td>entity<\/td>You have one (if round) or several (if square) entity(-ies) in output port or you need to input entity.<\/td><\/tr>
\"\"<\/td>boolean<\/td>You have true<\/em> or false<\/em> in output or operator expects true<\/em> or false<\/em> as input.<\/td><\/tr>
\"\"<\/td>dropdown<\/td> <\/td><\/tr>
\"\"<\/td>any data<\/td> <\/td><\/tr>
\"\"<\/td>string<\/td> <\/td><\/tr>
\"\"<\/td>number<\/td> <\/td><\/tr>
\"\"<\/td>structure or special type (like service)<\/td> <\/td><\/tr>
\"\"<\/td>date<\/td> <\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n

Filled data in Data Ports<\/b><\/p>\n\n\n\n

Some operators may require inputting data directly in the operator. There are some types of possible input data.<\/p>\n\n\n\n

Dropdown<\/em><\/p>\n\n\n\n

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

This means that you should select something from the list. Example \u2013 Get Entity Attributes<\/span>, On Data Change<\/span>, Dropdown Value<\/span>.<\/p>\n\n\n\n

After placing operator with a dropdown in Workplace – some lists are filled with values, but sometimes \u2013 not. If your dropdown list is empty \u2013 make sure:<\/p>\n\n\n\n

  1. That you submit input port.<\/li><\/ol>\n\n\n\n

    Example: Set Entity Attributes<\/span>. The dropdown list is empty until you specify entity in the input port.<\/p>\n\n\n\n

    1. That you specify another dropdown.<\/li><\/ol>\n\n\n\n

      Example: Dropdown<\/span> constant. Until you choose the dropdown name in the first line \u2013 the second one will be empty.<\/p>\n\n\n\n

      Input Value<\/em><\/p>\n\n\n\n

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

      This means that you should type something. It may be a symbol (separator for custom collection), string (a subject for email), number \u2013 actually, any value that you want. <\/p>\n\n\n\n

      It is not required to input data directly in a operator , you can also link input data:<\/p>\n\n\n\n

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

      Extend Operators’ Input Ports<\/b><\/p>\n\n\n\n

      Some operators allow you to submit several inputs value.<\/p>\n\n\n\n

      For this purpose, you will see symbols ‘+’ \u2013 to add input, ‘-‘ \u2013 to remove inputs:<\/p>\n\n\n\n

      \"\"<\/figure>\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":"

      Any logic is a set of connected operators. As when people connect constructors\u2019 bricks to build some figure, linking operators (bricks) in the right order brings you to some logic. Operator is a construct that performs an action, starting from simple a+b or setting a constant to more complex like process HTML. Operator consists of: Operator’s Name: …<\/p>\n

      Operators & Links<\/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-1467","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\/1467","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=1467"}],"version-history":[{"count":9,"href":"https:\/\/logicbuilder.integroscrm.com\/help\/wp-json\/wp\/v2\/pages\/1467\/revisions"}],"predecessor-version":[{"id":1525,"href":"https:\/\/logicbuilder.integroscrm.com\/help\/wp-json\/wp\/v2\/pages\/1467\/revisions\/1525"}],"wp:attachment":[{"href":"https:\/\/logicbuilder.integroscrm.com\/help\/wp-json\/wp\/v2\/media?parent=1467"}],"wp:term":[{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/logicbuilder.integroscrm.com\/help\/wp-json\/wp\/v2\/tags?post=1467"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}