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 de rua inseridos no catálogo de endereços da conta do cliente ou durante 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 à variável modelo de endereço que é usado para produzir documentos de vendas. O processo para criar um atributo de endereço personalizado é quase o mesmo que criar um atributo do 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. No Admin barra lateral, 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. No Attribute Properties faça o seguinte:

    • Insira um Default Label que identifica o atributo durante a entrada de dados.

    • Insira um Attribute Code que identifica 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, insira o Sort Ordere salve.
  4. Para determinar o tipo de controle de entrada usado para entrada de dados, defina Input Type a 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, semelhante 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.
      Uso Minimal Value para especificar a data mais antiga que pode ser inserida. Uso Maximum Value para especificar a data mais recente 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 para 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 ao 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 dos 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 apenas 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 um 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 a um dos seguintes:

    • None - Não aplica um filtro ao texto inserido no campo.
    • Strip HTML Tags - Remove tags 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 escape de HTML 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 menor que (<) e maior que (>) e o caractere "E" comercial (ampersand), 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 para Yes.

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

    • Para filtrar a grade Clientes pelo atributo de texto com condições de correspondência de filtros diferentes, defina Grid Filter Condition Type para Partial Match, Prefix Matchou Full Match. Não afeta a Pesquisar por palavra-chave para a grade.

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

    • Para disponibilizar esse atributo para segmentos de clientes, definir Use in Customer Segment para Yes.

Etapa 2: concluir as propriedades da loja

  1. Role para baixo até Storefront Properties seção.

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

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

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

  4. Definir Forms to Use para cada formulário que deve 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 de cada exibição de loja.

  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 que é 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, semelhante 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 dos dados.
Alphanumeric with Space- Permite que os espaços no endereço cumpram os requisitos de comprimento máximo do transportador. 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 apenas 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 um 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 tags 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 escape de HTML 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 menor que (<) e maior que (>) e o caractere "E" comercial (ampersand), 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 é incluído como uma coluna na variável Clientes grade. 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. Não afeta a Search by keyword ​para a 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 em segmento de cliente condições. 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