Retrieve e Deploy de Pacotes Salesforce e Outras Informações Pertinentes

Baixar Metadados (MDAPI)

    Na Salesforce, ao usar a linha de comando para gerenciar metadados, o formato mdapi (Metadata API) segue o modelo tradicional, no qual os metadados são compactados em um único arquivo .zip. Esse formato é ideal para implementações ou integrações com sistemas externos. Para baixar metadados no formato mdapi, você utiliza o comando sfdx force:mdapi:retrieve, que permite recuperar os metadados especificados no arquivo package.xml de uma organização Salesforce. O comando -r define o diretório de destino para armazenar o arquivo .zip recuperado, enquanto -o ou --target-org especifica a org de onde os metadados serão baixados. A flag -k é utilizada para apontar para o caminho do arquivo package.xml, que contém a lista dos metadados a serem recuperados.

sfdx force:mdapi:retrieve -r ./mdapi_output -o myOrgAlias -k ./path/to/package.xml

Info da Org (force:org:display)

    O comando sfdx force:org:display -o <your-username-or-alias> exibe informações detalhadas sobre uma organização Salesforce específica. O parâmetro -o permite que você forneça o nome de usuário ou o alias da org autenticada. Ao executar esse comando, ele retorna dados como o ID da organização, o nome da instância, a URL de login e outras configurações importantes, permitindo que você verifique rapidamente o estado e as propriedades da sua org no Salesforce.

Info das Orgs (force:org:list)

    O comando sfdx force:org:list exibe uma lista de todas as organizações Salesforce que estão autenticadas na sua máquina local, mostrando tanto as orgs de desenvolvimento quanto as de produção. Ele fornece informações como o nome da org, seu alias, o tipo de org (por exemplo, Developer, Sandbox, Production), o status de conexão (se está autenticada ou expirada) e a URL de login. Esse comando é útil para gerenciar várias organizações de forma eficiente, permitindo verificar rapidamente quais estão ativas e prontas para uso.

Deploy (check-only)

    O comando sfdx force:mdapi:deploy -c -d ./ -l NoTestRun -u <org-alias-or-username> -w -1 realiza a validação de uma implantação de metadados em uma organização Salesforce sem aplicar as alterações. O parâmetro -c indica que a implantação será feita em modo de validação (check-only), enquanto -d ./ especifica que os metadados a serem validados estão localizados no diretório atual. O argumento -l NoTestRun desativa a execução de testes durante o processo, e -u <org-alias-or-username> define a organização de destino, identificada pelo alias ou nome de usuário configurado. Por fim, o parâmetro -w -1 faz com que o comando aguarde indefinidamente até que o processo seja concluído, garantindo a validação completa dos metadados.

sfdx force:mdapi:deploy -c -d ./ -l NoTestRun -u <org-alias-or-username> -w -1

Deploy

    Remova a flag -c.

sfdx force:mdapi:deploy -d ./ -l NoTestRun -u <org-alias-or-username> -w -1

Deploy: Executar Classes de Teste (check-only)

    O comando sfdx force:mdapi:deploy -c -d ./ -u <org-alias-or-username> -l RunSpecifiedTests -r TestClass1,TestClass2 -w -1 realiza a validação de implantação executando apenas as classes de teste especificadas. A flag -c ativa o modo de validação (check-only), enquanto -l RunSpecifiedTests indica que apenas as classes de teste definidas em -r serão executadas. O parâmetro -r lista as classes de teste separadas por vírgula, e -w -1 faz com que o comando aguarde indefinidamente até que a execução seja concluída.

sfdx force:mdapi:deploy -c -d ./ -u <org-alias-or-username> -l RunSpecifiedTests -r TestClass1,TestClass2 -w -1