Метка (Label)

Метка — строковый параметр, прикрепляемый к служебным документам и предназначенный для реализации логики их обработки. Метки помогают реализовать клиентскую логику обработки служебных документов. Кроме пользовательских меток к документам можно прикреплять предопределенные метки Диадока — они влияют на поведение системы.

Для представления в API у меток нет отдельной структуры — они являются нерегистрочувствительными строками. Метки, добавленные к сущности, хранятся в структуре Entity.

При документообороте метки передаются в ящик другой стороны вместе с документом.

Предопределенные метки

В Диадоке заведены следующие предопределенные метки:

  • _impersonal — обезличенное действие. Если отправить извещение о получении ReceiptAttachment или уведомление об уточнении CorrectionRequestAttachment с этой меткой, то на странице документа в описании действия не будет упомянут сотрудник, который его совершил.

Ограничения

  • Длина метки должна быть не более 20 символов.

  • Метка может содержать латинские буквы, цифры и дефисы.

  • Только предопределенные метки могут начинаться с символа подчеркивания.

  • К одной сущности можно добавить не более 30 меток.

  • К одной сущности нельзя добавить несколько одинаковых меток.

См. также

Представление в API:

  • Entity — данные сущности, входящей в сообщение; содержит список меток