====== Дамп данных ======

В процессе промышленной эксплуатации программно-аппаратного комплекса КТ:Маркировка могут возникать инциденты, для решения кторых службе технической поддержки требуется проанализировать входящие и исходящие данные приложения.

<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|Talend API Tester для Chrome]].

После установки расширения в браузер первым делом нужно получить URL задания, которое требуется записать в дамп. Он содержится в ответе на запрос [[egais3terminal:quickstart#настройка_подключения_тсд_к_1с|списка заданий]].

{{ :egais3terminal:support:rest_getjoblist.png?nolink |}}

Настройте REST клиент на тот же тип авторизации, логин и пароль, что и в приложение КТ:Маркировка. Сделайте запрос GET по URL списка заданий. В ответ Вы получите JSON массив такого формата 

<code java>
    [
      {
        "jobType": 0,
        "jobComment": "Линия №3 смена 10.05.2018 Кладовщик Иванов И.И.",
        "jobUrl": "http://192.168.1.59/lineris/hs/api/v1/0004234"
      },
      {
        "jobType": 7,
        "jobComment": "Палетирование продукции на автоматической линии №13",
        "jobUrl": "http://192.168.1.59/lineris/hs/api/v1/0004342"
      }
    ]   
</code>

Поле ''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 на ПК или через файловый менеджер по локальной сети.