Программный продукт «QP8.Framework» (стр. 24 )

Аналог метода GetContentData, кэширующий результат во всех случаях.

Внимание: исключением является ситуация, когда кэширование отключено на уровне экземпляра класса.

Метод GetContentItemLinkIds

public string GetContentItemLinkIDs(string linkFieldName, long itemId)
public string GetContentItemLinkIDs(string linkFieldName, string itemIds)
public string GetContentItemLinkIDs(int linkId, long itemId)
public string GetContentItemLinkIDs(int linkId, string itemIds)
public string GetContentItemLinkIDs(int linkId, long itemId, bool isManyToMany)
public string GetContentItemLinkIDs(int linkId, string itemIds, bool isManyToMany)

Выводит данные для поля «Связь» типов M2M и M2O.

Параметры:

Название	Описание
linkFieldName	Имя поля «Связь».
itemId	Идентификатор статьи, для которой требуется получить данные.
itemIds	Идентификаторы статей, для которых требуется получить данные. Примечание: в качестве значения задавать идентификаторы через запятую.
linkId	Для типа M2M – идентификатор связи (запись в таблице CONTENT_TO_CONTENT). Для типа M2O – идентификатор базового поля «Связь» типа O2M (запись в таблице CONTENT_ATTRIBUTE). Примечание: идентификаторы хранятся в полях таблицы контента (CONTENT_NNN) и могут быть получены методом GetContentData, что позволяет избежать дополнительных запросов к БД.
isManyToMany	Указатель, что используется поле «Связь» типа M2M. Значение по умолчанию – true.

Результат возвращается в виде строки идентификаторов связанных статей через запятую.

Внимание: в результат всегда добавляется 0, так что он никогда не является пустым и может быть использован в SQL-конструкции IN без дополнительного кода.

Примечание: учитываются значения свойств IsStage и CacheData. Если IsStage = true, то возвращаются текущие версии полей, иначе только опубликованные. Если CacheData = true, то результат выполнения кэшируется на интервал времени InternalShortExpirationTime.

Метод GetRealContentItemLinkIds

public string GetRealContentItemLinkIDs(string linkFieldName, long itemId)
public string GetRealContentItemLinkIDs(string linkFieldName, string itemIds)
public string GetRealContentItemLinkIDs(int linkId, long itemId)
public string GetRealContentItemLinkIDs(int linkId, string itemIds)
public string GetRealContentItemLinkIDs(int linkId, long itemId, bool isManyToMany)
public string GetRealContentItemLinkIDs(int linkId, string itemIds, bool isManyToMany)

Метод аналогичен методу GetContentItemLinkIds. Отличие в том, что результат выполнения не кэшируется вне зависимости от значения свойства CacheData.

Метод GetContentItemLinkQuery

public string GetContentItemLinkQuery(string linkFieldName, long itemId)
public string GetContentItemLinkQuery(string linkFieldName, string itemIds)
public string GetContentItemLinkQuery(int linkId, long itemId)
public string GetContentItemLinkQuery(int linkId, string itemIds)
public string GetContentItemLinkQuery(int linkId, long itemId, bool isManyToMany)
public string GetContentItemLinkQuery(int linkId, string itemIds, bool isManyToMany)

Метод аналогичен методу GetContentItemLinkIds. Отличие в том, что он возвращает не результат запроса к БД, а сам SQL-запрос.

Методы для создания, изменения, удаления статей

Примечание: более удобной альтернативой являются методы класса ContentItem.

Метод AddFormToContent

public int AddFormToContent(int site_id, string content_name, string status_name, ref Hashtable Values, ref HttpFileCollection Files, int content_item_id, bool updateEmpty)

public int AddFormToContent(int site_id, string content_name, string status_name, ref Hashtable Values, ref HttpFileCollection Files, int content_item_id)

public int AddFormToContent(int site_id, string content_name, string status_name, ref Hashtable Values, ref HttpFileCollection Files)

public int AddFormToContent(int site_id, string content_name, string status_name, ref Hashtable Values, int content_item_id)

public int AddFormToContent(int actualSiteId, int content_id, string status_name, ref Hashtable Values, ref HttpFileCollection Files, int content_item_id, bool updateEmpty, int attribute_id)

public int AddFormToContent(int actualSiteId, int content_id, string status_name, ref Hashtable Values, ref HttpFileCollection Files, int content_item_id, bool updateEmpty, int attribute_id, bool visible, bool archive, bool returnModified, ref DateTime modified)

Создаёт новые статьи, изменяет существующие.

Поддерживается полноценная работа с расщеплёнными статьями, включая поля «Связь» типов M2M и M2O. Значения таких полей должны представлять собой строку идентификаторов связанных статей, разделённых запятыми.

Внимание: метод не поддерживает отправку уведомлений. Необходимо использовать метод SendNotification или использовать класс ContentItem.

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

тип поля («Числовой», «Дата»), обязательность, уникальность, допустимая длина и маска ввода (для поля типа «Строка»).

Дополнительно:

при обновлении статьи создается её версия, вся работа с БД происходит в одной транзакции.

Параметры:

Метод	Метод
site_id	Идентификатор сайта, с которого производится вызов.
actualSiteId	Фактический идентификатор сайта, в который добавляется статья.
contentName	Имя контента, в который добавляется статья. Внимание: контент не может быть виртуальным. При указании виртуального контента будет выдано исключение. Примечание: поддерживается имя контента в формате SiteName. ContentName. Если сайт SiteName будет найден, то его идентификатор будет использован в качестве значения параметра actualSiteId, иначе будет использован параметр site_id.
content_id	Идентификатор контента, в который добавляется статья. Внимание: контент не может быть виртуальным. При указании виртуального контента будет выдано исключение.
statusName	Имя статуса Workflow, который должен быть присвоен статье.
Values	Значения полей статьи в коллекции Values, ключи которой должны быть сформированы с помощью метода FieldName.
Files	Коллекция файлов, переданных вместе с веб-запросом. Для веб-формы её содержимое надо взять из Request. Files, иначе передать переменную со значением NULL.
content_item_id	Идентификатор статьи. При ненулевом значении метод работает в режиме обновления существующей статьи, при нулевом – в режиме добавления новой статьи. Примечание: значение по умолчанию – 0.
updateEmpty	Указатель, следует ли обнулять поля, которые в коллекции Values: имеют пустые значения, отсутствуют. Значение по умолчанию – true, то есть при обновлении статьи в коллекции Values должны быть представлены значения всех полей. Если нужно обновить одно или несколько полей и задать в коллекции Values только их, то для параметра следует задать значение false.
attribute_id	Идентификатор поля. При ненулевом значении выполняется изменение указанного поля, при нулевом – обычный режим обновления. Примечание: значение по умолчанию – 0.
visible	Значение флага видимости для статьи. Примечание: значение параметра не меняется в тех версиях метода, где он не передаётся. Примечание: используется в классах LINQ to SQL.
archive	Значение флага архивации для статьи. Примечание: значение параметра не меняется в тех версиях метода, где он не передаётся. Примечание: используется в классах LINQ to SQL.
returnModified	Указатель, что требуется вернуть дату модификации статьи в параметре modified. Примечание: используется в классах LINQ to SQL.
modified	Дата модификации статьи. Возвращается в случае returnModified = true. Примечание: используется в классах LINQ to SQL.

Примечание: в директорию контента сохраняются только те файлы из коллекции Files, которые корректно представлены в коллекции Values (сформированы методом FieldName). Если имя нового файла совпадает с именем уже существующего файла, то в имя нового файла будет добавлен числовой индекс (например, image[1].jpg), при этом изменение имени файла будет учтено в коллекции Values.

Примечание: вне зависимости от заполнения коллекции Files для статьи будут сгенерированы (перегенерированы) все динамические изображения.

Примечание: в случае невозможности предоставить коллекцию Files файлы необходимо сохранять вручную, используя для определения целевого пути метод GetUrlForFileAttribute.

Метод UpdateContentItem

public int UpdateContentItem(int site_id, int content_id, ref Hashtable Values, int content_item_id)
public int UpdateContentItem(int site_id, int content_id, ref Hashtable Values, int content_item_id, bool updateEmpty)
public int UpdateContentItem(int site_id, int content_id, ref Hashtable Values, int content_item_id, bool updateEmpty, string statusName)
public int UpdateContentItem(int site_id, int content_id, ref Hashtable Values, ref HttpFileCollection Files, int content_item_id)
public int UpdateContentItem(int site_id, int content_id, ref Hashtable Values, ref HttpFileCollection Files, int content_item_id, bool updateEmpty)
public int UpdateContentItem(int site_id, int content_id, ref Hashtable Values, ref HttpFileCollection Files, int content_item_id, bool updateEmpty, string statusName)