Configuração do campo de número de telefone E.164

  • Versão de lançamento: Yokohama
  • Atualizado 30 de jan. de 2025
  • 11 min. de leitura
  • Os administradores podem usar as propriedades do sistema de números de telefone e os atributos do dicionário para fazer determinadas coisas.

    As propriedades do sistema aplicam a opção de configuração a todos os campos de número de telefone que não têm um atributo de dicionário semelhante. Os atributos do dicionário aplicam a configuração somente ao campo de número de telefone ao qual ele foi adicionado. Como os atributos do dicionário têm precedência sobre as propriedades do sistema, os administradores podem definir uma configuração global com uma propriedade e aplicar exceções campo a campo.

    Nota:
    Caracteres alfanuméricos não são permitidos e não são considerados um número de telefone válido.

    Requer validação de formato de território

    Por padrão, os campos de número de telefone exigem que um número de telefone corresponda ao formato de exibição do território selecionado.

    Por padrão, os campos de número de telefone exigem que um número de telefone corresponda ao formato de exibição do território selecionado. Se um número de telefone não corresponder a esse formato, a caixa de entrada exibirá uma linha vermelha abaixo do número de telefone ou a caixa inteira ficará vermelha e os usuários serão impedidos de salvá-la.

    Figura 1. Telefone e164 estrito

    Definir a propriedade do sistema glide.phone_number_e164.strict como falsa ou adicionar o atributo de dicionário pn_strict permite que a caixa de entrada do número de telefone exiba uma linha verde abaixo dos números que não correspondem ao formato de território listado para o território selecionado ou que a caixa inteira fique verde. Você pode usar o território Outro/Desconhecido para armazenar números de telefone inválidos.

    Figura 2. Telefone e164 não estrito
    Aviso:
    Alternar da validação de formato de território opcional para a validação de formato de território obrigatória pode resultar em falha na validação de alguns números de telefone. Nesses casos, o campo de número de telefone E.164 exibe uma mensagem de erro.

    Requer entrada de formato internacional

    Por padrão, os usuários podem inserir números de telefone no formato local do território e não precisam formatar o número para discagem internacional.

    O campo de número de telefone formata automaticamente os números de telefone locais em números de telefone internacionais compatíveis com E.164 quando o usuário termina de editar o campo. Contanto que o número de telefone inserido corresponda ao formato do território para um número local, os usuários podem salvar o número de telefone.

    Figura 3. Entrada de telefone e164 local
    Figura 4. Telefone e164 com exibição internacional

    Alterar a propriedade do sistema glide.phone_number_e164.allow_national_entry ou adicionar o atributo de dicionário pn_allow_national_entry exige que os usuários insiram um número de telefone no formato internacional do território, que começa com o caractere de adição (+). Os usuários não podem salvar um número de telefone formatado localmente e a caixa de entrada do número de telefone exibe uma linha vermelha abaixo dos números de telefone sem a formatação internacional apropriada.

    Configurar a exibição do formato local

    Por padrão, um campo de número de telefone E.164 sempre exibe números de telefone em um formato internacional.

    Figura 5. Telefone e164 com display internacional
    Número de telefone da América do Norte exibido no formato local.
    Altere o número de telefone E.164 para usar o formato local em determinadas circunstâncias , adicionando a seguinte propriedade do sistema:
    Tabela 1.
    Propriedade Descrição
    glide.phone_number_e164.display_national
    • Tipo: cadeia de caracteres
    • Valor-padrão: falso
    • Outros valores possíveis:
      • verdadeiro ou formulário: exibe números de telefone em um formato local em formulários, mas exibe um formato internacional em listas.
      • all: sempre exibe números de telefone em um formato local.
      • user: exibe números de telefone somente em um formato local quando o número de telefone corresponde à configuração local do usuário atual.
      • false: não exibe números de telefone no formato local.
    Selecione um dos valores possíveis para determinar como o sistema lida com o número de telefone E.164.
    Você também pode adicionar o seguinte atributo de dicionário a um campo específico para substituir a propriedade do sistema:
    Tabela 2.
    Atributo de dicionário Descrição
    pn_display_national Substitui a configuração da propriedade glide.phone_number_e164.display_national de como um campo de número de telefone E.164 exibe números de telefone. Os valores disponíveis são idênticos aos descritos para a propriedade glide.phone_number_e164.display_national.
    • Tipo: cadeia de caracteres
    • Valor padrão: falso
    • Exemplo:pn_display_nacional=all

    Configurar a exibição de rótulos de território

    Uma propriedade controla como os rótulos de território são exibidos.

    Você pode exibir rótulos de território ao lado do número em um campo de número de telefone E.164 definindo a propriedade do sistema ou adicionando o atributo de dicionário. Essa exibição será útil se a lista de seleção do seletor de território estiver desativada e você quiser que o usuário veja o território do número de telefone inserido.

    Figura 6. Rótulos de território de exibição do telefone E164
    Tela de telefone com o número de telefone +44 01733 753363 e o rótulo do território Reino Unido.

    Habilitar rótulos de território também exibe o território do telefone em listas.

    Adicione a propriedade do sistema a seguir para exibir o rótulo do território ao lado do número em um número de telefone E.164.
    Tabela 3.
    Propriedade Descrição
    glide.phone_number_e164.display_territory_text Determina quando um campo de número de telefone E.164 exibe um rótulo de território.
    • Tipo : cadeia de caracteres
    • Valor padrão: somente leitura
    • Outros valores possíveis:
      • all: exibe o rótulo do território.
      • nacional: exibe o rótulo do território somente se o número de telefone estiver no formato local.
      • somente leitura: exibe o rótulo do território no modo somente leitura, independentemente de o número estar no formato local ou internacional.
      • somente leitura nacional: exibe o rótulo do território no modo somente leitura se o número estiver no formato local.
      • list: exibe o rótulo do território em uma lista.
      • list-tional: exibe o rótulo do território em uma lista se o número estiver no formato nacional.
      • nenhum: não exibe o rótulo do território.
    Você também pode adicionar o seguinte atributo de dicionário a um campo específico para substituir a propriedade do sistema:
    Tabela 4.
    Atributo de dicionário Descrição
    pn_display_territory_text Substitui a propriedade glide.phone_number_e164.display_territory_text que define quando um campo de número de telefone exibe um rótulo de território. Os valores disponíveis são idênticos aos descritos anteriormente para a propriedade glide.phone_number_e164.display_territory_text.
    • Tipo: cadeia de caracteres
    • Valor padrão: somente leitura
    • Exemplo:pn_display_territory_text=all

    Configurar os prefixos de discagem direta internacional

    Uma propriedade está disponível para controlar a exibição de prefixos.

    Você pode habilitar a exibição do prefixo de discagem direta internacional, que aparece entre a lista de seleção do seletor de território e a caixa de entrada para um campo de número de telefone E.164 em formulários, definindo a propriedade do sistema ou adicionando o atributo do dicionário.

    Figura 7. ID de exibição do telefone E164
    Exibição de telefone com o prefixo de discagem direta internacional antes do campo de número de telefone
    Adicione a seguinte propriedade do sistema para exibir o prefixo de discagem direta internacional.
    Tabela 5.
    Propriedade Descrição
    glide.phone_number_e164.display_users_idd Determina se o prefixo de discagem direta internacional deve ser exibido entre a lista de seleção do seletor de território e a caixa de entrada em formulários.
    • Tipo: verdadeiro | falso
    • Valor padrão: falso
    Você também pode adicionar o seguinte atributo de dicionário a um campo específico para substituir a propriedade do sistema:
    Tabela 6.
    Atributo de dicionário Descrição
    pn_display_users_idd Substitui a propriedade glide.phone_number_e164.display_users_idd que determina se o prefixo de discagem direta internacional deve ser exibido entre a lista de seleção do seletor de território e a caixa de entrada em formulários. Os valores disponíveis são idênticos aos descritos acima para a propriedade glide.phone_number_e164.display_users_idd.
    • Tipo: verdadeiro | falso
    • Valor padrão: falso
    • Exemplo:pn_display_users_idd=false

    Configurar a lista de seleção do seletor de território de telefone

    Por padrão, um campo de número de telefone E.164 sempre exibe o território do telefone associado ao número de telefone.

    Alterar a propriedade do sistema ou adicionar o atributo do dicionário oculta a lista de seleção do seletor de território. Se a lista de seleção do seletor de território estiver oculta, os usuários só poderão inserir um número local ou nacional.

    Figura 8. Ocultar seletor de telefone e164
    Campo de número sem seletor exibido.
    Adicione a seguinte propriedade do sistema para mostrar ou ocultar a lista de seleção do seletor de território.
    Propriedade Descrição
    glide.phone_number_e164.display_territory_selector Determina se a lista de seleção do seletor de territórios deve ser exibida. Ocultar a lista de seleção do seletor de território restringe os usuários a inserir somente números de telefone locais ou nacionais.
    • Tipo: verdadeiro | falso
    • Valor padrão: verdadeiro
    Você também pode adicionar o seguinte atributo de dicionário a um campo específico para substituir a propriedade do sistema:
    Atributo de dicionário Descrição
    pn_display_territory_selector Substitui a configuração da propriedade glide.phone_number_e164.display_territory_selector que determina se a lista de seleção do seletor de território deve ser exibida. Os valores disponíveis são idênticos aos descritos acima para a propriedade glide.phone_number_e164.display_territory_selector.
    • Tipo: verdadeiro | falso
    • Valor padrão: verdadeiro
    • Exemplo: pn_display_territory_selector=false

    Propriedades do sistema do campo de número de telefone E.164

    Várias propriedades estão disponíveis para configurar campos de número de telefone E.164.

    Nota:
    Para abrir a tabela Propriedades do sistema [sys_properties], digite sys_properties.list no filtro de navegação.
    Tabela 7. propriedades do sistema do campo de número de telefone e.164
    Propriedade Descrição
    glide.phone_number_e164.strict Determina se todos os campos de número de telefone devem corresponder ao formato de exibição do território selecionado.

    Quando o valor é verdadeiro, o campo de entrada do número de telefone exibe uma linha vermelha abaixo dos números de telefone que não correspondem ao formato do território selecionado. Os usuários não podem salvar o número de telefone.

    Quando o valor é falso, o campo de entrada do número de telefone exibe uma linha verde abaixo dos números de telefone que não correspondem ao formato do território selecionado. Os usuários podem salvar o número de telefone. A lista de seleção do seletor de território oferece a opção de selecionar um formato de território Outro/Desconhecido.

    • Tipo: verdadeiro | falso
    • Valor padrão: verdadeiro
    • Local: Adicionar à tabela Propriedades do sistema [sys_properties].
    glide.phone_number_e164.allow_nacional_entry Determina se os usuários podem inserir números de telefone no formato local ou se devem inserir números de telefone no formato internacional.

    Quando verdadeiro, os usuários podem inserir números de telefone no formato local para o território selecionado. Quando falso, os usuários devem inserir números de telefone no formato internacional para o território selecionado.

    • Tipo: verdadeiro | falso
    • Valor padrão: verdadeiro
    • Local: Adicionar à tabela Propriedades do sistema [sys_properties].
    glide.phone_number_e164.display_nacional Determina se os números de telefone E.164 devem ser exibidos no formato local.
    • Tipo: cadeia de caracteres
    • Valor padrão: falso
    • Outros valores possíveis:
      • verdadeiro ou formulário: exibe números de telefone em um formato local em formulários, mas exibe um formato internacional em listas.
      • all: sempre exibe números de telefone em um formato local.
      • user: exibe números de telefone somente em um formato local quando o número de telefone corresponde à configuração local do usuário atual. A configuração local do usuário atual é determinada pelo local associado ao registro do usuário.
      • false: não exibe números de telefone no formato local.
    • Local: Adicionar à tabela Propriedades do sistema [sys_properties].
    glide.phone_number_e164.display_territory_selector Determina se a lista de seleção do seletor de territórios deve ser exibida. Ocultar a lista de seleção do seletor de território restringe os usuários a inserir somente números de telefone locais ou nacionais.
    • Tipo: verdadeiro | falso
    • Valor padrão: verdadeiro
    • Local: Adicionar à tabela Propriedades do sistema [sys_properties].
    glide.phone_number_e164.display_territory_text Determina quando um campo de número de telefone E.164 exibe um rótulo de território.
    • Tipo: cadeia de caracteres
    • Valor padrão: somente leitura
    • Outros valores possíveis:
      • all: sempre exibe o rótulo do território.
      • nacional: exibe o rótulo do território somente se o número de telefone estiver no formato local.
      • somente leitura: exibe o rótulo do território no modo somente leitura, independentemente de o número estar no formato local ou internacional.
      • somente leitura nacional: exibe o rótulo do território no modo somente leitura se o número estiver no formato local.
      • list: exibe o rótulo do território em uma lista.
      • list-tional: exibe o rótulo do território em uma lista se o número estiver no formato nacional.
      • nenhum: não exibe o rótulo do território.
    • Local: Adicionar à tabela Propriedades do sistema [sys_properties].
    glide.phone_number_e164.display_users_idd Determina se o prefixo de discagem direta internacional deve ser exibido entre a lista de seleção do seletor de território e o campo de entrada em formulários.
    • Tipo: verdadeiro | falso
    • Valor padrão: falso
    • Local: Adicionar à tabela Propriedades do sistema [sys_properties].

    Atributos do dicionário de campo de número de telefone E.164

    Você pode substituir a propriedade do sistema global por determinados atributos de dicionário.

    Tabela 8. atributos do dicionário de campo de número de telefone e.164
    Atributo de dicionário Descrição
    pn_strict Substitui a configuração da propriedade glide.phone_number_e164.strict, que requer que todas as entradas de número de telefone correspondam ao formato do território selecionado. Os valores disponíveis são idênticos aos descritos para a propriedade glide.phone_number_e164.strict.
    • Tipo: verdadeiro | falso
    • Valor padrão: verdadeiro
    • Exemplo:pn_strict=false
    pn_allow_national_entry Substitui a configuração da propriedade glide.phone_number_e164.allow_national_entry que determina se os usuários podem inserir números de telefone no formato local ou se devem inserir números de telefone no formato internacional. Os valores disponíveis são idênticos aos descritos para a propriedade glide.phone_number_e164.allow_national_entry.
    • Tipo: verdadeiro | falso
    • Valor padrão: verdadeiro
    • Exemplo:pn_allow_nacional_entry=false
    pn_display_nacional Substitui a configuração da propriedade glide.phone_number_e164.display_national de como um campo de número de telefone E.164 exibe números de telefone. Os valores disponíveis são idênticos aos descritos para a propriedade glide.phone_number_e164.display_national.
    • Tipo: cadeia de caracteres
    • Valor padrão: falso
    • Exemplo:pn_display_nacional=all
    pn_display_territory_selector Substitui a configuração da propriedade glide.phone_number_e164.display_territory_selector que determina se a lista de seleção do seletor de território deve ser exibida. Os valores disponíveis são idênticos aos descritos para a propriedade glide.phone_number_e164.display_territory_selector.
    • Tipo: verdadeiro | falso
    • Valor padrão: verdadeiro
    • Exemplo: pn_display_territory_selector=false
    pn_display_territory_text Substitui a propriedade glide.phone_number_e164.display_territory_text que define quando um campo de número de telefone exibe um rótulo de território. Os valores disponíveis são idênticos aos descritos para a propriedade glide.phone_number_e164.display_territory_text.
    • Tipo: cadeia de caracteres
    • Valor padrão: somente leitura
    • Exemplo:pn_display_territory_text=all
    pn_display_users_idd Substitui a propriedade glide.phone_number_e164.display_users_idd que determina se o prefixo de discagem direta internacional deve ser exibido entre a lista de seleção do seletor de território e a caixa de entrada em formulários. Os valores disponíveis são idênticos aos descritos para a propriedade glide.phone_number_e164.display_users_idd.
    • Tipo: verdadeiro | falso
    • Valor padrão: falso
    • Exemplo:pn_display_users_idd=false