Обмен данными без использования COM-соединения (КУС) — различия между версиями

Материал из КинтВики
Перейти к: навигация, поиск
 
(не показана 21 промежуточная версия 7 участников)
Строка 1: Строка 1:
[[Категория:Администрирование (КУС)]]
+
<noinclude>[[Категория:Обмен данными (КУС)|*10]][[Категория: Расширения конфигурации (КУС)]]</noinclude>
Для программы «Кинт: Управление санаторием» предусмотрена возможность обмениваться данными с другими программами без использования СОМ-соединения. Это делается с помощью универсального расширения (файла типа cfe). Расширение совместимо с любыми конфигурациями 1С, где присутствует обработка «Универсальный обмен данными в формате XML».
+
{| align=right
 +
|__TOC__
 +
|}
 +
{{video|[https://youtu.be/fXDeC6Cs71w Обмен данными между «Кинт: Управление санаторием» и «1С:Бухгалтерия 8» через API]}}
 +
{{video2|[https://rutube.ru/video/247eaf909c98dc4813e7de5eb84c342d/ Обмен данными между «Кинт: Управление санаторием» и «1С:Бухгалтерия 8» через API]}}
 +
Для программы «Кинт: Управление санаторием» предусмотрена возможность обмениваться данными с другими программами без использования СОМ-соединения. Это возможно, если в 1С:Бухгалтерия 8 установлено специальное расширение. Это расширение (файл формата .cfe) совместимо с любыми конфигурациями 1С, где присутствует обработка «Универсальный обмен данными в формате XML».
  
 +
== Особенности ==
 +
Преимущества:
 +
* Работает быстрее, чем с использованием СОМ-соединения.
 +
* Обмен данными не зависит от версии платформы и позволяет работать, если базы на разных платформах. Без использования расширения приходится каждый раз перерегистрировать соединение после каждого обновления платформы «1С:Предприятие 8».
 +
* Можно обмениваться данными с любыми базами любой удаленности от исходной. Без использования расширения, обмен данными можно выполнять только в пределах одной локальной сети (либо настраивать виртуальные сети).
 +
* Не требуется регистрировать СОМ-соединение.
 +
 +
Недостатки:
 +
* Необходимо устанавливать расширение в конфигурацию базы-приемника.
 +
* Необходимо опубликовывать базу-приемника в интернете или локальной сети.
 +
* При обновлении платформы необходимо сделать перепубликацию базы на новой платформе.
 +
== Настройка обмена ==
 
Для возможности обмена без использования СОМ-соединения в базе-приемнике должно быть добавлено и опубликовано расширение конфигурации «Кинт: Обмен данными».
 
Для возможности обмена без использования СОМ-соединения в базе-приемнике должно быть добавлено и опубликовано расширение конфигурации «Кинт: Обмен данными».
  
# Обратитесь в [https://www.kint.ru/products/kus/ службу поддержки «Кинт: Управление санаторием»] с просьбой выслать вам файл расширения для обмена данными без СОМ-соединения.
+
# Обратитесь в [https://www.kint.ru/support/kus/ службу поддержки «Кинт: Управление санаторием»] с просьбой выслать вам файл расширения для обмена данными без СОМ-соединения.
 
# В базе-приемнике в 1С:Конфигураторе [[#Настройка расширения|добавьте расширение]] и настройте его.
 
# В базе-приемнике в 1С:Конфигураторе [[#Настройка расширения|добавьте расширение]] и настройте его.
# В программе «Кинт: Управление санаторием»:
+
# В программе «Кинт: Управление санаторием» сделайте следующее:
 
#* В [[Справочник "Информационные базы" (КУС)|карточке информационной базы-приемника]] в поле «Расположение» выберите расположение «Интернет-публикация» и укажите адрес, по которому база опубликована в интернете.
 
#* В [[Справочник "Информационные базы" (КУС)|карточке информационной базы-приемника]] в поле «Расположение» выберите расположение «Интернет-публикация» и укажите адрес, по которому база опубликована в интернете.
 
#* При настройке обмена данными в [[Справочник "Настройки обменов" (КУС)#Карточка обмена данными|карточке обмена]] в поле «Приемник» укажите базу с интернет-публикацией.
 
#* При настройке обмена данными в [[Справочник "Настройки обменов" (КУС)#Карточка обмена данными|карточке обмена]] в поле «Приемник» укажите базу с интернет-публикацией.
 
# Настроенный таким образом обмен данными между программами будет происходить без использования СОМ-соединения.
 
# Настроенный таким образом обмен данными между программами будет происходить без использования СОМ-соединения.
 +
 +
: [[Файл:Обмен данными без СОМ-соединения.png]]
  
 
=== Настройка расширения ===
 
=== Настройка расширения ===
Строка 17: Строка 36:
 
# Загрузите файл расширения cfe, полученный от службы поддержки «Кинт: Управление санаторием»:
 
# Загрузите файл расширения cfe, полученный от службы поддержки «Кинт: Управление санаторием»:
 
#: [[Файл:Выбор загрузки из файла.png]]
 
#: [[Файл:Выбор загрузки из файла.png]]
# После его загрузки и обновления информационной базы отобразятся параметры расширения:
+
# После его загрузки и обновления информационной базы отобразятся параметры расширения:  
#: [[Файл:Результат добавления.png]]
+
#: ВАЖНО! Для правильной работы расширения в платформе 8.3.18 и далее необходимо чтобы галочки "Безопасный режим" был снята. [[Файл:Результат добавления.png]]
 
# Опубликуйте http-сервисы расширения:
 
# Опубликуйте http-сервисы расширения:
 
#: [[Файл:Настройка публикации.png]]
 
#: [[Файл:Настройка публикации.png]]
Строка 43: Строка 62:
 
}
 
}
 
</pre>
 
</pre>
 +
 +
== Возможные проблемы ==
 +
* Публикация базы на IIS не работает.
 +
** Решение: проверить разрядность wsisapi.dll (Модуль расширения веб-сервера 1С). Возможно в файле web.config публикации прописана ссылка на dll из другой разрядности. Должно соответствовать разрядность платформы. Попробовать добавить/убрать "(x86)"
 +
: [[Файл:Ошибка публикации путь к dll.png]]
 +
 +
 +
* После обновления платформы не работает расширение для обмена данными.
 +
** Решение: проверьте установлены ли права на использование HTTP-сервиса и назначена ли пользователю соответствующая роль.
 +
:: Для этого:
 +
: 1. В 1С:Конфигураторе откройте настройки расширения «Кинт: Обмен данными».
 +
: 2. Раскройте ветку HTTP-сервиса «ОбменДанными_API».
 +
: 3. Откройте дополнительные свойства для метода «GetData».
 +
 +
: [[Файл:Конфигуратор HTTP-сервисы Дополнительно.png]]
 +
 +
: 4. Во вкладке «Права» установите флаг на право использования.
 +
 +
: [[Файл:Конфигуратор HTTP-сервисы Дополнительно2.png]]
 +
 +
: 5. Повторите шаги 3 и 4 для метода «PostData».
 +
: 6. В меню «Администрирование» откройте список пользователей.
 +
: 7. Откройте настройки пользователя и на вкладке «Прочие» в списке доступных ролей установите флаг на роли «ОбменДанными_ОсновнаяРоль».
 +
 +
: [[Файл:Конфигуратор Роль пользователя.png]]
 +
 +
== См. также ==
 +
[[Справочник "Настройки обменов" (КУС)]]

Текущая версия на 12:52, 22 октября 2024

YouTube.png
RUTUBE.png

Для программы «Кинт: Управление санаторием» предусмотрена возможность обмениваться данными с другими программами без использования СОМ-соединения. Это возможно, если в 1С:Бухгалтерия 8 установлено специальное расширение. Это расширение (файл формата .cfe) совместимо с любыми конфигурациями 1С, где присутствует обработка «Универсальный обмен данными в формате XML».

Особенности

Преимущества:

  • Работает быстрее, чем с использованием СОМ-соединения.
  • Обмен данными не зависит от версии платформы и позволяет работать, если базы на разных платформах. Без использования расширения приходится каждый раз перерегистрировать соединение после каждого обновления платформы «1С:Предприятие 8».
  • Можно обмениваться данными с любыми базами любой удаленности от исходной. Без использования расширения, обмен данными можно выполнять только в пределах одной локальной сети (либо настраивать виртуальные сети).
  • Не требуется регистрировать СОМ-соединение.

Недостатки:

  • Необходимо устанавливать расширение в конфигурацию базы-приемника.
  • Необходимо опубликовывать базу-приемника в интернете или локальной сети.
  • При обновлении платформы необходимо сделать перепубликацию базы на новой платформе.

Настройка обмена

Для возможности обмена без использования СОМ-соединения в базе-приемнике должно быть добавлено и опубликовано расширение конфигурации «Кинт: Обмен данными».

  1. Обратитесь в службу поддержки «Кинт: Управление санаторием» с просьбой выслать вам файл расширения для обмена данными без СОМ-соединения.
  2. В базе-приемнике в 1С:Конфигураторе добавьте расширение и настройте его.
  3. В программе «Кинт: Управление санаторием» сделайте следующее:
  4. Настроенный таким образом обмен данными между программами будет происходить без использования СОМ-соединения.
Обмен данными без СОМ-соединения.png

Настройка расширения

  1. В 1С:Конфигураторе добавьте любое расширение:
    Открытие расширений.png
    Добавление расширения.png
  2. Загрузите файл расширения cfe, полученный от службы поддержки «Кинт: Управление санаторием»:
    Выбор загрузки из файла.png
  3. После его загрузки и обновления информационной базы отобразятся параметры расширения:
    ВАЖНО! Для правильной работы расширения в платформе 8.3.18 и далее необходимо чтобы галочки "Безопасный режим" был снята. Результат добавления.png
  4. Опубликуйте http-сервисы расширения:
    Настройка публикации.png
  5. Проверьте корректность подключения расширения и публикации в браузере с помощью строки:
http://АДРЕС/ИМЯ_ПУБЛИКАЦИИ/hs/exchangeKintAPI.hs/GetData?Method=ПолучитьСвойстваИнформационнойБазы
Если все настроено правильно, браузер отобразит структуру свойств информационной базы примерно в таком виде:
{
"Success": true,
"Result": {
"Версия": "3.0.77.4505",
"Имя": "БухгалтерияПредприятия",
"Синоним": "УАУ 8",
"Комментарий": "{\"Имя\":\"БухгалтерияУАУ8\",\"Версия\":\"3.20.04.04\"}",
"КраткаяИнформация": "Учет. Анализ. Управление",
"ПодробнаяИнформация": "Учет. Анализ. Управление",
"АвторскиеПрава": "Copyright (С) ООО \"1C-Софт\", 2009 - 2020. Все права защищены",
"Поставщик": "Фирма «Кинт»",
"ПолнаяВерсия1С": "8.3.16.1359",
"Версия1С": "v83"
}
}

Возможные проблемы

  • Публикация базы на IIS не работает.
    • Решение: проверить разрядность wsisapi.dll (Модуль расширения веб-сервера 1С). Возможно в файле web.config публикации прописана ссылка на dll из другой разрядности. Должно соответствовать разрядность платформы. Попробовать добавить/убрать "(x86)"
Ошибка публикации путь к dll.png


  • После обновления платформы не работает расширение для обмена данными.
    • Решение: проверьте установлены ли права на использование HTTP-сервиса и назначена ли пользователю соответствующая роль.
Для этого:
1. В 1С:Конфигураторе откройте настройки расширения «Кинт: Обмен данными».
2. Раскройте ветку HTTP-сервиса «ОбменДанными_API».
3. Откройте дополнительные свойства для метода «GetData».
Конфигуратор HTTP-сервисы Дополнительно.png
4. Во вкладке «Права» установите флаг на право использования.
Конфигуратор HTTP-сервисы Дополнительно2.png
5. Повторите шаги 3 и 4 для метода «PostData».
6. В меню «Администрирование» откройте список пользователей.
7. Откройте настройки пользователя и на вкладке «Прочие» в списке доступных ролей установите флаг на роли «ОбменДанными_ОсновнаяРоль».
Конфигуратор Роль пользователя.png

См. также

Справочник "Настройки обменов" (КУС)