Incluindo campos na página de configuração Campos de dados
Em , um administrador locatário pode configurar para mostrar ou ocultar campos dentro da interface com o usuário para todos os usuários.
É possível customizar os Campos de dados para controlar outros campos no nível do locatário Por exemplo,
- IBM fornece um campo Vendedor na página Detalhes do Pedido . Suponha que sua empresa não use o campo ou não queira que seja exibido. É possível incluir Vendedor nessa página de configuração e, em seguida, um administrador de locatário pode ativar ou desativar o campo para todos os usuários
- Os desenvolvedores podem incluir campos de resumo customizados e colunas de tabela customizadas customizando arquivos JSON É possível incluir os campos customizados nessa página de configuração para que um administrador locatário possa ativar ou desativar o campo para todos os usuários.
Local do arquivo JSON:
Atualize ou crie o buc-tenant-config.json dentro da pasta buc-app-settings/packages/settings-configurations/src-custom/assets/custom do módulo
Sintaxe JSON
A matriz
attributes inclui duas entradas..- "id": "global" define os campos para mostrar na seção Campos globais .
- "id": "pageLevel" define os campos a serem mostrados dentro da seção B2B -campos relacionados
Propriedades de campos.
- ID
- O ID do campo que você deseja incluir É possível localizar o ID procurando na interface com o usuário do Order Hub e verificando a guia de rede do navegador.
- Para localizar IDs de campo de Resumo , revise o arquivo buc_field_details.json
- Para localizar IDs de Coluna da Tabela , revise o arquivo buc-table-config.json
- Para localizar IDs de campo de Procura , revise o arquivo search_fields.json
"id": "shipNode"..
Nota: se você estiver incluindo um campo de resumo customizado de coluna de tabela customizada, esse valor deverá corresponder ao ID definido nos arquivos de customização buc-table-config.json ou buc_field_details.json . Você pode não ter acesso para ver os arquivos customizados na guia de rede do navegador. Consulte seu código-fonte para os IDs. - rótulo
- O texto do rótulo a ser exibido Se o texto for traduzido, será possível incluir os arquivos de conversão na pasta i18n e referenciar o rótulo Por exemplo,
"label": "SHARED.GENERAL.LABEL_shipNode", - tooltipMsg
- Texto para exibir como uma dica de ferramenta ao lado do campo. Se o texto for traduzido, será possível incluir os arquivos de conversão na pasta i18n e referenciar o rótulo
- Campos
- Dentro da matriz
fields, também é possível definir uma matrizfieldsfilha Se você desejar que a configuração se aplique a todas as páginas, será possível omitir a matrizfieldsfilha Se desejar permitir que um administrador locatário mostre ou oculte a configuração em páginas específicas, defina uma matrizfieldsfilha.Nota: Se você estiver incluindo IDs de campo de procura , os campos de procura serão suportados somente por meio de configurações globais.. Não é possível incluir campos filhos para mostrar ou ocultar a configuração em páginas específicas.Na matrizfieldsfilha, é possível definir as propriedades a seguir:- ID
- O nome do objeto da página ou seção na qual o campo existe. É possível localizar o ID procurando na interface com o usuário do Order Hub e verificando a guia de rede do navegador.
- rótulo
- O texto do rótulo a ser exibido Se o texto for traduzido, será possível incluir os arquivos de conversão na pasta i18n e referenciar o rótulo Por exemplo,
"label": "TEXT_ORDER_DETAILS_SHIPMENT_TABLE", - tipo
- Define se o campo é um campo de resumo ou uma coluna de tabela Os valores válidos são summary ou table. Por exemplo, para o campo shipNode na tabela, você usaria "type": "table"..
Exemplo de JSON
O exemplo a seguir fornece alguns casos de uso.
Nota: o exemplo a seguir inclui comentários sequenciais como um guia para explicar os atributos enquanto você analisa o código.. Como o JSON não suporta comentários, este exemplo não é uma amostra JSON válida, conforme exibido Se você planeja copiar essa amostra, certifique-se de remover os comentários sequenciais
{
"configuration-data": {
"name": "configuration-data", //Defines customization for the Data fields section. Do not change.
"attributes": [
{
"id": "global", //Defines the custom fields to display under the "Global fields" section
"label": "SETTINGS.CONFIG.TEXT_GLOBAL_FIELDS",
"fields": [
{
"id": "customized", // 1 Add a customized field as an option to show or hide
"label": "Customized Field",
"tooltipMsg": "Available for customized fields"
//No child "fields" array therefore this setting applies to all pages where "customized" exists.
}]
},
{
"id": "pageLevel", //Defines the custom fields to display on the "B2B -related fields" section
"label": "SETTINGS.CONFIG.TEXT_B2B_FIELDS",
"fields": [
{
"id": "shipNode", // 2 Add the "Ship Node" field as an option to show or hide
"label": "SHARED.GENERAL.LABEL_shipNode",
"fields": [ //Specify the different pages where the field exists
{
"id": "ord-detail-shipment-table",
"label": "TEXT_ORDER_DETAILS_SHIPMENT_TABLE",
"type": "table"
},
{
"id": "order-summary",
"label": "Order line details: Summary",
"type": "summary"
}]
}]
}]
}}Exemplo de interface com o usuário:
A imagem a seguir ilustra a página Campos de Dados com os campos, conforme configurado no arquivo JSON
