Types de saisie et de données des champs personnalisables

Sommaire
  1. Options des types de saisie des champs personnalisables

Les types de saisie définissent les modes de saisie possibles des données dans les champs personnalisables.

 

Les types de saisie possibles sont :

  • Texte

    Une zone de texte libre affichée sur une ligne.

  • Liste de choix

    Une liste prédéfinie affichée sous la forme d'un sélecteur, dont les valeurs sont fixées dans les options du champ personnalisable.

  • Liste de choix à partir d'une requête

    Une liste prédéfinie affichée également sous la forme d'un sélecteur, et dont les valeurs sont déterminées à partir d'une requête MySQL.

  • Valeurs à partir d'un sélecteur d'autorités

    Une liste prédéfinie affichée de la même manière qu'un champ d'autorités et dont les valeurs sont des autorités.

  • Sélection d'une date

    Une date formatée, dont la saisie se fait avec un sélecteur de type calendrier.

  • Zone de commentaire

    Une zone de texte libre pouvant être affichée sur plusieurs lignes.

  • Sélecteur externe

    Un sélecteur de données défini à partir d'un script externe au logiciel PMB.

  • URL

    Une zone de texte qui contiendra une URL.

  • Résolveur de lien

    Une zone de texte qui permettra de générer automatiquement l'adresse URL d'accès à un document numérique. L'identifiant de l'article en ligne devra être renseigné dans ce champ lors de la saisie de notice. L'adresse url sera construite à l'aide de l'adresse url renseignée dans le paramétrage de ce champ personnalisé et de l'identifiant de l'article.

  • Marclist

    Une zone permettant de récupérer les valeurs d'un fichier XML de type MarcList.

  • Zone de saisie HTML

    Une zone de texte acceptant les balises HTML et pouvant contenir un éditeur HTML Javascript pour l'aide à la saisie.

  • Texte multilingue

    Une zone de texte permettant un affichage différencié selon la langue affichée.

  • Intervalle de dates

    Un ensemble de 2 sélecteurs de dates et heures de début et de fin.

Les types de données correspondent aux formats utilisés pour le stockage des données.

Ces formats sont liés aux types de saisie.

 

  • Texte

    Permet de stocker un texte pouvant comporter jusqu'à 256 caractères.

  • Texte large

    Permet de stocker un texte, non limité en taille, adapté au type de saisie Zone de commentaire.

  • Entier

    Permet de vérifier que la saisie effectuée correspond à un entier.

  • Date

    Permet de vérifier que la saisie effectuée correspond à une date.

  • Nombre à virgule

    Permet de vérifier que la saisie effectuée correspond à un nombre décimal.

Options des types de saisie des champs personnalisables⚓

Pour chacun des types de saisie des champs personnalisés, il est nécessaire de préciser les options possibles en cliquant sur le bouton Options.

Options du type "Texte"⚓

  • Taille du champ à l'écran

    permet de fixer la largeur de la zone d'affichage présentée à l'écran lors de la saisie.

  • Nombre maximum de caractères à saisir

    permet de limiter la taille de l'information saisie.(avec un maximum de 256 caractères).

  • Répétable

    permet de préciser si la zone peut accueillir plusieurs valeurs.

  • Html autorisé

    permet de préciser si l'affichage du contenu accepte l'utilisation de balises HTML.

Options du type "Liste de choix"⚓

Attention

Il n'est pas possible de créer directement les options si le champ n'a pas été au préalable enregistré.

Enregistrez donc ce champ puis modifiez le pour en spécifier les options.

  • Liste multiple

    Permet de préciser un champ multivalué.

  • Affichage sous forme d'autorité

    Valable notamment pour les listes avec un nombre important de valeurs, cet affichage se présente sous la forme d'un sélecteur de même type que ceux utilisés pour les autorités.

  • Affichage sous forme de cases à cocher ou bouton radio

    Valable pour les listes avec un nombre peu important de valeurs, cet affichage se présente sous la forme de case à cocher. Vous pouvez définir le nombre de valeurs affichées par ligne.

  • Numérotation automatique

    Permet l'incrémentation automatique de la valeur stockée en base du champ lors de la création de nouvelles options dans la liste de choix

  • Choix vide

    Valeur et libellé prédéfinis si aucun choix n'est effectué lors de la saisie du champ personnalisable invitant les utilisateurs à effectuer une action. Exemple : "Sélectionnez une valeur"

  • Choix par défaut

    Valeur sélectionnée par défaut en création de notice si aucun autre choix n'est effectué. Cette valeur correspond à un des éléments de la liste des options.

  • Liste des options de la liste

    Elle se compose :

    • d'une Valeur, stockée en base.

    • d'un Libellé, affiché pour la saisie.

    • d'un Ordre d'affichage.

A l'aide des boutons d'action vous pouvez:

  • Ajouter un choix supplémentaire à la liste.

  • Supprimer les options cochées en cliquant sur la case à cocher au début de chacune des lignes correspondantes.

Remarque

A noter : Si des valeurs sont déjà utilisées , elles ne peuvent être supprimées.

  • Trier les options par ordre alphabétique de libellé.

  • Enregistrer les changements.

Options du type "Liste de choix à partir d'une requête"⚓

  • Liste multiple

    permet de préciser un champ multivalué.

  • Affichage sous forme d'autorité

    Valable notamment pour les listes avec un nombre important de valeurs, cet affichage se présente sous la forme d'un sélecteur de même type que ceux utilisés pour les autorités.

  • Affichage sous forme de cases à cocher ou bouton radio

    Valable pour les listes avec un nombre peu important de valeurs, cet affichage se présente sous la forme de case à cocher. Vous pouvez définir le nombre de valeurs affichées par ligne.

  • Autoriser l'insertion de nouvelle valeur.

    Cette option permet la saisie de nouvelles valeurs d'options lors de l'utilisation du champ personnalisable, ceci dans un contexte précis. (non documenté)

  • Choix vide

    Valeur et libellé prédéfinis si aucun choix n'est effectué lors de la saisie du champ personnalisable invitant les utilisateurs à effectuer une action (Exemple : "Sélectionnez une valeur").

  • Requête

    Cette commande MySQL sur la base de données doit retourner une valeur pour stockage et un libellé pour affichage des options de saisie.

A l'aide des boutons d'action vous pouvez:

 

  • Tester la requête.

  • Enregistrer les changements.

Options du type "Valeurs à partir d'un sélecteur d'autorités"⚓

  • Méthode de récupération des valeurs :

    • id : permet de récupérer les valeurs depuis l'id de l'autorité (code Unimarc des auteurs par exemple).

    • label : permet de récupérer les valeurs depuis le label de l'autorité (nom de l'auteur par exemple).

  • Type de données

permet de sélectionner l'autorité choisie.

  • Liste multiple

permet de préciser un champ multivalué. Il est déconseillé d'utiliser un affichage sous forme de liste multiple pour les autorités ayant de nombreuses occurrences telles que Auteurs ou encore Éditeurs.

Options du type "Date"⚓

  • Ne pas utiliser la date du jour par défaut

    si coché, permet de ne pas saisir automatiquement la date du jour par défaut.

  • Répétable

    permet de préciser si la zone peut accueillir plusieurs valeurs.

Options du type "Zone de commentaire"⚓

Les options de type "Zone de commentaire" fonctionnent de la même manière que les options de type "texte".

Ce type permettant un affichage sur plusieurs lignes, il est possible de préciser un nombre de lignes à l'affichage.

Options du type "Sélecteur externe"⚓

Le sélecteur externe correspond à un script accessible par exemple sur le serveur, ceci en dehors des sélecteurs proposés par le logiciel PMB.

Ce script doit proposer l'affichage de valeurs, qui, une fois sélectionnées retournent une valeur à stocker dans le champ personnalisable.

 

  • Url du sélecteur externe

    Adresse du script permettant de lancer le sélecteur.

  • Cacher la boite de texte ?

  • Autoriser la suppression de la valeur

  • Texte du bouton

    permettant l'accès au choix du sélecteur.

  • Largeur de la fenêtre

  • Hauteur de la fenêtre

  • Taille du champ à l'écran

  • Nombre maximum de caractères à saisir

  • Requête pour les libellés (mettre !!id!! dans la clause where qui sera remplacé par la valeur du code)

    commande MySQL permettant de récupérer le libellé affiché pour une valeur donnée de saisie.

Options du type "URL"⚓

  • Nombre maximum de caractères à afficher

    permet de limiter la taille de l'information saisie.

  • Durée maximale en secondes de la vérification d'un lien

    durée pendant laquelle PMB vérifiera la validité de l'URL rentrée dans le champ.

  • Répétable

    permet de préciser si la zone peut accueillir plusieurs valeurs.

Options du type "Résolveur de lien"⚓

  • Taille du champ à l'écran

    permet de fixer la largeur de la zone d'affichage présentée à l'écran lors de la saisie.

  • Répétable

    permet de limiter la taille de l'information saisie.

  • Résolveurs

    URL des sites interrogés à l'aide de l'identifiant "!!id!!".

Exemple

Options du type "Marclist"⚓

Une Marclist est une liste de valeurs Unimarc, telle qu'une liste de pays ou encore de langue.

  • Méthode de récupération des valeurs

    • Code : permet de récupérer les valeurs depuis le code Unimarc de la valeur.

    • label : permet de récupérer les valeurs depuis le label de la valeur (nom de la langue par exemple).

  • Type de données

permet de sélectionner la liste choisie.

  • Méthode de tri des valeurs

permet de trier le résultat par label ou code et par ordre croissant ou décroissant. Par exemple, pour un type de donnée Pays, il est conseillé d'opter pour un tri croissant sur le label.

  • Liste multiple

permet de préciser un champ multivalué. Il est déconseillé d'utiliser un affichage sous forme de liste multiple pour les listes ayant de nombreuses occurrences telles que Pays ou encore Langues.

  • Affichage sous forme d'autorité

Valable notamment pour les listes avec un nombre important de valeurs, cet affichage se présente sous la forme d'un sélecteur de même type que ceux utilisés pour les autorités.

  • Choix vide

    Valeur et libellé prédéfinis si aucun choix n'est effectué lors de la saisie du champ personnalisable invitant les utilisateurs à effectuer une action (Exemple : "Sélectionnez une valeur"). Il n'est pas nécessaire de définir un choix vide si l'Affichage sous forme d'autorité est coché.

Options du type "Zone de saisie HTML"⚓

Les options de type "Zone de saisie HTML" fonctionnent de la même manière que les options de type "Texte".

Il est possible d'utiliser l'éditeur HTML plutôt qu'un champ de saisie simple.

Options du type "Texte multilingue"⚓

Les options de type "Texte multilingue" fonctionnent de la même manière que les options de type "Texte".

Ce type permettant une saisie en plusieurs langues, il est possible de choisir une langue par défaut. Il est également possible de saisir le texte en HTML.

Options du type "Intervalle de dates"⚓

Les options de type "Intervalle de dates" fonctionnent de la même manière que les options de type "Sélection d'une date".