Sv translation

language	en

Implementation

Classic

To create a new Apex class, access Setup in SalesForce, and type in "Apex" in the quick search box.

Select "Build ... Develop ... Apex Classes".

Lightning

Access Setup, and search for "Apex" in the search box.

Classic and Lightning

Create a new class. Add the following code:

Translations Ignore

Code Block

language	java
title	Sample Apex getCallerInformation

@RestResource(urlMapping='/jtelACD/getCallerInformation')
global with sharing class JTELACD_GetCallerInformation {
    @HttpGet
    global static String doGet() {
        RestRequest req = RestContext.request;
        RestResponse res = RestContext.response;

        // This is how to access URLParams if required
        // List<String> URLParams = req.requestURI.split('/');
        // Example: ["","jtelACD","getCallerInformation"]

        // Extract the request parameters
        String CallerID = req.params.get('CallerID');
        String ServiceNumber = req.params.get('ServiceNumber');
        String ServiceName = req.params.get('ServiceName');

// From release 3.25 - 2021-07-02 and upwards

//

Perform

SOSL

Query

over

contacts

and

leads,

String

searching

Function

for the phone number with *wildcards*

= req.params.get('Function');
        String

soslSearchString

UserData =

'*' + CallerID + '*'

req.params.get('UserData');

List<List<SObject>>

String

searchList

UserData2 =

[FIND :soslSearchString IN ALL FIELDS

req.params.get('UserData2');
        String UserData3 = req.params.get('UserData3');

        // Specifying a Function is intended to allow the developer to perform different types of query. 
        // As an

RETURNING

example,

we just return the data back if a function is specified.
        // In a real world case, a query for example to search for and return a ticket, contract or some other record would be

Contact,

performed.
        if( Function != null && Function != '' ) {
            JSONGenerator gen = JSON.createGenerator( true );

Lead];

gen.writeStartObject();

    gen.writeStringField( 'CallerID',

List<Contact> contacts = ( (List<Contact>) searchList[0]

CallerID );

List<Lead>

leads

= ( (List<Lead>) searchList[1]

gen.writeStringField( 'ServiceNumber', ServiceNumber );

    gen.writeStringField( 'ServiceName', ServiceName );

//

Multple

hits?

if(

contacts

gen.

size() + leads.size() > 1 )

writeStringField( 'Function', Function );
            gen.writeStringField( 'UserData', UserData

{

);

// Multiple hits

gen.writeStringField( 'UserData2', UserData2 );

res.statusCode = 300

gen.writeStringField( 'UserData3', UserData3 );

return null;

gen.writeEndObject();

}

   return gen.getAsString();

if(

contacts.size()

>

0

)

{

// Perform SOSL Query over contacts and leads, searching for the phone

//

number

Query for exact contact

with *wildcards*
        String soslSearchString = '*'

String

Id

CallerID

= (String) contacts.get(0).get('Id')

+ '*';
        List<List<SObject>> searchList = [FIND :soslSearchString

Set<String>

IN

fieldSet

ALL

= schema.describeSObjects(new String[] { 'Contact' } )[0].fields.getMap().keyset();

FIELDS

List<String>

fieldList

=

new

List<String>(

fieldSet

);

String

query

=

'SELECT

'

+

String.join( fieldList, ',' ) + ' FROM Contact WHERE Id = \'' + Id + '\'';

RETURNING

Contact

contact

=

Database.query(

query

);

           Contact,

//

200

OK

will

be

returned

by

default

return

JSON.serialize(

contact

);

}

   Lead];

if(

leads.size()

>

0 )

{


        List<Contact> contacts = (

// Query for exact lead

(List<Contact>) searchList[0] );
        List<Lead> leads

String

Id

= (

String)

leads.get

0).get('Id'

List<Lead>) searchList[1] );

Set<String>

fieldSet

=

schema.describeSObjects(new String[] { 'Lead' } )[0].fields.getMap().keyset();

 // Multple hits?
        if( contacts.size() + leads.size() > 1 )
        {

List<String>

fieldList

=

new

List<String>(

fieldSet

);

  // Multiple hits

String query

=

'SELECT

'

+ String.join( fieldList, ',' ) + ' FROM Lead WHERE Id = \'' + Id + '\''

res.statusCode = 300;
            return null;
        }

Lead

lead

=

Database.query(

query );

// 200 OK will be returned by default

if( contacts.size() > 0 )
        {

return

JSON.serialize( lead ); }

 // Query for exact contact

//

Nothing

found

    String Id = (String)

res.statusCode = 404; return null

contacts.get(0).get('Id');
            Set<String> fieldSet = schema.describeSObjects(new String[] { 'Contact' } )[0].fields.getMap().keyset();

} }

CURL Test

First of all, obtain an OAUTH Token, see Testing with CURL.

The following CURL command can be used to test this API:

Code Block

title	CURL - getCallerInformation Test

curl.exe

--silent

-i

-X

GET

--header

"Authorization:

Bearer <OAUTH_TOKEN>" --header "Connection: Close" "https://<SALES_FORCE_INSTANCE_URL>/services/apexrest/jtelACD/getCallerInformation?CallerID=4989461495000&ServiceNumber=4980012345678&ServiceName=test"

Sv translation

language	de

Implementation

Classic

To create a new Apex class, access Setup in SalesForce, and type in "Apex" in the quick search box.

Select "Build ... Develop ... Apex Classes".

Image Removed

Lightning

Access Setup, and search for "Apex" in the search box.

Image Removed

Classic and Lightning

Create a new class. Add the following code:

Code Block

language	java
title	Sample Apex getCallerInformation

@RestResource(urlMapping='/jtelACD/getCallerInformation') global with sharing class JTELACD_GetCallerInformation

 List<String> fieldList = new List<String>( fieldSet );
            String query = 'SELECT ' + String.join( fieldList, ',' ) + ' FROM Contact WHERE Id = \'' + Id + '\'';
            Contact contact = Database.query( query );
            // 200 OK will be returned by default
            return JSON.serialize( contact );
        }
        
        if( leads.size() > 0 )
        {

@HttpGet

global

static

String

doGet() {

 // Query for exact lead

RestRequest

req

=

RestContext.request;

     String Id =

RestResponse res = RestContext.response;

(String) leads.get(0).get('Id');

//

This

is

how to access URLParams if required

 Set<String> fieldSet = schema.describeSObjects(new String[] { 'Lead' } )[0].fields.getMap().keyset();

//

  List<String>

URLParams

fieldList =

req.requestURI.split('/'

 new List<String>( fieldSet );

//

Example:

["","jtelACD","getCallerInformation"]

  String query = 'SELECT '

// Extract the request parameters String CallerID = req.params.get('CallerID')

+ String.join( fieldList, ',' ) + ' FROM Lead WHERE Id = \'' + Id + '\'';

String ServiceNumber

    Lead lead =

req

Database.

params.get('ServiceNumber'

query( query );

String

ServiceName

=

req.params.get('ServiceName');

 // 200 OK will be returned by default

//

Perform

SOSL

Query

over contacts and leads, searching for the phone number with *wildcards*

return JSON.serialize( lead );
        }

String

//

soslSearchString

Nothing

=

found

'*'

+

CallerID

+

'*';

   res.statusCode = 404;

List<List<SObject>>

searchList

=

[FIND

:soslSearchString

IN ALL FIELDS

return null;
    }
}

CURL Test

First of all, obtain an OAUTH Token, see Testing with CURL.

The following CURL command can be used to test this API:

Translations Ignore

Code Block

title	CURL - getCallerInformation Test

curl.exe --silent -i -X GET --header "Authorization: Bearer <OAUTH_TOKEN>" --header "Connection: Close" "https://<SALES_FORCE_INSTANCE_URL>/services/apexrest/jtelACD/getCallerInformation?CallerID=4989461495000&ServiceNumber=4980012345678&ServiceName=test"

The following CURL command can be used to test this API with the additional parameters from Release 3.25 - 2021-07-02 and upwards:

Translations Ignore

Code Block

title	CURL - getCallerInformation Test

curl.exe --silent -i -X GET --header "Authorization: Bearer <OAUTH_TOKEN>" --header "Connection: Close" "https://<SALES_FORCE_INSTANCE_URL>/services/apexrest/jtelACD/getCallerInformation?CallerID=4989461495000&ServiceNumber=4980012345678&ServiceName=test&Function=testFunction&UserData=testUserData&UserData2=testUserData2&UserData3=testUserData3"

Sv translation

language	de

Status

colour	Red
title	This page is only available in English

Sv translation

language	fr

Mise en œuvre

Classique

Pour créer une nouvelle classe Apex, accédez à Setup dans SalesForce, et tapez "Apex" dans la boîte de recherche rapide.

Sélectionnez "Construire ... Développer ... Apex Classes".

Image Added

Foudre

Configuration de l'accès, et recherchez "Apex" dans la boîte de recherche.

Image Added

Classique and Foudre

Créez une nouvelle classe. Ajoutez le code suivant :

Translations Ignore

Code Block

language	java
title	Exemple Apex getCallerInformation

@RestResource(urlMapping='/jtelACD/getCallerInformation') global with sharing class JTELACD_GetCallerInformation { @HttpGet global static String doGet() { RestRequest req = RestContext.request; RestResponse res = RestContext.response; // This is how to access URLParams if required // List<String> URLParams = req.requestURI.split('/'); // Example: ["","jtelACD","getCallerInformation"] // Extract the request parameters String CallerID = req.params.get('CallerID'); String ServiceNumber = req.params.get('ServiceNumber'); String ServiceName = req.params.get('ServiceName'); // From release 3.25 - 2021-07-02 and upwards String Function = req.params.get('Function'); String UserData = req.params.get('UserData'); String UserData2 = req.params.get('UserData2'); String UserData3 = req.params.get('UserData3'); // Specifying a Function is intended to allow the developer to perform different types of query. // As an example, we just return the data back if a function is specified. // In a real world case, a query for example to search for and return a ticket, contract or some other record would be performed. if( Function != null && Function != '' ) { JSONGenerator gen = JSON.createGenerator( true ); gen.writeStartObject(); gen.writeStringField( 'CallerID', CallerID ); gen.writeStringField( 'ServiceNumber', ServiceNumber ); gen.writeStringField( 'ServiceName', ServiceName ); gen.writeStringField( 'Function', Function ); gen.writeStringField( 'UserData', UserData ); gen.writeStringField( 'UserData2', UserData2 ); gen.writeStringField( 'UserData3', UserData3 ); gen.writeEndObject(); return gen.getAsString(); } // Perform SOSL Query over contacts and leads, searching for the phone number with *wildcards* String soslSearchString = '*' + CallerID + '*'; List<List<SObject>> searchList = [FIND :soslSearchString IN ALL FIELDS RETURNING Contact, Lead]; List<Contact> contacts = ( (List<Contact>) searchList[0] ); List<Lead> leads = ( (List<Lead>) searchList[1] ); // Multple hits? if( contacts.size() + leads.size() > 1 ) { // Multiple hits res.statusCode = 300; return null; } if( contacts.size() > 0 ) { // Query for exact contact String Id = (String) contacts.get(0).get('Id'); Set<String> fieldSet = schema.describeSObjects(new String[] { 'Contact' } )[0].fields.getMap().keyset(); List<String> fieldList = new List<String>( fieldSet ); String query = 'SELECT ' + String.join( fieldList, ',' ) + ' FROM Contact WHERE Id = \'' + Id + '\''; Contact contact = Database.query( query ); // 200 OK will be returned by default return JSON.serialize( contact ); }

RETURNING Contact, Lead]; List<Contact> contacts = ( (List<Contact>) searchList[0] ); List<Lead> leads = ( (List<Lead>) searchList[1] ); // Multple hits? if( contacts.size() + leads.size() > 1 ) { // Multiple hits res.statusCode = 300; return null; } if( contacts.size() > 0 ) { // Query for exact contact String Id = (String) contacts.get(0).get('Id'); Set<String> fieldSet = schema.describeSObjects(new String[] { 'Contact' } )[0].fields.getMap().keyset(); List<String> fieldList = new List<String>( fieldSet ); String query = 'SELECT ' + String.join( fieldList, ',' ) + ' FROM Contact WHERE Id = \'' + Id + '\''; Contact contact = Database.query( query ); // 200 OK will be returned by default return JSON.serialize( contact ); }

 if( leads.size() > 0 )

 // Query for exact lead

 String Id = (String) leads.get(0).get('Id');

 Set<String> fieldSet = schema.describeSObjects(new String[] { 'Lead' } )[0].fields.getMap().keyset();

List<String> fieldList = new List<String>( fieldSet );

String query = 'SELECT ' + String.join( fieldList, ',' ) + ' FROM Lead WHERE Id = \'' + Id + '\'';

 Lead lead = Database.query( query );

 // 200 OK will be returned by default

 return JSON.serialize( lead );

 } // Nothing found res.statusCode = 404;

}

return null;

// Nothing found res.statusCode = 404; return null; } }

CURL Test

First of all, obtain an OAUTH Token, see Testing with CURL.

The following CURL command can be used to test this API:

} }

Test CURL

Tout d'abord, obtenez un jeton OAUTH, voir Testing with CURL.

La commande CURL suivante peut être utilisée pour tester cette API :

Translations Ignore

Code Block

title	CURL - Test getCallerInformation

curl.exe --silent -i -X GET --header "Authorization: Bearer <OAUTH_TOKEN>" --header "Connection: Close" "https://<SALES_FORCE_INSTANCE_URL>/services/apexrest/jtelACD/getCallerInformation?CallerID=4989461495000&ServiceNumber=4980012345678&ServiceName=test"

La commande CURL suivante peut être utilisée pour tester cette API avec les paramètres supplémentaires de la version 3.25 - 2021-07-02 et suivantes :

Test

Translations Ignore

Code Block

title	CURL - Test getCallerInformation

curl.exe --silent -i -X GET --header "Authorization: Bearer <OAUTH_TOKEN>" --header "Connection: Close" "https://<SALES_FORCE_INSTANCE_URL>/services/apexrest/jtelACD/getCallerInformation?CallerID=4989461495000&ServiceNumber=4980012345678&ServiceName=test&Function=testFunction&UserData=testUserData&UserData2=testUserData2&UserData3=testUserData3"

Page tree

Versions Compared

Old Version 7

New Version Current

Key

Implementation

Classic

Lightning

Classic and Lightning

CURL Test

Implementation

Classic

Lightning

Classic and Lightning

CURL Test

Mise en œuvre

Classique

Foudre

Classique and Foudre

CURL Test

Test CURL

Page tree

Page History

Versions Compared

Old Version 7

New Version Current

Key

Implementation

Classic

Lightning

Classic and Lightning

CURL Test

Implementation

Classic

Lightning

Classic and Lightning

CURL Test

Mise en œuvre

Classique

Foudre

Classique and Foudre

CURL Test

Test CURL