Carregar e exportar campos CSV do carregador de matriz e opções de campo

Carregamento de campos CSV

Todos os tipos de campo podem ser adicionados e editados por meio do Carregador de matriz. Esta seção presume que o leitor trabalhará em um arquivo de planilha (Planilhas Google, Microsoft Excel ou similar) e, em seguida, exporte o resultado para um arquivo CSV para carregar no Carregador de matriz. Este tópico descreve as colunas e os dados que o Carregador de matriz aceita no carregamento de campo.

Tabela 1. Colunas do arquivo CSV
Nome da coluna	Descrição	Valores válidos	Anotações
field_type	Define o tipo de dados do campo	Texto \| TextField boolian \| booleanField Number \| numberField Lista de seleção \| pickListField	Necessários
nome	O nome que o administrador vê na página Administrador da lista de campos	As cadeias de caracteres válidas podem ser compostas por até 255 caracteres, incluindo letras, números, espaços e os seguintes caracteres especiais: `();:/.-, ʼ&%"!`	Necessários
variableName	Cadeia de caracteres distinta usada para fazer referência ao campo	Os nomes de variáveis de campo válidos consistem em até 128 letras, números e sublinhados. O primeiro e o último caractere devem ser uma letra ou um número.	Necessário; deve ser exclusivo
obrigatório	Atualmente não usado pela aplicação	VERDADEIRO \| FALSO <empty>	Opcional; não usado atualmente pela aplicação
defaultValue	Forneça um valor inicial no campo quando a experiência de configuração for iniciada	[Ver nota]	Opcional; relevante somente para TextField, booleanField, numberField e single pickListField. Multi pickListFields Definir padrões no arquivo de upload fieldOptions.
minLength	Número mínimo de caracteres aceitos	<number>	Opcional; relevante somente para Campo de texto
maxLength	Número máximo de caracteres aceitos	<number>	Opcional; relevante somente para Campo de texto
precisão	Defina dígitos de precisão à direita do decimal	<number>	Opcional; relevante somente para NumberField
MinValue	Valor numérico mínimo aceito	<number>	Opcional; relevante somente para NumberField
Valor máximo	Valor numérico máximo aceito	<number>	Opcional; relevante somente para NumberField
SelecioneType	Defina se pickListField é de seleção única ou múltipla	único múltiplo <empty>	Opcional; relevante somente para pickListField. Se <empty>, assume único

Nota:

Quando um campo tem valores definidos, o valor padrão deve estar em conformidade com um dos valores definidos. Por exemplo:

Os valores padrão de campo booliano válidos são VERDADEIRO e FALSO.
Se um campo numérico tiver minValue ou maxValue definido, o valor padrão especificado deverá estar em conformidade com a definição.
O valor padrão de um único pickListField deve corresponder a um valor de opção definido para o campo. Este valor de opção pode ser definido em um arquivo CSV de opção de campo que é processado pelo carregador de matriz no mesmo lote que o arquivo CSV de campo.
Os valores do campo de texto são limitados a 2000 caracteres.

A ordem das colunas não é fixa. Para conveniência, os administradores podem reorganizar as colunas na planilha e o arquivo CSV resultante.

O arquivo explicativo de carregamento de campos mostra a variedade de campos e parâmetros de campo aceitos pelo carregador de matriz. As células com planos de fundo cinza indicam que a célula não é relevante para o contexto da linha. Para baixar o arquivo de explicação, no Carregador de matriz, clique no link Campos na seção Arquivos de amostra.

Nota:

Este arquivoʼs conteúdo não deve ser carregado em um ambiente como está. Em vez disso, use os exemplos de formato para criar um arquivo de carregamento que atenda aos requisitos do seu projeto atual, exporte-o para o formato CSV e carregue-o no seu ambiente usando o Carregador de matriz.

Assim como os campos adicionados por meio da IU do administrador devem ser associados a um ou mais blueprints, os campos adicionados em massa por meio do Carregador de matriz também devem ser associados. Para obter instruções, consulte Associe um campo a um blueprint.

Exportação de campos CSV

Para conveniência, os administradores podem exportar um arquivo CSV de campos e opções de campo definidas no ambiente por meio das seguintes etapas:

No painel de navegação Administrador, clique em Campos .
Você verá uma lista de todos os campos definidos.
(Opcional) Insira uma cadeia de caracteres de pesquisa e pressione <enter> para restringir a lista de campos.
Clique em Exportar. Uma mensagem aparece temporariamente na parte inferior da página.
Clique na central de notificações no canto inferior esquerdo.
Clique em Download Para baixar o arquivo CSV.

O arquivo ZIP resultante contém o arquivo CSV de campos e o arquivo CSV de opções de campo.

Carregamento de opções de campo CSV

O upload de opções de campo define opções e atribuição de pickListField. Esta seção presume que o leitor trabalhará em um arquivo de planilha (Planilhas Google, Microsoft Excel ou similar) e, em seguida, baixe/exporte o resultado para um arquivo CSV para carregar no Carregador de matriz. A seguir descreve as colunas e os dados que o Carregador de matriz aceita no carregamento da opção de campo.

Tabela 2. Colunas do arquivo CSV
Nome da coluna	Descrição	Valores válidos	Anotações
variableName	O nome da variável do campo ao qual esta linhaʼs opção será adicionada	<field variableName>	Necessários
nome	Nome da opção visível para o usuário final	As cadeias de caracteres válidas podem ser compostas por até 255 caracteres, incluindo letras, números, espaços e os seguintes caracteres especiais: `();:/.-, ʼ&%"!`	Necessários
valor	A cadeia de caracteres distinta será usada para fazer referência à opção de campo	Os nomes de variáveis de opção de campo válidos consistem em até 128 letras, números e sublinhados. O primeiro e o último caractere devem ser uma letra ou um número. Os nomes de variáveis de opção de campo devem ser exclusivos no escopo do mesmo campo.	Necessários
defaultValue	Forneça um valor inicial no campo quando a experiência de configuração for iniciada	VERDADEIRO FALSO <empty>	Opcional; relevante somente para vários pickListFields
DescriçãoextendedDescri ção	Descrição contextual para referência do administrador	As cadeias de caracteres válidas podem ser compostas por até 255 caracteres, incluindo letras, números, espaços e os seguintes caracteres especiais: `();:/.-, ʼ&%"!`	Opcional
UrimageUrl	A imagem mostrará o usuário final para esta opção pickListField	<URL>	Opcional; para uso com pickListField. O tipo de exibição é definido como VisualPicker ou MultiSelectVisua lPicker no layout

O arquivo explicativo de carregamento de campos mostra a variedade de opções de campo e parâmetros de opção de campo aceitos pelo carregador de matriz. As células com planos de fundo cinza indicam que a célula não é relevante para o contexto da linha. Para baixar o arquivo de explicação, no Carregador de matriz, clique no link Campos na seção Arquivos de amostra.

Nota:

Este arquivoʼs conteúdo não deve ser carregado em um ambiente como está. Em vez disso, use os exemplos de formato para criar um arquivo de carregamento que atenda aos requisitos do seu projeto atual, exporte-o para o formato CSV e carregue-o no seu ambiente usando o Carregador de matriz.

Exportação CSV de opções de campo

As opções de campo são exportadas no mesmo movimento usado para exportar campos de CPQ. Para obter instruções, consulte a seção "Exportação de campos CSV" acima.

Carregamento de CSV: Seletor de produto

Esta seção descreve as etapas para criar um seletor de produtos chamado "Meu seletor de produtos", que incluirá os seguintes produtos/opções:

Opção1/Produto1 - Produto um
Opção2/Produto2 - Produto dois
Opção3/Produto3 - Produto três

Para criar um seletor de produto, siga estas etapas.

Extraia um arquivo CSV de amostra para campos do carregador de matriz.
Este arquivo CSV deve conter as informações de campo necessárias para criar um seletor de produto. Certifique-se de adicionar uma linha extra na parte superior do arquivo de amostra especificando o tipo de campo como seletor de produto (este tipo de campo pode não estar presente no arquivo de amostra).
Extraia um arquivo CSV de amostra para opções de campo do carregador de matriz.
Este arquivo CSV deve conter os nomes de produtos que serão exibidos na IU do usuário final para os campos criados na etapa anterior.
Crie um novo arquivo .yaml.
Este arquivo deve incluir os campos contidos no seletor de produto, conforme definido no arquivo CSV na Etapa 1. O arquivo .yaml será usado para vincular os dois arquivos CSV durante o processo de carregamento no Carregador de matriz. Sem ele, o seletor de produto não será criado.
Exemplo de sintaxe .yaml:
```
---
- variableName: myProductPicker
	fields:
	- variableName: myProductPicker.value
		target: ProductId
	- variableName: myProductPicker.select
	- variableName: myProductPicker.quantity
		target: ProductQuantity
```
Carregar arquivos para o carregador de matriz: Compacte os dois arquivos .csv e o arquivo .yaml das etapas anteriores em uma pasta compactada. Em seguida, vá para o carregador de matriz, carregue a pasta compactada e clique em Importação e clique em Continuar .
Validar na IU: O seletor de produto recém-criado deve estar disponível no CPQ Campos de administrador, conforme mostrado abaixo.

Exportação CSV: Seletor de produto

Para exportar um seletor de produto, clique nos campos em CPQ Admin Clique em Selecionadores de produtos , selecione o seletor de produto a ser exportado e clique em Exportação .