Extensions

Généralités

Qu’est ce qu’une extension ?

Une extension est un export d’un projet de Reporting complet, autonome, sérialisé et verrouillé sous licence commerciale générée par un éditeur pour le déployer chez ses clients.

Pour exploiter l’extension, une licence doit être liée au compte client sur le portail Report One.

Le format de fichier associé aux extensions est .mrext signifié par une icône spécifique (câblage) qui sera présente dans tous les produits.

La composition d'une extension

Une extension peut contenir tous les éléments de projets suivants :

  • Tableaux de bord (Dashboards)

  • Diffusions Center BE

  • Modélisations

    • Connexions

    • Modèles avec les tables de correspondances

    • ETL

  • Droits d'administration

    • Groupes MyReport (sans les utilisateurs) avec des autorisations, attributs, filtres.

    • Programmations

  • Outre les éléments de projets, une extension embarque aussi :

    • Une clé de produit : l'identifiant de l'extension au niveau du portail Report One.

Comment exploiter une extension dans un projet

Introduction

La finalité d'une extension est d'être utilisée dans un projet pour accélérer la restitution des données d'un logiciel tiers.

On peut dans un projet importer plusieurs extensions et administrer celles-ci depuis la fenêtre des extensions.

Comment importer une extension

Important

Prérequis : L'accès au portail de Report One est nécessaire afin de permettre la récupération des informations de licence et l'activation automatique (serial.myreport.fr).

Il existe deux méthodes pour importer une extension :

  • L’import d’un fichier .mrext peut se faire depuis l’onglet Extension dans MyReport Administrator via le bouton importer.
  • Un double-clic sur un fichier portant l'extension .mrext ouvre automatiquement MyReport Administrator.

Important

Si vous réalisez l'import dans un projet existant, par exemple dans le cas d'une mise à jour de l'extension, il est important que le projet soit entièrement rechargé dans MyReport Administrator, afin que l'import se fasse sur la dernière version de votre projet. Votre procédure d'import doit commencer par les étapes ci-après :

  1. Sauvegarder vos modifications.

  2. Fermer complètement MyReport Administrator.

Lors de l'import, MyReport Administrator va tenter une activation automatique en réalisant les actions suivantes :

  • Lire la clé licence du compte associé au projet.
  • Lire la clé produit de l'extension.
  • Vérifier qu'une licence est disponible pour ce produit sur ce compte dans le portail de Report One.
  • Activer automatiquement la licence.

Une fois l’extension activée, tous les éléments sont accessibles dans les produits. Dans le cas contraire, l'accès aux éléments de l'extension est restreint.

En cas d'import sans connexion internet (serial.myreport.fr inaccessible), il est possible d'activer l'extension manuellement, en transmettant la clé d'activation au support.

Avertissement

L'import dans MyReport Administrator est verrouillé si l'utilisateur est connecté au même projet dans MyReport Data et a en sélection un des éléments du modèle en cours d'importation.

Comment fonctionne une extension

Une extension active permet d'accéder aux éléments importés dans chaque produits MyReport BE. L'icone de signification qu'un élément provient d'un extension est un câblage qui permet à son survol d'avoir des informations

sur l'extension.

Paramétrage

MyReport Data

  • Une fois MyReport Data lancé, il est nécessaire de configurer les connexions du projet (Sources et Datawarehouse) :

    • Pour un import dans un nouveau projet vide, la connexion au Datawarehouse doit être paramétrée en choisissant le type de Base de données.
    • Pour un import dans un projet existant, si les paramètres de connexion n'ont pas été exportés dans l'extension, la configuration des connexions sources est nécessaire.

    Lors de l'import d'une connexion :

    • Les paramètres existants ne sont pas modifiés.

    • Les nouveaux paramètres sont ajoutés.

    • Les informations de complément d'URL et de pagination sont mises à jour sirenseignés.

Tableau des verrouillages et autorisations dans une extension
Produits MyReport BEFonctionnalités dans une extension

Commun à tous les produits

Un élément verrouillé (programmation, groupe, diffusion, modèle) est représenté par une icone spécifique (câble pour l'extension)

Une infobulle indique l'extension dont provient l'élément

MyReport Data

Autorisé :

  • Création de champs de destinations (surcharge)
  • Création d'éléments (connexion, dossier, modèle) au sein d'une arborescence
  • Ajout d'éléments à un modèle (filtres, tables, champs)
  • Ajout de jointures entre tables du mapping
  • Ajout de sources locales
  • Les connexions Multibases
  • Possibilité de supprimer des modèles verrouillés s'ils ne sont pas utilisés dans le reste de la modélisation ou par d'autres utilisateurs.
  • Dans les propriétés d'un modèle (surchage)

    • Modification du mode de chargement

    • Modification du critère de suppression

    • Modification du délai d'exécution

    • Cocher/Décocher "Réinitialiser la table au prochain ETL"

    • Cocher/Décocher "Conserver les index"

    • Cocher/Décocher "Fermer la connexion à la fin de l'insertion des données"

    • Cocher/Décocher "Tolérer des lignes en erreur lors de l'ETL"

  • Dans les propriétés d'un champ destination (surcharge)

    • Taille des champs destination de type texte
  • Dans la configuration du fichier source (surcharge)

    • Modification du chemin d'accès d'un modèle fichier, cependant la structure du fichier doit rester identique

Non autorisé :

  • Déplacement des Mappings de modélisations
  • Modification du type de chargement d'un modèle
  • Modification des Jointures
  • Modification des champs de destinations issus de l’extension
  • Export du modèle
  • Suppression des tables, jointures, champs, filtres provenant de l’extension

Concernant les requêtes

  • Ajout de tables sur une requête provenant de l'export autorisé
  • Suppression de tables sur une requête existante interdit, seul la suppression des tables ajoutées en surcharge de la requête est autorisé
  • Ajout de requêtes autorisé
  • Suppression de requêtes provenant de l'export interdit.

Concernant les autorisations des utilisateurs :

  • Les autorisations ne sont pas pris en compte par les mises à jour d'un modèle. Les droits sont initialisés au premier import mais ne sont plus mis à jour par les nouvelles versions.
  • Modification des autorisations du groupe importé non autorisée (mais ajout possible)

Note

Au niveau du mapping, les tables ne pouvant pas être déplacées sont identifiées par un pictogramme représentant un cadenas blanc.

MyReport Page

Autorisé :

  • Création de Dashboard (surcharge)
  • Duplication d’un Dashboard
  • Modification par lot
  • Possibilité d'ajouter des partages

Non autorisé

  • Renommage des tableaux de bord
  • Déplacement des tableaux de bord importés dans des dossiers
  • Suppression des tableaux de bord
  • Modifier la palette de couleurs utilisée par les tableaux de bord importés

MyReport Center

Autorisé :

  • Visualisation des Dashboards Web
  • Téléchargement des diffusions Center BE

MyReport Messenger

Autorisé :

  • Une programmation issue d’une extension peut être ajoutée à une programmation nouvellement créée dans le projet.
  • Envoi des diffusions
  • Ajouter des destinataires (Groupes ou utilisateurs) à une diffusion Center BE (non publique)
  • Modifier l'expéditeur d'une diffusion Center BE (non publique)

    • L'expéditeur par défaut est celui qui a effectué l'import de l'extension.

Non autorisé

  • Renommage et suppression d'une diffusion
  • Suppression d'un groupe de destinataires présent dans l'extension
  • Modification du fichier source et de son emplacement
  • Modification de la portée (publique ou privée) de la diffusion
  • Suppression d'une diffusion issue de l'extension
  • Modifier le type de diffusion (Diffusion en accès public)

Verrouillage des programmations dans MyReport Messenger :

  • Une diffusion provenant d'une programmation d'une extension ou d'un export verrouillée ne peut pas être retirée de la programmation.

MyReport Administrator

Autorisé :

  • Modification de la fréquence d’une programmation
  • Cocher la case “Arrêter sur exécution en cas d’erreur”
  • Cocher la case “Envoyer un Email en cas d’erreur”
  • Création de nouvelle programmation avec la possibilité d’ajout d’ETL et diffusions issus d’une Extension
  • L'ajout de nouvelles valeurs dans les attributs des groupes et utilisateurs

Non autorisé

  • Suppression d’une programmation issue d’une extension
  • Les filtres sur les groupes et utilisateurs ne sont pas modifiables
  • Les attributs et les valeurs ne sont pas modifiables
Cas d'une licence inactive (icône câble barrée)

Une licence devient inactive dans les cas suivants :

  • Choix de l'utilisateur dans les options des Extensions dans MyReport Administrator (désactivation manuelle).

  • Fin de la date de location.

  • L’extension n’a pas réussi l’activation automatique lors de l’import (pas de connexion internet, pas de compte sur le portail).

Commun à tous les produits lorsque l’extension commerciale est inactive

  • Un message apparait sur les produits avec la liste des modèles inactifs provenant de l’extension

    • La licence de l'extension "{nom de l'extension}" n'est pas active. Veuillez contacter "{éditeur ou fournisseur de l'extension}" pour plus d'informations.

  • Aucun élément n’est duplicable

  • L'icone câble barrée remplace l’icone câble

    • Les icones sont présentes dans les autorisations de partage

    • Les attributs de l’extension ont aussi l’icone

Les fonctionnalités suivantes sont autorisées dans MyReport Data malgré une extension inactive :

  • Création de dossier à la racine du projet (surcharge).
  • Création de connexion à la racine du projet (surcharge).

Liste des actions indisponibles lorsque l’extension est inactive :

  • Modèles listés mais non affichés dans MyReport Data.

  • ETL non accessible dans MyReport Data.

  • Publication des modèles non accessible dans MyReport Data.

  • Création d'éléments (connexion, dossier, modèle) au sein d'une arborescence provenant d'une extension inactive.

  • Modèle non accessible dans MyReport Builder.

  • Le Dashboard est grisé mais les informations sont accessibles dans MyReport Center.

Cas spécifiques

Tableau 3.7. Migration Essential, Inside et Starter

Produits

Descriptions

Migration Essential et connecteurs

Lors de l'import d'une extension sur un projet provenant d'une migration Essential, les modèles du connecteur seront supprimés pour être remplacés par les nouveaux présents dans l'extension avec conservation des surcharges.

Cela peut entraîner des problèmes sur les rapports Excel qui s'appuient sur ces modèles en raison de la modification de l'identifiant du modèle.

Inside

Une extension ne peut être importée dans un projet sous licence Inside, que si elle respecte les bridages de la licence Inside : Une seule connexion source est autorisée. Les diffusions ne sont autorisées que pour les projets sous licence "Inside +".

Limitations pour une exploitation d'extension avec MyReport Starter

MyReport Starter permet :

  • Au maximum 1 seule connexion source dans le projet

  • Au maximum 1 seul projet dans le compte

  • D'activer plusieurs extensions

  • De ne pas avoir de restrictions sur les connexions à une extension


Gestion des extensions

Dans l'onglet Extensions de MyReport Administrator, la partie inférieure de la fenêtre permet de gérer manuellement les extensions. Il est également possible d’activer manuellement une extension en saisissant les informations suivantes : clé produit, clé licence et commentaire.

La liste des extensions installées permet de voir les informations relatives à la clé produit, clé licence et au statut de l'extension.

Options accessibles depuis le menu :

  • Activation d’une extension : exécute la demande d’activation de l’extension sur le portail Report One en utilisant les clés licences et produits de l’extension.

  • Désactivation d’une extension : exécute une demande de désactivation de l'extension sur le Portail Report One. Celle-ci peut prendre quelques secondes avant que la fenêtre de confirmation n'apparaisse.

  • Suppression d’une extension : Supprime entièrement les éléments de l’extension. Une désactivation est effectuée avant la suppression.

  • Obtenir la clé d’enregistrement : fournit un code d'enregistrement à fournir au support de l'extension pour permettre l'activation de l'extension sur le portail Report One.

  • Utiliser une clé d’activation : Clé envoyée par le support pour permettre l'activation de l'extension.

  • Désactiver manuellement

  • Obtenir la clé de désactivation : Clé à envoyer au support pour libérer la licence de l’extension.

Comment mettre à jour une extension

Une extension peut nécessiter d'être mise à jour pour les raisons suivantes :

  • Une évolution du périmètre fonctionnel de l'extension.
  • Une nouveauté de MyReport à intégrer.
  • Une évolution dans le logiciel métier.
Procédure de mise à jour

Important

Afin que l'import se fasse sur la dernière version de votre projet, il est important que le projet soit entièrement rechargé dans MyReport Administrator. Votre procédure d'import doit commencer par les étapes ci-après :

  1. Sauvegarder vos modifications.

  2. Fermer complétement MyReport Administrator.

Lors de l'import de la nouvelle version de l'extension :

  • La fenêtre de résumé des éléments de l'extension présente comme lors d'un premier import les éléments embarqués dans l'extension
  • La fenêtre de confirmation d'importation notifie les éléments qui seront mis à jour ou écrasés lors du nouvel import.

    • Le détail permet de voir la liste exhaustive des éléments mis à jour.
  • Note

    Les tables de correspondances sont systématiquement écrasées.

Héritage

Toutes les surcharges créées après un import sont conservées lorsqu’une nouvelle version de l’extension est installée.

Dans Data :

  • Pour un modèle "Sources", lorsque le champ table existe dans la modélisation "Client" et n'est pas présent dans la modélisation importée, le champ est ajouté à la suite des champs de la table "importée".
  • Pour un modèle "Datawarehouse", les champs table sont resynchronisés avec les champs destination du modèle source.
  • Lorsqu'un champ destination ajouté par le client à son modèle est aussi présent dans la modélisation importée (la comparaison se fait sur le libellé), le champ "client" est suffixé par "(surchargé)".
Règles de mises à jour

Elément de l'extension

Ajout

Elément déjà existant

Groupes

Ajout du groupe à la gestion utilisateur

  • Synchronisation * des filtres

  • Synchronisation des attributs

  • Synchronisation des autorisations

Modèles

Ajout du modèle

  • Propriétés du modèles

    • Description

    • Chargement ETL (mode insertion)

    • Configuration ETL (csv, datawarehouse)

    • Obsolescence

  • Droits

  • Synchronisation du nom du modèle

  • Synchronisation des tables

  • Synchronisation des champs

  • Synchronisation des jointures

  • Synchronisation des liens virtuels/requetes

  • Synchronisation des filtres

Tableaux de bord

Ajout du dashboard

Synchronisation des droits (partage)

Diffusions

Ajout de la diffusion

  • Synchronisation des droits (partage)

  • Synchronisation expéditeur, destinataire

  • Synchronisation du fichier diffusé

ETL

Ajout de l'ETL

Synchronisation des dates, états, modèles à charger/à enlever (selon s'ils sont présents dans l'ETL)

Programmations

Ajout de la programmation

Synchronisation des programmation à l'intérieur, visibilité, fréquences

Attributs

Ajout de l'attribut dans le projet

Autorisations

Modification de la règle d'autorisation

Si les autorisations ont été modifiés par l'utilisateur :

  • Les règles de l'utilisateur ne sont pas modifiés

Si les autorisations n'ont pas été modifiés :

  • Les autorisations sont modifiés en fonction de la mise à jour

Avertissement

La mise à jour de l'extension supprime tout ce qui n’est plus présent dans la nouvelle version de l'extension.

Note

* Synchronisation : remplacement des informations de l'extension existante par les informations de la nouvelle extension, tout en conservant les surcharges.

Comment supprimer une extension

Si l’action supprimer est choisie, Administrator va d’abord désactiver l’extension et procéder à la suppression des éléments.

Lors de la suppression d’une extension, tous les éléments de l’extension sont effacés dans chaque produit sauf les tables de correspondances dans MyReport Data.

L’utilisateur, connecté a un projet d’extension qui est supprimé, est notifié et redirigé vers l’écran d’accueil.

Comment créer une extension

Important

Si le projet est issu d'une migration Essential, les identifiants des modèles du projet seront régénérés au format GUID (par exemple "158a31c9-d83d-4fa6-8128-56fe9c423565") à la place du format "BaseLabelDecisionnel/A

Adresse".

Avertissement

Les groupes "Fournisseur d'identité", les utilisateurs, les diffusions autres que Center BE ne peuvent pas être exportés.

Important

Pour pouvoir créer une extension, le projet ne doit pas contenir d'éléments verrouillés ou appartenant à une extension.

Configuration

Pour Créer une extension, les champs clé produit et email sont obligatoires.

Lorsque la clé produit est entrée, l'assistant de création d'extension contacte le portail Report One pour vérifier la présence d'une licence Extensions. Une fois celle-ci trouvée le nom de l'extension est remplacé par le nom de

l'extension du Portail Report One et est grisé.

Astuce

Les informations d'impacts et dépendances d'un item (tableau de bord, diffusions, modèles) sont visibles au passage de la souris en hover. Les ETL, groupes et programmations affiche les dépendances au passage de la souris.

Exporter les paramètres de connexion

Il est possible de choisir l'export des information de connexions

Si la case est cochée alors , lors de l'export d'une connexion sont exportés :

  • les paramètres des propriétés de connexion

    Dans le cas d'un Web Service :

    • L'URL
    • Les paramètres
    • Les informations d'authentification

Version

Le champ version permet d'identifier l'itération de l'extension. Il est automatiquement suffixé au nom du fichier exporté (par exemple : MonExtension_1.0.mrext).

Contact

Ce champ permet de spécifier au choix soit les coordonnées mail de contact du responsable de l'extension, soit l'adresse du site de l'éditeur.

Sélection des tableaux de bord

Les tableaux de bord cochés valident le cochage automatique des modèles et groupes. Les ETL et Programmations liés à l'utilisation des modèles seront automatiquement cochés à leur tour.

Les palettes associées aux tableaux de bords sont exportées ainsi :

  • Si le tableau de bord est associé à une palette personnalisé, la palette personnalisée est exporté au niveau du tableau de bord,

  • Si le tableau de bord est associé à une palette du projet, la palette du tableau de bord passe en personnalisée, reprenant les couleurs et tendances de la palette projet associé

Sélection des diffusions

Seules les diffusions de type Center BE avec des fichiers enregistrés dans le dossier MySystems peuvent être exportées. L'option "Enregistrer le fichier dans le projet" doit être cochée dans les propriétés du fichier à envoyer sur MyReport Center BE.

Sélection des modèles

Sont sélectionnables les modèles du “Datawarehouse”, les modèles “Sources” et les fichiers.

Si un tableau de bord ou une diffusion a été précédemment coché, les modélisations utilisés pour ce tableau de bord seront automatiquement cochés.

L’utilisateur peut sélectionner d’autres modèles à inclure dans l’extension.

Sélection des groupes

Les groupes sont exportés dans les quatre cas suivants :

  • Une autorisation est appliquée sur le groupe (uniquement valable pour les autorisations modèles, ETL et diffusions)

  • Si dans data un groupe accède à un modèle ou une connexion

  • Si dans Messenger le groupe est destinataire d’une diffusion Center BE

  • Si dans Page un groupe est en partage d’un Dashboard

Sélection des programmations

Les programmations Contrôle journalier et Mise à jour du projet sont obligatoirement grisés. Elles font partie de tout les projets.

Autres éléments exportés

Certains éléments d'une extension ne sont pas visibles dans le résumé de création d'extension.

Attributs exportés dans l’extension :

  • Attributs sur les groupes

Filtres exportés dans l’extension :

  • Tous les filtres sont exportés (groupes, modèles…)

Les tables de correspondances utilisés par les modèles exportés sont intégrés dans l'extension

  • Rappel : Elles seront conservées même si l'extension est supprimée du projet.

Les autorisations sont prises en compte sur :

  • Les produits

  • les ETL

  • les modèles

  • Les diffusions

Important

Il n'est pas possible de créer une extension dans un projet qui contient des éléments verrouillés.

Si un élément est verrouillé dans le projet, le bouton Créer dans l'onglet Extensions de MyReport Administrator devient indisponible.

Différences entre extension et export

  • Une extension est un export sous licence commerciale, liée à une licence affectée au compte Report One.
  • Le menu des extensions est accessible depuis l'onglet "Extensions".
  • Le menu des exports est accessible depuis l'onglet "Options".
  • Une extension est forcément verrouillée, un export ne l'est pas obligatoirement

    • Un export verrouillé assure que les éléments importés ne peuvent pas être modifiés par l'utilisateur qui l'importe. Le verrouillage permet au concepteur de l'export de le mettre à jour, sans se soucier des modifications effectuées par les utilisateurs. Les utilisateurs peuvent importer la nouvelle mise à jour, et donc écraser l'ancienne version, tout en conservant leurs surcharges.
    • Un export non verrouillé est dit libre et ne possède pas de notion de surcharge. En cas de réimport de l'export, les modifications ajoutées seront écrasées.

Exporter un projet contenant des extensions

Dans un projet contenant une extension, il est possible de créer un export (onglet options) mais pas de créer une extension.

Dans un projet contenant un import verrouillé, il est possible de créer un export ou une extension.

Cependant dans les deux cas, les éléments issus d'un import verrouillé ou d'une extension ne seront pas disponibles à la sélection.

ghostghostghostghostghost
loading table of contents...