Publication et accès aux Portails

Le panneau Publication regroupe les releases, l'état de publication et les autorisations du Portail. Les opérations affichées dépendent de l'autorisation individuelle, du rôle dans le Projet et des fonctionnalités configurées par l'administrateur de la plateforme.

Préparer une release

Avant la publication :

1. sauvegarder toutes les modifications ;
2. exécuter Valider et corriger les erreurs ;
3. tester la prévisualisation avec Aperçu ;
4. sélectionner Publier pour ouvrir le panneau ;
5. créer une Nouvelle build release.

La release est une copie immuable de la révision validée. Modifier ultérieurement la prévisualisation ne modifie pas les releases déjà créées.

Comprendre et gérer les artefacts

Chaque build réussie produit un artefact : le document HTML exécutable du Portail, complet de mise en page, styles compilés et runtime des widgets. Au document est associé un manifest qui énumère la révision source, taille, capability et dépendances utilisées.

La valeur hexadécimale affichée après la build est l'hash SHA-256 du contenu. Ce n'est ni un mot de passe ni un code à saisir ailleurs : il identifie de manière unique l'artefact et permet à Sybot de vérifier son intégrité.

Dans le panneau Publication → Build et artefacts, il est possible de :

• consulter les builds prévisualisées et les releases avec état et révision ;
• ouvrir Détails pour lire l'hash complet, la taille, le manifest et la diagnostic ;
• utiliser Ouvrir l'artefact pour inspecter le document généré ;
• annuler une build toujours en file d'attente ou en cours d'exécution.

Les artefacts réussis ne sont pas supprimés manuellement par l'éditeur : une release peut dépendre exactement de ce contenu immuable. La gestion courante se fait via l'approbation, le déploiement, la révocation et le retour en arrière des releases.

Un Publisher ou Owner peut approuver une release réussie. L'approbation ne modifie pas la prévisualisation et rend la release sélectionnable pour la publication sur les destinations déjà rendues disponibles. L'état est mis à jour sans recharger la page.

Si aucune destination n'est disponible, contactez le propriétaire du Projet ou l'administrateur de la plateforme. N'essayez pas de réutiliser une destination appartenant à un autre Projet.

Publier sur la première cible

1. approuver la release créée ;
2. en tant qu'Owner du Portail et du Projet, créer la cible avec l'origine exacte, par exemple https://portals.example.com, sans chemin ;
3. si la release contient Power BI App owns data, ouvrir Gérer les profils et les rapports, créer un point de terminaison pour la cible ou le fallback de son environnement, puis exécuter Diagnostic jusqu'à l'état vérifié ;
4. sélectionner la release approuvée et la cible, puis lancer Déployer ;
5. attendre l'état actif et utiliser Ouvrir pour tester le Portail.

La production et la préproduction nécessitent HTTPS. HTTP est disponible uniquement pour une cible de développement sur localhost. Si une build réussit mais que le panneau ne s'actualise pas, utiliser Actualiser et vérifier la liste avant de créer une autre release.

Si la release utilise Qlik OAuth impersonation, le profil et l'endpoint doivent également avoir un diagnostic positif. Pour une cible Agent distant, l'administrateur doit avoir préparé la destination : après le déploiement, l'état reste En attente de l'Agent jusqu'à la vérification et l'activation. La version précédente reste disponible. Voir Intégrations gouvernées.

Comportement attendu d'une cible Agent distant

Lorsque vous utilisez Ouvrir, le runtime distant peut vous rediriger vers la page de connexion de l'installation Sybot propriétaire du Portail. Après l'authentification, le navigateur revient automatiquement au Portail ; aucune seconde configuration n'est nécessaire dans l'éditeur.

La mise en page, les styles et le contenu statique proviennent de la release activée sur la cible. Les widgets qui utilisent des données, des Vues Utilisateur, des Workflows, BPMN, Power BI ou Qlik continuent d'appliquer en temps réel les autorisations et la configuration de l'installation Sybot propriétaire. Ils peuvent donc être temporairement indisponibles si la plateforme n'est pas joignable, même si la partie statique du Portail est déjà visible.

Vérifier la publication

Pendant l'activation, le panneau affiche l'état actuel. Lorsque l'opération est terminée, Ouvrir apparaît, permettant de tester le Portail avec les mêmes contrôles d'accès appliqués aux utilisateurs finaux.

Pour une cible distante, Dernier contact de l’Agent confirme que l’Agent a communiqué avec Sybot. Cela ne remplace pas le test des widgets dynamiques.

Pendant la recette, comparez la position, la largeur et la hauteur des widgets avec la Preview de la même révision. La géométrie fait partie de l'artefact immuable : après une mise à jour qui modifie le rendu du Portail, créez une nouvelle build et une nouvelle release ; redéployer la même release ne la recompile pas.

Une publication échouée ne remplace pas la version déjà active. Lisez le message affiché, corrigez la cause indiquée et répétez l'opération avec une release valide.

Lorsqu'une version précédente est disponible, le Publisher peut utiliser Retour arrière pour la réactiver sans modifier ou reconstruire la prévisualisation actuelle.

Gérer les collaborateurs et l'audience

L'Owner trouve dans le panneau Accès deux zones :

• Collaborateurs, pour attribuer ou révoquer l'autorisation individuelle des membres du Projet ;
• Audience runtime, pour autoriser les rôles applicatifs qui peuvent ouvrir le Portail publié.

L'audience ne remplace pas l'appartenance au Projet. La suppression d'un membre, la révocation de l'autorisation ou la suppression du rôle de l'audience empêche les ouvertures ultérieures non plus autorisées.

Résolution des problèmes

• La build ne démarre pas ou reste en attente : actualisez le panneau et, si l'état ne change pas, communiquez le message à l'administrateur.
• La release n'est pas approuvable : vérifiez d'avoir l'autorisation Publisher ou Owner et que la build ait réussi.
• Le Portail publié ne s'ouvre pas : vérifiez l'appartenance au Projet, l'autorisation ou l'audience et l'état actif.
• La cible distante revient sans cesse à la page de connexion : fermez les onglets obsolètes, rouvrez le Portail avec Ouvrir et signalez la boucle à l'administrateur si elle persiste, sans partager de liens d'authentification.
• La cible distante s'ouvre mais les widgets dynamiques ne répondent pas : vérifiez que la plateforme Sybot est joignable ; le contenu statique visible ne confirme pas à lui seul la disponibilité des données et intégrations.
• Les widgets publiés sont comprimés ou mal positionnés : créez une nouvelle build et une nouvelle release avec la version actuelle, puis déployez-la ; le redéploiement de la release précédente conserve son ancien artefact.
• Données ou Workflow sont refusés : vérifiez que l'objet lié est toujours accessible et que la release utilise une configuration actuelle.
• Le déploiement avec Power BI est bloqué : vérifiez que chaque liaison et variante App owns data possède un point de terminaison actif et diagnostiqué pour la cible ou son environnement.
• Un identifiant de diagnostic apparaît : copiez-le sans ajouter de données sensibles et fournissez-le au support.