Извлечение метаданных Salesforce API (MDAPI) — это мощная функция, которая позволяет разработчикам получать метаданные из организации Salesforce с помощью интерфейса командной строки Salesforce (CLI). В этой статье мы рассмотрим различные методы получения метаданных с помощью интерфейса командной строки Salesforce, а также приведем примеры кода для каждого метода.

Метод 1. Получение всех компонентов метаданных
Первый метод — получение всех компонентов метаданных из организации Salesforce. Этот метод полезен, если вы хотите получить все метаданные вашей организации.

sfdx force:mdapi:retrieve -r ./retrieveDir -u <username> -k ./package.xml

Метод 2: получение определенных компонентов метаданных
Если вам нужно получить только определенные компоненты метаданных, вы можете использовать файл package.xml, чтобы определить компоненты, которые вы хотите получить. Вот пример:

<types>
    <members>Account</members>
    <members>Contact</members>
    <name>CustomObject</name>
</types>
<version>52.0</version>

sfdx force:mdapi:retrieve -r ./retrieveDir -u <username> -k ./package.xml

Метод 3: получение метаданных с помощью файла манифеста
Файл манифеста позволяет получать метаданные на основе списка имен компонентов метаданных. Вы можете создать файл манифеста (manifest/package.xml) и указать компоненты метаданных, которые вы хотите получить. Вот пример:

<?xml version="1.0" encoding="UTF-8"?>
<Package xmlns="http://soap.sforce.com/2006/04/metadata">
    <types>
        <members>Account</members>
        <members>Contact</members>
        <name>CustomObject</name>
    </types>
    <version>52.0</version>
</Package>

sfdx force:mdapi:retrieve -r ./retrieveDir -u <username> -x ./manifest/package.xml

Метод 4: получение метаданных с использованием каталога пакета
Если у вас есть каталог, содержащий компоненты метаданных, которые вы хотите получить, вы можете использовать флаг -p, чтобы указать каталог пакета. Вот пример:

sfdx force:mdapi:retrieve -r ./retrieveDir -u <username> -p ./src

Метод 5: получение метаданных с использованием идентификатора пакета
Вы также можете получить метаданные с помощью идентификатора пакета. Идентификатор пакета можно получить из API метаданных или пользовательского интерфейса настройки Salesforce. Вот пример:

sfdx force:mdapi:retrieve -r ./retrieveDir -u <username> -i 04tXXXXXXXXXXXX

В этой статье мы рассмотрели различные методы получения метаданных с помощью интерфейса командной строки Salesforce и получения MDAPI. Мы рассмотрели методы получения всех компонентов метаданных и конкретных компонентов с использованием файла манифеста, каталога пакета и идентификатора пакета. Используя эти методы, разработчики могут эффективно получать метаданные для своих проектов разработки Salesforce.

Не забудьте заменить <username>на имя пользователя вашей организации Salesforce и настроить пути и номера версий в соответствии с вашими конкретными настройками. Приятного получения метаданных с помощью Salesforce CLI!