Loading
Gobernar, gestionar y publicar cambios con DevOps Center
Actualizar la versión de API de origen del proyecto Cada versión de Salesforce

Actualizar la versión de API de origen del proyecto Cada versión de Salesforce

Debido a que los proyectos en DevOps Center requieren un repositorio de control de origen que utiliza la estructura del proyecto Salesforce DX, cada proyecto DevOps Center contiene un archivo de configuración, sfdx-project.json. Durante cada ciclo de versión de Salesforce, cree un plan para actualizar la versión de API de origen para evitar errores de desajuste de versión de tipo de metadatos al mover cambios por sus oportunidades en curso de versión.

Cuando crea un nuevo repositorio de control de origen de proyecto, cada canalización y bifurcación de función creada desde la bifurcación principal contiene su propia versión del archivo de configuración de proyecto DX. Sin embargo, este archivo no se actualiza automáticamente durante las transiciones de versiones de Salesforce. En la mayoría de los casos, el único valor que requiere actualización es la opción sourceApiVersion.

La opción sourceApiVersion en sfdx-project.json determina la versión de metadatos que se recupera cuando confirma cambios en una bifurcación de función de elemento de trabajo o cuando promociona cambios a través de las oportunidades en curso de la versión. Este valor es importante si está utilizando un tipo de metadatos que cambió en una versión reciente o si desea acceder a nuevos tipos de metadatos durante o después de una transición de versión.

Por ejemplo, supongamos que se agregó un nuevo campo al objeto CustomTab para la versión 63.0 de la API. Si la sourceApiVersion en su archivo sfdx-project.json es la versión 62.0, verá errores al promocionar cambios que incluyen el nuevo campo.

Si está trabajando en un proyecto DevOps Center existente durante un tiempo, es probable que la sourceApiVersion esté anticuada.

Actualizar durante el desarrollo al trabajar en un nuevo elemento de trabajo

Si está trabajando activamente en cambios, este método es el más sencillo para actualizar la versión de API de origen en sus oportunidades en curso.

Si la versión de API de origen no se actualiza, se producen algunos comportamientos inesperados:

  • Cuando intenta agregar componentes manualmente a un elemento de trabajo, no los ve en la lista Agregar componentes.
  • Recibirá errores cuando intente confirmar cambios en la bifurcación de funciones del elemento de trabajo.
  • Recibirá cualquier error de no coincidencia de versión de metadatos al intentar promocionar cambios en la primera etapa de canalización.

Una forma sencilla de resolver los problemas es actualizar la sourceApiVersion en el archivo sfdx-project.json en la bifurcación de funciones del elemento de trabajo. El elemento de trabajo también debe contener cambios de metadatos así como los cambios en el archivo de proyecto DX.

A medida que promociona este elemento de trabajo a través de las oportunidades en curso de versión y lo publica en producción, el archivo de proyecto DX se actualiza en la bifurcación de cada etapa de oportunidad en curso y la bifurcación principal.

Actualizar manualmente en cada bifurcación de canalización y cualquier bifurcación de función requerida

Para prepararse para la siguiente versión de Salesforce, o durante la fase de planificación para su siguiente proyecto, puede actualizar de forma proactiva los archivos de proyectos DX en cada sucursal de modo que los miembros del equipo no tengan problemas al desarrollar y probar nuevos cambios.

Actualice manualmente la sourceApiVersion en el archivo de proyecto DX de cada sucursal directamente en el repositorio de control de origen. Para garantizar promociones satisfactorias, actualice la bifurcación principal, cada bifurcación de etapa de canalización y cualquier bifurcación de función.

 
Cargando
Salesforce Help | Article