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.
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.
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.
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 :
Sauvegarder vos modifications.
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.
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.
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.
Produits MyReport BE | Fonctionnalité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é :
Non autorisé :
Concernant les requêtes
Concernant les autorisations des utilisateurs :
NoteAu 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é :
Non autorisé
|
MyReport Center |
Autorisé :
|
MyReport Messenger |
Autorisé :
Non autorisé
Verrouillage des programmations dans MyReport Messenger :
|
MyReport Administrator |
Autorisé :
Non autorisé
|
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.
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 :
|
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.
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.
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 :
Sauvegarder vos modifications.
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.
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é)".
Elément de l'extension |
Ajout |
Elément déjà existant |
---|---|---|
Groupes |
Ajout du groupe à la gestion utilisateur |
|
Modèles |
Ajout du modèle |
|
Tableaux de bord |
Ajout du dashboard |
Synchronisation des droits (partage) |
Diffusions |
Ajout de la diffusion |
|
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 :
Si les autorisations n'ont pas été modifiés :
|
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.
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.
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.
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.
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
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).
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.
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é
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.
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.
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
Les programmations Contrôle journalier et Mise à jour du projet sont obligatoirement grisés. Elles font partie de tout les projets.
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.
- 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.
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.