Кастомизация сценария выгрузки заказов для 1С — различия между версиями

Материал из Umicms
Перейти к:навигация, поиск
 
(не показано 10 промежуточных версий этого же участника)
Строка 1: Строка 1:
 +
 +
<br> '''Актуально для версии 2.9'''<br>
 +
 
<p><b>Задача:</b> Добавить к сценарию выгрузки заказов для 1С информацию об адресе доставки и её стоимости.<br />
 
<p><b>Задача:</b> Добавить к сценарию выгрузки заказов для 1С информацию об адресе доставки и её стоимости.<br />
 
<b>Решение.</b></p>
 
<b>Решение.</b></p>
Строка 11: Строка 14:
 
<h4>Выводим стоимость доставки</h4>
 
<h4>Выводим стоимость доставки</h4>
 
<p>1. Создадим переменную, в которой будет хранится текущий индентификатор объекта.<br />
 
<p>1. Создадим переменную, в которой будет хранится текущий индентификатор объекта.<br />
   <source lang="xml">
+
   <source lang="xml" highlight="3">
 
<xsl:template match="object" mode="order">
 
<xsl:template match="object" mode="order">
 
...
 
...
Строка 19: Строка 22:
 
</source></p>
 
</source></p>
 
2. Пропишем наш тег, в котором будет выводится информация о стоимости доставки. Для этого, внутри тега вызовим темплейт с mode=&quot;delivery_price&quot;:<br />
 
2. Пропишем наш тег, в котором будет выводится информация о стоимости доставки. Для этого, внутри тега вызовим темплейт с mode=&quot;delivery_price&quot;:<br />
<source lang="xml">
+
<source lang="xml" highlight="3">
 
<Курс>1</Курс>
 
<Курс>1</Курс>
 
 
Строка 25: Строка 28:
 
<Сумма><xsl:value-of select="$total_price" /></Сумма>
 
<Сумма><xsl:value-of select="$total_price" /></Сумма>
 
</source>
 
</source>
<p>Теперь необходимо понять откуда взять нужную нам информацию. Так как мы работаем с объектами, то вся информация содержится в них.<br />
+
 
  Чтобы просмотреть содержимое объекта в xml-виде, мы можем включить протокол uobject и через него просмотреть содержимое объекта:<br />
 
  [[Файл:Xslt.png]]<br> (Изображение 1)<br/>
 
В рамке отмеченна информация, которую мы будет внедрять в файл импорта заказов.</p>
 
 
<p>3. В конце файла опишем вызванный шаблон:<br />
 
<p>3. В конце файла опишем вызванный шаблон:<br />
 
<source lang="xml">
 
<source lang="xml">
Строка 36: Строка 36:
 
</source>
 
</source>
 
<h4>Выводим информацию об адресе доставки</h4>
 
<h4>Выводим информацию об адресе доставки</h4>
<p>Выводить информацию об адресе доставки удобнее всего у контрагента совершившего заказ.<br />
+
Выводить информацию об адресе доставки удобнее всего у контрагента совершившего заказ.<br />
Если мы посмотрим на рисунок, то увидим, что информация об адресе доставки содержется в другом объекте и нам доступен id этого объекта и ссылка на него.<br />
+
 
Получить данный id мы можем заранее, используя глобальную переменную, т.к. локальные переменные в других темплейтах будут недоступны.</p>
+
Получить данный id мы можем заранее, используя переменную.</p>
<p>1. Опишем глобальную переменную в самом начале файла:<br />
+
<p>1. Найдем шаблон, по которому выводится информация о контрагенте и опишем в нем нашу переменную:<br />
<source lang="xml">
+
<source lang="xml" highlight="2">
<xsl:output method="xml" encoding="utf-8"/>
 
<xsl:variable name="delivery_id" select="//properties/group/property[@name='delivery_address']/value/item/@id"/>
 
</source>
 
</p>
 
<p>2. Найдем шаблон, по которому выводится информация о контрагенте:<br />
 
<source lang="xml">
 
 
<xsl:template match="object" mode="customer">
 
<xsl:template match="object" mode="customer">
 +
        <xsl:variable name="delivery_id" select="//properties/group/property[@name='delivery_addresses']/value/item/@id"/>
 
<Контрагент>
 
<Контрагент>
 
</source></p>
 
</source></p>
<p>3. Вызовим наш шаблон:<br />
+
<p>3. Там же, вызовим наш шаблон:<br />
<source lang="xml">
+
<source lang="xml" highlight="3">
<xsl:apply-templates select="document(concat('uobject://', $delivery_id))/udata/object" mode="current_address" />
+
        <Контрагент>
 +
        ...
 +
        <xsl:apply-templates select="document(concat('uobject://', $delivery_id))/udata/object" mode="current_address" />
 +
        </Контрагент>
 
</source></p>
 
</source></p>
 
<p>4. Опишем шаблон:<br />
 
<p>4. Опишем шаблон:<br />
Строка 82: Строка 80:
 
<h4>Результат выгрузки</h4>
 
<h4>Результат выгрузки</h4>
 
[[Файл:900-export-result.png]]
 
[[Файл:900-export-result.png]]
<p>Версия: 2.8.5.3</p>
+
 
 +
[[Категория:Интеграция с 1С]][[Категория:Модуль Обмен данными]]

Текущая версия на 16:59, 7 июня 2013


Актуально для версии 2.9

Задача: Добавить к сценарию выгрузки заказов для 1С информацию об адресе доставки и её стоимости.
Решение.

Подготовка

1. Открываем папку: xsl/export/
2. Копируем файл ordersCommerceML.xsl и вставляем в папку /custom/ с заменой существующего там файла.
3. Открываем данный файл на редактирование.
4. В самом конце файла сотрем строчку:

<xsl:include href="custom/ordersCommerceML.xsl" />

Выводим стоимость доставки

1. Создадим переменную, в которой будет хранится текущий индентификатор объекта.

<xsl:template match="object" mode="order">
...
<xsl:param name="my_order_id" select="@id" />
...
	<Документ>

2. Пропишем наш тег, в котором будет выводится информация о стоимости доставки. Для этого, внутри тега вызовим темплейт с mode="delivery_price":

		<Курс>1</Курс>
		
		<СтоимостьДоставки><xsl:apply-templates select="//object[@id=$my_order_id]"  mode="delivery_price" /></СтоимостьДоставки>
		<Сумма><xsl:value-of select="$total_price" /></Сумма>

3. В конце файла опишем вызванный шаблон:

<xsl:template match="object" mode="delivery_price">
		Стоимость доставки: <xsl:value-of select="//property[@name='delivery_price']/value" />
</xsl:template>

Выводим информацию об адресе доставки

Выводить информацию об адресе доставки удобнее всего у контрагента совершившего заказ.

Получить данный id мы можем заранее, используя переменную.

1. Найдем шаблон, по которому выводится информация о контрагенте и опишем в нем нашу переменную:

<xsl:template match="object" mode="customer">
        <xsl:variable name="delivery_id" select="//properties/group/property[@name='delivery_addresses']/value/item/@id"/>
	<Контрагент>

3. Там же, вызовим наш шаблон:

        <Контрагент>
        ...
        <xsl:apply-templates select="document(concat('uobject://', $delivery_id))/udata/object" mode="current_address" />
        </Контрагент>

4. Опишем шаблон:

<xsl:template match="object" mode="current_address">
			<Адрес>
				Страна: <xsl:value-of select="//property[@name='country']/value/item/@name" />,
				Индекс: <xsl:value-of select="//property[@name='index']/value" />,
				Регион: <xsl:value-of select="//property[@name='region']/value" />,
				Город: <xsl:value-of select="//property[@name='city']/value" />,
				Улица: <xsl:value-of select="//property[@name='street']/value" />,
				Дом: <xsl:value-of select="//property[@name='house']/value" />,
				Квартира: <xsl:value-of select="//property[@name='flat']/value" />
			</Адрес>
</xsl:template>

Аналогичным образом, Вы можете описать и добавить в выгрузку любые другие поля, в том числе собственные.

Примечание 1:
Если при выгрузке заказов Вы получаете сообщение об ошибке разбора данных, то закомментируйте в нашем кастомном файле две строки:

<!-- <xsl:variable name="currency" select="document('udata://emarket/currencySelector/')/udata/items" /> -->
<!-- <xsl:variable name="default-currency" select="$currency/item[@default = 'default']/@codename" /> -->

Примечание 2:
Обратите внимание на то, что заказы, которые Вы хотите выгрузить, разрешены к выгрузке:
Order-export.png

Результат выгрузки

900-export-result.png