Loading
Aprimorar o Salesforce com código
Criar e gerenciar tipos de metadados personalizados usando comandos da CLI

Você está aqui:

  1. Ajuda do Salesforce
  2. Documentação
  3. Aprimorar o Salesforce com código

Criar e gerenciar tipos de metadados personalizados usando comandos da CLI

Você pode usar a interface de linha de comando do Salesforce (CLI) para criar tipos de metadados personalizados, gerar campos, criar registros, criar registros usando um arquivo CSV e gerar tipos de metadados personalizados usando um sObject.

Edições obrigatórias

Disponível em: Salesforce Classic e Lightning Experience

Disponível em: Edições Enterprise, Performance, Unlimited e Developer

Você pode criar, editar e excluir registros de tipo de metadados personalizados de pacotes instalados em: Group e Professional Editions
Permissões necessárias ao usuário
Para executar comandos da CLI de tipos de metadados personalizados: Personalizar aplicativo

O suporte para tipos de metadados personalizados está disponível no plugin Salesforce CLI versão 49.0. Consulte o Guia de configuração do Salesforce CLI para obter informações sobre como configurar a CLI, configurar um hub do desenvolvedor, criar um projeto e criar uma organização teste.

Comandos

Os comandos a seguir estão disponíveis para criar e gerenciar tipos de metadados personalizados. Para indicadores e informações de uso, use o indicador --help. Por exemplo, sf cmdt generate records --help.

  • Crie um tipo de metadados personalizados.

    sf cmdt generate object

  • Gere um campo de metadados personalizado com base no tipo de campo especificado. Você pode criar campos dentro da pasta do objeto de metadados ou passados no diretório da pasta do objeto.

    sf cmdt generate field

  • Gere um tipo de metadados personalizado e todos os seus registros para o sObject. Use esse comando para migrar os objetos personalizados ou as configurações personalizadas para tipos de metadados personalizados. O diretório padrão é force-app/main/default/customMetadata.

    sf cmdt generate fromorg

    Nota
    Nota Não há suporte para configurações personalizadas do tipo hierarquia.
  • Crie um registro para o tipo de metadados personalizado especificado.

    sf cmdt generate record

  • Insira novos registros de tipo de metadados personalizados de um arquivo CSV.

    sf cmdt generate records

Considerações

  • Especifique a pasta do objeto ao criar tipos ou campos de metadados personalizados. Por exemplo, --output-directory force-app/main/dirObjects/Mycmdt.
  • Especifique nomes exclusivos ao criar tipos de metadados personalizados.
  • Não há restrições ao número de registros que podem ser inseridos. Ao inserir um grande número de registros, saiba que o comando project deploy start usa 33 minutos como padrão. O padrão é o número de minutos que o comando aguarda para concluir e exibir os resultados na janela do terminal.
  • Ao usar o comando cmdt generate records, o identificador DeveloperName usa como padrão a coluna Name e é uma coluna obrigatória. No entanto, qualquer nome de coluna pode ser especificado usando o sinalizador --name-column. Não há suporte para Label como um identificador alternativo.
  • O comando cmdt generate records pode ser usado para criar novos registros de tipos de metadados personalizados ou atualizar registros de metadados personalizados existentes.
Exemplo
Exemplo Crie um tipo de metadados personalizado que seja protegido junto com os tipos de campo de percentual e caixa de seleção. O XML de metadados é criado no diretório local para o seu projeto da SDFX. 
sf cmdt generate object --type-name Mycmdt --visibility Protected --output-directory force-app/main/dirObjects
sf cmdt generate field --name Checkbox --type Checkbox --output-directory force-app/main/dirObjects/Mycmdt
sf cmdt generate field --name Percent --type Percent --output-directory force-app/main/dirObjects/Mycmdt
Exemplo
Exemplo Gere um tipo de metadados personalizado usando um objeto personalizado. Use este comando para migrar um objeto personalizado para um novo tipo de metadados personalizado. 
sf cmdt generate fromorg --dev-name FromCustomObject --sobject MyCustomObject__c
Exemplo
Exemplo Insira registros em um tipo de metadados personalizado a partir de um arquivo CSV.

Crie um arquivo CSV e forneça o nome da API do tipo de metadados personalizado no comando insert. Por exemplo,

Nome CountryCode__c CountryName__c
Austrália AU Austrália
Brasil BZ Brasil
Canadá CA Canadá 
sf cmdt generate records --csv ~/Downloads/CMT_CSV_country.csv --type-name CmdtCountry

Como migrar configurações e objetos personalizados para tipos de metadados personalizados

Ao converter SObjects em um tipo de metadados personalizado, tipos de objeto sem suporte são convertidos em um formato de string.

Mapeando
Tipo sObject Tipo de conversão
Numeração automática Campo de texto
Fórmula Convertido com base no tipo retornado de fórmula. Se for do tipo de texto, ele será convertido em uma área de texto longa com comprimento padrão de 32768
Pesquisa Campo de texto
Resumo da totalização Campo de texto
Pesquisa externa Campo de texto
Detalhes mestres Campo de texto
Texto criptografado String de texto ilegível.
Geolocalização Dois campos de texto separados representando a latitude e a longitude
Lista de opções de seleção múltipla Campo de texto
Horário Campo de texto
Moeda Campo de texto

Consulte também:

 
Carregando
Salesforce Help | Article