Может ли InstantiateTemplateRequest вернуть более одного значения?

Question

Как я понимаю, InstantiateTemplateRequest возвращает коллекцию сущностей с атрибутами "Subject" и "Description", однако большинство примеров, которые я видел, обрабатывают коллекцию так, как будто она содержит только одно значение.Есть ли случай, когда он может возвращать несколько значений?

Answer 1

Нет. Документация говорит:

Класс InstantiateTemplateRequest

Содержит параметры, необходимые для создания сообщения электронной почты из шаблона (шаблон электронной почты).

Таким образом, предназначен для получения одного объекта в ответе коллекции объектов.

Например, этот блог также объясняет это поведение, предполагая только одну сущность. Поскольку вы передаете templateId, contactId - это сгенерирует одно электронное письмо на основе этого шаблона и данных записи контакта.

InstantiateTemplateRequest instTemplateReq = new InstantiateTemplateRequest
{
    TemplateId = templateId,
    ObjectId = contactId,
    ObjectType = "contact"
};
InstantiateTemplateResponse instTemplateResp = (InstantiateTemplateResponse)service.Execute(instTemplateReq);

Entity template = instTemplateResp.EntityCollection.Entities[0];