Различия

Показаны различия между двумя версиями страницы.

--- egais3terminal:support:dump [2018/11/10 09:31] – [Входящие данные] kuld
+++ egais3terminal:support:dump [2020/12/01 09:28] (текущий) – [Входящие данные] kuld
@@ Строка 3: / Строка 3: @@
 В процессе промышленной эксплуатации программно-аппаратного комплекса КТ:Маркировка могут возникать инциденты, для решения кторых службе технической поддержки требуется проанализировать входящие и исходящие данные приложения.
-<note>В подавляющем большинстве случаев причина инцидентов - расхождения учётных данных и реальных складских остатков. Перед обращением в службу технической поддержки удостоверьтесь, что учётные остатки в Вашей информационной базе 1С соответствуют реальным остаткам на складе.</note>
+<note>В подавляющем большинстве случаев причина инцидентов -- расхождения учётных данных и реальных складских остатков. Перед обращением в службу технической поддержки удостоверьтесь, что учётные остатки в Вашей информационной базе 1С соответствуют реальным остаткам на складе.</note>
-В этом разделе показано как получить дамп входящих и исходящих данных для последующей передачи полученных данных в службу технической поддержки. Описание адресовано специалистам с минимальными навыками системного администрирования.
+В этом разделе показано как получить дамп входящих и исходящих данных для последующей передачи в службу технической поддержки. Описание адресовано специалистам с минимальными навыками системного администрирования.
 ===== Входящие данные =====
-Входящие данные передаются от Вашей информационной базы 1С:Предприятие через REST интерфейс. Для получения дампа Вам потребуется REST клиент. Ставить специализированное программное обеспечение для отладки REST интерфейсов не обязательно, достаточно установить специальное расширение в Ваш браузер, например, [[https://addons.mozilla.org/en-US/firefox/addon/rester/|RESTer для Firefox]] или [[https://chrome.google.com/webstore/detail/restlet-client-rest-api-t/aejoelaoggembcahagimdiliamlcdmfm|Restlet Client для Chrome]].
+Входящие данные передаются от Вашей информационной базы 1С:Предприятие через REST интерфейс. Для получения дампа Вам потребуется REST клиент. Ставить специализированное программное обеспечение для отладки REST интерфейсов не обязательно, достаточно установить специальное расширение в Ваш браузер, например, [[https://addons.mozilla.org/en-US/firefox/addon/rester/|RESTer для Firefox]] или [[https://chrome.google.com/webstore/detail/restlet-client-rest-api-t/aejoelaoggembcahagimdiliamlcdmfm|Talend API Tester для Chrome]].
 После установки расширения в браузер первым делом нужно получить URL задания, которое требуется записать в дамп. Он содержится в ответе на запрос [[egais3terminal:quickstart#настройка_подключения_тсд_к_1с|списка заданий]].
+{{ :egais3terminal:support:rest_getjoblist.png?nolink |}}
 Настройте REST клиент на тот же тип авторизации, логин и пароль, что и в приложение КТ:Маркировка. Сделайте запрос GET по URL списка заданий. В ответ Вы получите JSON массив такого формата
@@ Строка 26: / Строка 28: @@
         "jobComment": "Палетирование продукции на автоматической линии №13",
         "jobUrl": "http://192.168.1.59/lineris/hs/api/v1/0004342"
-      },
-      {
-        "jobType": 10,
-        "jobComment": "Добавление позиций. Тест",
-        "jobUrl": "http://192.168.1.59/lineris/hs/api/v1/0004239"
       }
     ]
 </code>
-Поле ''jobUrl'' соответствующего элемента и есть искомый URL.
+Поле ''jobUrl'' соответствующего элемента и есть искомый URL. С теми же параметрами авторизации сделайте к нему GET запрос. В ответ Вы получите JSON объект примерно такого формата:
+<spoiler|Дамп>
+<code java>
+{
+    "jobType": 6,
+    "comment": "Переупаковка продукции на складе",
+    "callBack": [
+        {
+            "url": "http://192.168.1.5:8080/test",
+            "priority": 0
+        },
+        {
+            "url": "https://lineris.ru/api/v2/test",
+            "priority": 1
+        }
+    ],
+    "products": [
+        {
+            "productId": "2900000005686",
+            "productName": "Водка \"Заветы Кузьмича\"",
+            "productQuantity": 18,
+            "productPack": 6,
+            "productMarks": [
+                "22N000008XSG44YGEUT0P7T70424001003452JZKW012VT5XOLTCW4IJ9VGEOP12FTBX",
+                "22N000008XSG44YGEUT0P7T70424001003462JZKW012VT5XOLTCW4IJ9VGEOP12FTBX",
+                "22N000008XSG44YGEUT0P7T70424001003472JZKW012VT5XOLTCW4IJ9VGEOP12FTBX",
+                "22N000008XSG44YGEUT0P7T70424001003482JZKW012VT5XOLTCW4IJ9VGEOP12FTBX",
+                "22N000008XSG44YGEUT0P7T70424001003502JZKW012VT5XOLTCW4IJ9VGEOP12FTBX",
+                "22N000008XSG44YGEUT0P7T70424001003512JZKW012VT5XOLTCW4IJ9VGEOP12FTBX",
+                "22N000008XSG44YGEUT0P7T70424001003522JZKW012VT5XOLTCW4IJ9VGEOP12FTBX",
+                "22N000008XSG44YGEUT0P7T70424001003532JZKW012VT5XOLTCW4IJ9VGEOP12FTBX",
+                "22N000008XSG44YGEUT0P7T70424001003542JZKW012VT5XOLTCW4IJ9VGEOP12FTBX",
+                "22N000008XSG44YGEUT0P7T70424001003552JZKW012VT5XOLTCW4IJ9VGEOP12FTBX",
+                "22N000008XSG44YGEUT0P7T70424001003562JZKW012VT5XOLTCW4IJ9VGEOP12FTBX",
+                "22N000008XSG44YGEUT0P7T70424001003572JZKW012VT5XOLTCW4IJ9VGEOP12FTBX",
+                "22N000008XSG44YGEUT0P7T70424001003582JZKW012VT5XOLTCW4IJ9VGEOP12FTBX",
+                "22N000008XSG44YGEUT0P7T70424001003592JZKW012VT5XOLTCW4IJ9VGEOP12FTBX",
+                "22N000008XSG44YGEUT0P7T70424001003602JZKW012VT5XOLTCW4IJ9VGEOP12FTBX",
+                "22N000008XSG44YGEUT0P7T70424001003632JZKW012VT5XOLTCW4IJ9VGEOP12FTBX",
+                "22N000008XSG44YGEUT0P7T70424001003942JZKW012VT5XOLTCW4IJ9VGEOP12FTBX",
+                "22N000008XSG44YGEUT0P7T70424001006364JZKW012VT5XOLTCW4IJ9VGEOP14FTBX"
+            ]
+        }
+    ],
+    "topPacks": [
+        {
+            "topРackId": "123456789012345678",
+            "topPackName": "Палета 1",
+            "packsId": [
+                "12345678901204567890123456",
+                "12345678901214567890123456",
+                "12345678901224567890123456",
+                "12345678901234563890123456"
+            ]
+        },
+        {
+            "topРackId": "123456789012343678",
+            "topPackName": "Палета 2",
+            "packsId": []
+        }
+    ],
+    "packs": [
+        {
+            "packId": "12345678901204567890123456",
+            "packName": "Короб 1",
+            "productMarks": [
+                "22N000008XSG44YGEUT0P7T70424001003452JZKW012VT5XOLTCW4IJ9VGEOP12FTBX",
+                "22N000008XSG44YGEUT0P7T70424001003462JZKW012VT5XOLTCW4IJ9VGEOP12FTBX",
+                "22N000008XSG44YGEUT0P7T70424001003472JZKW012VT5XOLTCW4IJ9VGEOP12FTBX",
+                "22N000008XSG44YGEUT0P7T70424001003482JZKW012VT5XOLTCW4IJ9VGEOP12FTBX",
+                "22N000008XSG44YGEUT0P7T70424001003502JZKW012VT5XOLTCW4IJ9VGEOP12FTBX"
+            ]
+        },
+        {
+            "packId": "12345678901214567890123456",
+            "packName": "Короб 2",
+            "productMarks": [
+                "22N000008XSG44YGEUT0P7T70424001003512JZKW012VT5XOLTCW4IJ9VGEOP12FTBX",
+                "22N000008XSG44YGEUT0P7T70424001003522JZKW012VT5XOLTCW4IJ9VGEOP12FTBX",
+                "22N000008XSG44YGEUT0P7T70424001003532JZKW012VT5XOLTCW4IJ9VGEOP12FTBX",
+                "22N000008XSG44YGEUT0P7T70424001003542JZKW012VT5XOLTCW4IJ9VGEOP12FTBX"
+            ]
+        },
+        {
+            "packId": "12345678901224567890123456",
+            "packName": "Короб 3",
+            "productMarks": [
+                "22N000008XSG44YGEUT0P7T70424001003552JZKW012VT5XOLTCW4IJ9VGEOP12FTBX",
+                "22N000008XSG44YGEUT0P7T70424001003562JZKW012VT5XOLTCW4IJ9VGEOP12FTBX",
+                "22N000008XSG44YGEUT0P7T70424001003572JZKW012VT5XOLTCW4IJ9VGEOP12FTBX",
+                "22N000008XSG44YGEUT0P7T70424001003582JZKW012VT5XOLTCW4IJ9VGEOP12FTBX",
+                "22N000008XSG44YGEUT0P7T70424001003592JZKW012VT5XOLTCW4IJ9VGEOP12FTBX"
+            ]
+        },
+        {
+            "packId": "12345678901234563890123456",
+            "packName": "Короб 4",
+            "productMarks": [
+                "22N000008XSG44YGEUT0P7T70424001003602JZKW012VT5XOLTCW4IJ9VGEOP12FTBX",
+                "22N000008XSG44YGEUT0P7T70424001003632JZKW012VT5XOLTCW4IJ9VGEOP12FTBX",
+                "22N000008XSG44YGEUT0P7T70424001003942JZKW012VT5XOLTCW4IJ9VGEOP12FTBX",
+                "22N000008XSG44YGEUT0P7T70424001006364JZKW012VT5XOLTCW4IJ9VGEOP14FTBX"
+            ]
+        }
+    ]
+}
+</code>
+</spoiler>
+Это именно то, что нужно службе технической поддержки для решения Вашего инцидента. Сохраните ответ в текстовый файл с расширением ''.json'', запакуйте его в архив, например, zip или rar и отправьте специалисту технической поддержки.
+<note important>Обязательно запакуйте файл в архив, даже если он небольшого размера</note>
+Если задание очень большое (10000 марок и более) задание разбивается на несколько блоков, т.н. //chunks//.
+Обратите внимание на начало дампа, поля JSON объекта:
+  "nexturl": "http://192.168.0.8/lvz_base/hs/api/v1/getjob/000000026/2",
+  "totalChunks": 11,
+  "chunk": 1,
+Поле ''nexturl'' сдержит ссылку на следующий блок, в поле ''totalChunks'' указано общее количество блоков, а поле ''chunk'' указывает порядковый номер полученного блока.
+Переходите по ссылкам, указанным в поле ''nexturl'' и сохраняйте полученные дампы в отдельных файлах. Запакуйте все файлы в архив и передайте нашей службе технической поддержки для анализа.
 ===== Исходящие данные =====
+Что бы получить дамп исходящих данных перед завершением выполнения и отправкой результатов в товароучетную систему откройте меню **Настройки** мобильного приложения, зайдите в раздел **Поддержка** и выберите пункт **Дамп задания** (в версиях до 1213 в меню мобильного приложения и выберите пункт **Задание в файл**).
+<note tip>
+Рекомендуется предварительно настроить на ТСД его штатный клиент электронной почты и подключить ТСД к Интернет. Тогда Вы сразу сможете отправить дамп в службу технической поддержки. Не забудьте в письме указать к какому номеру обращения он относится.
+</note>
+{{ :egais3terminal:support:dump-out.png?400 |}}
+Будет сформирован точно такой же JSON, как и тот, что возвращается в товароучетную систему по REST API протоколу. Объект сохраняется в ''.json'' файл и вызывается стандартная для Android активность //"Поделиться"//, где Вы можете отправить файл с устройства любым сервисом, установленном на ТСД, например, по электронной почте, через Bluetooth на ПК или через файловый менеджер по локальной сети.