База знаний АО АСП

Пример пакетов сборка: различия между версиями

← Предыдущая правка
ВизуальныйВики-текст
Нет описания правки
Нет описания правки
 
(не показано 5 промежуточных версий этого же участника)
Строка 1: Строка 1:
====== Универсальный обмен данными с АСП.Склад WMS ======
= Универсальный обмен данными с АСП.Склад WMS =
* Отправка идёт по HTTP протоколу по персональному адресу на http://gateway.aspcom.ru/имя_базы/ws/DataExchange.1cws.
* Для отправки используется WSDL протокол, который позволяется обмениваться пакетами данным в формате XML. <syntaxhighlight lang='bash'>
Пример описания данных: http:
</syntaxhighlight>gateway.aspcom.ru/pa6/ws/DataExchange.1cws?wsdl //
* Заголовки HTTP запроса:
* Authorization: Basic - логин и пароль на уровне базовой авторизации
* SOAPAction: http://gateway.aspcom.ru#DataExchange:'''КомандаЗапроса'''


===== Пример использования =====
== Общая информация ==
* Отправка данных осуществляется по HTTP протоколу по персональному адресу: <code>http://gateway.aspcom.ru/имя_базы/ws/DataExchange.1cws</code>
* Для отправки используется WSDL протокол, позволяющий обмениваться пакетами данных в формате XML
* Пример описания данных: <code>http://gateway.aspcom.ru/pa6/ws/DataExchange.1cws?wsdl</code>
 
== Заголовки HTTP запроса ==
* <code>Authorization: Basic</code> - логин и пароль на уровне базовой авторизации
* <code>SOAPAction: http://gateway.aspcom.ru#DataExchange:'''КомандаЗапроса'''</code>
 
== Пример использования ==
 
Наглядный пример XML запросов и ответов можно посмотреть здесь: [[описание_сервисов_сборка]].
 
Для отправки запросов через HTTP может использоваться утилита [https://bintray.com/artifact/download/vszakats/generic/curl-7.57.0-win32-mingw.7z curl32] [[File:curl-7.40.0-win64.msi.7z]].
 
=== Пример создания номенклатуры ===


Наглядный пример XML запросов и ответов можно [[File:описание_сервисов_сборка]].<br/>Например, для отправки запросов через HTTP может использоваться утилита [https://bintray.com/artifact/download/vszakats/generic/curl-7.57.0-win32-mingw.7z curl32] [[File:curl-7.40.0-win64.msi.7z]].<br/>Так, допустим мы хотим создать номенклатуру на сборке/
{| class="wikitable"
{| class="wikitable"
|-
|-
|
! Параметр !! Значение !! Описание
| 1. База называется "pa6".
| Имя, указанное при [[1_основная_инструкция:3_асп.шлюз:1_интеграция:4_публикация_конфигурации|публикации базы АСП.Склад WMS на веб сервере]].
|
|-
|-
|
| 1. Имя базы || "pa6" || Имя, указанное при [[5_асп.шлюз:1_интеграция:4_публикация_конфигурации|публикации базы АСП.Склад WMS на веб сервере]]
| 2. Имя пользователя "admin".
| Логин пользователя 1С для входа в АСП.Склад WMS.
|
|-
|-
|
| 2. Имя пользователя || "admin" || Логин пользователя 1С для входа в АСП.Склад WMS
| 3. Пароль "admin".
| Пароль пользователя 1С для входа в АСП.Склад WMS.
|
|-
|-
|
| 3. Пароль || "admin" || Пароль пользователя 1С для входа в АСП.Склад WMS
| 4. Подключаемся через шлюз "http://gateway.aspcom.ru".
| Адрес сервера, на котором выполнена публикация Шлюза.
|
|-
|-
|
| 4. Адрес шлюза || "http://gateway.aspcom.ru" || Адрес сервера, на котором выполнена публикация Шлюза
| 5. Команда: "СоздатьНоменклатуру".
|-
| Список всех возможных операций можно можно увидеть, перейдя по [[3_сборка:сборка_выгрузка:описание_сервисов_сборка|ссылке]].
| 5. Команда || "СоздатьНоменклатуру" || Список всех возможных операций можно увидеть, перейдя по [[3_асп.склад_wms:сборка_выгрузка:описание_сервисов_сборка|ссылке]]
|
|}
|}


Подробное описание доступных операций [[3_сборка:сборка_выгрузка:описание_сервисов_сборка|можно посмотреть тут]]. |
'''Дополнительная информация:'''
Подробное описание типов объектов [[3_сборка:сборка_выгрузка:описание_типов_сборка|можно посмотреть тут]].
* Подробное описание доступных операций [[3_асп.склад_wms:сборка_выгрузка:описание_сервисов_сборка|можно посмотреть тут]]
* Подробное описание типов объектов [[3_асп.склад_wms:сборка_выгрузка:описание_типов_сборка|можно посмотреть тут]]
 
=== Подготовка XML запроса ===
 
<source lang="xml">
<soap-env:Envelope xmlns:soap-env="http://schemas.xmlsoap.org/soap/envelope/">
<soap-env:Body>
<ns0:СоздатьНоменклатуру xmlns:ns0="http://gateway.aspcom.ru">
<ns0:Номенклатура>
    <ns0:Код>test_0002695</ns0:Код>
    <!--<ns0:КодЗагрузки></ns0:КодЗагрузки>-->
    <ns0:Наименование>Тест номенклатура</ns0:Наименование>
    <ns0:НаименованиеПолное>Полное наименование тестовой номенклатуры</ns0:НаименованиеПолное>
    <ns0:ЕдиницаИзмерения>
        <ns0:Код>test_002695</ns0:Код>
        <ns0:Наименование>тШтука</ns0:Наименование>
        <ns0:Коэффициент>1</ns0:Коэффициент>
        <!--<ns0:КодЗагрузки>С0000002695</ns0:КодЗагрузки>-->
        <ns0:Основная>true</ns0:Основная>
    </ns0:ЕдиницаИзмерения>
    <ns0:GTIN>12345678987654</ns0:GTIN>
    <ns0:ШтрихКод>1122332211</ns0:ШтрихКод>
    <ns0:Артикул>01001001</ns0:Артикул>
    <ns0:Весовой>false</ns0:Весовой>
</ns0:Номенклатура>
</ns0:СоздатьНоменклатуру>
</soap-env:Body>
</soap-env:Envelope>
</source>
 
=== Выполнение команды curl ===
 
<source lang="bash">
curl -H "SOAPAction: \"http://gateway.aspcom.ru#DataExchange:СоздатьНоменклатуру\"" \
    --data @request.xml \
    --user admin:admin \
    http://gateway.aspcom.ru/pa6/ws/DataExchange.1cws \
    -o response.xml
</source>


Подготавливаем XML запрос:
=== Результат выполнения ===
<file xml request.xml>
    <soap-env:Envelope xmlns:soap-env="http://schemas.xmlsoap.org/soap/envelope/">
        <soap-env:Body>
            <ns0:СоздатьНоменклатуру xmlns:ns0="http://gateway.aspcom.ru">
                <ns0:Номенклатура>
    <ns0:Код>test_0002695</ns0:Код> <!--Если выгрузка номенклатуры в сборку осуществлялась по коду-->
    <!--<ns0:КодЗагрузки></ns0:КодЗагрузки>-->  <!--Если выгрузка номенклатуры в сборку осуществлялась по ПОЛНОМУ коду-->
    <ns0:Наименование>Тест номенклатура</ns0:Наименование>
    <ns0:НаименованиеПолное>Полное наименование тестовой номенклатуры</ns0:НаименованиеПолное>
    <ns0:ЕдиницаИзмерения>
    <ns0:Код>test_002695</ns0:Код>
    <ns0:Наименование>тШтука</ns0:Наименование>
    <ns0:Коэффициент>1</ns0:Коэффициент>
    <!--<ns0:КодЗагрузки>С0000002695</ns0:КодЗагрузки>-->
    <ns0:Основная>true</ns0:Основная>
    </ns0:ЕдиницаИзмерения>
    <ns0:GTIN>12345678987654</ns0:GTIN>
    <ns0:ШтрихКод>1122332211</ns0:ШтрихКод>
    <ns0:Артикул>01001001</ns0:Артикул>
    <ns0:Весовой>false</ns0:Весовой>
    </ns0:Номенклатура>
            </ns0:СоздатьНоменклатуру>
        </soap-env:Body>
    </soap-env:Envelope>


<source lang="xml">
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
    <soap:Body>
        <m:СоздатьНоменклатуруResponse xmlns:m="http://gateway.aspcom.ru">
            <m:return xmlns:xs="http://www.w3.org/2001/XMLSchema"
                    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
                Номенклатура загружена: Тест номенклатура
            </m:return>
        </m:СоздатьНоменклатуруResponse>
    </soap:Body>
</soap:Envelope>
</source>
== Детальный разбор команды curl ==
[[File:описание_курл.png]]
# Используемое пространство имен / имя пакета web-сервисов (неизменяемая часть)
# Имя выполняемой операции из списка [[3_асп.склад_wms:сборка_выгрузка:описание_сервисов_сборка|возможных операций]]
# Ключ для указания добавляемых данных HTTP запроса или файла (@file) передаваемого POST-запросом
# Путь к XML-файлу, содержащему текст выполняемой операции (относительный или абсолютный)
# Имя пользователя : Пароль пользователя 1С:Предприятия для аутентификации в АСП.Склад WMS
# Адрес сервера публикации АСП.Склад WMS
# Имя публикации информационной базы, указанное при публикации
# Адрес web-сервисов (неизменяемая часть)
# Путь к XML-файлу для записи результата выполнения операции (относительный или абсолютный)


</file>
Выполняем команду '''curl''':
<syntaxhighlight lang="bash">
curl -H "SOAPAction: \"http:<syntaxhighlight lang='bash'>
gateway.aspcom.ru#DataExchange:СоздатьНоменклатуру<br/>"" --data @request.xml --user admin:admin http:
</syntaxhighlight>gateway.aspcom.ru/pa6/ws/DataExchange.1cws -o response.xml
</syntaxhighlight>
В результате получаем файл:
<file xml response.xml>
    <soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
    <soap:Body>
    <m:СоздатьНоменклатуруResponse xmlns:m="http://gateway.aspcom.ru">
    <m:return xmlns:xs="http://www.w3.org/2001/XMLSchema"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">Номенклатура загружена: Тест номенклатура</m:return>
    </m:СоздатьНоменклатуруResponse>
    </soap:Body>
    </soap:Envelope>
</file>
|
==Выполним детальный разбор команды curl:==
[[File:описание_курл.png]] 
  - Используемое пространство имен / имя пакета web-сервисов. Данная часть запроса остается неизменной.
  - Имя выполняемой операции из списка [[3_сборка:сборка_выгрузка:описание_сервисов_сборка|возможных операций]].
  - Ключ, после которого указываются добавляемые данные http запроса или файл (@file) передаваемый POST-запросом.
  - Путь к xml-файлу, содержащему текст выполняемой операции. Можно указывать относительный или абсолютный путь.
  - Имя пользователя : Пароль пользователя 1С:Предприятия, которые используются для аутентификации в программе АСП.Склад WMS.
  - Адрес сервера, на котором выполнена публикация АСП.Склад WMS.
  - Имя публикации информационной базы, указанное при публикации базы АСП.Склад WMS на веб сервере.
  - Адрес web-сервисов. Данная часть запроса остается неизменной.
  - Путь к xml-файлу, в который будет записан результат выполнения операции в АСП.Склад WMS. Можно указывать относительный или абсолютный путь.
[[Category:сборка выгрузка]]
[[Category:сборка выгрузка]]
 
[[Тег::WMS]]
<vote type=1 />
<vote type=1 />
Источник — https://pub.aoasp.ru/Пример_пакетов_сборка