Просмотр исходного текста страницы Класс umiImportRelations

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

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


<table>
<tr>
<td>'''source_id'''</td><td>'''old_id'''</td><td>'''new_id'''</td>
</tr>
<tr>
<td>123</td><td>42907251-d287-11de-9943-000fea605ee9</td><td>3242</td>
</tr>
</table>


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


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


'''Описание методов класса umiImportRelations:'''
<ul>
  <li><span style="color:blue">getInstance()</span> - Получить экземпляр коллекции
     <p>'''Параметры:''' </p>
     <p>'''Результат:''' экземпляр класса umiImportRelations</p>
     <hr>
  </li>

  <li><span style="color:blue">getSourceId()</span> - Получить идентификатор ресурса (Каждому сценарию импорта/экспорта в таблице cms3_import_sources соответствует свой ресурс)
    <p>'''Параметры:''' <br/> 
    String<span style="color:blue"> $source_name</span>:
    Имя ресурса </p>
    <p>Например, commerceML2 или имя csv файла, или идентификатор ресурса, указанный в сценарии импорта.</p>
    <p>'''Результат:''' массив идентификаторов ресурсов</p>
    <hr>
  </li>

  <li><span style="color:blue">addNewSource()</span> - Добавить ресурс.
    <p>'''Параметры:''' <br/> 
    String<span style="color:blue"> $source_name</span>:
    Имя ресурса<br/>
    </p>
    <p>'''Результат:''' Если ресурс с таким $source_name существует, то будет возвращен его id.</p>
    <p>Если ресурса с таким $source_name нет, то ресурс будет создан и метод вернет его id.</p>
    <hr>
  </li>

  <li><span style="color:blue">setIdRelation()</span> - Добавить связь между импортируемой сущностью и страницей в системе.
    <p>'''Параметры:''' <br/> 
    Int <span style="color:blue">$source_id</span>:
    Идентификатор ресурса<br/>
    </p>
  </li>
</ul>
 [[category:API]]