Notes de version de Sapphire

Le contrôle d’image, utilisé pour afficher une ou plusieurs images jointes à l'enregistrement en cours L'enregistrement actuellement affiché en Vue de Détails ou mis en évidence en Vue de Liste (il est entouré d'une légère ligne pointillée). On ne peut avoir qu'un seul enregistrement en cours à la fois., comprend désormais deux nouveaux outils : Annoter et Dessiner .

L’outil Annoter est utilisé pour ajouter du texte à une image :

Conseil : Les annotations peuvent être placées sur l’image et en dehors de ses bordures.

Il est désormais possible de l'associer à une liste déroulante proposant des motifs d'annotation :

Les motifs d’annotation des images peuvent être définis dans une Liste de consultation EMu et associés à l’outil Annoter (détails ici) : une liste déroulante contenant les motifs d’annotation est ajoutée au Contrôle d’image. Il est possible de configurer Sapphire de manière à ce que chaque option de la liste déroulante ait une couleur et une taille spécifiques, ce qui permet de la distinguer des annotations associées à toutes les autres options de la liste déroulante. Dans cet exemple, les annotations ajoutées lorsque l’option 5. Dégâts physiques est sélectionnée auront une couleur et une taille différentes de celles des annotations ajoutées lorsque l’option 6. Réparations précédentes est sélectionné.

Note: Pour que chaque option sélectionnée dans la liste déroulante Annoter ait une couleur différente par défaut, il faut définir les paramètres suivants dans config/client.js :
IMu.Config.generateAnnotTextColour = true

L’outil Dessiner est utilisé pour tracer une ligne (à main levée) sur une image.

La taille et la couleur du texte d’annotation et d’une ligne tracée avec l’outil Dessiner peuvent être personnalisées à l’aide de l’option Paramètres .

Plus de détails ici.

Un projet Sapphire peut inclure un ou plusieurs Formulaires, chacun pouvant être sélectionné à partir du Tableau de bord selon les besoins (vous trouverez ici des détails sur l’utilisation des Formulaires). Lorsque cela s’avère pertinent, deux Formulaires ou plus peuvent être ajoutés à une Tâche :

Avec une Tâche, il est possible de parcourir plusieurs Formulaires à la suite sans avoir à sélectionner chaque Formulaire séparément à partir du Tableau de bord. Dans l’exemple ci-dessus, les quatre Formulaires répertoriés dans la section Formulaires traitent tous des données dans le module Constats d’état et ont été ajoutés à la Tâche Constat d’état. Lorsque la Tâche est exécutée, le premier Formulaire, Enregistrement de constat d’état, s’affichera :

Lorsque l’utilisateur remplit le Formulaire et sélectionne Suivant, le Formulaire suivant de la séquence s’affichera. Lorsque le dernier Formulaire de la séquence est atteint, le bouton Suivant est remplacé par le bouton Enregistrer :

En sélectionnant Enregistrer, toutes les données ajoutées à chacun des Formulaires de la séquence en cours seront enregistrées, ce qui modifiera les enregistrements concernés et créera de nouveaux enregistrements si nécessaire, avant de revenir au premier Formulaire de la séquence.

Plus de détails :

• Vous trouverez ici des détails sur l’utilisation d’une Tâche.
• Vous trouverez ici des détails sur la configuration d’une Tâche.

OpenID Connect (OIDC) est une norme ouverte et un protocole d’authentification décentralisé qui permet aux utilisateurs de se connecter à plusieurs sites Web à l’aide d’un seul ensemble d’informations d’identification. Au lieu de créer un nouveau nom d’utilisateur et un nouveau mot de passe pour chaque site, les utilisateurs peuvent s’authentifier à l’aide d’un fournisseur d’identité tel que Google ou Microsoft. Cette fonctionnalité est disponible dans EMu depuis la version 6.5 ; il est désormais possible de se connecter à Sapphire via OIDC.

Note: Vous trouverez ici des détails sur la mise en œuvre et la configuration de l’OICD dans EMu.

Lors de la configuration de Sapphire, une case à cocher Connectez-vous avec OpenID Connect s’affichera dans la fenêtre de connexion :

Conseil : Laissez la case décochée si vous souhaitez vous connecter à Sapphire en utilisant votre mot de passe et votre nom d’utilisateur EMu.

Pour vous connecter avec OpenID, cochez la case :

• Une liste déroulante Prestataire est ajoutée à la fenêtre de connexion :

  

  Conseil : Si un seul fournisseur est disponible, il s’affiche automatiquement dans le champ Prestataire.

  Si plusieurs fournisseurs sont disponibles, sélectionnez-en un dans la liste déroulante :

  

• Saisissez votre nom d’utilisateur EMu1 Sapphire utilise le même nom d’utilisateur et le même mot de passe qu’EMu., sélectionnez un groupe dans la liste déroulante Groupe (si vous êtes membre de plusieurs groupes) et sélectionnez Connexion.

  Note: Le nom d’utilisateur ne fonctionne que comme un indice pour le prestataire d’identité externe, car il est possible de se connecter au prestataire avec un compte différent de celui spécifié dans Sapphire. Ceci est résolu lorsque vous vous connectez au fournisseur d’identité et que Sapphire s’est connecté au serveur EMu.

Vous trouverez ici tous les détails sur la connexion à Sapphire.

Une nouvelle propriété Lien est disponible lors de la configuration de champs à inclure dans un Formulaire :

La propriété Lien est utile pour consulter les données et pour ajouter ou modifier des données ligne par ligne dans un tableau tel que Détails de la mesure dans le Catalogue :

Pour chaque Type du tableau Détails de la mesure, il est possible d’ajouter des valeurs telles que Hauteur, Largeur, Profondeur, etc., et de spécifier les unités utilisées. Avec la propriété Lien, il est possible de présenter les données dans deux Sections liées d’un formulaire Sapphire, par exemple :

Dans cet exemple, Dimensions de l’œuvre est sélectionné dans la section Type de mesure et ses valeurs s’affichent dans la section Dimensions. Sélectionnez Dimensions de l’objet dans Type de mesure pour afficher ses détails :

Si l’on sélectionne le champ Type de mesure vide, les valeurs de Dimensions sont effacées : on peut alors ajouter un nouveau Type de mesure et compléter les valeurs de Dimensions :

Lorsque le Formulaire est enregistré, une ligne contenant ces détails est ajoutée au tableau Détails de la mesure du Catalogue pour l’enregistrement d’objet en cours :

Comment configurer

Cette mise en page de Formulaire nécessite deux Sections (détails sur l’ajout de Sections ici).

Dans la première Section, ajoutez un Champ et pointez Colonne sur le nom back-end du premier champ de la table EMu, Type : (Détails de la mesure) dans l’exemple ci-dessus (nom back-end : PhyType_tab) :

Dans la deuxième Section, ajoutez un Champ pour chacun des autres champs pour chacun d’eux, pointez Lien sur le nom back-end du premier champ de la ligne (PhyType_tab dans cet exemple) :

Enfin, disposez les Sections en deux colonnes :

Il est possible de personnaliser la page de connexion à Sapphire en enregistrant une image d’arrière-plan à l’emplacement suivant :

client\saphhire\

où client correspond au nom ou à l’acronyme utilisé pour l’implémentation de votre établissement, par exemple : ushmm\sapphire\

Il est important que votre image soit optimisée pour le Web et respecte les consignes suivantes :

• L’image doit être jpg et appelée login-background :

  login-background.jpg

• La taille du fichier doit être comprise entre 100 et 500 Ko afin d’optimiser les performances de chargement de la page.
• Le rapport d’aspect doit être de 3:2 (largeur : hauteur), les dimensions recommandées étant de 1 600 px sur 1 067 px.

Un contrôle d’image peut inclure une option permettant d’ajouter une superposition de texte à une image en sélectionnant l’option Annoter :

Sapphire attribue une couleur par défaut à l’annotation, le bleu par exemple, et chaque annotation créée utilisera cette couleur jusqu’à ce que l’utilisateur la modifie dans l’option Paramètres :

Une fois la couleur modifiée, toutes les annotations suivantes utiliseront la nouvelle couleur.

Ce comportement par défaut est déterminé par le paramètre suivant dans config/client.js :

IMu.Config.generateAnnotTextColour = false

Il est possible de modifier ce comportement en définissant :

IMu.Config.generateAnnotTextColour = true

Avec ce paramètre, il n'est pas possible de modifier la couleur par défaut et toutes les annotations ajoutées à une image utiliseront la couleur par défaut attribuée par Sapphire. Cela vaut également lorsqu’un Contrôle d’image comporte une liste déroulante proposant des motifs d’annotation (voir détails ici) :

Lorsque IMu.Config.generateAnnotTextColour = true, Sapphire attribue par défaut une couleur différente à chaque option de la liste déroulante afin de distinguer les annotations ajoutées pour cette option de celles ajoutées pour toutes les autres options de la liste. Dans cet exemple, chaque annotation ajoutées lorsque l’option 5. Dégâts physiques est sélectionnée auront une couleur et une taille différentes de celles ajoutées lorsque l'option 6. Réparations précédentes est sélectionné.

Avec ce paramètre, la couleur par défaut attribuée par Sapphire à chaque option ne peut pas être modifiée.

Notez cependant que même avec ce paramètre, il est toujours possible de sélectionner une annotation existante et de changer sa couleur (du bleu au rouge par exemple) ; cependant, si la couleur par défaut attribuée par Sapphire est le bleu, la prochaine annotation ajoutée à l’image sera bleue.

Il n’est pas possible de télécharger via Sapphire des images de plus de 10 Mo, et un message d’avertissement s’affiche désormais si vous tentez de le faire (auparavant, Sapphire plantait sans avertissement) :

Sapphire est capable d’afficher des images qui dépassent 10 Mo car ses images sont hébergées sur le serveur EMu, et une solution de contournement consiste à télécharger des images via le client EMu, ou Axiell Go.

Une autre amélioration est que les images générées par le processus d’annotation (indiqué par -annot) sont désormais automatiquement compressées pour éviter ces limitations de taille d’image.

• Les enregistrements avec plusieurs images envoyées et reçues du serveur respectent désormais l’ordre dans lequel elles apparaissent sur l’enregistrement, ce qui permet de maintenir la cohérence de l’ordre des images entre Sapphire et le serveur.
• Les performances de téléchargement ont été améliorées en ne générant des images d’annotation que lorsque les images ont été modifiées.

La version 9.1 de Sapphire comprend une série de mises à jour et de mises à niveau technologiques :

• La version 8.2.8 de PHP est désormais prise en charge.
• JQuery a été mis à niveau vers la version 3.7.0 et la bibliothèque JQueryUI a été mise à niveau vers la version 1.13.2, apportant des améliorations, des corrections de bogues et des fonctionnalités supplémentaires pour améliorer les interfaces utilisateur et les interactions.
• La bibliothèque OpenLayers a été mise à jour vers la version 7.5.0. OpenLayers est une bibliothèque cartographique permettant de créer des cartes interactives et des applications géospatiales.
• La bibliothèque d'animation Tweenmax a été remplacée par GSAP (GreenSock Animation Platform) version 3.12.2. GSAP offre des fonctionnalités d'animation performantes permettant de créer des expériences utilisateur fluides et captivantes.
• HTTPS est désormais activé avec Sapphire.

  Note: HTTP est toujours la valeur par défaut et un paramètre de configuration doit être modifié pour activer HTTPS.

Il est désormais possible d’ajouter un champ dans un Formulaire afin d’enregistrer un emplacement réel à l’aide du système de géocodage what3words. what3words est un système de géocodage propriétaire conçu pour identifier n'importe quel emplacement avec une précision d'environ trois mètres. Le système convertit les coordonnées géographiques (la latitude et la longitude de votre appareil) en trois mots attribués de façon permanente. Par exemple, la porte d’entrée du 10 Downing Street à Londres est identifiée par slurs.this.shark2 https://en.wikipedia.org/wiki/What3words.

Lorsqu’il est inclus dans un Formulaire, l’utilisateur voit s’afficher un champ en lecture seule avec un bouton Actualiser utilisé pour Générer what3words :

Lorsque l’utilisateur sélectionne le bouton, les coordonnées géographiques précises de son appareil sont converties en trois mots attribués de façon permanente :

Le système de géocodage what3words peut notamment servir à enregistrer des coordonnées géographiques lors de prélèvements sur le terrain ou à enregistrer l’emplacement physique d’un objet lors d’un inventaire.

Vous trouverez ici des détails sur la configuration d’un champ what3words.

Note: Une clé API est nécessaire pour générer des données encodées au format what3words. Si cette fonctionnalité est nécessaire, les clients peuvent obtenir une clé directement auprès de what3words ou demander à Axiell de générer une clé gratuite. Notez que les clés gratuites et payantes offrent des fonctionnalités différentes, et que la clé gratuite est limitée à 100 utilisations par mois. L’équipe de livraison du projet Axiell devra définir la clé API (what3words-key) dans le fichier de configuration PHP (config/local.php).

La fonctionnalité de recherche de Sapphire sert généralement à localiser un ou plusieurs enregistrements afin d'en modifier les données. Avec l’introduction d’un nouvel élément de Page de requête, il est désormais possible d’effectuer une recherche afin d’obtenir un jeu de résultats (par exemple, tous les objets situés à un emplacement donné) et d’enregistrer les résultats au format PDF.

Lorsqu’il est utilisé, l’élément Page de requête est le seul élément d’un Formulaire (il ne peut être combiné à aucun autre élément) :

Un élément de Page de requête est configuré pour rechercher un ou plusieurs champs dans un module spécifique. Le Responsable du programme détermine le nombre maximal de résultats à afficher, ainsi que les données à afficher (provenant d'un ou plusieurs champs). Vous trouverez ici des détails sur l’objectif de la Page de requête et le nombre maximal de résultats pouvant être affichés à partir de l’icône Information dans la barre de titre :

Les utilisateurs saisissent un terme de recherche (ou ne saisissent rien pour afficher tous les enregistrements) et sélectionnent Allez (ou appuient sur ENTRÉE) ; le nombre d'enregistrements trouvés s'affiche et les résultats apparaissent sous le champ de recherche :

Les enregistrements ne peuvent pas être modifiés ; les utilisateurs peuvent toutefois enregistrer les résultats au format PDF en sélectionnant . Selon la configuration du navigateur :

• un fichier, dont le nom correspond à celui du Formulaire de requête, sera téléchargé dans le dossier Téléchargements de votre appareil ; ou
• l’utilisateur aura la possibilité de nommer le fichier et de l’enregistrer à l’emplacement de son choix.

Vous trouverez ici des détails sur la définition d’un élément de Page de requête.

L’une des fonctionnalités introduites avec le nouvel élément de Page de requête décrit ci-dessus est la possibilité de trier les enregistrements renvoyés par une recherche (lors de l’utilisation de l’élément de Page de requête ou de l’option de recherche et d’édition).

La section Recherche dans le Concepteur de formulaires comprend désormais une option Ajouter une colonne de tri qui permet aux Responsables du programme d’ajouter un ou plusieurs champs utilisés pour trier le jeu de résultats par ordre alphabétique ou numérique.

Par défaut, les champs sont triés de A à Z et de 0 à 9. Pour inverser l’ordre, faites précéder le nom du champ d’un signe moins, par exemple -NamLast.

L’élément Statistiques fournit aux utilisateurs autorisés (Gestionnaires) des graphiques (à barres et circulaires) présentant tout type de données statistiques (l’avancement d’un projet, l’état des objets, etc.). Un graphique peut être associé à n'importe quelle colonne de n'importe quel module, et il est possible de filtrer les données avant qu'elles ne soient affichées.

Si la colonne de filtrage est un champ de date (elle est de type date), il est désormais possible de saisir une date ou de sélectionner une valeur dans une liste déroulante de dates (aujourd'hui, cette année, etc.), ce qui rend le filtre dynamique par rapport à la date du jour :

Les valeurs sont :

• aujourd'hui
• hier
• ce mois-ci
• le mois dernier
• cette année
• l'année dernière
• cette semaine
• la semaine dernière

Des requêtes de plage de dates sont désormais également possibles à l’aide des opérateurs suivants : >, >=, <, <=

Seules les dates individuelles saisies dans un champ de valeur sont actuellement prises en charge, par exemple :

• >2015
• <=01/01/2021
• >l’année dernière

et une valeur telle que >2010 <2015 ne fonctionnera pas ; cependant, deux filtres distincts peuvent être spécifiés pour obtenir le même résultat :

La validation de date a également été ajoutée. Les formats de date valides sont jj/mm/aaaa, mm/aaaa et aaaa. Un message d’erreur s’affichera si des valeurs de date non valides sont saisies (lors de l’enregistrement de l’élément Statistiques).

Vous trouverez ici des détails sur la configuration d’un élément Statistiques.

Un formulaire Sapphire peut inclure un Contrôle d'image qui affiche une ou plusieurs images jointes à l'enregistrement en cours L'enregistrement actuellement affiché en Vue de Détails ou mis en évidence en Vue de Liste (il est entouré d'une légère ligne pointillée). On ne peut avoir qu'un seul enregistrement en cours à la fois..

Avec la mise à jour de la bibliothèque OpenLayers de Sapphire, les icônes et les fonctionnalités du Contrôle d’image ont été entièrement repensées. Parmi les nouvelles fonctionnalités figure un outil de dessin et d'annotation à main levée. Plus de détails ici.

Lorsque plusieurs images s’affichent dans un contrôle d’image, celui-ci fonctionne comme un carrousel (statique), ce qui permet de faire défiler les images :

L’image actuelle occupe la majeure partie de la zone du carrousel. En dessous se trouve une ligne contenant les vignettes de toutes les images chargées dans le formulaire, la vignette de l’image actuelle étant mise en évidence par une bordure grise.

Il existe plusieurs méthodes pour parcourir les images :

• Cliquez sur les flèches situées à côté de l’image actuelle pour passer à l’image suivante ou précédente.
• Cliquez sur une vignette pour en faire l’image actuelle.
• Cliquez sur à droite du Contrôle d’image pour afficher la liste des noms de fichiers de toutes les images ajoutées, puis cliquez sur un nom de fichier pour en faire l’image actuelle.

Ce comportement par défaut peut être désactivé par les utilisateurs disposant des autorisations nécessaires, en définissant IMu.Config.enableImageCarousel sur false dans le fichier de configuration PHP (config/local.php).

Une nouvelle installation de Sapphire comprend un projet de démonstration contenant une série de Formulaires et d’Outils conçus pour gérer les Mises à jour d’état, la Capture d’images, les Mises à jour de localisation et l’Inventaire. Notez que ces exemples de Formulaires ont été configurés pour le système EMu museum et qu’ils peuvent ne pas fonctionner tels quels dans tous les environnements. Même si les utilisateurs peuvent éventuellement utiliser ces Formulaires et Outils, ceux-ci sont principalement destinés aux responsables de programme, qui pourront examiner la manière dont ils ont été configurés.

Les trois premiers outils s’expliquent d’eux-mêmes. Avec l’outil Inventaire, il est possible de rechercher un emplacement, puis de scanner tous les objets qui s’y trouvent. Dans l’enregistrement du Catalogue de chaque objet scanné, les champs Date d’inventaire et Inventorié par sont mis à jour dans l’onglet Statut. Si l’emplacement actuel d’un objet diffère de l’emplacement où il a été trouvé, l’objet est signalé comme étant au mauvais endroit. Si un objet est censé se trouver à l’emplacement indiqué sur le Formulaire et qu’il n’a pas été scanné, il est signalé comme manquant. Ces deux exceptions peuvent ensuite faire l’objet d’un suivi manuel.

Lors de l’inclusion d’une section Recherche dans un Formulaire, ou de l’ajout d’une Page de requête, il est désormais possible d’associer le champ de recherche à une Liste de consultation, État de l'objet par exemple, afin de proposer une liste déroulante des valeurs de recherche possibles :

Si le champ recherché pour la valeur de recherche (alias la colonne de recherche) et le champ contenant les valeurs dans la liste de consultation sont identiques, cela limite effectivement la recherche à ces valeurs. S’ils ne sont pas identiques (la colonne de recherche est Données sommaires et la Liste de consultation est État de l’objet par exemple), la liste déroulante ne fournit que des termes de recherche suggérés.

Plus de détails :

• Vous trouverez ici des détails sur la configuration d’une section Recherche dans un Formulaire.
• Vous trouverez ici des détails sur la configuration d’une Page de requête.