Класс umiImportRelations

Описание класса: Класс служит для работы со связями между импортируемыми сущностями и системными объектами.

Например, из 1С к нам приходит <товар> с <ид> равным "42907251-d287-11de-9943-000fea605ee9", UMI.CMS создает <page> с идентификатором id = "3242", и записывает в таблицу cms3_import_relations следующую запись:

source_id	old_id	new_id
123	42907251-d287-11de-9943-000fea605ee9	3242

Когда в следующий раз из 1С опять придет <товар> с <ид> равным "42907251-d287-11de-9943-000fea605ee9", то заново его создавать UMI.CMS не будет, система просто обновит страницу с id = "3242".

Класс является синглтоном, экземпляр класса можно получить через статический метод getInstance(). Исходный код класса находится в файле /classes/system/utils/importRelations/umiImportRelations.php.

Описание методов класса umiImportRelations:

• getInstance() - Получить экземпляр коллекции

  Параметры:

  Результат: экземпляр класса umiImportRelations

  ---

• getSourceId() - Получить идентификатор ресурса (Каждому сценарию импорта/экспорта в таблице cms3_import_sources соответствует свой ресурс)

  Параметры:
  String $source_name: Имя ресурса

  Например, commerceML2 или имя csv файла, или идентификатор ресурса, указанный в сценарии импорта.

  Результат: массив идентификаторов ресурсов

  ---

• addNewSource() - Добавить ресурс.

  Параметры:
  String $source_name: Имя ресурса
  

  Результат: Если ресурс с таким $source_name существует, то будет возвращен его id.

  Если ресурса с таким $source_name нет, то ресурс будет создан и метод вернет его id.

  ---

• setIdRelation() - Добавить связь импортируемой сущностью/страницей в UMI.CMS и страницей в UMI.CMS/экспортируемой сущностью в файле экспорта.

  Параметры:
  Int $source_id: Идентификатор ресурса
  String $old_id: Идентификатор импортируемой сущности/страницы в UMI.CMS
  String $new_id: Идентификатор страницы в UMI.CMS/экспортируемой сущности
  

  Результат: true, в случае успеха, false в случае неудачи

• getNewIdRelation() - Получить новое значение (new_id) из таблицы cms3_import_relations.

  Параметры:
  Int $source_id: Идентификатор ресурса
  String $old_id: Идентификатор импортируемой сущности/страницы в UMI.CMS
  

  Результат: "старый" идентификатор(old_id), false в случае неудачи

• getOldIdRelation() - Получить старое значение (old_id) из таблицы cms3_import_relations.

  Параметры:
  Int $source_id: Идентификатор ресурса
  String $new_id: Идентификатор страницы в UMI.CMS/экспортируемой сущности
  

  Результат: "новый" идентификатор(new_id), false в случае неудачи

• setTypeIdRelation() - Добавить связь между импортируемым/экспортируемым и созданным/имеющимся типом данных.

  Параметры:
  Int $source_id: Идентификатор ресурса
  String $new_id: Идентификатор страницы в UMI.CMS/экспортируемой страницы
  

  Результат: "новый" идентификатор(new_id), false в случае неудачи