Aprenda MOAR en Summer '22 con servicios externos y actualizaciones de API ☁️

Esta es una traducción que desde EGA Futura ofrecemos como cortesía a toda la Ohana y comunidad de programadores , consultores , administradores y arquitectos de Salesforce para toda Iberoamérica .

El enlace a la publicación original, lo encontrarás al final de este artículo.

…

Siga y complete un trailmix de Learn MOAR Summer '22 para administradores o desarrolladores antes del 31 de julio de 2022 a las 11:59 p. Se aplican restricciones. Aprenda cómo participar y revise las reglas oficiales visitando la página de Trailhead Quests .

Cuando se trata del desarrollo de Salesforce, la automatización y la integración van de la mano, por lo que estamos entusiasmados con las últimas actualizaciones de las API de Salesforce . Además de esto, los servicios externos han continuado expandiéndose como una característica de la plataforma de Salesforce, brindando a los clientes la capacidad de automatizar múltiples sistemas sin tener que escribir código personalizado. En esta publicación de blog, echaremos un vistazo a todas las nuevas características de los Servicios externos, así como algunas fantásticas actualizaciones de API, disponibles en la versión Summer '22.

Actualizaciones de servicios externos

Mediante el uso de servicios externos, los desarrolladores y administradores pueden tomar un proceso que se encuentra detrás de una especificación OpenAPI y acelerar la creación de acciones que invocan la funcionalidad en otros sistemas desde Salesforce. Esto proporciona una forma valiosa de aprovechar las herramientas de automatización de procesos de Salesforce para automatizar e integrar cualquier cosa.

Llame a servicios externos de forma nativa desde Apex

¡Tus servicios externos ahora son más reutilizables que nunca! Con esta versión, puede llamar a sus acciones registradas de Servicios externos directamente desde Apex . Este proceso es similar a realizar una llamada a un servicio externo con Apex Http Class, pero sin escribir código repetitivo. Esto elimina la sobrecarga de tener que escribir una integración varias veces en su organización. Anteriormente, las acciones registradas en Servicios externos solo estaban disponibles a través de Flow o Bots.

Usando la especificación API de un servicio web bancario ficticio, el siguiente código de Apex resalta las clases que se crean automáticamente cuando registra el esquema en Servicios externos.

Ejemplo

Especificaciones de la API del servicio bancario

 "caminos": { "/cuentas/{nombre de la cuenta}": { "conseguir": { "IdOperación": " obtenerCuenta ", "summary": "Recupera una cuenta", "description": "Recupera la cuenta con un nombre específico", "parámetros": [ { "nombre": "nombre de cuenta", "en": "camino", "obligatorio": cierto, "descripción": "Nombre de la cuenta", "esquema": { "tipo": "cadena" } } ], " respuestas ": { " 200 ": { "description": "La respuesta cuando el sistema encuentra una cuenta con el nombre dado", "contenido": { "aplicación/json": { "esquema": { "$ref": "#/componentes/esquemas/cuentaDetalles" } } } },

Registro de Servicios Externos del Servicio Bancario

Código Apex del servicio bancario
Todas las clases que necesita se crean automáticamente cuando registra el esquema como un servicio externo. También se puede acceder a ellos en la página de configuración de Servicios externos de su organización. En este ejemplo tenemos el. getAccount , getAccount_Request y getAccount_Response

 //Llamar a acciones registradas de servicios externos desde Apex //Crear una instancia de la clase de Apex de servicios externos ExternalService.bankService servicio = new ExternalService.bankService(); //Establecer solicitud
ExternalService.bankService.*getAccount_Request* solicitud = new ExternalService.bankService.getAccount_Request(); request.accountName = 'KevinWong'; tratar { //Hacer llamada ExternalService.bankService.*getAccount_Response* respuesta = servicio.*getAccount*(solicitud); system.debug ('respuesta 200: id -->' + respuesta.Code200.id); system.debug ('respuesta 200: saldo disponible -->'+ respuesta.Code200.balaldisponible); } captura (ExternalService.bankService.getAccount_ResponseException exc){ system.debug('404 respuesta: mensaje de error --> '+ exc.Code404.errorMessage);
}

Actualizar esquemas existentes conectados a Flow

Si un registro está en uso por un flujo o en Apex (¡los bots llegarán pronto!), ahora puede actualizarlo con una nueva versión de especificación de API compatible . Anteriormente, no podía actualizar un esquema registrado que estaba en uso por un flujo. Si la nueva versión del esquema no es compatible, el flujo de trabajo de edición le notifica qué operaciones y objetos de esquema están en uso, por qué flujos y por qué clases de Apex. Con esta información, sabrá qué referencias existentes son incompatibles, para que pueda eliminarlas antes de guardar su registro actualizado.

Pantalla de edición de servicios externos

actualizaciones de API

Hay una serie de actualizaciones de la API disponibles en la versión Summer '22, incluidas las actualizaciones de la API masiva y la API de la interfaz de usuario.

API masivas

Las API masivas han recibido algunas actualizaciones excelentes que le brindan límites de Apex más apropiados para admitir cargas de trabajo asincrónicas a gran escala, incluido el cambio del límite de tiempo de la CPU de 10 segundos a 60 segundos. Esto le dará la capacidad de innovar realmente en la plataforma con la confianza de que las integraciones a gran escala serán exitosas.

API de interfaz de usuario

La API de interfaz de usuario ahora tiene la capacidad de obtener datos de registro para una lista relacionada o un lote de listas relacionadas. Puede acceder a estos a través de la API directamente enviando una solicitud de publicación a /ui-api/related-list-records/ o /ui-api/related-list-records/batch/ . También puede acceder a estas API directamente desde sus componentes web Lightning utilizando los nuevos adaptadores de cable para obtener información y registros de listas relacionadas.

Este módulo incluye nuevos adaptadores de cables para obtener registros y metadatos para un lote de listas relacionadas:

getRelatedListRecordsBatch : devuelve datos de registro para un lote de listas relacionadas
getRelatedListInfoBatch : devuelve metadatos para un lote de listas relacionadas

Estos adaptadores de cables para obtener registros, metadatos y recuentos de registros para una lista relacionada ya están disponibles de forma general:

getRelatedListRecords : devuelve datos de registro para una lista relacionada
getRelatedListInfo — devuelve metadatos para una lista relacionada
getRelatedListsInfo : devuelve metadatos para listas relacionadas en el diseño predeterminado de un objeto
getRelatedListCount : devuelve el recuento de registros de una lista relacionada

Este ejemplo obtiene una lista de lista relacionada de un registro y pasa parentRecordId y relatedLIstParamaters al adaptador de cable getRelatedListRecordsBatch .

 importar { LightningElement, cable } de 'lwc';
importar { getRelatedListRecordsBatch } desde 'lightning/uiRelatedListApi'; exportar la clase predeterminada LdsGetRelatedListRecordsBatch extiende LightningElement { @wire(getRelatedListRecordsBatch, { parentRecordId: '001RM000003UNu6YAG', Parámetros de lista relacionados: [ { RelatedListId: 'Contactos', campos: ['Contacto.Nombre','Contacto.Id'] }, { relatedListId: 'Oportunidades', campos: ['Oportunidad.Nombre','Oportunidad.Cantidad'] } ] })
}

Otras características notables

Ahora hay un código de error 401:GONE cuando se elimina o retira un servicio.
La API de GraphQL ahora está en Beta.
Las versiones de API heredadas 7.0 a 20.0 ahora están retiradas .
Las versiones de API heredadas 21.0 a 30.0 se retirarán en Summer '23.

Obtenga más información sobre todas las actualizaciones de API en Actualizaciones de API y nuevas funciones en las Notas de la versión de Summer '22.

Aprende MOAR esta semana

Los gerentes de producto y el equipo de relaciones con los desarrolladores están de regreso para compartir las características y funcionalidades más recientes en Summer '22. Para ayudarlo a desarrollarse más rápido, el nuevo contenido de Developer Relations cubrirá sus nuevas funciones favoritas. Además, asegúrese de consultar Release Readiness Live el viernes 20 de mayo de 2022 a las 9:00 a. m. PST . Por último, esté atento al blog de desarrolladores de Salesforce todos los días de esta semana para obtener más publicaciones sobre Summer '22.

Para obtener aún más información, consulte la mezcla de senderos Summer '22 .

Sobre el Autor

Andrea Guzman es Product Manager de Servicios Externos. Trabaja en productos de integración de Salesforce que aprovechan los estándares de la industria API para generar bloques de construcción declarativos en la Plataforma de Salesforce, lo que permite a los desarrolladores y administradores crear integraciones y flujos de trabajo entre sistemas. Cuando Andrea no está trabajando, le gusta viajar, hacer caminatas y jugar fútbol.

Stephan Chandler-Garcia es desarrollador evangelista sénior en Salesforce. Se centra en el desarrollo de aplicaciones, la seguridad y Experience Cloud. Puedes seguirlo en Twitter @stephanwcg .