Publicación y acceso a los Portales

El panel Publicación recopila las versiones, el estado de publicación y las autorizaciones del Portal. Las operaciones mostradas dependen del permiso individual, del rol en el Proyecto y de las funcionalidades configuradas por el administrador de la plataforma.

Preparar una versión

Antes de la publicación:

1. guardar todos los cambios;
2. ejecutar Validar y corregir los errores;
3. probar el borrador con Vista previa;
4. seleccionar Publicar para abrir el panel;
5. crear una Nueva versión de compilación.

La versión es una copia inmutable de la revisión verificada. Modificar posteriormente el borrador no cambia las versiones ya creadas.

Comprender y gestionar los artefactos

Cada compilación exitosa produce un artefacto: el documento HTML ejecutable del Portal, completo de diseño, estilos compilados y tiempo de ejecución de los widgets. Al documento se le asocia un manifiesto que enumera la revisión del código fuente, tamaño, capability y dependencias utilizadas.

El valor hexadecimal mostrado después de la compilación es el hash SHA-256 del contenido. No es una contraseña ni un código para insertar en otro lugar: identifica de manera única el artefacto y permite a Sybot verificar su integridad.

En el panel Publicación → Compilaciones y artefactos es posible:

• consultar las compilaciones de vista previa y las versiones con estado y revisión;
• abrir Detalles para leer el hash completo, tamaño, manifiesto y diagnóstico;
• usar Abrir artefacto para inspeccionar el documento generado;
• cancelar una compilación aún en cola o en ejecución.

Los artefactos exitosos no se eliminan manualmente por el editor: una versión puede depender exactamente de ese contenido inmutable. La gestión normal se realiza mediante aprobación, despliegue, revocación y reversión de las versiones.

Un Publisher o Owner puede aprobar una versión exitosa. La aprobación no modifica el borrador y hace que la versión sea seleccionable para la publicación en los destinos ya habilitados. El estado se actualiza sin recargar la página.

Si no hay ningún destino disponible, diríjase al propietario del Proyecto o al administrador de la plataforma. No intente reutilizar un destino que pertenezca a otro Proyecto.

Publicar en el primer destino

1. aprobar la versión creada;
2. como Owner del Portal y del Proyecto, crear el destino con el origen exacto, por ejemplo https://portals.example.com, sin ruta;
3. si la versión contiene Power BI App owns data, abrir Gestionar perfiles e informes, crear un endpoint para el destino o para el fallback de su entorno y ejecutar Diagnóstico hasta que quede verificado;
4. seleccionar la versión aprobada y el destino y, a continuación, iniciar Desplegar;
5. esperar al estado activo y utilizar Abrir para probar el Portal.

Producción y preproducción requieren HTTPS. HTTP solo está disponible para un destino de desarrollo en localhost. Si una compilación finaliza correctamente pero el panel no se actualiza, utilice Actualizar y revise la lista antes de crear otra versión.

Si la release usa Qlik OAuth impersonation, su perfil y endpoint también deben tener un diagnóstico positivo. Para un destino Agent remoto, el administrador debe haber preparado la máquina: tras desplegar, el estado queda Esperando al Agent hasta verificar y activar la release. La versión anterior sigue disponible. Consulte Integraciones gobernadas.

Qué esperar de un destino Agent remoto

Al usar Abrir, el runtime remoto puede redirigir a la página de acceso de la instalación Sybot propietaria del Portal. Después de la autenticación, el navegador vuelve automáticamente al Portal; no es necesaria una segunda configuración en el editor.

El diseño, los estilos y el contenido estático proceden de la versión activada en el destino. Los widgets que usan datos, Vistas de usuario, Workflows, BPMN, Power BI o Qlik siguen aplicando en tiempo real los permisos y la configuración de la instalación Sybot propietaria. Por ello pueden no estar disponibles temporalmente si la plataforma no es accesible, aunque la parte estática del Portal ya sea visible.

Verificar la publicación

Durante la activación, el panel muestra el estado actual. Cuando la operación se completa aparece Abrir, que permite probar el Portal con los mismos controles de acceso aplicados a los usuarios finales.

Para un destino remoto, Último contacto del Agent confirma que el Agent se ha comunicado con Sybot. No sustituye las pruebas de los widgets dinámicos.

Durante la validación, compare la posición, la anchura y la altura de los widgets con la Vista previa de la misma revisión. La geometría forma parte del artefacto inmutable: después de una actualización que cambie la representación del Portal, cree una nueva compilación y una nueva versión; volver a desplegar la misma versión no la recompila.

Una publicación fallida no sustituye la versión ya activa. Lea el mensaje mostrado, corrija la causa indicada y repita la operación con una versión válida.

Cuando está disponible una versión anterior, el Publisher puede usar Reversión para reactivarla sin modificar o reconstruir el borrador actual.

Gestionar colaboradores y audiencia

El Owner encuentra en el panel Acceso dos áreas:

• Colaboradores, para asignar o revocar el permiso individual de los miembros del Proyecto;
• Audiencia de tiempo de ejecución, para autorizar los roles de aplicación que pueden abrir el Portal publicado.

La audiencia no sustituye la pertenencia al Proyecto. La eliminación de un miembro, la revocación del permiso o la eliminación del rol de la audiencia impide las aberturas posteriores no autorizadas.

Solución de problemas

• La compilación no inicia o permanece en espera: actualice el panel y, si el estado no cambia, comunique el mensaje al administrador.
• La versión no es aprobable: verifique que tenga el permiso de Publisher o Owner y que la compilación haya sido exitosa.
• El Portal publicado no se abre: verifique la pertenencia al Proyecto, permiso o audiencia y el estado activo.
• El destino remoto vuelve repetidamente a la página de acceso: cierre las pestañas obsoletas, vuelva a abrir el Portal con Abrir y, si el ciclo continúa, comuníquelo al administrador sin compartir enlaces de autenticación.
• El destino remoto se abre pero los widgets dinámicos no responden: verifique que la plataforma Sybot sea accesible; el contenido estático visible no confirma por sí solo la disponibilidad de datos e integraciones.
• Los widgets publicados aparecen comprimidos o fuera de la cuadrícula: cree una nueva compilación y una nueva versión con la versión actual y despliegue; volver a desplegar la versión anterior conserva su artefacto antiguo.
• Datos o Workflows son denegados: verifique que el objeto vinculado siga siendo accesible y que la versión utilice una configuración actual.
• El despliegue con Power BI está bloqueado: verifique que cada vinculación y variante App owns data tenga un endpoint activo y diagnosticado para el destino o su entorno.
• Aparece un identificador de diagnóstico: cópielo sin agregar datos reservados y proporciónelo al soporte.