Propagation automatique d'un rapport

Vue d'ensemble

Dans les déploiements multi-locataires, il est courant de maintenir une seule application Qlik Sense maître dupliquée pour chaque client final, aboutissant souvent à plus de 100 instances individuelles. Cette duplication est généralement automatisée via des scripts et des API.

Sans propagation automatique, gérer séparément les rapports, tâches, connexions et filtres pour chaque instance d'application client devient impraticable à grande échelle. Qalyptus résoud ce problème en vous permettant de créer un rapport une seule fois basé sur l'application maître, puis de propager les tâches vers n'importe quel nombre d'applications cibles via l'API, avec les références d'applications Qlik Sense remplacées dynamiquement à l'exécution.

Pourquoi cela fonctionne

Lorsque vous dupliquez une application Qlik Sense, tous les ID d'objets (graphiques, tableaux, etc.) restent identiques dans la nouvelle application, même si vous rechargez ultérieurement les données depuis différentes sources ou modifiez des propriétés d'objets telles que les titres ou colonnes. Qalyptus exploite cela pour appliquer la même mise en page de rapport à n'importe quelle instance d'application dupliquée.

Flux de travail

Flux de travail standard

Sans propagation automatique, la configuration habituelle est :

1. Créer un rapport connecté à l'application maître Qlik Sense.
2. Ajouter optionnellement des filtres basés sur l'application maître.
3. Publier le rapport dans Qalyptus Server.
4. Créer une tâche et y ajouter le(s) rapport(s).

Cela fonctionne pour une seule application, mais nécessite de répéter toutes les étapes manuellement pour chaque instance d'application supplémentaire.

Flux de travail avec propagation automatique

Avec la propagation automatique, vous ne configurez le rapport qu'une seule fois et utilisez l'API pour le mettre à l'échelle :

1. Créer un rapport connecté à l'application maître Qlik Sense (comme avant).
2. Ajouter optionnellement des filtres basés sur l'application maître.
3. Publier le rapport dans Qalyptus Server et créer une tâche.
4. Appeler le point de terminaison API duplicateTask pour chaque instance d'application cible, en fournissant un mappage d'application qui remplace l'ID de l'application maître par l'ID de l'application cible.
5. Qalyptus crée une nouvelle tâche où tous les rapports sont automatiquement liés aux applications cibles spécifiées.

Les tâches dupliquées s'exécutent de manière indépendante, chacune générant des rapports depuis leurs instances d'application respectives.

Référence API

Dupliquer une tâche avec des substitutions d'application

Utilisez le point de terminaison duplicateTask pour créer une copie d'une tâche existante et rediriger ses rapports vers différentes applications Qlik Sense.

Point de terminaison : POST /api/v2/tasks/{taskId}/duplicate

Corps de la requête :

{
  "NewName": "string (optional)",
  "OverwriteReportApps": [
    {
      "ReportId": "guid (required)",
      "QlikApps": [
        {
          "QlikAppId": "guid (required)",
          "NewQlikAppId": "guid (required)"
        }
      ]
    }
  ]
}

Champ	Type	Requis	Description
NewName	string	Non	Nom de la tâche dupliquée. Si omis ou null, un nom incrémenté est généré automatiquement.
OverwriteReportApps	tableau	Non	Liste des mappages d'applications à appliquer par rapport dans la tâche.
OverwriteReportApps[].ReportId	guid	Oui	ID du rapport dans la tâche auquel appliquer le mappage.
OverwriteReportApps[].QlikApps[].QlikAppId	guid	Oui	L'ID d'application Qlik Sense original utilisé dans le rapport (généralement l'application maître).
OverwriteReportApps[].QlikApps[].NewQlikAppId	guid	Oui	L'ID d'application Qlik Sense cible à substituer à l'exécution.

Réponse : Retourne l'ID de la tâche nouvellement créée.

Exemple - dupliquer une tâche et rediriger deux rapports vers différentes applications :

{
  "NewName": "Monthly Report - Customer A",
  "OverwriteReportApps": [
    {
      "ReportId": "a1b2c3d4-0000-0000-0000-000000000001",
      "QlikApps": [
        {
          "QlikAppId": "master-app-guid-here",
          "NewQlikAppId": "customer-a-app-guid-here"
        }
      ]
    }
  ]
}

Mettre à jour les mappages d'applications sur un rapport de tâche existant

Les mappages d'applications peuvent également être ajoutés, modifiés ou supprimés sur un rapport de tâche existant en utilisant le point de terminaison updateTaskReport. Incluez l'objet OverwriteReportApps dans le corps de la requête pour gérer les mappages sans dupliquer la tâche.

Point de terminaison : PATCH /api/v2/tasks/{taskId}/reports/{reportId}

Afficher les mappages d'applications dans l'interface

Lorsqu'un rapport de tâche possède des mappages d'applications configurés, un onglet Substitution des applications du rapport apparaît dans le panneau de paramètres du rapport de tâche (Tâche → Rapport → Substitution des applications du rapport).

Cet onglet affiche une liste en lecture seule de tous les mappages actifs source → cible pour ce rapport.

remarque

Les mappages d'applications ne peuvent pas être modifiés depuis l'interface. Utilisez le point de terminaison API updateTaskReport pour les gérer par programmation.

Fonctionnement à l'exécution

Lorsqu'une tâche s'exécute, Qalyptus vérifie chaque rapport pour les mappages d'applications actifs :

• Si OverwriteReportApps est configuré pour un rapport, Qalyptus substitue dynamiquement l'ID d'application Qlik Sense original par le NewQlikAppId mappé pour toutes les connexions, filtres et conditions utilisés par ce rapport.
• Le rapport est généré entièrement à partir des données de l'application cible (NewQlikAppId), et non de l'application maître originale.