Почтовый метод
POST — это метод http, который одновременно добавляет одну или несколько записей в Salesforce. Мы можем вставлять записи с URI через пользовательский API REST Apex или напрямую из URI.
Пользовательский ресурс отдыха в Apex
Чтобы написать REST в Apex, мы должны использовать некоторые аннотации, которые обращаются к REST API в вашем классе Apex.
@HttpPost Аннотация
Этот метод вызывается при отправке HTTP POST, что позволяет представить метод Apex как ресурс REST. Затем он создает новый ресурс.
Синтаксис: @httpPost
Пример:
Напишите класс Apex «RestApi_Post_Record.apxc», который использует метод REST «POST» для вставки полей состояния, приоритета и темы в объект «Обращение» Salesforce.
- Создайте Post_Method с тремя параметрами: статус, приоритет и тема строкового типа.
- Создайте объект «Case», передав эти параметры.
- Используйте вставку DML, чтобы вставить запись в объект «Обращение» Salesforce.
глобальный класс RestApi_Post_Record{
// ОТДЫХ - Почтовый метод
@httpPost
глобальный статический Case Post_Method (приоритет строки, статус строки, тема строки) {
Дело case_obj= новое дело(Приоритет=приоритет,Статус=статус,Тема=тема);
// Вставляем DML
вставить case_obj;
вернуть case_obj;
}
}
URI и результат:
Перейдите в Workbench и перейдите в REST Explorer. Укажите следующий URI и выполните его:
/services/apexrest/v56.0/RestApi_Post_Record/
Укажите данные в теле запроса:
{'Приоритет': 'Высокий',
«Статус»: «Новый»,
'Subject':'Проблема с мобильным телефоном'
}
Откройте запись в Salesforce (перейдите к объекту «Обращение» в средстве запуска приложений).
Вставьте одну запись непосредственно из URI
Перейдите в REST Explorer на вкладке «Утилиты» и укажите следующий URI и укажите эту запись в теле запроса:
/услуги/данные/v56.0/объекты/Дело/Тело запроса:
{'Приоритет': 'Средний',
«Статус»: «Новый»,
'Subject':'Microsoft team – не подходит'
}
Перейдите на вкладку Salesforce «Обращения» и просмотрите запись.
Вставка нескольких записей непосредственно из URI
Если вы хотите вставить несколько записей одновременно, нам нужно указать URI следующим образом: /услуги/данные/v56.0/составной/дерево/sObject
Тело запроса содержит записи в следующем формате:
'записи' :[{'атрибуты' : {'тип' : 'Объект', 'referenceId' : 'reference1'},
поле:значение,
...
...
},{
'атрибуты' : {'тип' : 'Объект', 'referenceId' : 'reference1'},
поле:значение,
...
...
}]
}
Давайте вставим две записи в объект «Обращение» Salesforce.
URI: /services/data/v56.0/composite/tree/Case/Тело запроса:
{'записи' :[{
«атрибуты»: {«тип»: «Case», «referenceId»: «reference1»},
'Приоритет': 'Высокий',
«Статус»: «Новый»,
'Тема':'Проблема конструкции с механическим ротором',
'Тип':'Электрический'
},{
«атрибуты»: {«тип»: «Case», «referenceId»: «reference2»},
«Приоритет»: «Низкий»,
«Статус»: «Новый»,
'Subject':'Запуск генератора после отказа электросети' ,
'Тип':'Электрический'
}]
}
В Salesforce вставляются две записи с CaseNumber 00001038 и 00001039.
ПОЛОЖИТЬ Метод
Как мы уже обсуждали ранее, PUT — это http-метод, который используется для создания/обновления записей. В этом руководстве мы используем этот метод для создания новой записи Salesforce с помощью пользовательского REST API.
@httpPut : этот метод вызывается при отправке HTTP PUT, что позволяет отображать метод Apex как ресурс REST. Затем он создает новый ресурс или обновляет существующий ресурс.
Синтаксис: @httpPutПример:
Напишите класс Apex «RestApi_Put_Record.apxc», который использует метод REST «PUT» для вставки полей состояния, приоритета и описания в объект Salesforce «Case».
@RestResource(urlMapping='/v56.0/RestApi_Put_Record/')глобальный класс RestApi_Put_Record{
// REST - Метод Put
@httpPut
глобальный статический Case Put_Method (приоритет строки, статус строки, тема строки) {
Дело case_obj= новое дело(Приоритет=приоритет,Статус=статус,Тема=тема);
// Вставляем DML
вставить case_obj;
вернуть case_obj;
}
}
URI и результат:
Перейдите в Workbench и перейдите в REST Explorer. Укажите следующий URI и выполните его:
/services/apexrest/v56.0/RestApi_Put_Record/Укажите данные в теле запроса:
{'Приоритет': 'Высокий',
«Статус»: «Закрыто»,
'Subject':'Требуется руководство по овощерезке'
}
Откройте запись в Salesforce (перейдите к объекту «Обращение» в средстве запуска приложений).
Заключение
Теперь вы можете вставлять записи в Salesforce, используя методы http PUT и POST. Мы узнали, как вставлять записи непосредственно в Workbench и использовать пользовательский REST API через класс Apex. Объект Salesforce «Case» используется в этом руководстве в качестве примера. Фактическая разница между PUT и POST заключается в том, что POST используется для вставки данных, тогда как PUT используется для вставки/обновления данных. Аннотация @httpPut используется для метода PUT, а аннотация @httpPost — для метода POST.