Atributos de endereço do cliente

Recurso do Adobe Commerce {width="20"} Recurso exclusivo somente no Adobe Commerce (Saiba mais)

O conjunto de atributos Endereço do Cliente determina as propriedades dos endereços que são inseridos no catálogo de endereços a partir da conta do cliente ou durante o check-out.

Os atributos de endereço personalizados podem ser configurados para fornecer informações adicionais, como um endereço de email opcional, conta Skype, número de telefone alternativo, prédio ou município. O atributo personalizado pode ser incorporado ao modelo de endereço usado para produzir documentos de vendas. O processo para criar um atributo de endereço personalizado é quase o mesmo que criar um atributo de cliente.

Os atributos de endereço do cliente são usados nos seguintes formulários:

Administrador - Atributos de endereço do cliente

Etapa 1: Preencha as propriedades do atributo

  1. Na barra lateral Admin, vá para Stores > Attributes>Customer Address.

  2. No canto superior direito, clique em Add New Attribute.

    Propriedades do atributo do cliente {width="600" modal="regular"}

  3. Na seção Attribute Properties, faça o seguinte:

    • Digite um Default Label que identifique o atributo durante a entrada de dados.

    • Digite um Attribute Code que identifique o atributo no sistema.

      O código do atributo deve começar com uma letra e pode incluir qualquer combinação de letras minúsculas (a-z) e números (0-9). O código deve ter menos de 30 caracteres e não pode incluir caracteres especiais ou espaços. O caractere de sublinhado (_) pode ser usado para indicar um espaço.

      note tip
      TIP
      Atalho: Para preencher apenas os campos obrigatórios, role até Storefront Properties, digite o Sort Order e salve.
  4. Para determinar o tipo de controle de entrada usado para entrada de dados, defina Input Type como um dos seguintes:

    • Text Field - Um campo de texto de linha única.
    • Text Area - Uma área de texto multilinha.
    • Multiple Line - Cria várias linhas de texto para o atributo, semelhantes a um endereço de várias linhas. O número de linhas de entrada de dados separadas pode ser de 2 a 20. Use o Default Value para especificar o valor inicial do campo.
    • Date - Exibe um campo de data com um calendário pop-up. Propriedades adicionais: use Default Value para especificar o valor inicial do campo.
      Use Minimal Value para especificar a data mais antiga que pode ser inserida. Use Maximum Value para especificar a última data que pode ser inserida.
    • Dropdown - Uma lista suspensa que aceita apenas um valor a ser selecionado.
    • Multiple Select - Uma lista suspensa que aceita vários valores a serem selecionados.
    • Yes/No - Um campo que oferece apenas uma opção de Yes ou No valores.
    • File (attachment) - Um campo que permite que um arquivo seja carregado e associado ao atributo do cliente como um anexo.
    • Image File - Um campo que permite que uma imagem seja carregada na galeria e associada ao atributo do cliente.
  5. Se o cliente precisar inserir um valor no campo, defina Values Required como Yes.

  6. Para atribuir um valor inicial ao campo, insira um Default Value.

  7. Para verificar a precisão dos dados inseridos no campo antes que o registro seja salvo, defina Input Validation como o tipo de dados que será permitido no campo. Os valores disponíveis dependem do Input Type ​especificado.

    • None - O campo não tem validação de entrada durante a entrada de dados.
    • Alphanumeric - Aceita qualquer combinação de números (0-9) e caracteres alfabéticos (a-z, A-Z) durante a entrada de dados. Para incluir caracteres especiais, consulte Escape HTML Entities na próxima etapa.
    • Alphanumeric with Space - Aceita qualquer combinação de números (0-9), caracteres alfabéticos (a-z, A-Z) e espaços durante a entrada de dados.
    • Numeric Only - Aceita somente números (0-9) durante a entrada de dados.
    • Alpha Only - Aceita somente caracteres alfabéticos (a-z, A-Z) durante a entrada de dados.
    • URL - Aceita apenas uma URL durante a entrada de dados.
    • Email - Aceita apenas um endereço de email durante a entrada de dados.
    • Length Only - Valida a entrada com base no comprimento dos dados inseridos no campo.
  8. Para aplicar um filtro de pré-processamento a valores inseridos em um campo de texto, área de texto ou tipo de entrada de várias linhas, defina Input/Output Filter como um dos seguintes:

    • None - Não aplica um filtro ao texto inserido no campo.
    • Strip HTML Tags - Remove marcas de HTML do texto. Esse filtro pode ajudar a limpar dados que estão colados em um campo de outra fonte que inclui tags HTML.
    • Escape HTML Entities - Converte caracteres especiais encontrados no texto em uma sequência de HTML de escape válida, como &;. As sequências de escape são delimitadas entre um E comercial e um ponto e vírgula, e são frequentemente usadas para aspas inteligentes, direitos autorais e símbolos de marca comercial do tipógrafo. As sequências de escape também são usadas para identificar caracteres como os símbolos menor que (<) e maior que (>) e o caractere E comercial (&) que também são usados no código. Este filtro pode ajudar a limpar os caracteres especiais que às vezes são colados nos campos do banco de dados a partir de processadores de texto.
  9. Complete as propriedades da grade e do segmento do cliente:

    • Para poder incluir a coluna na grade Clientes, defina Add to Column Options como Yes.

    • Para filtrar a grade Clientes por este atributo, defina Use in Filter Options como Yes.

    • Para filtrar a grade Clientes por atributo de texto com condições de correspondência de filtros diferentes, defina Grid Filter Condition Type como Partial Match, Prefix Match ou Full Match. Isso não afeta o campo Pesquisar por palavra-chave da grade.

    • Para pesquisar a grade Clientes por esse atributo, defina Use in Search Options como Yes.

    • Para disponibilizar este atributo para segmentos de clientes, defina Use in Customer Segment como Yes.

Etapa 2: concluir as propriedades da loja

  1. Role até a seção Storefront Properties.

    Atributos de endereço do cliente - Propriedades da vitrine eletrônica {width="600" modal="regular"}

  2. Para tornar o atributo visível para os clientes, defina Show on Storefront como Yes.

  3. Insira um número no campo Sort Order, que determina sua ordem de aparência quando listado com outros atributos.

  4. Defina Forms to Use para cada formulário que deverá incluir o atributo.

    Para escolher ambas as opções, mantenha pressionada a tecla Ctrl (PC) ou a tecla Command (Mac) enquanto clica em cada formulário.

Etapa 3: preencha o rótulo e salve

  1. No painel à esquerda, escolha Manage Labels/Options.

  2. Em Manage Titles, insira um rótulo para identificar o atributo para cada exibição de armazenamento.

  3. Quando terminar, clique em Save Attribute.

    Atributos de endereço do cliente - rótulos/opções {width="600" modal="regular"}

Descrições dos campos

Attribute Properties

Campo
Descrição
Default Label
O rótulo padrão que identifica o atributo no Admin e na loja.
Attribute Code
Um código exclusivo que identifica o atributo no sistema. O código pode ter até 21 caracteres e não pode incluir espaços ou caracteres especiais. O símbolo de sublinhado pode ser usado em vez de um espaço.
Input Type
Determina o controle de entrada usado para entrada de dados. Opções:
Text Field- Um campo de texto de linha única.
Text Area - Uma área de texto multilinha.
Multiple Line- Cria várias linhas de texto para o atributo, semelhantes a um endereço de várias linhas. O número de linhas de entrada de dados separadas pode ser de 2 a 20.
Date - Exibe um campo de data com um calendário pop-up.
Dropdown- Uma lista suspensa que aceita apenas um valor a ser selecionado.
Multiple Select - Uma lista suspensa que aceita vários valores a serem selecionados.
Yes/No- Um campo que oferece apenas uma opção de Yes ou No valores.
File (attachment) - Um campo que permite que um arquivo seja carregado e associado ao atributo do cliente como um anexo.
Image File- Um campo que permite que uma imagem seja carregada na galeria e associada ao atributo do cliente.
Values Required
Determina se um valor deve ser inserido no campo. Opções: Yes / No
Default Value
Especifica o valor inicial do atributo.
Input Validation
A seleção de opções é determinada pelo tipo de entrada. Opções:
None- O campo não tem validação de entrada durante a entrada de dados.
Alphanumeric - Aceita qualquer combinação de números (0-9) e caracteres alfabéticos (a-z, A-Z) durante a entrada de dados.
Alphanumeric with Space- Permite que espaços no endereço cumpram com os requisitos de comprimento máximo da transportadora. Durante a finalização da compra, o cliente pode inserir qualquer combinação de números (0-9), caracteres alfabéticos (a-z, A-Z) e espaços no endereço do recipient e do remetente. Quaisquer espaços extras são cortados quando o endereço é salvo.
Numeric Only - Aceita somente números (0-9) durante a entrada de dados.
Alpha Only- Aceita somente caracteres alfabéticos (a-z, A-Z) durante a entrada de dados.
​ URL ​- Aceita apenas uma URL durante a entrada de dados.
Email - Aceita apenas um endereço de email durante a entrada de dados.
Length Only- Valida a entrada com base no comprimento dos dados inseridos no campo.
Input/Output Filter
Aplica um filtro de pré-processamento aos valores inseridos em um campo de texto, área de texto ou tipo de entrada de várias linhas antes de o registro ser salvo. Opções:
None- Não aplica um filtro ao texto inserido no campo.
Strip HTML Tags - Remove marcas de HTML do texto. Esse filtro pode ajudar a limpar dados que estão colados em um campo de outra fonte que inclui tags HTML.
Escape HTML Entities- Converte caracteres especiais encontrados no texto em uma sequência de HTML de escape válida, como amp;. As sequências de escape são delimitadas entre um E comercial e um ponto e vírgula, e são frequentemente usadas para aspas inteligentes do tipógrafo, símbolos de direitos autorais e símbolos de marca comercial. As sequências de escape também são usadas para identificar caracteres como os símbolos menor que (<) e maior que (>) e o caractere E comercial (&) que também são usados no código. Este filtro pode ajudar a limpar os caracteres especiais que às vezes são colados nos campos do banco de dados a partir de processadores de texto.
Add to Column Options
Especifica se o atributo está incluído como uma coluna na grade Clientes. Opções: Yes / No
Usar em Opções de Filtro
Especifica se o atributo pode ser usado como filtro para operações de pesquisa na grade. Opções: Yes / No
Grid Filter Condition Type
Especifica condições de correspondência de filtros para atributos em operações de pesquisa da grade. Isso não afeta o campo Search by keyword ​da grade. Opções: Partial Match / Prefix Match / Full Match
Use in Search Options
Especifica se o valor do atributo pode ser usado como uma palavra-chave em operações de pesquisa. Opções: Yes / No
Use in Customer Segment
Determina se o atributo está incluído nas condições do segmento de cliente. Opções: Yes / No

Storefront Properties

Campo
Descrição
Show on Storefront
Determina se o atributo aparece como um campo nas informações do cliente na loja. Opções: Yes / No
Sort Order
Especifica a ordem de classificação deste atributo em relação a outros atributos do cliente. A ordem de classificação determina a sequência em que os campos recebem foco durante a entrada de dados ao usar a navegação pelo teclado.
Forms to Use in
Determina as páginas com formulários de entrada de dados em que o atributo aparece. Opções:
Customer Address Registration
Customer Account Address
recommendation-more-help
09e7db7e-4210-474a-8bbf-c72a92c7537c