Solución de problemas del App Builder

Esta guía cubre errores e inconvenientes comunes que se encuentran al instalar, configurar y usar Jitterbit App Builder. Comienza con los pasos de diagnóstico a continuación, luego encuentra tu problema específico en la sección correspondiente.

Para una referencia unificada que cubra problemas de integración, automatización, gestión de API, EDI y desarrollo de aplicaciones en un solo lugar, consulta la guía de solución de problemas de Harmony.

Pasos de diagnóstico

Verifica tu compilación con respecto a las notas de la versión

App Builder se entrega como versiones discretas locales (App Builder 4.0 y posteriores; la línea 3.x y anteriores se denominaba Vinyl, cuya documentación se mantiene por separado), y cada versión incluye correcciones acumuladas. Un síntoma que estás persiguiendo puede haber sido resuelto en una compilación más nueva, así que anota la compilación que estás utilizando y revisa las notas de la versión de App Builder en busca de una corrección correspondiente antes de investigar más a fondo. Actualizar a la versión más reciente disponible es la forma más rápida de descartar eso.

Determina si el error es del lado del cliente o del lado del servidor

Los errores del lado del cliente y del lado del servidor se diagnostican en diferentes lugares, y solo los errores del lado del servidor llegan a los registros de App Builder:

• Errores del lado del servidor ocurren en App Builder mismo y casi siempre se registran en los registros de la aplicación. Puedes recuperar los detalles más tarde incluso si el usuario no copió el mensaje cuando apareció.
• Errores del lado del cliente ocurren en el navegador en la computadora del usuario y no son registrados por App Builder. Para ver el detalle, abre las herramientas de desarrollador del navegador (F12 en Chrome o Edge) y verifica el panel Consola mientras reproduces el error.

Un error que reporta un valor de Url y hace referencia a un archivo de JavaScript (.js) es del lado del cliente. Las causas comunes son el diseño de la página, un problema en la plantilla de la aplicación o un widget, o una conexión de red lenta o interrumpida.

El panel de Red del navegador también muestra el código de estado HTTP devuelto para cada solicitud, lo que distingue un error del cliente (por ejemplo, 401 o 404) de un error del servidor (por ejemplo, 500 o 504). Consulta Identificar códigos de error HTTP.

Verifica los registros de la aplicación

App Builder registra los logs tanto en el producto como en archivos en el servidor. Desde IDE > Monitoreo, puedes ver varios tipos de registros, cada uno adecuado para un tipo diferente de problema:

• Registros de Base de Datos y Registros de Memoria: Entradas de error y eventos de la aplicación, incluyendo trazas de pila. Comienza aquí para la mayoría de los errores. Las entradas están ordenadas por LogId, así que ordénalas en orden descendente para llevar el error más reciente a la parte superior.
• Registros de Eventos y Eventos del Sistema: Actividad de eventos en segundo plano y a nivel del sistema.

Para capturar más detalles, selecciona una entrada de registro, haz clic en Editar Configuración y aumenta la verbosidad del registro (por ejemplo, a Trace). Para incluir también los datos de la aplicación que App Builder normalmente oculta en los registros, habilita Registrar Datos Seguros; consulta Registrar datos seguros.

Desde el mismo diálogo, utiliza Descargar Registros de Disco para descargar los registros de disco de todos los servidores en el entorno. Los archivos también se escriben en el directorio logs bajo la raíz de instalación de App Builder. Para todas las opciones de Monitoreo, consulta Página de Monitoreo del IDE.

Habilitar el registro del servidor de datos CData

Muchos conectores de App Builder están basados en CData. Si un problema involucra uno de estos servidores de datos, habilita el registro para él y descarga el archivo de registro para inspeccionar los detalles a nivel de conector. Consulta Habilitar el registro del servidor de datos CData.

Verificar registros de sesión, vistas de página y REST

Dependiendo del problema, otros registros pueden ser más útiles que los registros de la aplicación:

• Registros de sesión y vistas de página: Los registros de sesión ayudan con problemas de autenticación, autorización e identidad; los registros de vistas de página muestran qué páginas visitó un usuario. Consulta Registro de actividad de vistas de página y sesiones.
• Pestaña de sesiones: Desde Monitoreo > Sesiones, verifica quién está actualmente conectado, la última actividad de cada sesión y el conteo de vistas de página.
• Registros de REST: Soluciona problemas de llamadas API entrantes y salientes y webhooks. Consulta Configurar el registro de REST.

Copiar mensajes de error desde la interfaz de usuario

Cuando aparece un mensaje de error en la interfaz de usuario de App Builder, utiliza el botón Copiar dentro de la región de error para copiar el texto completo del error en tu portapapeles. Pégalo en un editor de texto o en un caso de soporte para una revisión más fácil. En el registro copiado, desplázate hasta los datos de la excepción, que suelen ser la parte más descriptiva y a menudo suficiente para resolver el error por ti mismo. Si Registrar datos seguros está habilitado, los metadatos de la consulta SQL aparecerán debajo de esto.

Diagnosticar problemas de conectividad de red

Las fallas de conexión ocurren en uno de dos caminos: desde el navegador de un usuario hasta el servidor de App Builder, o desde el servidor de App Builder hasta otro servidor como una base de datos, una API o un host SMTP. Ejecuta estos comandos desde la máquina al inicio del camino que falla, de modo que una prueba desde el servidor de App Builder se ejecute en ese servidor en lugar de en una estación de trabajo:

• telnet <hostname> <port> o, en PowerShell, Test-NetConnection <hostname> -Port <port>: confirma que se puede abrir una conexión TCP al puerto. Un fallo indica una regla de firewall, un puerto incorrecto o un servicio que no está escuchando.
• nslookup <hostname>: confirma que el nombre de host se resuelve a la dirección esperada.
• ping <hostname> y tracert <hostname>: muestran si el host es accesible y la ruta tomada, en redes que permiten tráfico ICMP.
• ipconfig /displaydns: lista las entradas DNS en caché, lo cual es útil después de que un registro DNS ha cambiado.

Las causas frecuentes de fallos de conexión incluyen un nombre de host o puerto incorrecto, resolución DNS, un firewall o lista de permitidos que omite algunas de las direcciones IP del servicio remoto (algunos servicios publican un amplio rango), configuración de IIS y un servidor sobrecargado o mal configurado entre los dos puntos finales.

Capture a HAR file

Un archivo HAR (HTTP Archive) registra cada solicitud de red que un navegador realizó mientras se cargaba una página o se realizaba una acción. Es útil cuando una página carga lentamente, nunca termina de cargar o falla sin producir un error registrado, y el soporte de Jitterbit puede pedirte que proporciones uno. Para el procedimiento, consulta Generar un archivo .har.

Retrieve a process dump

Si App Builder responde lentamente o no responde, recuperar un volcado de proceso del proceso de trabajo w3wp.exe de IIS puede ayudar al soporte a diagnosticar la causa. Consulta Recuperar un archivo de volcado para obtener instrucciones.

Instalación y puesta en marcha

App Builder no inicia y muestra un error 500

• Síntoma: App Builder no inicia en IIS y devuelve un error HTTP 500.
• Causa posible: El paquete de hospedaje de ASP.NET Core Runtime que requiere App Builder no está instalado en el servidor Windows, por lo que IIS no puede iniciar la aplicación.
• Resolución:
  1. Instalar el paquete de hospedaje de ASP.NET Core Runtime requerido por App Builder, como se indica en los Requisitos del sistema.
  2. Reiniciar IIS y verificar que App Builder se cargue correctamente.

App Builder no inicia y muestra un error HTTP 500.30

• Síntoma: App Builder no inicia y devuelve:

  HTTP Error 500.30 - ASP.NET Core app failed to start
  

• Causa posible: La identidad del grupo de aplicaciones de IIS no tiene acceso completo a la carpeta raíz de App Builder, por lo que la aplicación no puede iniciar.

• Resolución:

  1. Otorgar a la identidad del grupo de aplicaciones de App Builder (por defecto, IIS AppPool\Vinyl) Control total de la carpeta raíz de App Builder. Ver Establecer permisos.
  2. Reiniciar el grupo de aplicaciones, luego recargar App Builder.

App Builder devuelve un error HTTP 503

• Síntoma: Abrir App Builder devuelve:

  HTTP Error 503. The service is unavailable.
  

• Causa posible: El grupo de aplicaciones de IIS para App Builder está detenido.

• Resolución:

  1. Abrir Administrador de IIS y seleccionar Grupos de aplicaciones.
  2. Seleccionar el grupo de aplicaciones de App Builder (por defecto, Vinyl), luego seleccionar Iniciar.

  Nota

  Si el grupo de aplicaciones se detiene nuevamente inmediatamente después de iniciar, es probable que App Builder esté fallando al iniciar. Revise los registros de la aplicación y el Visor de eventos de Windows para el error subyacente.

App Builder inicia pero no crea bases de datos

• Síntoma: App Builder inicia correctamente pero no se crean bases de datos en el SQL Server.
• Causa posible: El archivo de conexión tiene una extensión incorrecta (por ejemplo, .txt en lugar de .xml).
• Resolución: Localice el archivo de conexión de App Builder y confirme que use la extensión .xml. Cambie el nombre del archivo si la extensión es incorrecta, luego reinicie App Builder. Si App Builder inicia pero devuelve un error de conexión en lugar de crear silenciosamente ninguna base de datos, consulte Ocurre un error al cargar la información de conexión de la base de datos.

Ocurre un error al cargar la información de conexión de la base de datos

• Síntoma: App Builder devuelve el siguiente error:

  An error occurred while attempting to load the database connection information.
  

• Causa posible: El archivo Connection.xml está ausente o contiene datos de conexión incorrectos.

• Resolución:

  • Reemplace o actualice Connection.xml con los datos de conexión correctos, luego reinicie App Builder. Consulte Crear un archivo de conexión.
  • Si App Builder inicia sin un error pero no crea bases de datos, consulte App Builder inicia pero no crea bases de datos.

App Builder se carga con estilos faltantes o rotos

• Síntoma: App Builder inicia, pero las páginas se renderizan con estilos faltantes o rotos (CSS).
• Causa posible: El archivo ZIP de instalación no fue desbloqueado antes de ser extraído. Windows marca los archivos descargados de otra computadora como bloqueados (la "marca de la web"), y extraer un archivo comprimido que aún está bloqueado propaga esa marca a los archivos extraídos, lo que puede impedir que los activos de estilo de App Builder se carguen correctamente.
• Resolución:
  1. Eliminar los archivos extraídos.
  2. Desbloquear el archivo ZIP original: haz clic derecho sobre él, selecciona Propiedades, abre la pestaña Seguridad y selecciona Desbloquear. Consulta Obtener y descomprimir el software.
  3. Extraer el ZIP nuevamente, luego reiniciar la instalación o actualización.

La carga de la licencia falla

• Síntoma: La carga de un archivo de licencia falla con uno de los siguientes errores:

  An unknown error occurred.
  

  405 POST Method not allowed
  

  Failed to deserialize license (d3fc6d4e835e)
  

• Causa posible: WebDAV está instalado o habilitado en IIS y puede interferir con la solicitud POST utilizada para cargar la licencia.

• Resolución:
  1. Desinstalar o deshabilitar el módulo WebDAV en IIS.
  2. Reintentar la carga de la licencia.
  3. Si WebDAV es necesario para otras aplicaciones en el servidor, contactar a soporte de Jitterbit para obtener orientación sobre cómo configurar ambos servicios para coexistir.

App Builder no se inicia automáticamente después de un reinicio del servidor

• Síntoma: El App Builder no se vuelve disponible automáticamente después de que el servidor de Windows se reinicia, requiriendo una primera solicitud manual para inicializar la aplicación.
• Resolución: Para los pasos de resolución, consulta Solucionar el comportamiento de inicio automático.

Implementación de Docker: No se puede cargar la licencia de App Builder 4.x en la interfaz de usuario

• Síntoma: Después de actualizar de Vinyl 3.3 a App Builder 4.x en Docker, la carga de la licencia de App Builder a través de la interfaz de usuario de App Builder falla o la opción no está disponible.
• Causa posible: Las implementaciones de Docker de App Builder 4.x no soportan la carga de licencias a través de la interfaz de usuario.
• Resolución: Proporciona la licencia a través de uno de los siguientes métodos:
  • En el archivo docker-compose.yml, establece la variable de entorno License__LicenseKey con la clave de licencia de App Builder 4.x codificada en base64.
  • Agrega la clave de licencia al archivo appsettings.json en el subdirectorio data del directorio de Docker compose.

Alta disponibilidad: Todas las instancias deben usar el mismo appsettings.json

• Síntoma: En una implementación de alta disponibilidad, algunos nodos de App Builder se comportan de manera diferente a otros (por ejemplo, la autenticación funciona en algunos nodos pero no en otros, o las claves de cifrado de datos son inconsistentes entre nodos).
• Causa posible: Cada instancia de App Builder en una implementación de alta disponibilidad debe usar un archivo de configuración appsettings.json idéntico. Si los archivos difieren entre instancias, el comportamiento será inconsistente entre nodos.
• Resolución:
  • Confirma que todas las instancias de App Builder en la implementación de HA tengan archivos appsettings.json idénticos.
  • Después de cambiar la configuración en una instancia, aplica el mismo cambio a todas las demás instancias y reinicia cada una.

Fallos de autenticación

Fallos de inicio de sesión SSO o redirección a la URL incorrecta

• Síntoma: Los usuarios que intentan iniciar sesión a través de inicio de sesión único (SSO) encuentran un error de redirección o son enviados a una URL inesperada.
• Causas posibles:
  • La URI de redirección configurada en el Proveedor de Identidad (IdP) no coincide con la URL que está utilizando App Builder.
  • Un proxy inverso o balanceador de carga frente a App Builder (por ejemplo, IIS detrás de un F5) termina TLS, por lo que App Builder ve http mientras que la URL pública utiliza https. La URI de redirección entonces utiliza el protocolo incorrecto y no coincide con el valor registrado en el IdP.
  • La URL de integración SSO en App Builder hace referencia a una dirección obsoleta o incorrecta.
  • El proveedor de seguridad OpenID Connect en App Builder está mal configurado.
• Resolución:
  • En el IdP (por ejemplo, Okta o Azure AD), confirma que la URI de redirección coincide exactamente con la URL de la aplicación de App Builder, incluyendo el protocolo (https://) y cualquier ruta.
  • En App Builder, revisa la configuración del proveedor de seguridad en IDE > Proveedores de Seguridad y verifica que la configuración de OpenID Connect coincida con los valores esperados por el IdP.
  • Si la URL de App Builder ha cambiado (por ejemplo, después de una migración o actualización de dominio), actualiza la URI de redirección tanto en App Builder como en el IdP.

La URL base no redirige a la página de inicio de sesión

• Síntoma: Abrir la URL base de un entorno de App Builder (por ejemplo, https://example.com/) no redirige a la página de inicio de sesión. Los visitantes no autenticados son llevados directamente a una aplicación en su lugar.
• Causa posible: El usuario anonymous incorporado tiene acceso a la página de inicio de una aplicación. App Builder redirige automáticamente a cada usuario a una página de inicio a la que pueden acceder, por lo que cuando el usuario anonymous puede acceder a la página de inicio de una aplicación, todos los visitantes no autenticados son redirigidos allí en lugar de a la página de inicio de sesión.
• Resolución: Eliminar el acceso del usuario anonymous a la página de inicio de la aplicación para que los visitantes no autenticados sean dirigidos a la página de inicio de sesión.

Los usuarios locales no pueden restablecer una contraseña olvidada

• Síntoma: Los usuarios locales no pueden restablecer una contraseña olvidada. El enlace Olvidé mi contraseña en la pantalla de inicio de sesión falta o no completa el restablecimiento.
• Causa posible: Al grupo de Usuarios anónimos no se le ha otorgado acceso a la aplicación de restablecimiento de contraseña, por lo que los usuarios no autenticados no pueden acceder al flujo de trabajo de restablecimiento de contraseña.
• Resolución: Otorgar al grupo de Usuarios anónimos acceso a la aplicación App Builder - Restablecimiento de contraseña y agregarlo al rol de Restablecimiento de contraseña. Consulte Restablecimiento de contraseña para los pasos completos de configuración, incluido el ajuste de SMTP requerido.

La autenticación de Salesforce OAuth falla o se autentica con la instancia incorrecta

• Síntoma: Los usuarios que inician sesión con SSO de Salesforce son autenticados inesperadamente con la instancia incorrecta de Salesforce, o los tokens de Salesforce dejan de funcionar y se solicita a los usuarios que se reautenticen repetidamente.
• Causas posibles:
  • Múltiples instancias de App Builder comparten la misma Aplicación Conectada de Salesforce. Salesforce retiene solo los cuatro tokens de actualización más recientes por Aplicación Conectada. Cuando se emite un quinto token, el más antiguo se invalida, lo que provoca que la instancia que tiene ese token pierda la autenticación.
  • Múltiples instancias de Salesforce están configuradas en App Builder, y el navegador del usuario ya tiene una sesión activa con una instancia de Salesforce. Cuando el usuario intenta iniciar sesión en una segunda instancia, Salesforce reutiliza la sesión existente y registra al usuario en la primera instancia en su lugar.
• Resolución:
  • Asignar una Aplicación Conectada de Salesforce separada a cada instancia de App Builder para evitar conflictos de tokens de actualización. Consulte la documentación del proveedor de seguridad de Salesforce para obtener detalles de configuración.
  • Si un usuario se está autenticando con la instancia incorrecta de Salesforce, pídale que cierre sesión de todas las sesiones activas de Salesforce en su navegador antes de intentar iniciar sesión nuevamente.

Rendimiento

El App Builder es lento o no responde

• Síntoma: El App Builder responde lentamente a las interacciones del usuario, o las cargas de página y las consultas se agotan.
• Causas posibles:
  • El servidor de App Builder tiene recursos de CPU o memoria insuficientes para la carga actual.
  • Un problema de red entre el usuario y el servidor de App Builder, como un ancho de banda limitado, pérdida de paquetes o un firewall, está ralentizando la transmisión de datos.
  • Consultas o lógica de aplicación no optimizadas están produciendo páginas lentas, o un servicio en segundo plano está consumiendo recursos excesivos.
  • El proceso de trabajo de IIS ha entrado en un estado no saludable.
  • Una operación de larga duración superó el tiempo de espera de un proxy, balanceador de carga u otro dispositivo de red entre el navegador y App Builder, lo que desconectó el navegador. El navegador informa un error como 504 Gateway Timeout, pero la operación sigue ejecutándose en el servidor y puede tener éxito o fallar después de que el navegador se desconecte.
• Resolución:
  • Revisar la utilización de recursos del servidor (CPU, memoria, disco I/O) para identificar cualquier saturación de recursos.
  • Para descartar un problema de red, conectarse desde una red diferente (por ejemplo, otra red Wi-Fi o un dispositivo móvil en una conexión celular) y realizar una prueba de velocidad de internet. Si el rendimiento mejora en otra red, la causa probablemente sea un ancho de banda limitado, un problema con el ISP o un firewall, en lugar del App Builder en sí.
  • Revisar los registros de la aplicación en busca de errores recurrentes, tiempos de espera o advertencias que puedan indicar la causa.
  • Si el navegador informó un tiempo de espera de puerta de enlace, usar el historial de eventos para determinar si la operación finalizó en el servidor antes de volver a intentarlo. Dado que la operación sigue ejecutándose después de que el navegador se desconecta, volver a intentarlo puede duplicar el trabajo.
  • Revisar los servicios en segundo plano activos y el historial de eventos en busca de trabajos de larga duración o atascados. Para identificar consultas SQL lentas específicamente, ver Capturar y analizar consultas lentas.
  • Para páginas lentas causadas por consultas o lógica de aplicación no optimizadas, ver Optimización del rendimiento del App Builder para orientación sobre optimización de consultas, indexación y diseño de aplicaciones.
  • Si el servidor parece saludable pero el App Builder sigue sin responder, reciclar el grupo de aplicaciones de IIS para App Builder.
  • Si el problema es intermitente y difícil de diagnosticar, recuperar un volcado de proceso para un análisis más detallado. Ver Recuperar un archivo de volcado.

Datos e integraciones

Los valores de las columnas encriptadas aparecen en blanco después de la reconfiguración de la fuente de datos

• Síntoma: Los valores almacenados en una columna encriptada aparecen en blanco (nulos) en la aplicación después de que se eliminó y recreó una fuente de datos, tabla o columna, o después de actualizar o migrar el entorno de App Builder.
• Causas posibles:
  • App Builder deriva la clave de encriptación de cada columna de los valores DataSourceId, TableId y ColumnId en su modelo lógico. Si alguno de estos identificadores cambia (por ejemplo, después de eliminar y recrear una fuente de datos, tabla o columna), los valores encriptados existentes ya no pueden ser desencriptados. No se muestra ningún error: el valor aparece silenciosamente como nulo.
  • Durante una actualización o migración, la carpeta keys de la instalación anterior no se copió a la nueva carpeta de instalación, por lo que App Builder no puede acceder al material de clave necesario para desencriptar los valores existentes.
• Resolución:
  • Si los valores encriptados aparecen en blanco después de una actualización o migración, confirme que el contenido de la carpeta keys se copió de la carpeta de instalación anterior a la nueva. Consulte el paso 5 de Restaurar configuraciones.
  • Para prevenir la pérdida de datos por cambios en los identificadores, evite eliminar y recrear fuentes de datos, tablas o columnas encriptadas que contengan datos. Para una lista completa de limitaciones de encriptación, consulte Encriptación de columnas a nivel de aplicación.
  • Antes de realizar cambios estructurales, exporte o haga una copia de seguridad de cualquier valor de columna encriptada.
  • Si los identificadores ya han cambiado y los datos no pueden ser recuperados de una copia de seguridad, contacte a soporte de Jitterbit con detalles de la configuración original.

La línea base del registro de auditoría no se llena

• Síntoma: Llenar la Línea Base Completa de Auditoría genera un error y la línea base no se crea.
• Causa posible: La tabla no tiene una clave primaria UUID de una sola parte. La Auditoría Completa requiere un UUID único para cada registro, por lo que las tablas con una clave primaria compuesta (de múltiples partes) no se auditan por defecto. Para auditar tal tabla, primero se debe agregar una columna de auditoría UUID.
• Resolución:
  1. Agregar una columna UUID a la tabla y establecer su tipo de uso de columna en Auditoría, luego llenarla para los registros existentes. Para el procedimiento completo, ver Otras configuraciones de clave primaria.
  2. Navegar a Cajón de Acción > IDE > Configuración Adicional y hacer clic en el botón Llenar Registros de Auditoría.
  3. Localizar la fuente de datos de la aplicación, hacer clic en Llenar Todo (o Llenar en tablas individuales), luego hacer clic en Proceder para reintentar.

SharePoint File System: se requiere autenticación OAuth a partir de abril de 2026

• Síntoma: Las conexiones del SharePoint File System no logran autenticarse o no se pueden crear.
• Causa posible: A partir del 30 de abril de 2026, las conexiones del SharePoint File System requieren autenticación OAuth. Las conexiones que utilizan autenticación heredada ya no funcionan.
• Resolución:
  1. Actualizar a App Builder 4.61 o posterior.
  2. Seguir la guía de conexión OAuth de Microsoft SharePoint para configurar un proveedor de seguridad OAuth antes de crear o actualizar el servidor de datos.

SharePoint File System: Archivos no mostrados o las rutas devuelven errores

• Síntoma: Una fuente de datos del SharePoint File System se conecta correctamente, pero los archivos no se muestran, el contenido no se renderiza o una ruta de directorio causa un error.
• Causas posibles:
  • App Builder solo puede acceder a los archivos almacenados en el directorio Documentos. Los archivos en otros directorios de SharePoint no son accesibles.
  • Los nombres de archivo son sensibles a mayúsculas y minúsculas al enlazar entre fuentes de datos. Un desajuste en el uso de mayúsculas entre el nombre del archivo de SharePoint y el nombre utilizado en otra fuente de datos impide que el contenido se renderice.
  • Usar una barra diagonal (/) en una ruta de directorio en un objeto de negocio causa un error.
• Resolución:
  • Confirmar que los archivos estén almacenados en el directorio Documentos en SharePoint.
  • Verificar que los nombres de archivo utilizados en objetos de negocio y enlaces de fuentes de datos coincidan exactamente con el uso de mayúsculas de los nombres de archivo de SharePoint.
  • Al especificar una ruta de directorio en un objeto de negocio, usar barras invertidas (\\) en lugar de barras diagonales (/). Por ejemplo, usar \documents\employees en lugar de /documents/employees.

Conector de App Builder: No se puede recuperar la clave API generada después de abandonar la pantalla

• Síntoma: Un usuario del conector ha configurado el Conector de App Builder pero el valor de la clave API ya no está disponible después de navegar fuera de la pantalla de generación de claves.
• Causa posible: La clave API generada se muestra solo una vez en la pantalla de Generar clave. Una vez que se abandona la pantalla, el valor no se puede recuperar.
• Resolución:
  • Copie el valor de la clave en el portapapeles inmediatamente después de que se genere, antes de navegar fuera.
  • Si la clave no fue copiada, genere una nueva clave.

Conector de App Builder: error 403 Prohibido

• Síntoma: Conectarse a un entorno remoto de App Builder utilizando el Conector de App Builder devuelve un error 403 Prohibido.
• Causa posible: La cuenta de usuario configurada para el conector no ha recibido el rol de Conector Remoto de App Builder en el entorno de App Builder de origen.
• Resolución:
  1. En el entorno de App Builder de origen, abra la cuenta de usuario utilizada por el conector.
  2. Asigne el rol de Conector Remoto de App Builder a ese usuario.

Webhook: La autenticación HTTP Básica requiere el encabezado de Autorización en la carga útil

• Síntoma: Un webhook configurado para usar HTTP Básica no procesa correctamente las cargas útiles entrantes.
• Causa posible: El método de HTTP Básica requiere que el encabezado Authorization esté presente en la carga útil recibida. Los sistemas de terceros que omiten este encabezado no se autentican correctamente.
• Resolución: Utilice el método de autenticación Clave API para el proveedor de seguridad del webhook en lugar de HTTP Básica. El método de Clave API no requiere el encabezado Authorization y es más compatible con los remitentes de webhook externos.

El tiempo de migración de fechas se agota en conjuntos de datos grandes

• Síntoma: Una operación de migración de fechas no se completa y falla con un error de tiempo de espera.
• Causa posible: Las migraciones de fechas se ejecutan como una única transacción de base de datos durante una actualización de la aplicación o fuente de datos. Con conjuntos de datos grandes, la transacción puede exceder el tiempo de espera de comando predeterminado de la base de datos.
• Resolución: En el archivo Connection.xml de App Builder, aumenta el valor de CommandTimeOut para permitir más tiempo para que la transacción de migración se complete.

Configuración de zona horaria

El servidor de aplicaciones de App Builder y el servidor de base de datos deben usar la misma zona horaria

• Síntoma: Los valores de DateTime en la aplicación están desplazados por compensaciones inesperadas, o los tiempos mostrados en App Builder difieren de lo que se muestra en la base de datos.
• Causa posible: El servidor de aplicaciones de App Builder y el servidor de base de datos están configurados con diferentes zonas horarias. Estos servidores deben estar sincronizados para que los valores de DateTime se representen correctamente.
• Resolución:
  1. Confirma que el servidor de aplicaciones de App Builder y todos los servidores de base de datos estén configurados en la misma zona horaria.
  2. En App Builder, establece la Zona Horaria de Fuente de Datos Predeterminada en cada servidor de fuente de datos y la Zona Horaria en cada fuente de datos para que coincida con la zona horaria del servidor de base de datos. Consulta Zonas horarias para los pasos de configuración.

Notificaciones por correo electrónico

Errores de configuración de SMTP

• Síntoma: App Builder no puede enviar notificaciones por correo electrónico, y los registros de la aplicación o la salida de Correo Electrónico de Prueba muestran uno de los siguientes errores:

  Argument passed in is not serializable. Parameter name: value
  

  Value cannot be null. ParameterName: From Address
  

  Unknown URI scheme. Parameter name: uri
  

  Authentication required
  

• Causas posibles:

  • El campo From Address del servidor de notificaciones SMTP está vacío, nulo o utiliza una dirección de correo electrónico no válida (produce los dos primeros errores anteriores).
  • El campo URI utiliza un formato no válido o un esquema no soportado (produce el error "Esquema URI desconocido"). El URI debe usar el esquema smtp:// o smtps://, por ejemplo smtp://mail.ejemplo.com:587.
  • Los campos UserName o Password contienen credenciales incorrectas (produce el error "Se requiere autenticación").

• Resolución: En el IDE, desde las opciones de Connect abre Notification Servers, luego abre el registro del servidor SMTP y verifica el campo que coincide con el error que recibiste:

  • Verifica que el From Address sea una dirección de correo electrónico válida permitida para enviar correos a través del host SMTP configurado.
  • Verifica que el URI use el formato smtp://<hostname>:<port> o smtps://<hostname>:<port>. Consulta Configurar SMTP para los protocolos y formatos soportados.
  • Verifica que el UserName y Password coincidan con las credenciales del servidor SMTP.
  • Después de realizar un cambio, utiliza la función Test Email en la ventana emergente del servidor de notificaciones para confirmar la configuración antes de implementarlas en un flujo de trabajo.

Páginas y comportamiento de la aplicación

Los enlaces profundos dejan de funcionar después de que se renombra una aplicación o página

• Síntoma: Un enlace profundo que anteriormente dirigía a los usuarios a una aplicación o página específica ya no funciona.
• Causa posible: Renombrar una aplicación o página en App Builder cambia la ruta de URL utilizada en los enlaces profundos. Cualquier enlace existente que contenga el antiguo nombre de la aplicación o página ya no es válido.
• Resolución:
  • Actualizar cualquier sistema externo, correos electrónicos, portales o marcadores que contengan la antigua URL de enlace profundo para usar el nuevo nombre de la aplicación o página.
  • Construir el nuevo enlace profundo navegando a la página de destino en App Builder y copiando la URL de la barra de direcciones del navegador, luego eliminar la cadena de consulta (todo lo que está desde ? en adelante) para obtener la URL canónica.
  • Para evitar este problema en el futuro, utilizar el campo Etiqueta para nombres de visualización y mantener el campo Nombre (que determina la ruta de URL) corto y estable.

Un evento se activa múltiples veces al guardar, insertar, actualizar o eliminar

• Síntoma: Un evento que debería activarse una vez se activa múltiples veces en la misma acción del usuario, resultando en registros duplicados, notificaciones duplicadas u otros efectos secundarios repetidos.
• Causas posibles:
  • La acción o validación del evento está registrada tanto en la capa de datos como en la capa de lógica de negocio simultáneamente. App Builder permite esta configuración, pero activa el evento una vez por registro de capa.
  • La vinculación de la acción está sin vincular o está vinculada a más de un registro. La acción se activa una vez por cada registro en el ámbito.
• Resolución: Abrir el Taller de Aplicaciones, localizar la configuración del evento, luego abordar la causa que aplique:
  • Determinar si la lógica pertenece a la capa de datos (para comportamiento a nivel de tabla) o a la capa de lógica de negocio (para comportamiento específico de la página). Ver Configurar eventos para orientación, y eliminar el registro duplicado de la capa a la que no pertenece.
  • Revisar la vinculación de la acción. Si está sin vincular o vinculada a más de un registro, limitarla al único registro previsto. Ver Vinculación implícita y explícita.

Los controles de íconos HTML no respetan los permisos de rol

• Síntoma: Un control de ícono HTML en una página no respeta los permisos de rol de un usuario. Por ejemplo, un ícono que debería estar deshabilitado para usuarios sin permiso permanece activo.
• Causa posible: Los íconos HTML se comportan como botones. Sin un evento adjunto, los permisos basados en roles no se aplican al ícono, por lo que permanece visible y activo independientemente del rol del usuario.
• Resolución:
  1. Adjuntar un evento vacío al control de ícono HTML para que se aplique la visibilidad basada en roles.
  2. Especificar el acceso apropiado (por ejemplo, Actualizar) en el rol para los usuarios que deberían ver el ícono.

El ícono de auditoría no aparece en una página

• Síntoma: El botón o ícono de Auditoría utilizado para ver los registros de Auditoría Completa no es visible en un panel de Formulario o Cuadrícula.
• Causas posibles:
  • El usuario no pertenece al rol de App Builder - Administradores o al rol de App Builder - Auditoría.
  • El panel de la página no tiene habilitado Mostrar Auditoría, o el panel no es un panel de Formulario o Cuadrícula.
• Resolución:
  • Confirmar que el usuario pertenece al rol de App Builder - Administradores o al rol de App Builder - Auditoría. Ver Seguridad.
  • En un panel de Formulario o Cuadrícula, habilitar Mostrar Auditoría para el panel de la página. Ver Habilitar auditoría completa en una página.

Aplicaciones móviles y fuera de línea

Para problemas con la aplicación móvil de App Builder (incluidos congelamientos, bloqueos, enlaces bloqueados y problemas para guardar imágenes), consulta Solución de problemas de la aplicación móvil.

Aplicación fuera de línea: La base de datos local se borra cuando se actualiza la aplicación

• Síntoma: Después de que se actualiza una aplicación fuera de línea, todos los datos almacenados localmente en el dispositivo móvil desaparecen.
• Causa posible: La base de datos local de una aplicación fuera de línea se borra cada vez que se actualiza la aplicación. Esta es una limitación conocida de las aplicaciones fuera de línea.
• Resolución:
  • Asegúrate de que todos los datos recopilados localmente estén completamente sincronizados con el servidor antes de que se implemente una actualización de la aplicación.
  • Informa a los usuarios sobre las actualizaciones planificadas con anticipación para que puedan sincronizarse antes de que la actualización entre en efecto.

Aplicación fuera de línea: Los horarios en segundo plano no se ejecutan cuando la aplicación está cerrada

• Síntoma: Las tareas programadas o los procesos en segundo plano en una aplicación fuera de línea no se están ejecutando en un dispositivo móvil cuando se espera.
• Causa posible: Los horarios en segundo plano no se ejecutan cuando la aplicación de App Builder está cerrada en el dispositivo móvil. Los horarios solo se ejecutan mientras la aplicación está abierta.
• Resolución:
  • Informa a los usuarios que el procesamiento programado en segundo plano requiere que la aplicación permanezca abierta.
  • Rediseña los flujos de trabajo que dependen de horarios en segundo plano para que se activen con la interacción del usuario, o mueve el procesamiento programado al lado del servidor.

Widgets

Para problemas con widgets que no se activan, se cargan incorrectamente o no pueden leer un archivo zip de widget, consulta Solución de problemas de widgets.