Изменения

Перейти к: навигация, поиск

RetailCRM

36 байт добавлено, 11:40, 27 января 2021
м
Нет описания правки
==Введение==
''';Триггер''' - это событие:Хранимая процедура специального типа, автоматически выполняющаяся при наступлении которого, срабатывает другое событиезаданного события.
Пример триггера:Каждый каждый месяц 1-го числа у вас списывается абонентская плата за интернет. В таком примере, триггер "настал 1Триггер «1-ый день месяца" - месяца» — это событие, при наступлении которого срабатывает другое событие "списание процедура «списание абонентской платы"платы».
В реалиях '''Для RetailCRM''', предусмотрены 3 триггераследующие триггеры:* [[Настройка триггеров для RetailCRM#Передача заказа при смене статуса|«Отправка заказа в КС2008»]] — при наступлении события «Смена статуса заказа на "Отправлен в КС2008"». При установке статуса, означающего, что заказ отправлен в курьерскую службу, срабатывает триггер, и заказ передается в MeaSoft;* «Отмена заказа в КС2008» — при наступлении события «Смена типа доставки у заказа». При изменении типа доставки с доставки MeaSoft на доставку, например, Почтой России, заказ в MeaSoft отменяется, если он туда передан и имеет статус «Новый» или «Ожидает синхронизации»;* «Изменения заказа в КС2008» — при наступлении события «Изменение заказа в RetailCRM». При изменении заказа в RetailCRM новые данные отправляются в MeSoft, если заказ передан и имеет статус «Новый» или «Ожидает синхронизации».
*== Передача заказа при смене статуса == {|align="right" |-valign="top" |[[Файл:rcrm_trig101.png|200px|thumb|right|рис.1 Настройки]] |[[Файл:rcrm_trig102.png|200px|thumb|right|рис.2 Кнопка "Добавить"]] |- |[[Файл:rcrm_trig103.png|200px|thumb|right|рис.3 Настройки полей статуса]] |[[Файл:rcrm_trig104.png|200px|thumb|right|рис.4 настройки Типов доставок]] |- |[[Файл:rcrm_trig105.png|200px|thumb|right|рис.5 Тип доставки город]] |[[Файл:rcrm_trig106.png|200px|thumb|right|рис.6 Тип доставки межгород]] |} Чтобы настроить триггер:# Cоздайте пользовательский статус заказа, при установке которого заказ будет автоматически передаваться в курьерскую службу. Можно создать любое количество статусов.Заходим в настройки (рис.1) Триггер .   2.Кнопка '''"Добавить"''' (рис.2).  3.Указываем поля '''"Название"''', '''"отправка заказа в КС2008Символьный код"''', при наступлении события '''"Смена статуса заказа на Группа"'''. <span style="color: red;>'''"Символьный код"Отправлен ''' необходимо записать, так как он понадобится в КС2008"дальнейшем!</span> Символьный код желательно вбивать латинскими буквами и цифрами, без пробелов, например '''"ks2008send'''" (рис.3).
:*То есть, когда вы меняете статус заказу, то срабатывает триггер '''"отправка заказа в КС2008"''' и заказ уходит в систему КС2008.
*24.Переходим в настройки Типов доставок: '''"Настройки"''' (1) Триггер -> '''"отмена заказа в КС2008Справочники"''', при наступлении события (2) -> '''"Смена типа доставки у заказаТипы доставок"'''(3) (рис. 4).
:*То есть, когда вы меняете Тип заказа с нашей 5.Находим нужные нам доставки на доставку, например, в Почту России, то мы отменяем ваш заказ в нашей системе (если он туда передавался и имеет статус '''"Новый"''' или '''"Ожидает синхронизации"'''доставку).На примере выше мы видим 2 Типа доставок:
*3) Триггер '''"изменения заказа в КС2008Доставка межгород"''', при наступлении события символьный код <span style="color: red;>'''"Изменения заказ в RetailCRM"outcity'''.</span>
'''"Доставка по городу"''', символьный код <span style="color: red;>'''incity'''</span> <span style="color:*То естьred;>'''Запишем эти значения.'''</span>   6.Теперь, когда вы меняете данные имея <span style="color: red;>символьный код Статуса заказа </span> (или статусов, если вам нужно передавать заказы при двух и более статусах) и <span style="color: red;>символьный код Типа доставки</span> (или типов), мы можем создать сам триггер: Переходим в настройки Триггеров: '''"Настройки"''' (1) -> '''"Коммуникации"''' (2) -> '''"Триггеры"''' (3) (рис.7).  7.Кнопка '''"Добавить"''' (рис.8). В появившемся окне нужно заполнить и настроить несколько полей: 1.Поле '''"Название"''' (рис.9). 2.В поле '''"Условие применения триггера"''' добавляем скрипт (рис.10):<source lang="javascript">order.getStatus().getCode() in ["ks2008send"] and order.getDeliveryType().getCode() in ["outcity","incity"]</source>{|align="right" |-valign="top" |[[Файл:rcrm_trig111.png|200px|thumb|right|рис.11 выбор меню "Добавить действие"]] |[[Файл:rcrm_trig112.png|200px|thumb|right|рис.12 Дополнительные поля настроек]] |} Где: *''''''"ks2008send"'''''' - данные меняются это <span style="color: red;>символьный код Статуса заказа</span>.:*Если у вас будет 2 статуса, то нужно вписать их через запятую в таком виде: '''["ks2008send_1",”ks2008send_2”]''' вместо '''["ks2008send"]''' *'''"outcity"''','''"incity"''' - это <span style="color: red;>символьные коды Типа доставки</span>.:*Если у вас будет 1 Тип доставки, то нужно вписать в нашей системе таком виде '''["incity”]''' вместо '''["outcity","incity"]'''  3.Далее нужно нажать '''Добавить действие''' (1) -> '''Выполнить HTTP-запрос''' (2) чтобы появились дополнительные поля настроек (рис.11). 4.В поле '''"Адрес"''' прописываем: https://home.courierexe.ru/reintegrations/requests/trigger/retailcrm 5.В списке '''"HTTP метод"''' выбираем '''"POST"'''. 6.В списке '''"Передавать параметры"''' выбираем '''"В теле запроса (если он туда передавался и имеет статус urlencode)"'''.Получим следующие настройки полей (рис. 12). 7.Нажимаем кнопку '''"Добавить параметр"''' 3 раза подряд. 8.Теперь нам нужно эти поля заполнить следующими данными: {| class="wikitable" cellpadding="10" cellspacing="0" border="2"|'''Параметр'''|'''Значение'''|-|'''id'''|<source lang="Новыйjavascript">{{ order.getNumber() }}</source>|-|''' или sum'''|<source lang="Ожидает синхронизацииjavascript">{{ order.getIntegrationDeliveryData().getDeclaredSum() }}</source>|-|'''key'''|<source lang="javascript">{{ order.getIntegrationDeliveryData().getExtraData().deliveryApiKey }}</source>|-|}  По итогу мы получим следующее заполнение полей (рис.14): Обратите внимание, что <span style="color: red;>ВО ВСЕХ СЛУЧАЯХ ДАННЫЕ ЗАПИСАНЫ В ОДНОЙ СТРОКЕ, ПЕРЕНОСОВ СТРОК БЫТЬ НЕ ДОЛЖНО!</span> 10.Последнее действие - нажатие кнопки '''"Сохранить"'''. Настройка триггера завершена.
==Триггер “Отмена заказа при смене Типа доставки”==
10.Последнее действие - нажатие кнопки '''"Сохранить"'''. Настройка триггера завершена.
==Триггер “Передача заказа при смене Статуса заказа”==
 
{|align="right"
|-valign="top"
|[[Файл:rcrm_trig101.png|200px|thumb|right|рис.1 Настройки]]
|[[Файл:rcrm_trig102.png|200px|thumb|right|рис.2 Кнопка "Добавить"]]
|-
|[[Файл:rcrm_trig103.png|200px|thumb|right|рис.3 Настройки полей статуса]]
|[[Файл:rcrm_trig104.png|200px|thumb|right|рис.4 настройки Типов доставок]]
|-
|[[Файл:rcrm_trig105.png|200px|thumb|right|рис.5 Тип доставки город]]
|[[Файл:rcrm_trig106.png|200px|thumb|right|рис.6 Тип доставки межгород]]
|}
 
1.Для начала нужно создать '''Статус заказа''' (или статусы, если вам нужно передавать заказы при двух или более статусах)
Заходим в настройки (рис.1).
 
 
2.Кнопка '''"Добавить"''' (рис.2).
 
3.Указываем поля '''"Название"''', '''"Символьный код"''', '''"Группа"'''.
 
<span style="color: red;>'''"Символьный код"''' необходимо записать, так как он понадобится в дальнейшем!</span>
 
Символьный код желательно вбивать латинскими буквами и цифрами, без пробелов, например '''"ks2008send'''" (рис.3).
 
 
4.Переходим в настройки Типов доставок: '''"Настройки"''' (1) -> '''"Справочники"''' (2) -> '''"Типы доставок"''' (3) (рис. 4).
5.Находим нужные нам доставки (или доставку).
На примере выше мы видим 2 Типа доставок:
 
'''"Доставка межгород"''', символьный код <span style="color: red;>'''outcity'''</span>
 
'''"Доставка по городу"''', символьный код <span style="color: red;>'''incity'''</span>
 
<span style="color: red;>'''Запишем эти значения.'''</span>
 
 
 
6.Теперь, имея <span style="color: red;>символьный код Статуса заказа</span> (или статусов, если вам нужно передавать заказы при двух и более статусах) и <span style="color: red;>символьный код Типа доставки</span> (или типов), мы можем создать сам триггер:
 
Переходим в настройки Триггеров: '''"Настройки"''' (1) -> '''"Коммуникации"''' (2) -> '''"Триггеры"''' (3) (рис.7).
 
7.Кнопка '''"Добавить"''' (рис.8).
В появившемся окне нужно заполнить и настроить несколько полей:
 
1.Поле '''"Название"''' (рис.9).
 
2.В поле '''"Условие применения триггера"''' добавляем скрипт (рис.10):
<source lang="javascript">
order.getStatus().getCode() in ["ks2008send"] and order.getDeliveryType().getCode() in ["outcity","incity"]
</source>
{|align="right"
|-valign="top"
|[[Файл:rcrm_trig111.png|200px|thumb|right|рис.11 выбор меню "Добавить действие"]]
|[[Файл:rcrm_trig112.png|200px|thumb|right|рис.12 Дополнительные поля настроек]]
|}
Где:
*''''''"ks2008send"'''''' - это <span style="color: red;>символьный код Статуса заказа</span>.
:*Если у вас будет 2 статуса, то нужно вписать их через запятую в таком виде: '''["ks2008send_1",”ks2008send_2”]''' вместо '''["ks2008send"]'''
*'''"outcity"''','''"incity"''' - это <span style="color: red;>символьные коды Типа доставки</span>.
:*Если у вас будет 1 Тип доставки, то нужно вписать в таком виде '''["incity”]''' вместо '''["outcity","incity"]'''
 
3.Далее нужно нажать '''Добавить действие''' (1) -> '''Выполнить HTTP-запрос''' (2) чтобы появились дополнительные поля настроек (рис.11).
4.В поле '''"Адрес"''' прописываем: https://home.courierexe.ru/reintegrations/requests/trigger/retailcrm
 
5.В списке '''"HTTP метод"''' выбираем '''"POST"'''.
 
6.В списке '''"Передавать параметры"''' выбираем '''"В теле запроса (urlencode)"'''.
Получим следующие настройки полей (рис. 12).
 
7.Нажимаем кнопку '''"Добавить параметр"''' 3 раза подряд.
 
8.Теперь нам нужно эти поля заполнить следующими данными:
 
{| class="wikitable" cellpadding="10" cellspacing="0" border="2"
|'''Параметр'''
|'''Значение'''
|-
|'''id'''
|<source lang="javascript">{{ order.getNumber() }}</source>
|-
|'''sum'''
|<source lang="javascript">{{ order.getIntegrationDeliveryData().getDeclaredSum() }}</source>
|-
|'''key'''
|<source lang="javascript">{{ order.getIntegrationDeliveryData().getExtraData().deliveryApiKey }}</source>
|-
|}
 
 
По итогу мы получим следующее заполнение полей (рис.14):
 
Обратите внимание, что <span style="color: red;>ВО ВСЕХ СЛУЧАЯХ ДАННЫЕ ЗАПИСАНЫ В ОДНОЙ СТРОКЕ, ПЕРЕНОСОВ СТРОК БЫТЬ НЕ ДОЛЖНО!</span>
 
10.Последнее действие - нажатие кнопки '''"Сохранить"'''. Настройка триггера завершена.
==Триггер “Передача изменений заказа”==

Навигация