How to create a new service?<\/b><\/p>\n\n\n\n
To add new service:<\/p>\n\n\n\n
- Register it in Sugar<\/li>
- Configure its logic in Logic Builder<\/li>
- Use it!<\/li><\/ol>\n\n\n\n
Register New Service in Sugar<\/b><\/p>\n\n\n\n
After deploying LB service extension, the new module LB Services is added to Sugar. To register a service, create a new record in this Module:<\/p>\n\n\n\n
![\"\"](\"https:\/\/logicbuilder.integroscrm.com\/help\/wp-content\/uploads\/2022\/05\/img-202-c44a765d6315476ca177a7d634fb167a.png\")
<\/figure>\n\n\n\n- Name \u2013 specify the user-friendly name of the service<\/li>
- System Name \u2013 specify unique name of the service (can contain only symbols [a-z], [0-9], [_], [-])<\/li>
- Arguments \u2013 specify all arguments that are going to be input to the service (e.g. by an external system or another flowchart) or will be returned as a result of service execution (e.g. to return the result to an external system). In Label part specify a user-friendly argument name, and in part Name \u2013 system name, which can contain only symbols [a-z], [0-9], [_], [-]<\/li>
- Description \u2013 optionally add some words which explain what is this service for.<\/li><\/ul>\n\n\n
![\"\"](\"https:\/\/logicbuilder.integroscrm.com\/help\/wp-content\/uploads\/2022\/05\/img-202-d7917c70f5bc46e6adc23153f3ce7696-1024x317.png\")
<\/a><\/p>\n\n\nHow to configure service logic in Logic Builder?<\/b><\/p>\n\n\n\n
The start operator of service logic is On Service Call<\/span><\/strong>:<\/p>\n\n\n\n
![\"\"](\"https:\/\/logicbuilder.integroscrm.com\/help\/wp-content\/uploads\/2022\/05\/img-202-8017dd45f6f441b09b287bec0cfa5bf4.png\")
<\/figure>\n\n\n\nIn service name<\/span><\/em> dropdown select the service which logic is described in this flowchart. This dropdown is composed of records in LB Services module from Sugar which metadata is loaded in the Project.<\/p>\n\n\n\n
To read service parameters that were input by an external system or other flowcharts use the operator Get Service Parameters<\/span><\/strong>. Once service is linked into the input port, select needed parameters from the dropdowns.<\/p>\n\n\n\n
![\"\"](\"https:\/\/logicbuilder.integroscrm.com\/help\/wp-content\/uploads\/2022\/05\/img-202-255c1f70654b4fd8b3bf2d70ddb002e4-1024x322.png\")
<\/figure>\n\n\n\nTo set values for service parameters to be used as a response to a call from an external system or SugarBPM use Set Service Parameters<\/span><\/strong>. Input service and then select service arguments which values you would like to set. To set the value simple link it with the appropriate service argument:<\/p>\n\n\n\n
![\"\"](\"https:\/\/logicbuilder.integroscrm.com\/help\/wp-content\/uploads\/2022\/05\/img-202-131f145b2e144113aadca17e508f6a3d.png\")
<\/figure>\n\n\n\nTo set the result to be used in other flowcharts use Set Service Result<\/span><\/strong>. Input service and value that should be in the result port and can be used in other flowcharts:<\/p>\n\n\n\n
![\"\"](\"https:\/\/logicbuilder.integroscrm.com\/help\/wp-content\/uploads\/2022\/05\/img-202-287464d1264b49b58edc3fea7cfd6a8f-1024x296.png\")
<\/figure>\n\n\n\nCombine dedicated to services operators with other others to configure logic.<\/p>\n\n\n\n
How to use services?<\/b><\/p>\n\n\n\n
There are several options for how to use services. Let\u2019s see the following examples.<\/p>\n\n\n\n
Example 1: How to use service to call flowchart from another flowchart<\/b><\/p>\n\n\n\n
Let\u2019s say that there is a step to get a number of related to Account Product Cases, that were registered this month. This number of Cases is used in several flowcharts, so instead of counting this number in each flowchart, let\u2019s create a service that will count this number and then just call this service from the other flowcharts.<\/p>\n\n\n\n
Step 1: Register service in Sugar.<\/p>\n\n\n\n
In LB Services module we are creating a new record. As an argument we need only one to have an Account ID:<\/p>\n\n\n
![\"\"](\"https:\/\/logicbuilder.integroscrm.com\/help\/wp-content\/uploads\/2022\/05\/img-202-c6ce680df73242c69a8c3fca15775d70-1024x271.png\")
<\/a><\/p>\n\n\nStep 2: Configure logic in Logic Builder<\/p>\n\n\n\n
Firstly, right after adding a new service, it is needed to update Sugar Metadata in the Project.<\/p>\n\n\n\n
The flowchart starts from On Service Call<\/span><\/strong> and in the very first step we are reading the service parameter value to get account_id and retrieve Account by this ID:<\/p>\n\n\n\n
![\"\"](\"https:\/\/logicbuilder.integroscrm.com\/help\/wp-content\/uploads\/2022\/05\/img-202-03f9c59dfd1c4bb9b85d95da1056b0bb-1024x189.png\")
<\/figure>\n\n\n\nThen count a number of cases in a loop:<\/p>\n\n\n
![\"\"](\"https:\/\/logicbuilder.integroscrm.com\/help\/wp-content\/uploads\/2022\/05\/img-202-b75bb71b34004362aa60d534e7df916a-1024x432.png\")
<\/a><\/p>\n\n\nFinally, put the result (the number of such cases) using Set Service Result<\/span><\/strong>:<\/p>\n\n\n
![\"\"](\"https:\/\/logicbuilder.integroscrm.com\/help\/wp-content\/uploads\/2022\/05\/img-202-7e839034038a4be493c5d154ef8f76dc-1024x374.png\")
<\/a><\/p>\n\n\nThe flowchart that implements service is ready, deploy it in Sugar instance.<\/p>\n\n\n\n
Step 3: Call the flowchart from another flowchart<\/p>\n\n\n\n
Now let\u2019s assume that after a Case is linked to an Account it\u2019s needed to evaluate the number of Product Cases registered this month. So instead of building logic to count such Cases, just use Call Service<\/span><\/strong> operator to call the corresponding service. In service name dropdown select service and then provide argument values \u2013 Account ID in our case. As result there is a number of such Cases:<\/p>\n\n\n
![\"\"](\"https:\/\/logicbuilder.integroscrm.com\/help\/wp-content\/uploads\/2022\/05\/img-202-a143d5fdc4ea47dcaba38d6a9c2f777a-1024x218.png\")
<\/a><\/p>\n\n\nExample 2: How to use service from an external system or custom code<\/b><\/p>\n\n\n\n
Let\u2019s say that Lead Status is updated from an external system. But it is needed to evaluate whether the status can be updated prior to actually changing it.<\/p>\n\n\n\n
Step 1. Again, register service in Sugar. As service arguments, we have lead_id<\/em> that should be an input argument and message<\/em>, that will be filled by the service and returned to the external system.<\/p>\n\n\n
![\"\"](\"https:\/\/logicbuilder.integroscrm.com\/help\/wp-content\/uploads\/2022\/05\/img-202-3fd8f07a420b4340b06a9c7c657bda88-1024x253.png\")
<\/a><\/p>\n\n\nStep 2. Create a flowchart that implements the service logic. As usual, such flowchart starts from On Service Call<\/span><\/strong>. Then read parameters values from the service with Get Service Parameters<\/span><\/strong>:<\/p>\n\n\n
![\"\"](\"https:\/\/logicbuilder.integroscrm.com\/help\/wp-content\/uploads\/2022\/05\/img-202-49dcaaca9b10415a9ba9837bd6c8cbe3-1024x198.png\")
<\/a><\/p>\n\n\nAfter configuring the logic of whether Lead status can be updated, to return value to the external system use Set Service Parameters<\/span><\/strong>:<\/p>\n\n\n\n
![\"\"](\"https:\/\/logicbuilder.integroscrm.com\/help\/wp-content\/uploads\/2022\/05\/img-202-e07c6ea82e924736af80641789d0c4e5-1024x336.png\")
<\/figure>\n\n\n\nAnd deploy flowchart into Sugar instance.<\/p>\n\n\n\n
Right after deployment the new REST endpoint will be created in Sugar:<\/p>\n\n\n\n
Endpoint<\/strong><\/td> Method<\/strong><\/td> Description<\/strong><\/td> Exceptions<\/strong><\/td><\/tr> POST \/lb\/services\/:serviceName<\/td> lbServiceCall<\/td> Call specific LB Flowchart Service.<\/td> Not Found, No Service Implementation<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n Request Arguments<\/strong><\/p>\n\n\n\n
Name<\/strong><\/td> Type<\/strong><\/td> Description<\/strong><\/td> Required<\/strong><\/td><\/tr><\/thead> arguments<\/td> Map<\/td> Input service parameters passed to the flowchart as key-value pairs, where key is a name of service parameter, and value is a value of service parameter.<\/td> false<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n Response Arguments<\/strong><\/p>\n\n\n\n
Name<\/strong><\/td> Type<\/strong><\/td> Description<\/strong><\/td><\/tr><\/thead> arguments<\/td> Map<\/td> Output service parameters returned from the flowchart as key-value pairs.<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n Endpoint can be used just like the standard Sugar REST API. Documentation is available at: sugarurl\/rest\/v11_4\/help<\/p>\n\n\n\n
Example of usage the service to update lead status:<\/p>\n\n\n\n
url<\/td> https:\/\/{\u200b\u200b\u200b\u200b\u200bsite_url}\u200b\u200b\u200b\u200b\u200b\/rest\/v11_15\/lb\/services\/update_lead_status<\/td><\/tr> method<\/td> POST<\/td><\/tr> request<\/td> {\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b
“arguments” : {\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b
“lead_id” : “798cdde8-ff5e-11e7-ab44-000c29996212”
}\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b
}\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b<\/td><\/tr>response<\/td> {\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b
“arguments” : {\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b
“lead_id “: “798cdde8-ff5e-11e7-ab44-000c29996212”,
“message”: “success!”
}\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b
}\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b\u200b<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\nManually calling service<\/b><\/p>\n\n\n\n
It\u2019s possible to call Service from the Sugar interface.<\/p>\n\n\n
\nPlease note that this is a real call and service execution, not an emulation.<\/p>\n<\/div>\n\n\n
To manually call the service, open the LB Services record and click the Call Service button:<\/p>\n\n\n\n
![\"\"](\"https:\/\/logicbuilder.integroscrm.com\/help\/wp-content\/uploads\/2022\/05\/img-202-14e0809342e9435a92ed49aec562998b-1024x346.png\")
<\/figure>\n\n\n\nThen provide input arguments (e.g. Lead ID) and click Execute:<\/p>\n\n\n\n
![\"\"](\"https:\/\/logicbuilder.integroscrm.com\/help\/wp-content\/uploads\/2022\/05\/img-202-8abd7f66aa3f401585696e8da076a3ff-1024x271.png\")
<\/figure>\n\n\n\nOn the right side there are results of service execution:<\/p>\n\n\n
![\"\"](\"https:\/\/logicbuilder.integroscrm.com\/help\/wp-content\/uploads\/2022\/05\/img-202-d7917c70f5bc46e6adc23153f3ce7696.png\")
<\/a><\/p>\n\n\n