IBaseCardService.GenerateDigest — метод (BaseCard, IXmlExportable, String)

Генерирует дайджест на основе данных карточки.

Синтаксис

string GenerateDigest(BaseCard baseCard, IXmlExportable cardData, string defaultDigest)
Параметры
baseCard

Тип: BaseCard

Карточка

cardData

Тип: IXmlExportable

Данные карточки

defaultDigest

Тип: System.String

Базовое значение, которое будет возвращено в случае невозможности создания дайджеста из данных карточки

Возвращаемое значение

Тип: System.String

Дайджест

Исключения

Исключение Условие

System.ArgumentNullException

Ошибка возвращается в случае, если не задан параметр baseCard или cardData.

Примеры

В качестве примера использования данного сервиса, можно привести код, который позволяет сгенерировать описание (дайджест) карточки, на основе её данных. Это может понадобиться, например, при программном изменении имени документа (свойство MainInfo.Name).

(1)

IBaseCardService baseCardService = objectContext.GetService<IBaseCardService>(); (2)

Document document = objectContext.GetObject<Document>(new Guid("00000000-0000-0000-0000-000000000000")); (3)

CardData cardData = userSession.CardManager.GetCardData(new Guid("00000000-0000-0000-0000-000000000000")); (4)

string digest = baseCardService.GenerateDigest(document, cardData, "Дайджест по умолчанию"); (5)

document.Description = digest; (6)

objectContext.AcceptChanges(); (7)
1 Инициализация контекста объектов.
2 Получение базового сервиса для работы с карточками.
3 Получение документа для которого мы генерируем дайджест..
4 Получение данных документа.
5 При генерации метод формирует из данных карточки дайджест, согласно шаблону хранимого в базовом объекте. Если данных для генерации недостаточно, будет использован последний аргумент метода.
6 Дайджест Документа сохраняется в свойство Description.
7 Сохранение всего контекста.