Розширення конфігурацій 1С дедалі частіше стали використовуватися додавання нового функціоналу у конфігурації 1С Підприємство. Сьогодні розглянемо інструкцію з встановлення одного з популярних розширень, що дозволяє заповнювати реквізити контрагентів з ІПН та найменування.
Спочатку буде докладна текстова інструкція, а нижче можете переглянути відео щодо встановлення цього розширення.
Підключення розширення до 1С 8.3
1. Відкрийте базу 1С:Підприємство 8 та перейдіть до розділу «Адміністрування». Зайдіть до пункту "Друкарські форми, звіти, обробки".
2. Натисніть на пункт «Розширення» (якщо у Вас немає такого пункту меню, значить це стара конфігурація і вона не підтримує роботу з розширеннями)
3. Натисніть кнопку «Додати» та виберіть файл із розширенням (*.cfe), який ви завантажили. Відкрийте його:
4. Може з'явитися вікно "Попередження безпеки" - натисніть «Так»:
Рекомендується звертати увагу на джерело, з якого було отримано даний файл. Якщо з джерелом немає домовленості щодо розробки додаткових модулів, або є сумніви у вмісті файлу, то його не рекомендується відкривати, оскільки це може зашкодити комп'ютеру та даним.
Дозволити відкривати цей файл?
5. Може з'явитись вікно з інформацією, що потрібно ще раз повторити дію. Просто поверніться на пункт 3 і повторітьдодавання розширення.
Поточне виконання дії було перервано для видачі попередження.
Ви підтвердили виконання дії для цього модуля. Надаліця дія для даного модуля виконуватиметься без видачі попереджень.
Прохання зараз викликати цю дію ще раз.
6. Т.к. для заповнення реквізитів, розширення буде звертатися до інтернету, то потрібно зняти галочку. Безпечний режим» та після цього перезапустити програму 1С.
Після запуску 1С:Підприємство, розширення має автоматично підключитися і ви можете почати роботу з ним. Якщо при роботі виникнуть якісь питання, то завжди можете звернутися до нашої технічної підтримки через чат або .
Ключові слова: Розширення для роботи з файлами, веб-клієнт, ПочатиПідключенняРозширенняРоботиСФайлами, ПочатиУстановкуРозширенняРоботиСФайлами
У прекрасному новому світі веб-клієнтів та асинхронного програмування не можна просто так взяти і
завантажити в базу файл під час роботи у веб-клієнті. При спробі використання діалогу вибору файлу буде
повідомлення про необхідність наявності "Розширення для роботи з файлами". Не слід плутати це
розширення з розширенням для веб-браузера (яке також необхідно). Це таки дві різні сутності.
Якщо розширення для веб-браузера встановлюється з магазину Chrome (або звідки там для
інших браузерів), то розширення для роботи з файлами встановлюється невідомо звідки при
виконання методу вбудованої мови 1С "ПочатиУстановкуРозширенняРоботиСФайлами()". При виконанні
цього методу в папку "Завантаження" закачується файл виду "1CExtension1509032170224.exe". Необхідно
запустити цей файл для кожного користувача комп'ютера, який використовує розширення. Файл
можна зберегти і централізовано засетапит усім потрібним користувачам.
Тепер перед використанням функціоналу передачі файлів між клієнтом та сервером слід виконувати
метод вбудованої мови "ПочатиПідключенняРозширенняРоботиСФайлами(Оповідання)". Метод вимагає
параметрі "Оповідання" наявність опису оповіщення з процедурою, що містить параметри:
- <Подключено>– результат підключення, Тип: Бульово. Істина - розширення успішно підключено
- <ДополнительныеПараметры>- значення, яке було вказано під час створення об'єкта
Опис Оповіщення.
У цій процедурі перевіряємо, якщо Підключено = Істина, тобто підключення пройшло успішно, і тоді
повернення і їдемо далі.
Зверніть увагу, що весь функціонал роботи з файлами має бути написаний в асинхронному стилі,
тобто. низкою процедур з оброблювачами оповіщення всередині.
Приклад реалізації асинхронної передачі файлів з використанням розширення можна переглянути в модулі
"ОбмінДанимиКлієнт" + загальна форма "ПитанняОб УстановціРозширенняРоботиСФайлами" у типовому ЗУПР 3. Там
напрочуд досить небагато процедур.
Час невблаганно йде вперед, а платформа 1С 8 біжить ще швидше за цей час.
Керовані форми тепер називаються "інтерфейс ТАКСІ", модальні вікна заборонені, а режим використання синхронних викликів розширень і зовнішніх компонентів наглухо поклав працездатність більшості цих розширень і зовнішніх компонентів, і половину старих методів на додаток.
Загалом, пацани, справи такі - багато хто з вас читав статтю чудового Чистова П. про роботу з файлами в 8.3
Якщо Ви цього ще не зробили - бігом марш! ()
Суть механізму роботи з файлами в короткому:
1) На клієнті вибираємо файл
2) Тихаємо його в чорну скриньку
3) Зберігаємо вміст чорної скриньки на сервері
Загвоздка полягає в тому, що робити це треба особливо по-новому і з душею.
Тому ваші
ВибранийФайл.Існує()
та інші язичницькі штучки тут не прокотять.
Тож поїхали!
Ось листинг коду, який дозволяє завантажити файл із клієнта
ОписОповіді = Новий ОписОповіді("ОбробитиВибірФайлу", ЦяФорма); ДіалогВідкриттяФайлу = Новий ДіалогВиборуФайлу(РежимДіалогуВиборуФайлу.Відкриття); Діалог Відкриття файлу. Множинний Вибір = Брехня; ПочатиПриміщенняФайлів(ОписПовідомлення, ДіалогВідкриттяФайлу, Істина, УнікальнийІдентифікатор);
Нас цікавить метод РозпочатиПриміщенняФайлів", який, власне, викликає діалог вибору файлу і поміщає цей файл у тимчасове сховище. Заморочуватися з описом тимчасового сховища немає сенсу, просто запам'ятайте - це місце, куди поміщаються всі вибрані нами файли у вигляді двійкових даних (чорна скринька).
&НаКлієнті Процедура ОбробитиВибірФайлу(ЗміщеніФайли, ДодатковіПараметри) Експорт Якщо ПоміщеніФайли = Невизначено Тоді Повернення; КінецьЯкщо; Для кожного ПереданийФайл З ПоміщеніФайли Цикл ШляхКФайлу = ПереданийФайл.Ім'я; Запис.ІмяФайла = РозбірРядки(ШляхКФайлу, "\"); Елементи.ВідкритиФайл.Заголовок = Запис.Ім'яФайлу; Адреса = ПереданийФайл.Зберігання; КінецьЦикл; КінецьПроцедури // ()
Зрозуміти, що там і як зберігатись у цьому тимчасовому сховищі практично неможливо. Можна тільки звернутися до нашого файлу за навігаційним посиланням, яке надається автоматично (див. змінну " Адреса").
З тим, що файли потрібно зберігати у реквізиті чи ресурсі з типом " Сховище значення", сперечатися, думаю, ніхто не буде. Дістати файл із тимчасового сховища і помістити його в реквізит із типом" Сховище значенняможна слід.образом:
Новий СховищеЗначення(ОтриматиЗ ТимчасовогоСховища(Адреса));
З одним розібралися, тепер друге – як дістати файл із цього сховища значень (яке, нагадаю, знаходиться на сервері) та зберегти на диск клієнта?
Насамперед, нам треба отримати навігаційне посилання на реквізит з типом. Сховище значення", куди у нас міститься файл як бінарних даних.
Будьте уважні!Це навігаційне посилання вже не має з тимчасовим сховищем нічого спільного! Перевірити тип навігаційного посилання можна методом
ЦеАдрес ТимчасовогоСховища(Адреса)
За традицією, листинг коду, який викликає діалог збереження файлу
ОписОповіді = Новий ОписОповіді("ОбробкаЗбереженняФайлів", ЕтаФорма); Файл = Новий ОписПередаєтьсяФайла(Ім'яФайла, Адреса); Файли = Новий Масив; Файли.Додати(Файл); ДіалогВідкриттяФайлу = Новий ДіалогВиборуФайлу(РежимДіалогуВиборуФайлу.Збереження); Діалог Відкриття файлу. Множинний Вибір = Брехня; ПочатиОтриманняФайлів(ОписПовідомлення,ОтримуваніФайли, ДіалогВідкриттяФайлу, Істина);
Значення змінної Файлце ще одна особливість даного способу. Тут варто звернути увагу на Ім'я файлу". Справа в тому, що поміщаючи файл у тимчасове сховище, інформація про його ім'я та розширення втрачається. Тому не забудьте десь зберігати коректне ім'я файлу, або хоча б його розширення, щоб потім не мучитися з питанням" А це ордівський документ чи мп3?"
Метод " ПочатиОтриманняФайлів" аналогічний методу " РозпочатиПриміщенняФайлівПросто один відкриває діалог для вибору файлу, інший, навпаки, відкриває діалог для збереження файлу.
У принципі, все.
При використанні цього способу, ніякі сумісності модальності та синхронних викликів у властивостях конфігурації не потрібно встановлювати.
Статтю писав більше як пам'ятку собі.
Тут ви зможете ознайомитись з детальною інформацієюз налаштування та конфігурації веб-браузерів Microsoft Internet Explorer, Mozilla Firefox, Apple Safari та Google Chromeдля роботи з програмою "1С:Управління нашою фірмою" ("УНФ").
Налаштування та використання веб-браузера Microsoft Internet Explorer
Особливості використання
Для роботи з веб-клієнтом в операційній системі Windows XP SP 2 потрібна наявність системної бібліотеки jscript.dllверсії 5.6.0.8834 або вище.
Бібліотека знаходиться у каталозі system32 операційної системи. Якщо на вашому комп'ютері встановлена більш рання версія бібліотеки, то можливе сповільнення роботи веб-клієнта. Для оновлення версії необхідно завантажити пакет оновлень, який знаходиться за адресою http://support.microsoft.com/kb/942840/en-us .
При використання Microsoft Internet Explorer 7 і Microsoft Internet Explorer 8 при включених закладках, у тому вікні, де закладки є, для перемикання за допомогою клавіатури з головного (вікно із закладками) в дочірню форму (окреме вікно) слід використовувати комбінації клавіш +Ctrl+F6. Якщо закладки вимкнені, то для перемикання можна використовувати також клавіші Ctrl+Tab.
Для цього
- В меню Сервіс (Tools)виберіть пункт Властивості браузера (Internet Options)та виконайте налаштування:
-
- на вкладці Безпека (Security)для зони Internet натисніть кнопку Інший (Custom level);
- в розділі Сценарії (Scripting)для параметра Активні сценарії (Active scripting)встановіть Дозволити (Enable)та натисніть кнопку "OK".
- Дозвольте спливаючі вікна:
- перейдіть на вкладку Конфіденційність (Privacy);
- в розділі Блокування спливаючих вікон (Pop-up Blocker)зніміть прапорець Блокувати спливаючі вікна (Block Pop-ups).
-
- на вкладці Конфіденційність (Privacy)за допомогою регулятора виберіть рівень використання cookies - не вище Помірно високий (Medium High).
Якщо передбачається сумісна працязі сканером штрих-кодів, електронними вагами або іншими зовнішніми компонентами, необхідно виконати наступне налаштування веб-браузера:
- на вкладці Безпека (Security)натисніть кнопку Інший (Custom level);
- у вікні необхідно встановити Дозволити (Enable)для наступних параметрів:
- Запит дозволу для ActiveX об'єктів (Automatic promting for ActiveX controls);
- Завантаження підписаних ActiveX об'єктів із дозволу користувача (Download signed ActiveX controls);
- Робота з ActiveX об'єктами та плагінами (Run ActiveX controls and plug-ins);
- Робота з об'єктами, що позначені як безпечні (Script ActiveX controls marked safe for scripting).
При кожному відкритті допоміжних вікон розкладка клавіатури вибирається із налаштувань операційної системи. Якщо вона не співпадає з мовою введення даних, то, щоб виключити перемикання мови, рекомендується в налаштуваннях вказати потрібну мову введення.
Щоб настроїти мову введення за промовчанням, виконайте такі дії:
- відкрийте налаштування операційної системи "Мова та регіональні стандарти" ("Regional and Languages Options");
- на закладці "Мов" ("Languages")в розділі "Мови та служби текстового введення" ("Text services and input languages")натисніть кнопку "Докладніше..." ("Details...");
- у вікні на закладці "Параметри" ("Settings")в розділі "Мова стандартного введення" ("Default input language")виберіть потрібну мову;
- натисніть кнопку "OK".
При роботі в Internet Explorer 8 у деяких ситуаціях при переході до вже відкритому вікнуз іншого вікна видаватиметься діалог із текстом "Натисніть OK для переходу до вікна" та кнопкою OK. Після натискання кнопки буде здійснено перехід до вікна.
Особливості використання розширених засобів роботи з файлами
Реалізація для Internet Explorer потребує встановлення спеціального ActiveX компонента 1С:Підприємство 8.2. Розширення роботи з файлами для Internet Explorer (x86), або її 64-розрядний варіант для 64-розрядного Internet Explorer. Компонент включений у платформу, але її установка повинна бути передбачена в конфігурації (має бути реалізований виклик методу Встановити Розширення Роботи з файлами).
Для роботи з компонентом, у браузері повинні бути надані права на встановлення та використання підписаних ActiveX компонентів для зони, де знаходиться веб-сайт.
Для роботи з файлами використовується бібліотека Microsoft Core XML Services (MSXML). Рекомендовані версії MSXML 6.0 та MSXML 4.0. У разі використання MSXML 3.0 можливі проблеми з передачею файлів великого розміру з клієнта на сервер.
Зі списку версій модулів MSXML, обмежень та рекомендацій щодо встановлення можна ознайомитися на цій сторінці .
Налаштування та використання веб-браузера Mozilla Firefox
Особливості використання
Всі операції з файловою системою(Отримання файлу з сервера, передача файлу на сервер, видалення файлу тощо) виконуються строго інтерактивно. Якщо виконання дії не потребує взаємодії з користувачем (наприклад вибору файлу), то видається діалог-попередження, що вимагає від користувача підтвердження.
Установки використання веб-браузера
Для підключення до інформаційних баз 1С:Підприємства 8 за допомогою Mozilla Firefox потрібно виконати такі налаштування:
- Відкрийте браузер у меню Інструменти (Tools)виберіть пункт Налаштування (Options);
- Вміст (Content)
- Зніміть прапорець;
- Встановіть прапорець Використовувати JavaScript (Enable JavaScript).
- Перейдіть до розділу Приватність (Privacy)встановіть такі установки:
- Встановіть прапорець Приймати cookies із сайтів (Assept cookies from sites);
- Для детального налаштування прийому або відхилення cookies натисніть кнопку Винятки (Exeptions)та дотримуйтесь пояснень діалогу налаштування.
Якщо як браузер використовується англійська версія Mozilla Firefox, то для правильної роботивеб-клієнта потрібно виконати наступне налаштування (налаштування наведено для версії 3.5):
- Відкрийте браузер у меню Toolsвиберіть пункт Options;
- На закладці Contentsу групі Fonts & Colorsнатисніть кнопку Advanced;
- У параметрі Default Character EncodingОберіть Unicode.
Модифікацію інших параметрів, які можуть знадобитися для роботи з веб-клієнтом 1С:Підприємства, можна здійснити за допомогою команди "Сервіс - Налаштування веб-браузера". У вікні виконуються налаштування, які також можна виконати в налаштуваннях самого веб-браузера в діалозі запиту привілеїв.
У вікні здійснюється налаштування наступних параметрів браузера (у круглих дужках вказується аналогічні параметри налаштувань веб-браузера):
- Дозволити роботу з буфером обміну, розширенням роботи з файлами, зовнішніми компонентами(signed.applets.codebase_principal_support) - для роботи з буфером обміну, зовнішніми компонентами та розширеною роботи з файлами (значення true);
- Дозволити використання у параметрах рядка запуску нелатинських символів(network.standard-url.encode-query-utf8) – для використання нелатинських символів в адресному рядку (значення true);
- Дозволити використання клавіатури для перемикання між вікнами програм(dom.popup_allowed_events) - для дозволу навігації по вікнах програми з клавіатури (додає значення параметра подія keydown);
- Використати аутентифікацію операційної системи(network.automatic-ntlm-auth.trusted-uris) - якщо встановлено, то буде виконуватись аутентифікація операційної системи. Це налаштуваннязмінює лише значення ключа network.automatic-ntlm-auth.trusted-uris. Для автентифікації операційної системи в конкретній конфігурації мережі та веб-сервера, можливо, знадобиться значення ключів network.negotiate-auth.trusted-uris і network.negotiate-auth.delegation-uris. Додаткову інформаціюдив. у https://developer.mozilla.org/en/Integrated_Authentication .
Ці параметри можна також настроїти вручну. Для цього необхідно в адресному рядку веб-браузера набрати about:config, потім у рядку фільтра набрати будь-яке слово з імені параметра (наприклад, principal) і змінити його значення у списку.
- Відкрийте браузер у меню Інструменти (Tools)виберіть пункт Налаштування (Options);
- У вікні, перейдіть в розділ Основні;
- Встановіть прапорець Завжди видавати запит на збереження файлу.
Для ручного налаштуванняавтентифікації слід:
- в адресному рядку браузера набрати about:config.
- потім на сторінці параметрів у рядку фільтра ввести назву параметра.
Це налаштування здійснюється для трьох параметрів:- network.automatic-ntlm-auth.trusted-uris,
- network.negotiate-auth.delegation-uris,
- network.negotiate-auth.trusted-uris.
- далі задати список веб-серверів, через які здійснюватиметься робота з базою "1С:Підприємства".
- Веб-сервер підтримує NTLM-Аутентифікацію.
Якщо ім'я веб-сервера, до якого використовується спроба доступу, перелічено у списку імен, що містяться у параметрі network.automatic-ntlm-auth.trusted-uris, то буде здійснено спробу автоматичної аутентифікації. Якщо ім'я веб-сервера там немає, то браузер покаже діалог, в якому необхідно вказати логін і пароль користувача для доступу до веб-сервера. - Веб-сервер підтримує Kerberos-Аутентифікацію.
Щоб отримати доступ до веб-сервера з даним типом автентифікації, до параметра потрібно додати ім'я цього веб-сервера. При роботі з файловою інформаційною базоюцього буде достатньо. У разі необхідності забезпечити автоматичну аутентифікацію користувачів веб-клієнта при використанні клієнт-серверного варіанта "1С:Підприємства", необхідно додати DNS-ім'я цього веб-сервера до параметра network.negotiate-auth.delegation-uris.
У випадку, якщо ім'я веб-сервера, до якого здійснюється доступ, не виявлено у параметрі network.negotiate-auth.trusted-uris, автентифікація не буде проводитися, і користувач побачить повідомлення про помилку 401 Unauthorized. Для інформування користувача про дії, які йому необхідно вжити, адміністратор може модифікувати сторінку повідомлення про помилку 401 (див. документацію до веб-сервера).
Особливості використання розширених засобів роботи з файлами
Усі операції з файловою системою (отримання файлу з сервера, передача файлу на сервер, видалення файлу тощо) виконуються строго інтерактивно. Якщо виконання дії не потребує взаємодії з користувачем (наприклад вибору файлу), то видається діалог-попередження, що вимагає від користувача підтвердження.
Розширення для роботи з файлами вимагає надання привілею UniversalXPConnect. Веб-браузер Mozilla FireFox виконує запит привілею інтерактивно, але користувач може запам'ятати рішення для цього веб-сайту.
У випадку, якщо веб-браузер Mozilla FireFox запам'ятав рішення користувача щодо надання привілею, а користувач хоче змінити це рішення, йому доведеться самостійно відредагувати файл. prefs.js, який зберігається в папці профілю веб-браузера Mozilla Firefox.
Опис, як знайти папку профілю, знаходиться тут:
http://wiki.mozilla.ru/index.php/Про профілі Mozilla Firefox (російськомовна стаття)
http://support.mozilla.com/en-US/kb/Profiles (англомовна стаття).
Далі потрібно:
1. Завершити роботу Mozilla FireFox.
2. Відкрити prefs.jsбудь-яким текстовим редактором
3. Знайти у тексті рядок UniversalXPConnect. Буде знайдено фрагмент тексту такого вигляду:
user_pref("capability.principal.codebase.p.granted", "UniversalXPConnect");
або
user_pref("capability.principal.codebase.p.denied", "UniversalXPConnect");
user_pref("capability.principal.codebase.p.id", "");
user_pref("capability.principal.codebase.p.subjectName", "");
де - будь-яке число, а - це адреса потрібного веб-сайту. Якщо інший, потрібно продовжити пошук "UniversalXPConnect" за текстом.
4. Видалити знайдені рядки з тексту.
Налаштування та використання веб-браузера Apple Safari
Для використання веб-браузера необхідно настроїти властивості браузера.
Для цього відкрийте меню, виберіть пункт Налаштування (Preferences)та виконайте налаштування:
- Дозвольте виконання JavaScript скриптів:
на закладці Безпека (Security)Оберіть Підключити JavaScript (Enable JavaScript) - Дозвольте використання cookies:
на закладці Безпека (Security)у групі Приймати cookies (Accept cookies)Оберіть Тільки від відвідуваних сайтів (Only from sites I visit); - Дозвольте спливаючі вікна:
на закладці Безпека (Security)зніміть прапорець Блокувати спливаючі вікна (Block pop-up windows).
- В меню Налаштування Safari (Safari Settings)виберіть пункт Налаштування (Preferences);
- На закладці Основні (General)встановіть прапорець Завжди виконувати запит перед завантаженням (Always prompt before downloading).
Налаштування та використання веб-браузера Google Chrome
Для використання веб-браузера необхідно настроїти властивості браузера.
Для цього відкрийте меню Інструменти (Tools), виберіть пункт Параметри (Options), на закладці Розширені (Under the Hood)натисніть кнопку Налаштування змісту (Content settings)та виконайте налаштування:
- Дозвольте використання cookies:
на закладці Файли cookie(Cookies)Оберіть Дозволити зберігати локальні дані (рекомендується) (Allow local data to be set (recommended))або налаштуйте винятки; - Дозвольте виконання JavaScript скриптів:
на закладці JavaScriptОберіть Дозволити всім сайтам використовувати JavaScript (рекомендується)або налаштуйте винятки; - Дозвольте спливаючі вікна:
на закладці Спливаючі вікна (Pop-ups)Оберіть Дозволити спливаючі вікна для всіх сайтів (Allow all sites to show pop-ups)або налаштуйте винятки.
- Відкрийте меню Інструменти (Tools), виберіть пункт Параметри (Options);
- На закладці Розширені (Under the Hood)в розділі Завантаження (Downloads)встановіть прапорець Запитувати місце для збереження кожного файлу перед завантаженням (Ask where to save each file before download).
В нової версіїплатформи «1С:Підприємство 8»буде розширено можливості роботи з файлами у веб-клієнті.
У ній з'являться такі функції, як перетягування файлів ззовні, а також збільшиться кількість можливостей, доступних без встановлення спеціального розширення роботи з файлами.
Як повідомляється в офіційному блозі розробників фірми «1С», для методу Почати ПриміщенняФайлів() більше не потрібно розширення роботи з файлами. Тепер цей метод використовуватиме свій "власний" діалог вибору файлів, що дозволяє вибирати відразу кілька з них. Якщо розширення роботи з файлами все-таки встановлено, буде використовуватися діалог вибору файлів операційної системи.
Сам діалог, за словами розробників, також зазнав істотних змін. Тепер він не тільки дозволить вибрати кілька файлів перетягуванням, але й покаже їхню назву та розмір. При цьому можна буде виключити з вибору файли.
У методи Почати ПриміщенняФайла() та ПочатиПриміщенняФайлів() можна буде передавати заздалегідь налаштований діалог вибору файлів. Наприклад, встановити власний заголовок з описом того, які файли може вибирати користувач.
Усі характеристики файлів, що завантажуються на сервер, також можна буде перевірити. Крім того, з'явиться можливість перетягувати файли на зображення або таблицю, щоб не користуватися провідником.
