Actualización de referencias codificadas

Preguntas generales más frecuentes

1. ¿Qué son las referencias codificadas (también referencias específicas de instancia)?

a) Una referencia codificada es una URL que contiene el nombre de la instancia en la URL (por ej. na1.salesforce.com). Sustituya estas referencias codificadas por direcciones URL no específicas de instancia o relativas (por ej. login.salesforce.com o <midominio>.my.salesforce.com).

Este es un ejemplo de una referencia codificada: https://na1.salesforce.com/{Case.Id}
Haga que esta sea una referencia relativa retirando, "na1.salesforce.com" de modo que se convierta en: /{Case.Id}

NOTA: Dentro de Salesforce, las referencias relativas le dirigirán automáticamente al registro correcto. Las solicitudes externas deberían enviarse a un extremo genérico, como: https://login.salesforce.com, en vez de https://na1.salesforce.com.
 

2. ¿Cómo puedo localizar las referencias codificadas?

a) Aproveche la herramienta de Salesforce Comprobación de preparación para Lightning Experience para descubrir las referencias codificadas, lo que también le ayuda a determinar su nivel de preparación para Lightning Experience:
En Lightning: diríjase a Configuración | Lightning Experience | Comprobar preparación
En Classic: vaya a Configuración | haga clic en "Primeros pasos" debajo de "Asistente de migración de Lightning Experience" | Comprobar preparación

Tenga en cuenta que pueden no aparecer todas las referencias codificadas con la herramienta Comprobación de preparación para Lightning Experience. Para aprender más sobre lo que informa esta herramienta, revise la documentación, ¿Qué evalúa la Comprobación de preparación para Lightning Experience?

b) Busque referencias codificadas con Salesforce Extensions for Visual Studio Code:
Salesforce Extensions for Visual Studio Code es una herramienta de desarrollador que puede aprovecharse para encontrar referencias codificadas. Siga los pasos del artículo Creación de un proyecto de Salesforce en Visual Studio Code y búsqueda de referencias codificadas para actualizar referencias codificadas* en su organización y en los metadatos de su organización (código de configuración o de cliente).

3. ¿Cómo actualizo las referencias codificadas en las integraciones?

Para sus integraciones de productos de Salesforce o de Force.com, utilice la solicitud login() de la API de Force.com como punto inicial. La solicitud login() debería enviarse a un extremo genérico, como: https://login.salesforce.com/services/Soap/u/26.0.
La llamada login() establecerá una sesión de Force.com y responderá con una dirección URL de inicio de sesión del servidor. Establezca esta dirección URL del servidor como el servidor de destino para las solicitudes posteriores de la API, y establezca el Id. de la sesión devuelta en el encabezado SOAP para proporcionar autorización del servidor para las solicitudes posteriores de la API.

Preguntas frecuentes relacionadas con la actualización de instancias y migración de organizaciones
Las preguntas sobre referencias codificadas pueden ser relevantes cuando se esté preparando para trasladarse a una nueva instancia.

4. ¿Qué referencias codificadas pueden redirigir los servidores de Salesforce tras un traslado a una nueva instancia?

Ya que no todas las referencias codificadas se redirigen tras una actualización de instancia o una migración de organización, recomendamos encarecidamente implementar Mi dominio y eliminar todas las referencias codificadas antes de un traslado. A continuación aparece una lista de los elementos que los servidores de Salesforce pueden redirigir; no obstante, podrá experimentar un rendimiento lento cuando utilice estos objetos tras el traslado a una nueva instancia: 

i. Vínculos de navegadores
ii. Direcciones URL agregadas a favoritos en navegadores
iii. Botones personalizados
iv. Direcciones URL de contenido
v. Publicaciones de Chatter
vi. Direcciones URL de inicio de sesión de autoservicio (sserv/login.jsp?orgid)
vii. Integraciones

5. ¿Qué referencias codificadas deben actualizarse (por ej., las que no se redireccionan) antes del traslado a una nueva instancia?

Si no tiene Mi dominio activado, deberá actualizar las referencias codificadas en plantillas de correo electrónico y artículos de Knowledge.
Tenga o no Mi dominio activado, tendrá que asegurarse de que todas las imágenes de artículos de Knowledge y plantillas de correo electrónico se hayan cargado desde su equipo, en contraposición a una dirección de Internet para que se sigan mostrando tras la operación de mantenimiento.

i. Si tiene imágenes que se hayan insertado a través de una dirección de Internet, tendrá que descargar la imagen a su equipo y volverla a cargar empleando la opción "Cargar imagen" cuando se inserte la imagen en un artículo de Knowledge o plantilla de correo electrónico. Consulte los siguientes diagramas que representan el proceso apropiado.

NOTA: Si encuentra imágenes que no se visualizan tras la operación de mantenimiento debido a que no se cargaron desde su equipo, tendrá que sustituir el nombre anterior de la instancia en la URL de la imagen por su nuevo nombre de instancia. A continuación, descargue la imagen a su equipo y vuélvala a cargar desde su equipo para evitar que la imagen deje de visualizarse tras operaciones de mantenimiento futuras.

6. ¿Cómo puedo verificar que todas las imágenes de mis artículos de Knowledge y plantillas de correo electrónico se han cargado desde mi equipo en contraposición a una dirección de Internet?

Si una imagen se ha cargado desde un equipo local, la dirección URL de la imagen será del tipo “https://[HOST-O-MI-DOMINIO]/servlet/rtaImage…”.

Si una imagen se ha vinculado desde una dirección de Internet (o desde su ficha Documentos), la dirección URL de la imagen será del tipo “https://[HOST-O-MI-DOMINIO]/servlet/servlet.ImageServer...” o bien “https://[HOST-O-MI-DOMINIO]/servlet/servlet.FileDownload…”

7. ¿Necesito actualizar las referencias codificadas en mis integraciones de CTI si me estoy trasladando a una nueva instancia?

Si está utilizando Open CTI y la URL de adaptador de CTI en su definición de centro de llamadas está codificada con su instancia de Salesforce (por ejemplo https://c.na6-visual.force.com/apex/Softphone ), su integración de CTI se verá afectada.
Cambie esta referencia codificada a una URL relativa (por ejemplo, /apex/Softphone) para garantizar que su integración de CTI siga funcionando tras el traslado a una nueva instancia. Para actualizarla, puede navegar a la ruta de clics específica del objeto de centro de llamadas: Configuración > Centros de llamadas.

Si está utilizando el Kit de herramientas de integración de CTI de sobremesa de Salesforce, esta operación de mantenimiento no afectará a su integración de CTI ya que el Kit de herramientas no admite referencias codificadas.

8. ¿Tengo que actualizar mis Id. de cadenas de correo electrónico si me estoy trasladando a una nueva instancia?

Si ha creado identificadores de cadenas de correo electrónico personalizados, es posible que se vea afectado tras el traslado a una nueva instancia. En caso contrario no se le requerirá que actualice los Id. de cadenas de correo electrónico existentes generados por Salesforce tras un traslado a una nueva instancia (incluso si aún se hace referencia a un nombre de la instancia anterior).

Revise los siguientes pasos para corregir un Id. de cadena de correo electrónico:
i. Actualice su fórmula personalizada al siguiente formato: ref:_00D[XX][yyyyy]._500[AA][bbbbb]:ref
ii. Donde yyyyy y bbbbb representan el Id. de 10 caracteres con los ceros iniciales retirados.
iii. Nuestro sistema puede analizar los formatos de Id. de cadena de correo electrónico de la manera siguiente: (yyyyy y bbbbb representan el Id. de registro sin los ceros iniciales)

NOTA: ref:00DXyyyyy.500Abbbbb:ref es el formato antiguo que ya no se utiliza.

Salesforce podría cambiar los formatos más adelante, lo que supone el motivo por el que los clientes no deben generar sus Id. de cadenas propios. Con los Id. de cadenas personalizados, puede experimentar un problema con Casos de correo electrónico (E2C), donde los nuevos casos que se creen no se adjuntan al caso original con respuestas. No cree sus propios formatos de Id. de cadenas personalizados. No admitimos oficialmente fórmulas personalizadas para Id. de cadenas de casos, por lo que recomendamos a los clientes que utilicen la fórmula de Id. de cadena ya preparada que genera Salesforce. Para obtener más información sobre el motivo por el que no debería personalizarlos, revise el artículo Utilizar Id. de cadenas personalizados con Casos de correo electrónico.

9. ¿Podrán los clientes acceder a nuestro portal de socios desde la URL de la instancia antigua después de trasladarnos a una nueva instancia?

Durante 30 días aproximadamente tras el traslado a una nueva instancia, los clientes pueden acceder a su portal de socios utilizando la URL de la instancia anterior. Después de este periodo de 30 días, se retirará la URL de inicio de sesión de la instancia anterior. Antes del traslado a una nueva instancia, recomendamos a los administradores que agreguen una nota personalizada bajo el mensaje "Mantenimiento del sistema" en sus portales de socios indicando a los clientes que utilicen la nueva URL del portal de socios tras el traslado a una nueva instancia. Los administradores también pueden recomendar a los clientes que actualicen sus marcadores de inicio de sesión con la nueva URL del portal de socios.

10. ¿Tendrá algún tipo de efecto en Candidatos Web/Casos Web (W2X) después de trasladarme a una nueva instancia?

Si tiene referencias codificadas en sus W2X, tendrá que actualizarlas a direcciones URL relativas antes del traslado a una nueva instancia. Si no actualiza las referencias codificadas, es posible que sufra interrupciones no intencionadas del servicio en W2X tras la operación de mantenimiento. W2X se pondrán en cola y se procesarán después de finalizar el mantenimiento.

11. ¿Es necesario actualizar los nombres de sitios remotos después del traslado a una nueva instancia?

Sí. Si no está utilizando Mi dominio, las referencias codificadas en los nombres de sitios remotos necesitarán actualizarse con el nuevo nombre de la instancia inmediatamente después de la operación de mantenimiento.
Si no actualiza las referencias codificadas en los nombres de sitios remotos tras la operación de mantenimiento, es posible que sufra interrupciones no intencionadas del servicio en los sitios remotos.

12. ¿Afectará el traslado a una nueva instancia a Salesforce Mobile SDK?

El traslado a una nueva instancia puede afectar a los datos de las aplicaciones creadas con el Salesforce Mobile SDK si los usuarios no tienen las versiones más recientes. Recomendamos que actualice todas las aplicaciones creadas con el Salesforce Mobile SDK y distribuya estas actualizaciones a todos los usuarios de su organización antes de la operación de mantenimiento.
Si los usuarios disponen de las versiones más recientes de todas las aplicaciones creadas con el Salesforce Mobile SDK, el traslado a una nueva instancia no debería afectar a los datos de las aplicaciones.

13. ¿Qué hago si tengo una implementación de Live Agent o Emergencia?

Si su página web o certificados tienen una referencia codificada a la URL del extremo de Live Agent, entonces una actualización de instancia, una migración de organización o un cambio de sitio pueden afectar a sus funciones de Live Agent/Emergencia. Para reducir al mínimo el impacto, siga las prácticas recomendadas y evite utilizar cualquier referencia codificada al extremo y asegúrese de que actualiza la URL del extremo en el código de Implementación que copió de la página Implementación en Configuración. El código de Implementación que proporcionamos tiene la capacidad de redirigir al servidor que se acaba de asignar, pero aún deberá actualizar el extremo inmediatamente después de que se realice la actualización. 

Para obtener más información sobre los extremos de Live Agent y lo que significan las referencias codificadas a un extremo, revise el artículo, El servidor de Live Agent (URL de extremo) ha cambiado y ahora el Chat de Live Agent no funciona.

14. ¿Qué acciones debo realizar para los WSDL generados por los servicios Web de Apex?

Si utiliza WSDL para generar código, todas las áreas donde haya utilizado el código tendrán que comprobarse por si existieran referencias codificadas. Todas las referencias codificadas deberán actualizarse a una dirección URL de Mi dominio o una URL relativa (login.salesforce.com). Recomendamos la implementación de Mi dominio antes del traslado a una nueva instancia. Esta acción garantizará que una vez haya solucionado todas las referencias codificadas para que apunten a la nueva dirección URL de Mi domino, no tendrá que realizar este trabajo de nuevo.