Set Up Remote Calls

Authorize External Endpoint URL

1. From Setup, find and select Remote Site Settings.
2. Click New Remote Site.
3. In Remote Site Name, enter RemoteAPI.
4. In Remote Site URL, enter the URL for the remote site. For example, www.examplewebsite.com.
5. To allow access to the remote site irrespective of whether the user’s connection is over HTTP or HTTPS, select the Disable Protocol Security checkbox. When selected, Salesforce can pass data from an HTTPS session to an HTTP session, and vice versa.
   Select this checkbox only after you review all security implications.
6. If needed, enter a description of the site.
7. Click Save to complete registration, or click Save & New to save your work and register another site.

Create an Endpoint

Consumer Goods Cloud offline mobile app supports remote calls only with Salesforce endpoints (Apex-based REST API calls). All standard Apex governor limits apply to Apex REST classes.

1. Log in to Salesforce as admin.
2. From Setup, click Developer Console.
3. In Developer Console, from the File menu, select New.
4. Click Apex Class.
5. In the class name, enter RemoteAPI and then click OK.
6. Implement your custom business logic in your VS Code based Modeler workspace to invoke REST API in this class.
   Here’s a sample of GET and POST requests:

   @RestResource(urlMapping='/remoteapi/*')
   global with sharing class RemoteAPI {
       @HttpGet
       global static void getData() {
           // new HTTP request to external end point
           Http http = new Http();
           HttpRequest request = new HttpRequest();
           request.setEndpoint('https://www.examplewebsite.com');
           request.setMethod('GET');
           HttpResponse responseFromRemoteSite = http.send(request);
           String data = responseFromRemoteSite.getBody();
           System.debug(data);
           
           // Prepare response
           RestResponse res = RestContext.response;
           res.addHeader('Content-Type', 'application/json');
           res.responseBody = Blob.valueOf(data);
           res.statusCode = responseFromRemoteSite.getStatusCode();
       }
       
       
       @HttpPost
       global static void postData() {
           String requestBody = RestContext.request.requestBody.toString();
           
           // new HTTP request to external end point
           Http http = new Http();
           HttpRequest request = new HttpRequest();
           request.setEndpoint('https://www.examplewebsite.com');
           request.setMethod('POST');
           request.setHeader('Content-Type', 'application/json');
           request.setBody(requestBody);
           HttpResponse responseFromRemoteSite = http.send(request);
           String data = responseFromRemoteSite.getBody();
           System.debug(data);
           
           RestResponse res = RestContext.response;
           res.addHeader('Content-Type', 'application/json');
           res.responseBody = Blob.valueOf(data);
       }
   }

Configure Remote API Access Permission

To access the new API from VS Code based Modeler, grant sales reps access to the newly created remote API.

1. Log in to Salesforce as admin.
2. From Setup, find and select Permission Sets in the Quick Find box, then click Permission Sets.
3. In Users, go to Permission Sets and select CGCloud Sales User or CGCloud Retail Sales User.
4. On the permission set page, under Apps, select Apex Class Permissions.
5. Edit Apex Class Access and add <namespace>.RemoteAPI to Enabled Apex Classes.
6. Save your changes.

Post Configuration Tasks

Test the endpoints by using an API testing tool. On successful testing, define the remoteApiCallAsync API in your customization project.