Розбіжності

Тут показані розбіжності між вибраною ревізією та поточною версією сторінки.

--- btrx24 [2023/06/20 14:11] – nightfly
+++ btrx24 [2023/06/22 17:05] (поточний) – nightfly
@@ Рядок 1: / Рядок 1: @@
 ====== Інтеграція з CRM Bitrix24 ======
-//
-Доступна починаючи з Ubilling 1.3.8 rev 8872//
+Доступна починаючи з Ubilling 1.3.8 rev 8872. Експортує всіляке різне.
+====== Експорт стану абонбази ======
 Вмикається та керується наступними опціями конфігу [[alteriniconf|alter.ini]]:
@@ Рядок 54: / Рядок 59: @@
 Що повинно виглядати якось так:
-{{::btrx24json2.png?800|}}
+{{:btrx24json2.png|}}
@@ Рядок 67: / Рядок 72: @@
 ====== Експорт опитувань ======
-Доступний починаючи з Ubilling 1.3.9 rev 8907.
+Доступний починаючи з Ubilling 1.3.9 rev 8909. Вміє окремо надсилати наявні опитування користувачів та їх результати до CRM. Керується наступними двома опціями конфігу alter.ini (також вимагає ввімкненої опції BTRX24_ENABLED):
+<code ini>
+;URL скрипта для експорту даних опитувань та їх результатів
+BTRX24_POLLS_URL="http://127.0.0.1/dev/post_debug.php"
+;Ім`я POST змінної, в якій буде експортовано дані про опитування
+BTRX24_POLLS_VAR="pollsupdtd"
+</code>
+Дані надсилаються методом POST у вигляді JSON, що вміщує наступну структуру:
+<code>
+Array
+(
+    [poll_id(int)] => Array
+        (
+            [id] => existing poll ID (int)
+            [title] => existing poll title(string)
+            [enabled] => 1/0 enabled flag(int)
+            [votes] => Array
+                (
+                    [0] => Array
+                        (
+                            [login] => userlogin1(string)
+                            [vote] => vote option text(string)
+                            [option_id] => vote option id(int)
+                            [address] => userlogin1 address(string)
+                            [date] => voting time Y-m-d H:i:s(string)
+                        )
+                         [1] => Array
+                        (
+                            [login] => userlogin1(string)
+                            [vote] => vote option text(string)
+                            [option_id] => vote option id(int)
+                            [address] => userlogin1 address(string)
+                            [date] => voting time Y-m-d H:i:s(string)
+                        )
+                )
+        )
+</code>
+що на практиці, виглядає якось наступним чином:
+{{:btrxpollsexport.png|}}
+в секції **votes** знаходиться масив голосів користувачів в рамках конкретного опитування, за поточну добу.
+надсилання даних відбувається за допомогою окремого виклику RemoteAPI - **btrxpolls** раз на добу
+<file bash crontab>
+23 * * *     /bin/ubapi "btrxpolls"
+</file>
+Вищевказані дані будуть надіслані для опитувань, що відповідають наступним критеріям:
+  * Активних (з галочкою "Включений") опитувань
+  * З типом "голосують користувачі"
+  * Поточна дата й час виклику експорту, знаходиться між датами початку та кінця опитування
+  * Для котрих **за поточну добу** здійснено хоча б один голос користувачами