Инструкции по развертыванию — различия между версиями

Материал из ANT-Inform documentation
Перейти к: навигация, поиск
(Initial rewrite from http://ant-ais.ru/Ascug_ws.readme.htm)
 
 
(не показано 14 промежуточных версий 4 участников)
Строка 1: Строка 1:
 
== Обновление конфигурации АИС ==
 
== Обновление конфигурации АИС ==
  
−
Из предложенного на сайте файла конфигурации (.cf), в режиме сравнения и обновления конфигураций требуется перенести полностью только следующие объекты:  
+
Из предложенного на сайте файла конфигурации (.cf), в режиме сравнения и объединения конфигураций требуется перенести полностью только следующие объекты:  
−
'''Общие -> Пакеты XDTO -> ASCUG'''
+
* '''Общие -> Пакеты XDTO -> ASCUG'''
−
'''Общие -> Web-сервисы -> ASCUG'''
+
* '''Общие -> Web-сервисы -> ASCUG'''
  
 
{{ ambox | type = warning | text = Пожалуйста, даже если остальные объекты изменены относительно вашей конфигурации, и о них не было специально заявлено, не надо обновлять их - такие изменения не поддерживаются }}
 
{{ ambox | type = warning | text = Пожалуйста, даже если остальные объекты изменены относительно вашей конфигурации, и о них не было специально заявлено, не надо обновлять их - такие изменения не поддерживаются }}
Строка 11: Строка 11:
 
== Публикация Веб-сервиса ASCUG ==
 
== Публикация Веб-сервиса ASCUG ==
  
−
Здесь мы уже предполагаем что вы определились с выбором ВЕБ-сервра и настроили его. Если нет, самое время [[настройка Веб-сервера|сделать это]].
+
Здесь мы уже предполагаем что вы определились с выбором Веб-сервера и настроили его. Если нет, самое время [[настройка Веб-сервера|сделать это]].
  
−
Наиболее рекомендуемым является способ стандартной публикации сервиса из конфигуратора 1С. Делается это из меню "Администрирование", "Публикация Web-сервисов". Там нужно выбрать директорию, корня (DOCUMENT_ROOT) ВЕБ-сервера (мы рекомендуем свободный [http://httpd.apache.org/|Apache] с модулем 1С<ref>Компонент "Расширения Веб-сервисов" входит в стандартный дистрибутив 1С платформы</ref>).
+
Наиболее рекомендуемым является способ стандартной публикации сервиса из конфигуратора 1С. Делается это из меню "Администрирование", "Публикация Web-сервисов". Там нужно выбрать директорию, корня (DOCUMENT_ROOT) ВЕБ-сервера (мы рекомендуем свободный [http://httpd.apache.org/ Apache] с модулем 1С<ref>Компонент "Расширения Веб-сервисов" входит в стандартный дистрибутив 1С платформы</ref>).
  
 
{{ ambox | text = В подавляющем большинстве случаев не требуется больше никаких настроек! }}
 
{{ ambox | text = В подавляющем большинстве случаев не требуется больше никаких настроек! }}
Строка 20: Строка 20:
 
<source lang="xml">
 
<source lang="xml">
 
<?xml version="1.0" encoding="UTF-8"?>
 
<?xml version="1.0" encoding="UTF-8"?>
−
<service namespace="http://spb.ant-inform.ru/ASCUG" name="ASCUG" connectString="Srvr=&quot;ServerHost&quot;;Ref=&quot;DataBaseName&quot;;;Usr=&quot;UserOfWebService&quot;;Pwd=&quot;Password&quot;"/>
+
<service
 +
namespace="http://spb.ant-inform.ru/ASCUG"
 +
name="ASCUG"
 +
connectString="Srvr=&quot;ServerHost&quot;;Ref=&quot;DataBaseName&quot;;;Usr=&quot;UserOfWebService&quot;;Pwd=&quot;Password&quot;"/>
 
</source>
 
</source>
 +
 +
{{ ambox | text = В версии 1С 8.3 отдельно файл ascug.1cws не создается. Информация об опубликованном веб-сервисе типа:
 +
<source lang="xml">
 +
<ws>
 +
<point name="ASCUG"
 +
alias="ascug.1cws"
 +
enable="true"/>
 +
</ws>
 +
</source>
 +
прописывается в файле default.vrd}}
  
 
Если имеется необходимость, можно внести изменения в представленные значения: ServerHost, DataBaseName, UserOfWebService, Password.
 
Если имеется необходимость, можно внести изменения в представленные значения: ServerHost, DataBaseName, UserOfWebService, Password.
Строка 27: Строка 40:
 
== Как убедиться что все настроено и функционирует правильно ==
 
== Как убедиться что все настроено и функционирует правильно ==
  
−
Вы заходите по опубликованному [http://ru.wikipedia.org/wiki/URL|URL] локально браузером - видите ссылку. Переходите по ней, и должны увидеть запрос логина и пароля. Вводите логин и пароль учетной записи 1С которые планируете предоставить нам. После этого должен будет отобразиться достаточно объемный WSDL (XML) документ. Если он, а не любого рода ошибка - значит всё работает.
+
Вы заходите по опубликованному [http://ru.wikipedia.org/wiki/URL URL] локально браузером - видите ссылку. Переходите по ней, и должны увидеть запрос логина и пароля. Вводите логин и пароль учетной записи 1С которые планируете предоставить нам. После этого должен будет отобразиться достаточно объемный WSDL (XML) документ. Если он, а не любого рода ошибка - значит всё работает.
  
−
'''После этого предоставьте нам [http://ru.wikipedia.org/wiki/URL|URL]''' опубликованного Веб-сервиса (вида http://example.com/ascug.1cws или http://192.168.72.55/ascug/ascug.1cws) и логин-пароль для его использования.
+
'''После этого предоставьте нам [http://ru.wikipedia.org/wiki/URL URL]''' опубликованного Веб-сервиса (вида http://example.com/ascug.1cws или http://192.168.72.55/ascug/ascug.1cws) и логин-пароль для его использования.
  
 +
{{ ambox | text = В версии 1С 8.3 url опубликованного веб-сервиса выглядит http://example.com/ws/ascug.1cws}}
 +
 +
== Пример, как формировать url по файлу default.vrd ==
 +
Пример:
 +
<source lang="xml">
 +
<?xml version="1.0" encoding="UTF-8"?>
 +
<point xmlns="http://v8.1c.ru/8.2/virtual-resource-system"
 +
xmlns:xs="http://www.w3.org/2001/XMLSchema"
 +
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
 +
base="/kursk_83"
 +
ib="Srvr=&quot;10.78.101.20&quot;;Ref=&quot;kursk_83&quot;;"
 +
enableStandardOData="true">
 +
<ws>
 +
<point name="ASKUG"
 +
alias="askug.1cws"
 +
enable="false"/>
 +
<point name="DataExchange"
 +
alias="dataexchange.1cws"
 +
enable="true"/>
 +
<point name="Consumer"
 +
alias="consumer.1cws"
 +
enable="true"/>
 +
<point name="ASCUG"
 +
alias="ascug.1cws"
 +
enable="true"/>
 +
</ws>
 +
</point>
 +
 +
</source>
 +
 +
Url будет выглядеть следующим образом:
 +
 +
* Ip сервера (Srvr="10.78.101.20")
 +
* Название таблицы (base="/kursk_83")
 +
* Папка ws (<ws>)
 +
* Имя базы (ascug.1cws)
 +
 +
[[''url=http://10.78.101.20/kursk_83/ws/ascug.1cws'']]
 +
 +
=== Проверка версии установленного Веб-сервиса ===
 +
 +
Чтобы узнать номер версии установленного Веб-сервиса, необходимо в браузере ввести URL, затем логин и пароль в появившемся окне. После этого должен будет отобразиться достаточно объемный WSDL (XML) документ, необходимо воспользоваться контекстным поиском по слову "version".
 +
 +
[[Файл:WebServiceVersionFromWsdl.png]]
 +
 +
== Переход с платформы 1С версии 8.2 на 8.3 ==
 +
 +
Мы поддерживаем обе версии платформ.
 +
 +
В общем процедура развёртывания и публикации практически такая же. Но если вы переходите и прежде уже всё было настроено, вам надо совсем не многое:
 +
* В файле настроек Апача (httpd.conf) скорректировать путь к файлу wsap22.dll соответствующей версии. Перезапустить службу.
 +
* В файле публикации, URL к которому вы давали нам ранее (ascug.1cws) изменить хост и/или имя базы, если они у вас изменились.
 +
 +
Перепубликация не требуется.
  
 
----
 
----
 +
 
== Примечания ==
 
== Примечания ==
 
<references/>
 
<references/>

Текущая версия на 10:01, 4 декабря 2017

Обновление конфигурации АИС

Из предложенного на сайте файла конфигурации (.cf), в режиме сравнения и объединения конфигураций требуется перенести полностью только следующие объекты:

  • Общие -> Пакеты XDTO -> ASCUG
  • Общие -> Web-сервисы -> ASCUG
Пожалуйста, даже если остальные объекты изменены относительно вашей конфигурации, и о них не было специально заявлено, не надо обновлять их - такие изменения не поддерживаются
ВНИМАНИЕ! Если осуществляется обновление, сначала удалите оба этих элемента из БД, сохраните изменения (F7) и только затем произведите новый импорт из файла с нужной версией. В обратном случае могут быть странные, трудноуловимые проблемы

Публикация Веб-сервиса ASCUG

Здесь мы уже предполагаем что вы определились с выбором Веб-сервера и настроили его. Если нет, самое время сделать это.

Наиболее рекомендуемым является способ стандартной публикации сервиса из конфигуратора 1С. Делается это из меню "Администрирование", "Публикация Web-сервисов". Там нужно выбрать директорию, корня (DOCUMENT_ROOT) ВЕБ-сервера (мы рекомендуем свободный Apache с модулем 1С[1]).

В подавляющем большинстве случаев не требуется больше никаких настроек!

Если что-то пошло не так, или вы хотите иметь полный доступ к имеющимся настройкам, можно отредактировать результирующий файл (по умолчанию это ascug.1cws) в текстовом редакторе. Его содержание должно быть приблизительно следующим: 

<?xml version="1.0" encoding="UTF-8"?>
<service
 namespace="http://spb.ant-inform.ru/ASCUG"
 name="ASCUG"
 connectString="Srvr=&quot;ServerHost&quot;;Ref=&quot;DataBaseName&quot;;;Usr=&quot;UserOfWebService&quot;;Pwd=&quot;Password&quot;"/>
В версии 1С 8.3 отдельно файл ascug.1cws не создается. Информация об опубликованном веб-сервисе типа: 
<ws>
<point name="ASCUG"
alias="ascug.1cws"
enable="true"/>
</ws>
прописывается в файле default.vrd

Если имеется необходимость, можно внести изменения в представленные значения: ServerHost, DataBaseName, UserOfWebService, Password.

Как убедиться что все настроено и функционирует правильно

Вы заходите по опубликованному URL локально браузером - видите ссылку. Переходите по ней, и должны увидеть запрос логина и пароля. Вводите логин и пароль учетной записи 1С которые планируете предоставить нам. После этого должен будет отобразиться достаточно объемный WSDL (XML) документ. Если он, а не любого рода ошибка - значит всё работает.

После этого предоставьте нам URL опубликованного Веб-сервиса (вида http://example.com/ascug.1cws или http://192.168.72.55/ascug/ascug.1cws) и логин-пароль для его использования.

В версии 1С 8.3 url опубликованного веб-сервиса выглядит http://example.com/ws/ascug.1cws

Пример, как формировать url по файлу default.vrd

Пример: 

<?xml version="1.0" encoding="UTF-8"?>
<point xmlns="http://v8.1c.ru/8.2/virtual-resource-system"
		xmlns:xs="http://www.w3.org/2001/XMLSchema"
		xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
		base="/kursk_83"
		ib="Srvr=&quot;10.78.101.20&quot;;Ref=&quot;kursk_83&quot;;"
		enableStandardOData="true">
	<ws>
		<point name="ASKUG"
				alias="askug.1cws"
				enable="false"/>
		<point name="DataExchange"
				alias="dataexchange.1cws"
				enable="true"/>
		<point name="Consumer"
				alias="consumer.1cws"
				enable="true"/>
		<point name="ASCUG"
				alias="ascug.1cws"
				enable="true"/>
	</ws>
</point>

Url будет выглядеть следующим образом:

  • Ip сервера (Srvr="10.78.101.20")
  • Название таблицы (base="/kursk_83")
  • Папка ws (<ws>)
  • Имя базы (ascug.1cws)

''url=http://10.78.101.20/kursk_83/ws/ascug.1cws''

Проверка версии установленного Веб-сервиса

Чтобы узнать номер версии установленного Веб-сервиса, необходимо в браузере ввести URL, затем логин и пароль в появившемся окне. После этого должен будет отобразиться достаточно объемный WSDL (XML) документ, необходимо воспользоваться контекстным поиском по слову "version".

WebServiceVersionFromWsdl.png

Переход с платформы 1С версии 8.2 на 8.3

Мы поддерживаем обе версии платформ.

В общем процедура развёртывания и публикации практически такая же. Но если вы переходите и прежде уже всё было настроено, вам надо совсем не многое:

  • В файле настроек Апача (httpd.conf) скорректировать путь к файлу wsap22.dll соответствующей версии. Перезапустить службу.
  • В файле публикации, URL к которому вы давали нам ранее (ascug.1cws) изменить хост и/или имя базы, если они у вас изменились.

Перепубликация не требуется.

Примечания

  1. ↑ Компонент "Расширения Веб-сервисов" входит в стандартный дистрибутив 1С платформы
Источник — «http://ais-site.dgtserv.ru/wiki_/index.php?title=Инструкции_по_развертыванию&oldid=1427»