HTTP-сервіси для тих, хто нічого не розуміє у WEB
Почну з того, що колись я змушений був самостійно розбиратися з Web-сервісами. Тоді якось потихеньку мені вдалося освоїти цю справу і зрозуміти, що й куди треба натиснути, щоби все запрацювало. Благо конфігурація, з якою довелося працювати, вже була напхана Web-сервісами і можна було піддивитися і зробити за аналогією, а також в інтернеті мені вдалося знайти достатньо статей у цій справі. І так, на прикладах (для мене це найкращий спосіб вивчення), я освоїв цю справу, і тепер мене вони вже не лякають.
Після оновлення платформи до версії 8.3 мені стало цікаво спробувати нові технології - ті саміHTTP-сервіси. Погортавши інтернет, я знайшов пару статей самої фірми 1С і трохи сторонніх статей, в яких якась інформація є, але написана складно (для простого тупого 1С-ніка). У результаті своєму досвіді, шляхом спроб і помилок, я трохи наблизився до усвідомлення, що це за звір, і хочу поділитися інформацією з вами (може, комусь допоможе швиденько щось зробити, коли горить).
ОТРУГ. Основним завданням будь-якої інтеграції, будь то КД, Web-сервіси або HTTP-сервіси, є щось звідки передати, що-небудь з цим зробити і повернути відповідь. Ось у такому форматі ми розглянемо нову технологію.
У дереві метаданих HTTP-сервіси розміщуються у гілці Загальні:
Додається новий HTTP-сервіс так само, як і будь-який інший об'єкт метаданих. Ім'я та синонім як хочете. Тут важливий лише " Кореневий URL " - це, власне, і є ідентифікатор HTTP-сервісу у цій основі, тобто. саме те, що ви напишете в цій властивості, ви передасте сторонньому розробнику (ну чи собі) як посилання на сервіс.
Вжене знаю, чи можна тут писати кирилицею, але щоб вас у прогресивному світі не засміяли, пишіть латиницею).
Далі переходимо на закладку Шаблони URL та додаємо новий шаблон.
Тут важлива сама властивість Шаблон:
За допомогою шаблону ви зможете звернутися до тих даних, які вам передали.ОТРУД: всі дані, які ви хочете отримати ззовні, можна розділити на 2 блоки - обов'язкові і не обов'язкові.
Обов'язкові дані/параметри запихаємо в шаблон, тим самим якщо той, хто звертається до сервісу, їх не заповнив, то сервіс апріорі видасть помилку, а при розробці тексту модуля оброблювача будете впевнені, що ці дані є. Як це робиться: у рядку Шаблон у фігурних дужках "<>", чергуючи зі знаком "/", пишемо імена змінних. Наприклад, нам обов'язково потрібен артикул – тоді пишемо/. Якщо нам треба отримати артикул, ім'я та ім'я користувача, рядок шаблону виглядатиме так: // і т.д. Кожен із таких параметрів у тексті модуля обробника можна буде отримати так: Запит.ПараметриURL[" "]. Якщо обов'язкових немає, шаблон виглядає так: /*.
Не обов'язкові дані, які ми хочемо отримувати через сервіс, у шаблоні НЕ описуються. При побудові посилання для звернення до сервісу вони описуються в кінці посилання після знака "?", розділяються символом амперсанда "&" та мають структуру = . У тексті модуля обробника до них можна звернутися конструкцією: Запит.ПараметриЗапроса.Отримати(" "). АЛЕ: важливо пам'ятати, якщо вони не обов'язкові, то їх може і не бути, відповідно значення перевіряємо на невизначено.
Далі додаємо новий метод нашого шаблону. Тут важлива властивість HTTP-метод. Їх тут безліч, АЛЕ ми не вдаватимемося у всі тонкощі. Для реалізації будь-якого вашого завдання вампотрібні тільки 2:GET таPOST.
Адміністрування - Публікація на веб-сервері.
Там закладка HTTP-сервісів. Ставимо галки та натискаємо "Опублікувати"
