Errores y resoluciones comunes en OmniStudio

1. Inicie sesión como administrador del sistema.
2. Desde Configuración, busque y seleccione OmniStudio.
3. Active el permiso de OmniStudio para su organización.

Si no ve la opción, verifique que su organización tiene licencias de OmniStudio. Haga contacto con su ejecutivo de cuentas de Salesforce si se necesitan licencias.

Sugerencia Tras activar los permisos de OmniStudio, los cambios pueden tardar unos minutos en propagarse por toda su organización. Si sigue viendo este error, intente cerrar sesión y volver a iniciar sesión.

• Intentar eliminar un OmniScript activo
• Intentar actualizar campos estructurales en un OmniScript activo
• Intentar cambiar Tipo, Subtipo o Idioma en un OmniScript activo

1. Desde el Iniciador de aplicación, busque y seleccione OmniScripts.
2. Localice el OmniScript que desea modificar o eliminar.
3. Tenga en cuenta la versión actual y advierta a los usuarios sobre la próxima desactivación.
4. Anule la selección de la casilla de verificación Activo para desactivar OmniScript y guardar sus cambios.
5. Ahora puede realizar los cambios que desee o eliminar el OmniScript.
6. Si realizó cambios, puede reactivar seleccionando la casilla de verificación Activo de nuevo.

Advertencia La desactivación de un OmniScript afecta inmediatamente a todos los usuarios y procesos que lo utilizan actualmente. Considere crear una nueva versión en vez de modificar la versión activa si necesita mantener la continuidad del servicio.

• Otro OmniScript con Tipo, Subtipo e Idioma idénticos ya está activo
• Creación de una nueva versión sin desactivar la versión anterior
• Múltiples versiones creadas e intentando activar más de una

Asegúrese de tener permisos para modificar registros de OmniScript y completar estas tareas.

1. Desde el Iniciador de aplicación, busque y seleccione OmniScripts.
2. Utilice filtros o busque OmniScripts con Tipo y Subtipo coincidentes.
3. Identifique el OmniScript activo actualmente con el mismo Type/SubType/Language.
4. Revise ambas versiones para determinar cuál debe permanecer activa.
5. Abra el OmniScript que desea desactivar.
6. Anule la selección de la casilla de verificación Activo y guarde sus cambios.
7. Vuelva a la nueva versión y actívela.

Advertencia Antes de activar una nueva versión, pruébela minuciosamente en un entorno de vista previa o sandbox. Cuando esté listo para implementar, desactive la versión antigua y active inmediatamente la nueva para minimizar el tiempo de inactividad.

• El campo Tipo está vacío o nulo
• El campo Subtipo está vacío o nulo
• El campo Idioma no está seleccionado
• Intentar guardar un nuevo OmniScript sin rellenar todos los campos obligatorios

Asegúrese de tener permisos para modificar registros de OmniScript y completar estas tareas.

1. Desde el Iniciador de aplicación, busque y seleccione OmniScripts.
2. En el panel de propiedades de OmniScript, localice el campo Tipo.
3. Ingrese un nombre de Tipo descriptivo como CustomerOnboarding o ClaimSubmission.
4. Localice el campo Subtipo e ingrese un nombre de Subtipo específico como Residencial o Comercial.
5. Seleccione un Idioma desde el menú desplegable.
6. Asegúrese de que los tres campos están rellenos y guarde sus cambios.
7. Vuelva a la nueva versión y actívela.

Sugerencia Seleccione nombres de Tipo y Subtipo con sentido que indiquen claramente el propósito de su OmniScript. Estos valores se convierten en parte de cómo hace referencia al OmniScript en sus aplicaciones y no se pueden cambiar fácilmente después de su creación.

• Los campos Tipo o Subtipo contienen espacios
• Los campos Tipo o Subtipo contienen guiones bajos
• Los campos Tipo o Subtipo contienen caracteres especiales no admitidos: !@#$%^&*, etc.
• Los campos Tipo o Subtipo contienen guiones u otra puntuación

1. Revise sus valores de Tipo y Subtipo.
2. Elimine cualquier espacio: utilice UpperCamelCase (o PascalCase) en su lugar. Por ejemplo, CustomerOnboarding.
3. Elimine los guiones bajos y sustitúyalos por UpperCamelCase (o PascalCase).
4. Elimine cualquier carácter especial.
5. Asegúrese de que solo se utilizan letras (A-Z, a-z) y números (0-9).
6. Guarde sus cambios.

Sugerencia Utilice PascalCase (también denominado UpperCamelCase) para valores de Tipo y Subtipo. Esto mejora la legibilidad sin requerir espacios o guiones bajos.

• El valor de tipo es demasiado largo.
• El valor SubType es demasiado largo.
• Tipo combinado + Subtipo + Idioma supera el límite de caracteres.

1. Revise el mensaje de error para ver la longitud máxima permitida.
2. Acorte su valor de Tipo o Subtipo.
3. Guarde sus cambios.

Sugerencia Utilice abreviaturas donde sea necesario. Elimine palabras redundantes. Utilice una convención de nomenclatura más corta.

El campo Tipo o Subtipo utiliza una palabra clave reservada. Las palabras clave restringidas comunes incluyen: in, out, exc, cb, kt, vt, v, x785f, x5f

Como se sugiere en el mensaje de error, sustituya la palabra clave restringida por un valor diferente. Consulte Palabras reservadas en la página Convenciones de nomenclatura de OmniStudio para obtener más información.

• Intentando agregar un nuevo elemento a un OmniScript activo.
• Intentar modificar un elemento existente en un OmniScript activo.
• Intentar eliminar un elemento de un OmniScript activo.
• El OmniScript está activo y en uso.

Asegúrese de tener permisos para modificar registros de OmniScript y completar estas tareas.

1. Verifique si el OmniScript está activo actualmente.
2. Considere crear una nueva versión en vez de modificar la versión activa.
3. Para crear una nueva versión: Haga clic en Duplicar en OmniScript.
4. Para modificar existentes: Desactive anulando la selección de la casilla de verificación Activo y guarde sus cambios.
5. Ahora puede agregar, actualizar o eliminar elementos.
6. Pruebe sus cambios.
7. Active el OmniScript cuando esté listo para su uso.

Advertencia Se recomienda crear una nueva versión para cambios significativos en vez de desactivar y modificar la versión activa. Esto le permite realizar pruebas exhaustivas antes de la implementación y proporciona una opción de reversión sencilla si surgen problemas.

• Otro elemento en el mismo OmniScript tiene el mismo nombre.
• Asigne un nombre a la colisión entre elementos en diferentes pasos.
• El elemento se copió y el nombre no cambió.

1. Revise todos los elementos en su OmniScript.
2. Identifique los elementos con los nombres en conflicto.
3. Decida qué elemento debe mantener el nombre.
4. Cambie el nombre del otro elemento con un nombre exclusivo.
5. Considere utilizar prefijos para indicar el paso o la sección, por ejemplo, step1_firstName, step2_firstName.
6. Actualice cualquier fórmula o asignación de datos que haga referencia al elemento con nombre nuevo y guarde sus cambios.

• El OmniScript procede de un paquete gestionado y no tiene permisos para modificarlo o eliminarlo.
• Intentando actualizar un OmniScript empaquetado desde fuera del espacio de nombres del paquete.

1. Verifique si el OmniScript procede de un paquete gestionado.
2. Si necesita personalizar el OmniScript, duplíquelo en su lugar.
3. Cambie el nombre de la versión duplicada con su propia combinación Tipo/SubTipo/Idioma.
4. Realice las modificaciones que desee en la versión duplicada, guarde y active su OmniScript.
5. Actualice cualquier fórmula o asignación de datos que haga referencia al elemento con nombre nuevo y guarde sus cambios.

Sugerencia Haga contacto con el proveedor del paquete o su administrador de Salesforce si necesita realizar cambios en componentes empaquetados. Pueden proporcionar opciones de configuración o puntos de extensión que no requieren modificar el OmniScript empaquetado directamente.

• El OmniScript es reutilizable.
• El OmniScript contiene elementos de OmniScript (OmniScripts integrados).
• Intentar hacer que un OmniScript sea reutilizable después de agregar OmniScripts integrados

1. Decida si este OmniScript debe ser reutilizable o contener OmniScripts integrados.
2. Opción 1: Mantenerlo reutilizable: Eliminar todos los elementos de OmniScript integrados
3. Opción 2: Permitir incrustación: Anule la selección de la casilla de verificación Reutilizable.
4. Si está eliminando OmniScripts integrados, considere utilizar Procedimientos de integración en su lugar. Puede refactorizar la lógica en Procedimientos de integración que se pueden llamar desde OmniScript.

Sugerencia Utilice Procedimientos de integración para lógica de negocio compartida en vez de anidar OmniScripts reutilizables. Esto crea una arquitectura más limpia y evita la complejidad en dependencias de OmniScript.

• Otra Flexcard con el mismo nombre ya está activa.
• Intentando activar una nueva versión sin desactivar la anterior.

1. Busque Flexcards con el mismo campo Nombre.
2. Revíselos para determinar cuáles deben permanecer activos.
3. Abra la Flexcard que desea desactivar.
4. Anule la selección de la casilla de verificación Activo para desactivar la Flexcard y guardar sus cambios.

Advertencia La desactivación de una Flexcard afecta inmediatamente a todos los usuarios y procesos que la utilizan actualmente. Considere crear una nueva versión en vez de modificar la versión activa si necesita mantener la continuidad del servicio.

1. Verifique si la Flexcard procede de un paquete gestionado.
2. Si necesita retirarlo del uso, desactívelo en vez de eliminarlo.
3. Para ello, abra la Flexcard y anule la selección de la casilla de verificación Activo.
4. Si necesita una versión personalizada de la Flexcard, duplíquela en su lugar.

Sugerencia Haga contacto con el proveedor del paquete o su administrador de Salesforce si necesita realizar cambios en componentes empaquetados. Pueden proporcionar opciones de configuración o puntos de extensión que no requieren modificar la Flexcard empaquetada directamente.

• El nombre del nombre de Flexcard secundario está mal escrito.
• La Flexcard secundaria existe pero no está activa.
• Se eliminó la Flexcard secundaria.
• La Flexcard secundaria está en un espacio de nombres diferente.

1. Desde el Iniciador de aplicación, busque y seleccione Anotar el nombre de Flexcard secundario desde el mensaje de error.
2. Busque la Flexcard secundaria por nombre.
3. Si se encuentra pero está inactivo, actívelo.
4. Si no se encuentra, verifique el nombre correcto.
5. Si el nombre es incorrecto, actualice la configuración principal de Flexcard.
6. En la Flexcard principal, localice la referencia de Flexcard secundaria.
7. Corrija el nombre para que coincida con una Flexcard activa existente y guarde la Flexcard principal.

Nota Las Flexcard secundarias deben activarse antes de que la Flexcard principal pueda hacer referencia a ellas. Cree y pruebe Flexcards secundarias primero, luego configure Flexcards principales para utilizarlas.

• El Tipo/Subtipo/Idioma de OmniScript es incorrecto.
• El OmniScript existe pero no está activo.
• Se eliminó el OmniScript.
• Se cambió el Tipo/SubTipo/Idioma del OmniScript.

1. Anote el Tipo, Subtipo e Idioma del mensaje de error.
2. Busque el OmniScript con Tipo y Subtipo coincidentes.
3. Verifique las coincidencias de Idioma.
4. Si se encuentra pero está inactivo, active el OmniScript.
5. Si no se encuentra, verifique los valores de Type/SubType/Language correctos.
6. Vuelva a su Flexcard y actualice la referencia de OmniScript con los valores correctos.
7. Guarde sus cambios.

Sugerencia Asegúrese de que el OmniScript al que se hace referencia está activo antes de activar la Flexcard. Si está implementando ambos juntos, active el OmniScript primero.

• El nombre del Asignador de datos está mal escrito.
• El Asignador de datos existe pero no está activo.
• Se eliminó el Asignador de datos.
• Se cambió el nombre del Asignador de datos.

1. Anote el nombre del Asignador de datos desde el mensaje de error.
2. Busque el Asignador de datos por nombre.
3. Si se encuentra pero está inactivo, actívelo.
4. Si no se encuentra, verifique el nombre correcto.
5. Vuelva a su Flexcard, actualice la referencia del Asignador de datos con el nombre correcto y guarde sus cambios.

Sugerencia Active Asignadores de datos antes de activar Flexcards que hacen referencia a ellos. Pruebe el Asignador de datos de forma independiente para asegurarse de que devuelve la estructura de datos esperada.

• El nombre del Procedimiento de integración es incorrecto.
• El Asignador de datos existe pero no está activo.
• Se eliminó el Asignador de datos.
• Está utilizando el formato de nomenclatura incorrecto (debería utilizar el formato Type_SubType).

1. Anote el nombre Procedimiento de integración desde el mensaje de error.
2. Busque el Procedimiento de integración.
3. Verifique que existe y anote su Tipo y Subtipo.
4. Si se encuentra pero está inactivo, actívelo.
5. Vuelva a su Flexcard.
6. Actualice la referencia Procedimiento de integración utilizando el formato: Type_SubType y guarde sus cambios.

Advertencia Se hace referencia a Procedimientos de integración utilizando su OmniProcessKey, que sigue el formato Type_SubType. Asegúrese de que está utilizando el formato correcto al configurar la Flexcard.

• Intenta cambiar el nombre de una Flexcard existente.
• Intentando cambiar el Autor de una Flexcard existente.
• El UniqueName se utiliza por otros componentes y no se puede cambiar.

1. Si necesita un nombre o autor diferente, duplique la Flexcard en su lugar.
2. Localice su Flexcard y duplíquela.
3. Ingrese el nuevo Nombre o Autor.
4. Realice cualquier otro cambio necesario en la versión duplicada y active su nueva Flexcard.
5. Actualice cualquier componente que haga referencia a la Flexcard antigua para utilizar la nueva.
6. Desactive la Flexcard antigua una vez que se actualicen todas las referencias.

• El Nombre del procedimiento de integración comienza por Basado en archivo.
• El Tipo de procedimiento de integración comienza por basado en archivos.
• El Subtipo de procedimiento de integración comienza por Basado en archivo.

1. Abra su procedimiento de integración.
2. Compruebe los campos Nombre, Tipo y Subtipo.
3. Si alguno comienza por Basado en archivos, seleccione un prefijo diferente.
4. Considere utilizar prefijos como Archivo, Documento, Datos o el nombre de su organización.
5. Actualice los campos proclives a errores y guarde sus cambios.

• El esquema de entrada JSON tiene objetos anidados con más de 10 niveles.
• El esquema de salida JSON tiene objetos anidados con más de 10 niveles.

1. Revise su estructura de esquemas JSON.
2. Identifique secciones profundamente anidadas.
3. Aplane la estructura reduciendo los niveles de anidación.
4. Considere mover datos profundamente anidados para separar procedimientos de integración.
5. Utilice matrices con objetos más planos en vez de jerarquías profundamente anidadas.
6. Reestructurar para mantener el anidamiento por debajo de 10 niveles.
7. Guarde el esquema actualizado.

Los esquemas JSON de procedimientos de integración tienen un límite máximo de 500 claves en toda la estructura. Esto incluye todas las claves en todos los niveles de anidación combinados. De forma específica:

• El esquema de entrada JSON contiene más de 500 claves en total.
• El esquema de salida JSON contiene más de 500 claves en total.
• El esquema incluye un gran número de campos entre múltiples objetos anidados.

1. Revise su esquema JSON.
2. Cuente el número total de claves en todos los niveles.
3. Identifique secciones con claves excesivas.
4. Considere dividir el Procedimiento de integración en múltiples procedimientos más pequeños.
5. Elimine claves no utilizadas o redundantes.
6. Utilice matrices para representar estructuras repetidas en vez de claves numeradas.
7. Consolide campos relacionados en subobjetos.
8. Guarde el esquema optimizado.

Sugerencia Si necesita legítimamente más de 500 claves, considere dividir el proceso en múltiples procedimientos de integración que se pueden encadenar entre sí.

• El sObject seleccionado no es compatible con operaciones de Asignador de datos.
• El sObject seleccionado es un objeto del sistema que no admite consultas.
• El sObject seleccionado no tiene la compatibilidad de API necesaria para trabajar con Asignadores de datos.

1. Revise el sObject que seleccionó como el tipo de entrada y compruebe si hay objetos compatibles en la Ayuda de Salesforce.
2. Considere utilizar un objeto relacionado diferente compatible.
3. Si necesita datos del objeto no admitido, utilice un Procedimiento de integración con Apex personalizado en su lugar.
4. Actualice su configuración de Asignador de datos con un objeto compatible y guarde sus cambios.

Nota La mayoría de los objetos estándar y personalizados son compatibles. Si encuentra un objeto no compatible, considere si puede reestructurar su flujo de datos para utilizar una alternativa compatible.

• OmniAnalytics para OmniStudio no está activado.
• Su organización no se configuró para OmniAnalytics.

1. Inicie sesión como administrador del sistema y, desde Configuración, busque Configuración de OmniStudio o Configuraciones de interacción.
2. Localice el parámetro OmniAnalytics para principal y actívelo.
3. Guarde sus cambios y espere unos minutos a que el cambio entre en vigor.
4. Pruebe si su seguimiento de análisis funciona.

Nota Verifique que Decision Explainer está configurado correctamente.

• El Id. no tiene un formato de Id. de Salesforce válido, con 15 o 18 caracteres.
• El Id. no pertenece al objeto OmniTrackingComponentDef.
• Se eliminó la definición del componente de seguimiento.
• El Id. es nulo o incorrecto.

1. Verifique el Id. de definición de componente que está utilizando.
2. Navegue a Configuración > OmniStudio > Seguimiento de Analytics y encuentre la definición de componente de seguimiento correcta.
3. Copie el Id. correcto del registro.
4. Actualice su código o configuración con el Id. correcto.
5. Si se eliminó la definición, cree una nueva definición de componente de seguimiento. Consulte Crear un grupo de seguimiento y agregar componentes a seguimiento.
6. Pruebe el seguimiento de nuevo.

Nota Verifique que Decision Explainer está configurado correctamente.