La classe de cadena Apex de Salesforce té molts mètodes integrats que s'apliquen a tipus de dades de cadena/text, com ara camps de sector i de qualificació a l'objecte de compte estàndard. Mitjançant aquests mètodes, podem manipular les dades de Salesforce com vulguem. A Apex, la cadena es pot declarar mitjançant el tipus de dades 'String'. En aquesta guia, ens centrarem a aplicar els mètodes de cadena a objectes estàndard de Salesforce com ara comptes i contactes.
Classe Apex String
La classe String admet tots els mètodes de cadena que són primitius. Utilitza l'espai de noms del sistema. El tipus de dades que s'utilitza per declarar una cadena és una cadena seguida d'una variable. Podem assignar una cadena a aquesta variable.
Sintaxi:
variable de cadena = 'cadena';Parlem dels mètodes disponibles a la classe 'cadena' d'Apex.
1. toLowerCase()
Bàsicament, aquest mètode converteix tots els caràcters que hi ha a la cadena a minúscules. Quan necessiteu convertir els registres d'objectes de Salesforce (camps relacionats amb la cadena) a minúscules, podeu utilitzar el mètode toLowerCase(). Quan treballeu amb objectes, heu de passar el fieldName quan esteu treballant amb objectes de Salesforce.
Sintaxi:
- string.toLowerCase()
- Salesforce_obj.fieldName.toLowerCase()
Exemple genèric:
Tinguem una cadena 'LINUXHINT' i la convertim en minúscules.
String my_stri = 'LINUXHINT';
system.debug('Actual: '+ my_stri);
system.debug('Minúscules: '+ my_stri.toLowerCase());
Sortida:
Amb l'objecte de contacte de Salesforce:
Creeu un objecte de 'contacte' amb 'Departament' i 'Títol' i apliqueu aquest mètode als registres d'objectes de 'contacte'.
// Crea un objecte de contacte amb dos registres d'instància
Contact obj = nou Contacte (Departament='VENDES',Títol='Gerent-executiu');
system.debug('Dades de contacte: '+obj);
// aMinúscules ()
system.debug('Departament en minúscula: '+obj.Department.toLowerCase());
system.debug('Títol en minúscula: '+obj.Title.toLowerCase());
Sortida:
2. toMajúscules()
Aquest mètode converteix tots els caràcters que estan presents a la cadena (declarats des de la classe 'cadena' d'Apex) a majúscules.
Quan necessiteu convertir els registres d'objectes de Salesforce (camps relacionats amb la cadena) a majúscules, podeu utilitzar el mètode toUpperCase(). Quan treballeu amb objectes, heu de passar el fieldName quan esteu treballant amb objectes de Salesforce.
Sintaxi:
- string.toUpperCase()
- Salesforce_obj.fieldName.toUpperCase()
Exemple genèric:
Tinguem una cadena 'linuxhint' i la convertim en majúscules.
String my_stri = 'linuxhint';system.debug('Actual: '+ my_stri);
system.debug('Majúscula: '+ my_stri.toUpperCase());
Sortida:
Amb l'objecte de contacte de Salesforce:
Creeu un objecte de 'contacte' amb 'Departament' i 'Títol' i apliqueu aquest mètode als registres d'objectes de 'contacte'.
Contact obj = nou Contacte (Departament='VENDES',Títol='Gerent-executiu');system.debug('Dades de contacte: '+obj);
// a majúscules ()
system.debug('Departament en majúscula: '+obj.Department.toUpperCase());
system.debug('Títol en majúscula: '+obj.Title.toUpperCase());
Sortida:
3. majúscules ()
És bo veure el primer caràcter en majúscula. Només la primera lletra es posa en majúscula amb aquest mètode. Com els mètodes anteriors, no necessitarà cap paràmetre.
Sintaxi:
- string.capitalize()
- Salesforce_obj.fieldName.capitalize()
Exemple genèric:
Tinguem una cadena de 'indicació de Linux' i convertim el primer caràcter a majúscules.
String my_stri = 'suggeriment de Linux';system.debug('Actual: '+ my_stri);
system.debug(my_stri.capitalize());
Sortida:
Amb l'objecte de contacte de Salesforce:
Apliquem aquest mètode als camps d'objectes de 'contacte' (Departament i Títol) per convertir el seu primer caràcter de la cadena en majúscula.
Contact obj = nou Contacte (Departament='sALES',Títol='gerent-executiu');system.debug('Dades de contacte: '+obj);
// majúscules ()
system.debug(obj.Department.capitalize());
system.debug(obj.Title.capitalize());
Sortida:
4. Conté()
És possible comprovar si la cadena existeix en una altra cadena utilitzant el mètode Apex string contains(). Retorna un valor booleà true si la cadena especificada existeix a la cadena real. En cas contrari, es retorna false.
Sintaxi:
- actual_string.contains(check_string)
- Salesforce_obj.fieldName.contains(check_string)
Exemple genèric:
Tinguem una cadena de 'indicació de Linux' i comprovem si les cadenes 'linux' i 'python' existeixen en aquesta cadena o no.
String my_stri = 'suggeriment de Linux';system.debug('Actual: '+ my_stri);
system.debug('linux existeix: '+my_stri.contains('linux'));
system.debug('python existeix: '+my_stri.contains('python'));
Sortida:
Amb l'objecte de contacte de Salesforce:
Comproveu si les cadenes 'Vendes' i 'Procés' existeixen al títol 'Executiu de vendes' o no.
Contact obj = nou Contacte (Títol='Executiu de vendes');system.debug('Dades de contacte: '+obj);
// conté()
system.debug(obj.Title.contains('Vendes'));
system.debug(obj.Title.contains('Procés'));
Sortida:
5. comença amb()
El mètode startsWith() de la classe 'cadena' d'Apex retorna true si la cadena especificada comença amb el valor de cadena/camp donat de l'objecte de Salesforce. En cas contrari, es retorna false. Pren una cadena com a paràmetre.
Sintaxi:
- actual_string.startsWith(check_string)
- Salesforce_obj.fieldName.startsWith(check_string)
Exemple genèric:
Tinguem una cadena de 'indicació de Linux' i comprovem si comença amb les cadenes 'linux' i 'python'.
String my_stri = 'suggeriment de Linux';system.debug('Actual: '+ my_stri);
system.debug('Comença amb linux: '+my_stri.startsWith('linux'));
system.debug('Comença amb python: '+my_stri.startsWith('python'));
Sortida:
Amb l'objecte de contacte de Salesforce:
Comproveu si el títol 'Executiu de vendes' comença per 'Vendes' i 'executiu' per separat.
Contact obj = nou Contacte (Títol='Executiu de vendes');system.debug('Dades de contacte: '+obj);
// comença amb()
system.debug(obj.Title.startsWith('Vendes'));
system.debug(obj.Title.startsWith('executiu'));
Sortida:
6. acaba amb()
El mètode endsWith() de la classe 'cadena' d'Apex retorna true si la cadena especificada acaba amb el valor de cadena/camp donat de l'objecte de Salesforce. En cas contrari, es retorna false. Pren una cadena com a paràmetre.
Sintaxi:
- actual_string.endsWith(check_string)
- Salesforce_obj.fieldName.endsWith(check_string)
Exemple genèric:
Tinguem una cadena de 'suggeriment de Linux' i comprovem si comença amb les cadenes de 'suggeriment' i 'linux'.
String my_stri = 'suggeriment de Linux';system.debug('Actual: '+ my_stri);
system.debug('Acaba amb una pista: '+my_stri.endsWith('hint'));
system.debug('Acaba amb linux: '+my_stri.endsWith('linux'));
Sortida:
Amb l'objecte de contacte de Salesforce:
Comproveu si el títol 'Executiu de vendes' acaba amb 'Vendes' i 'executiu' per separat.
Contact obj = nou Contacte (Títol='Executiu de vendes');system.debug('Dades de contacte: '+obj);
// acaba amb()
system.debug(obj.Title.endsWith('Vendes'));
system.debug(obj.Title.endsWith('executiu'));
Sortida:
7. swapCase()
Aquest mètode està disponible a la classe 'cadena' Apex que intercanvia els caràcters de la cadena (Inferior - Superior)/(Superior - Inferior) i retorna la cadena actualitzada. No calen arguments per a aquest mètode.
Sintaxi:
- string.swapCase()
- Salesforce_obj.fieldName.swapCase()
Exemple genèric:
Tinguem una cadena 'Linux Hint' i intercanviem tots els caràcters que hi ha.
String my_stri = 'Suggeriment de Linux';system.debug('Actual: '+ my_stri);
system.debug('Caràcters intercanviats: '+ my_stri.swapCase());
Sortida:
Amb l'objecte del compte de Salesforce:
Considereu el compte amb el nom 'Linux Hint' i intercanvieu-hi tots els caràcters.
Compte obj = compte nou (Nom = 'Linux Hint');system.debug('Nom del compte: '+obj);
// swapCase()
system.debug(obj.Name.swapCase());
Sortida:
8. isAllLowerCase()
Podeu utilitzar aquest mètode si voleu comprovar si tots els caràcters de la cadena estan en minúscules. Si tots els caràcters estan en minúscules, es retorna true. En cas contrari, es retorna false. No es requereix cap paràmetre per a aquest mètode.
Sintaxi:
- string.isAllLowerCase()
- Salesforce_obj.fieldName.isAllLowerCase()
Exemple genèric:
Tinguem una cadena 'linuxhint' i apliquem el mètode isAllLowerCase() per comprovar si tots els caràcters de la cadena estan en minúscules.
String my_stri = 'linuxhint';system.debug('Actual: '+ my_stri);
system.debug( my_stri.isAllLowerCase());
Sortida:
Amb l'objecte del compte de Salesforce:
Comproveu si tots els caràcters del nom del compte 'linuxhint' estan en minúscules o no.
Compte obj = compte nou (Nom='linuxhint');system.debug('Nom del compte: '+obj);
// isAllLowerCase()
system.debug(obj.Name.isAllLowerCase());
Sortida:
9. isAllUpperCase()
De manera similar al mètode anterior, també podem comprovar si tots els caràcters de la cadena estan en majúscules o no. Tampoc no pren paràmetres i retorna un valor booleà (true/false).
Sintaxi:
- string.isAllUpperCase()
- Salesforce_obj.fieldName.isAllUpperCase()
Exemple genèric:
Tinguem una cadena 'LINUXHINT' i apliquem el mètode isAllUpperCase() per comprovar si tots els caràcters de la cadena estan en minúscules.
String my_stri = 'LINUXHINT';system.debug('Actual: '+ my_stri);
system.debug( my_stri.isAllUpperCase());
Sortida:
Amb l'objecte del compte de Salesforce:
Comproveu si tots els caràcters del nom del compte “AGRICULTURA” estan en majúscules o no.
Compte obj = compte nou (Nom='AGRICULTURA');system.debug('Nom del compte: '+obj);
// isAllLUpperCase()
system.debug(obj.Name.isAllUpperCase());
Sortida:
10. invers ()
El mètode reverse() de la classe 'cadena' d'Apex inverteix la cadena donada. Tampoc pren paràmetres i retorna la cadena.
Sintaxi:
- string.reverse()
- Salesforce_obj.fieldName.reverse()
Exemple genèric:
Tinguem una cadena de 'indicació de Linux' i invertim-la.
String my_stri = 'linuxhint';system.debug('Actual: '+ my_stri);
system.debug('Invertit: '+ my_stri.reverse());
Sortida:
Amb l'objecte del compte de Salesforce:
Creeu un objecte de compte amb el nom 'linuxhint' i inverteix-lo.
Compte obj = compte nou (Nom='linuxhint');system.debug('Nom del compte: '+obj);
// al revés()
system.debug(obj.Name.reverse());
Sortida:
Conclusió
Hem parlat de la classe 'cadena' de Salesforce Apex. A continuació, passem als seus mètodes i els comentem un per un en detall. En cada mètode, vam aprendre a aplicar aquests mètodes a cadenes simples i objectes estàndard de Salesforce com 'Compte' i 'Contacte'. Es comenten els 10 principals mètodes útils de la classe 'cadena' d'Apex juntament amb exemples i bones captures de pantalla de sortida. Després de llegir aquest article, ara ja sabeu com aplicar aquests mètodes de cadena a les dades de Salesforce.