Configuration du champ de numéro de téléphone E.164

  • Rversion finale: Xanadu
  • Mis à jour 1 août 2024
  • 11 minutes de lecture
  • Les administrateurs peuvent utiliser le numéro de téléphone, les propriétés système et les attributs de dictionnaire pour effectuer certaines actions.

    Les propriétés système appliquent l’option de configuration à tous les champs de numéro de téléphone qui n’ont pas d’attribut de dictionnaire comparable. Les attributs de dictionnaire appliquent la configuration uniquement au champ de numéro de téléphone auquel il est ajouté. Étant donné que les attributs de dictionnaire ont priorité sur les propriétés système, les administrateurs peuvent définir une configuration globale avec une propriété, puis appliquer des exceptions champ par champ.

    Remarque :
    Les caractères alphanumériques ne sont pas autorisés et ne sont pas considérés comme un numéro de téléphone valide.

    Nécessitant une validation du format de territoire

    Par défaut, les champs de numéro de téléphone requièrent qu’un numéro de téléphone corresponde au format d’affichage du territoire sélectionné.

    Par défaut, les champs de numéro de téléphone requièrent qu’un numéro de téléphone corresponde au format d’affichage du territoire sélectionné. Si un numéro de téléphone ne correspond pas à ce format, la zone de saisie affiche une ligne rouge sous le numéro de téléphone ou l’ensemble de la zone devient rouge, et les utilisateurs sont empêchés de l’enregistrer.

    Figure 1. Téléphone e164 strict

    Si vous définissez la glide.phone_number_e164.strict propriété système sur false ou si vous ajoutez l’attribut de pn_strict dictionnaire, la zone de saisie du numéro de téléphone affiche une ligne verte sous les nombres qui ne correspondent pas au format de territoire répertorié pour le territoire sélectionné, ou la zone entière devient verte. Vous pouvez utiliser le territoire Autre / Inconnu pour stocker des numéros de téléphone autrement non valides.

    Figure 2. Téléphone e164 pas strict
    Avertissement :
    Le passage de la validation du format de territoire facultatif à la validation du format de territoire obligatoire peut entraîner l’échec de la validation de certains numéros de téléphone. Dans ce cas, le champ Numéro de téléphone E.164 affiche un message d’erreur.

    Obligation d’entrée au format international

    Par défaut, les utilisateurs peuvent saisir des numéros de téléphone au format local de leur territoire et n’ont pas besoin de formater le numéro pour la numérotation internationale.

    Le champ de numéro de téléphone formate automatiquement les numéros de téléphone locaux en numéros de téléphone internationaux compatibles E.164 lorsque l’utilisateur a terminé de modifier le champ. Tant que le numéro de téléphone saisi correspond au format du territoire pour un numéro local, les utilisateurs peuvent enregistrer le numéro de téléphone.

    Figure 3. Téléphone e164 entrée local
    Figure 4. Téléphone e164 afficher international

    La modification de la glide.phone_number_e164.allow_national_entry propriété système ou l’ajout de l’attribut de pn_allow_national_entry dictionnaire oblige les utilisateurs à saisir un numéro de téléphone au format international du territoire, qui commence par le caractère plus (+). Les utilisateurs ne peuvent pas enregistrer un numéro de téléphone formaté localement, et la zone de saisie du numéro de téléphone affiche une ligne rouge sous les numéros de téléphone sans le formatage international approprié.

    Configurer l’affichage du format local

    Par défaut, un champ de numéro de téléphone E.164 affiche toujours les numéros de téléphone au format international.

    Figure 5. Téléphone e164 afficher international
    Numéro de téléphone nord-américain affiché au format local.
    Modifiez le numéro de téléphone E.164 pour utiliser le format local dans certaines circonstances en ajoutant la propriété système suivante :
    Propriété Description
    glide.phone_number_e164.display_national
    • Type : chaîne
    • Valeur par défaut : faux
    • Autres valeurs possibles :
      • vrai ou forme : affiche les numéros de téléphone dans un format local sur les formulaires, mais affiche un format international sur les listes.
      • all : affiche toujours les numéros de téléphone dans un format local.
      • utilisateur : n’affiche les numéros de téléphone au format local que lorsque le numéro de téléphone correspond aux paramètres locaux de l’utilisateur actuel.
      • faux : n’affiche pas les numéros de téléphone au format local.
    Sélectionnez l’une des valeurs possibles pour déterminer comment le système gère le numéro de téléphone E.164.
    Vous pouvez également ajouter l’attribut de dictionnaire suivant à un champ spécifique pour remplacer la propriété système :
    Attribut du dictionnaire Description
    pn_display_national Remplace le paramètre de glide.phone_number_e164.display_national propriété pour la façon dont un champ de numéro de téléphone E.164 affiche les numéros de téléphone. Les valeurs disponibles sont identiques à celles décrites pour la glide.phone_number_e164.display_national propriété.
    • Type : chaîne
    • Valeur par défaut : faux
    • Exemple :pn_display_national=all

    Configurer l’affichage des étiquettes de territoire

    Une propriété contrôle la façon dont les étiquettes de territoire sont affichées.

    Vous pouvez afficher des étiquettes de territoire à côté du numéro dans un champ de numéro de téléphone E.164 en définissant la propriété système ou en ajoutant l’attribut de dictionnaire. Cet affichage est utile si la liste de choix du sélecteur de territoire est désactivée et que vous souhaitez que l’utilisateur voie le territoire pour le numéro de téléphone saisi.

    Figure 6. E164 étiquettes de territoire d’affichage de téléphone
    Afficheur de téléphone avec le numéro de téléphone +44 01733 753363 et l’étiquette du territoire Royaume-Uni.

    L’activation des étiquettes de territoire affiche également le territoire téléphonique dans des listes.

    Ajoutez la propriété système suivante pour afficher l’étiquette de territoire à côté du numéro d’un numéro de téléphone E.164.
    Propriété Description
    glide.phone_number_e164.display_territory_text Détermine quand un champ de numéro de téléphone E.164 affiche une étiquette de territoire.
    • Type : chaîne
    • Valeur par défaut : lecture seule
    • Autres valeurs possibles :
      • all : affiche l’étiquette de territoire.
      • national : affiche l’étiquette de territoire uniquement si le numéro de téléphone est au format local.
      • Lecture seule : affiche l’étiquette de territoire en mode lecture seule, que le numéro soit au format local ou international.
      • read-only-national : affiche l’étiquette de territoire en mode lecture seule uniquement si le numéro est au format local.
      • list : affiche l’étiquette de territoire dans une liste.
      • list-national : affiche l’étiquette du territoire dans une liste si le numéro est au format national.
      • none : n’affiche pas l’étiquette de territoire.
    Vous pouvez également ajouter l’attribut de dictionnaire suivant à un champ spécifique pour remplacer la propriété système :
    Attribut du dictionnaire Description
    pn_display_territory_text Remplace la glide.phone_number_e164.display_territory_text propriété qui définit quand un champ de numéro de téléphone affiche une étiquette de territoire. Les valeurs disponibles sont identiques à celles décrites précédemment pour la glide.phone_number_e164.display_territory_text propriété.
    • Type : chaîne
    • Valeur par défaut : lecture seule
    • Exemple :pn_display_territory_text=all

    Configurer les préfixes de numérotation directe internationale

    Une propriété est disponible pour contrôler l’affichage des préfixes.

    Vous pouvez activer l’affichage du préfixe de numérotation directe internationale, qui apparaît entre la liste de choix du sélecteur de territoire et la zone de saisie d’un champ de numéro de téléphone E.164 sur les formulaires, en définissant la propriété système ou en ajoutant l’attribut de dictionnaire.

    Figure 7. Idd de l’affichage du téléphone E164
    Affichage du téléphone avec le préfixe de numérotation directe internationale avant le champ du numéro de téléphone
    Ajoutez la propriété système suivante pour afficher le préfixe de numérotation directe internationale.
    Propriété Description
    glide.phone_number_e164.display_users_idd Détermine s’il faut afficher le préfixe de numérotation directe internationale entre la liste de choix du sélecteur de territoire et la zone de saisie sur les formulaires.
    • Type : true | false
    • Valeur par défaut : faux
    Vous pouvez également ajouter l’attribut de dictionnaire suivant à un champ spécifique pour remplacer la propriété système :
    Attribut du dictionnaire Description
    pn_display_users_idd Remplace la glide.phone_number_e164.display_users_idd propriété qui détermine s’il faut afficher le préfixe de numérotation directe internationale entre la liste de choix du sélecteur de territoire et la zone de saisie sur les formulaires. Les valeurs disponibles sont identiques à celles décrites ci-dessus pour la glide.phone_number_e164.display_users_idd propriété.
    • Type : true | false
    • Valeur par défaut : faux
    • Exemple :pn_display_users_idd=false

    Configurer la liste de choix du sélecteur de territoire téléphonique

    Par défaut, un champ de numéro de téléphone E.164 affiche toujours le territoire téléphonique associé au numéro de téléphone.

    La modification de la propriété système ou l’ajout de l’attribut de dictionnaire masque la liste de choix du sélecteur de territoire. Si la liste de choix du sélecteur de territoire est masquée, les utilisateurs ne peuvent saisir qu’un numéro local ou national.

    Figure 8. Téléphone e164 Masquer le sélecteur
    Champ numérique sans sélecteur affiché.
    Ajoutez la propriété système suivante pour afficher ou masquer la liste de choix du sélecteur de territoire.
    Propriété Description
    glide.phone_number_e164.display_territory_selector Détermine s’il faut afficher la liste de choix du sélecteur de territoire. Le masquage de la liste de choix du sélecteur de territoire limite la saisie des numéros de téléphone locaux ou nationaux.
    • Type : true | false
    • Valeur par défaut : true
    Vous pouvez également ajouter l’attribut de dictionnaire suivant à un champ spécifique pour remplacer la propriété système :
    Attribut du dictionnaire Description
    pn_display_territory_selector Remplace le paramètre de glide.phone_number_e164.display_territory_selector propriété qui détermine s’il faut afficher la liste de choix du sélecteur de territoire. Les valeurs disponibles sont identiques à celles décrites ci-dessus pour la glide.phone_number_e164.display_territory_selector propriété.
    • Type : true | false
    • Valeur par défaut : true
    • Exemple : pn_display_territory_selector=false

    Propriétés système du champ de numéro de téléphone E.164

    Plusieurs propriétés sont disponibles pour configurer les champs de numéro de téléphone E.164.

    Remarque :
    Pour ouvrir la table Propriétés système [sys_properties], saisissez sys_properties.list dans le filtre de navigation.
    Tableau 1. E.164 Système de champs de numéro de téléphone Propriétés
    Propriété Description
    glide.phone_number_e164.strict Détermine si tous les champs de numéro de téléphone doivent correspondre au format d’affichage pour le territoire sélectionné.

    Lorsque la valeur est définie sur vrai, le champ d’entrée du numéro de téléphone affiche une ligne rouge sous les numéros de téléphone qui ne correspondent pas au format du territoire sélectionné. Les utilisateurs ne peuvent pas enregistrer le numéro de téléphone.

    Lorsque la valeur est définie sur faux, le champ d’entrée Numéro de téléphone affiche une ligne verte sous les numéros de téléphone qui ne correspondent pas au format du territoire sélectionné. Les utilisateurs peuvent enregistrer le numéro de téléphone. La liste de choix du sélecteur de territoire offre la possibilité de sélectionner un format de territoire Autre/Inconnu .

    • Type : true | false
    • Valeur par défaut : true
    • Emplacement : ajouter à la table Propriétés système [sys_properties].
    glide.phone_number_e164.allow_national_entry Détermine si les utilisateurs peuvent saisir des numéros de téléphone au format local ou s’ils doivent saisir des numéros de téléphone au format international.

    Si vrai, les utilisateurs peuvent entrer des numéros de téléphone au format local pour le territoire sélectionné. Si la propriété est définie sur false, les utilisateurs doivent saisir des numéros de téléphone au format international pour le territoire sélectionné.

    • Type : true | false
    • Valeur par défaut : true
    • Emplacement : ajouter à la table Propriétés système [sys_properties].
    glide.phone_number_e164.display_national Détermine s’il faut afficher les numéros de téléphone E.164 au format local.
    • Type : chaîne
    • Valeur par défaut : faux
    • Autres valeurs possibles :
      • vrai ou forme : affiche les numéros de téléphone dans un format local sur les formulaires, mais affiche un format international sur les listes.
      • all : affiche toujours les numéros de téléphone dans un format local.
      • utilisateur : n’affiche les numéros de téléphone au format local que lorsque le numéro de téléphone correspond aux paramètres locaux de l’utilisateur actuel. Le paramètre local de l’utilisateur actuel est déterminé par l’emplacement associé à l’enregistrement utilisateur.
      • faux : n’affiche pas les numéros de téléphone au format local.
    • Emplacement : ajouter à la table Propriétés système [sys_properties].
    glide.phone_number_e164.display_territory_selector Détermine s’il faut afficher la liste de choix du sélecteur de territoire. Le masquage de la liste de choix du sélecteur de territoire limite la saisie des numéros de téléphone locaux ou nationaux.
    • Type : true | false
    • Valeur par défaut : true
    • Emplacement : ajouter à la table Propriétés système [sys_properties].
    glide.phone_number_e164.display_territory_text Détermine quand un champ de numéro de téléphone E.164 affiche une étiquette de territoire.
    • Type : chaîne
    • Valeur par défaut : lecture seule
    • Autres valeurs possibles :
      • all : affiche toujours l’étiquette de territoire.
      • national : affiche l’étiquette de territoire uniquement si le numéro de téléphone est au format local.
      • Lecture seule : affiche l’étiquette de territoire en mode lecture seule, que le numéro soit au format local ou international.
      • read-only-national : affiche l’étiquette de territoire en mode lecture seule uniquement si le numéro est au format local.
      • list : affiche l’étiquette de territoire dans une liste.
      • list-national : affiche l’étiquette du territoire dans une liste si le numéro est au format national.
      • none : n’affiche pas l’étiquette de territoire.
    • Emplacement : ajouter à la table Propriétés système [sys_properties].
    glide.phone_number_e164.display_users_idd Détermine s’il faut afficher le préfixe de numérotation directe internationale entre la liste de choix du sélecteur de territoire et le champ d’entrée sur les formulaires.
    • Type : true | false
    • Valeur par défaut : faux
    • Emplacement : ajouter à la table Propriétés système [sys_properties].

    E.164 Attributs du dictionnaire de champ de numéro de téléphone

    Vous pouvez remplacer la propriété système globale par certains attributs de dictionnaire.

    Tableau 2. E.164 Dictionnaire de champ de numéro de téléphone Attributs
    Attribut du dictionnaire Description
    pn_strict Remplace le paramètre de glide.phone_number_e164.strict propriété qui exige que toutes les entrées de numéro de téléphone correspondent au format du territoire sélectionné. Les valeurs disponibles sont identiques à celles décrites pour la glide.phone_number_e164.strict propriété.
    • Type : true | false
    • Valeur par défaut : true
    • Exemple :pn_strict=false
    pn_allow_national_entry Remplace le paramètre de propriété qui détermine si les glide.phone_number_e164.allow_national_entry utilisateurs peuvent entrer des numéros de téléphone au format local ou s’ils doivent entrer des numéros de téléphone au format international. Les valeurs disponibles sont identiques à celles décrites pour la glide.phone_number_e164.allow_national_entry propriété.
    • Type : true | false
    • Valeur par défaut : true
    • Exemple :pn_allow_national_entry=false
    pn_display_national Remplace le paramètre de glide.phone_number_e164.display_national propriété pour la façon dont un champ de numéro de téléphone E.164 affiche les numéros de téléphone. Les valeurs disponibles sont identiques à celles décrites pour la glide.phone_number_e164.display_national propriété.
    • Type : chaîne
    • Valeur par défaut : faux
    • Exemple :pn_display_national=all
    pn_display_territory_selector Remplace le paramètre de glide.phone_number_e164.display_territory_selector propriété qui détermine s’il faut afficher la liste de choix du sélecteur de territoire. Les valeurs disponibles sont identiques à celles décrites pour la glide.phone_number_e164.display_territory_selector propriété.
    • Type : true | false
    • Valeur par défaut : true
    • Exemple : pn_display_territory_selector=false
    pn_display_territory_text Remplace la glide.phone_number_e164.display_territory_text propriété qui définit quand un champ de numéro de téléphone affiche une étiquette de territoire. Les valeurs disponibles sont identiques à celles décrites pour la glide.phone_number_e164.display_territory_text propriété.
    • Type : chaîne
    • Valeur par défaut : lecture seule
    • Exemple :pn_display_territory_text=all
    pn_display_users_idd Remplace la glide.phone_number_e164.display_users_idd propriété qui détermine s’il faut afficher le préfixe de numérotation directe internationale entre la liste de choix du sélecteur de territoire et la zone de saisie sur les formulaires. Les valeurs disponibles sont identiques à celles décrites pour la glide.phone_number_e164.display_users_idd propriété.
    • Type : true | false
    • Valeur par défaut : faux
    • Exemple :pn_display_users_idd=false