1

Зміст
1. Вступ......................................................................................................................................................................... 3
2. Компоненти, які необхідні для встановлення програми ............................................................................... 4
3. Встановлення рівня безпеки – доступ до програми ...................................................................................... 6
4. Встановлення програми. ..................................................................................................................................... 7
5. Конфігурація послуги ............................................................................................................................................. 14
5.1 Конфігурація головної послуги .......................................................................................................................... 15
5.2. Конфігурація сервера SMTP ............................................................................................................................. 21
5.3 Налаштування формату назви документа ..................................................................................................... 24
5.4 Налаштування мовних параметрів Логів ........................................................................................................ 25
5.5 Конфігурація доступу до мережевої служби Comarch EDI ......................................................................... 26
5.6 Конфігурація проксі-сервера ............................................................................................................................. 27
6. Робота програми..................................................................................................................................................... 28
6.1 Запуск програми ................................................................................................................................................... 29
6.2 Вихідні документи................................................................................................................................................. 30
6.3 Документи опрацьовані....................................................................................................................................... 35
6.4 Логи .......................................................................................................................................................................... 37
6.5 Втрата з’єднання з базою даних ....................................................................................................................... 39
6.6 Оновлення програми ........................................................................................................................................... 41
6.7 Реінсталяція .......................................................................................................................................................... 42
6.8 Деінсталяція .......................................................................................................................................................... 43

2
 1. Вступ
Платформа ComarchEDI - це система обігу документів, котра надає можливість автоматично
обмінюватися інформацією та документами встановленої форми (замовленнями, повідомленнями
про відвантаження, підтвердженнями замовлення і т. д.) відповідно до загальних стандартів
електронного документообігу.

Програма Comarch EDI Connector Premium є аплікацією stand-alone (що інсталюється на комп’ютер
користувача) і служить для комунікації з платформою EDI. Головним завданням якої є пересилання
електронних документів. Програма складається з двох послуг (видів) :

- Comarch EDI Connector Premium – в значній мірі відповідальний за механізм передачі

документів;
- Comarch EDI Connector Premium web, який відповідає за рівень презентації програми.

Програма дозволяє швидко пересилати велику кількість документів з великим об’ємом.

Характеризується мульти-платформою – працює як під управлінням операційної системи Windows,
так i на Linux, дає можливість управляти статусами документів, дозволяє обслуговувати достатньо
велику кількість рахунків Comarch EDI, а її конфігурація легка і інтуїтивна.

Програма надає можливість роботи без налаштування взаємозв’язків, а також відправляти

документи без підключення – обліковий запис для користувача створюється на стороні компанії
Comarch.

3
 2. Компоненти, які необхідні для встановлення програми
Для того щоб встановлення програми Comarch EDI Connector Premium було успішним, повинні
бути дотримані наступні вимоги:

- процесор – мінімум 1,4 GHz;

- кількість вільної пам’яті RAM – мінімум 1GB;
- вільне місце на диску – 500 MB (при цьому необхідна кількість місця для комфортної праці
програми залежить від частоти обміну документами та їх об’єму);
- операційна система – Windows (7, Vista, XP, 2000), Linux;
- доступ до Інтернету;

Увага: Дана інструкція стосується встановлення програми тільки для операційної системи
Windows.

Крім того для правильної роботи програми необхідно встановити Java версія принаймі 7. Останню
версію цієї програми можна завантажити з сайту - http://www.java.com/pl/.

Також програма використовує в своїй праці зовнішню базу даних, в якій зібрана інформація про
вислані і оброблені документи, а також їх статуси. Програма може співпрацювати з п'ятьма
серверами баз даних:

- MySQL
- MS SQL
- Oracle
- PostgreSQL
- Firebird

Увага: правильне подання даних вимагає бази даних з кодуванням UTF-8.

Якщо користувач користується однією з вищезгаданих баз, можливо є, щоб програма Comarch EDI
Connector Premium також користувалася саме цією базою. Якщо користувач не використовує
жодної з перелічених баз даних, можливі два варіанти:

• можна власноруч інсталювати одну з перелічених баз даних, або

• використати базу даних, яка включена до програми. В такому випадку вона буде
встановлена під час інсталяції програми, і її кодування буде установлено на UTF- 8.

Якщо користувач вирішить самостійно інсталювати базу даних, то це необхідно зробити перед
встановленням Comarch EDI Connector Premium.

Запуск програми можливий за допомогою веб-браузера, тому необхідно встановити один з нижче
вказаних інтернет браузерів:

- Internet Explorer – версія 8 або новіша (версія 10 на даний час не підтримується);

- Firefox – версія 13 або новіша;
- Google Chrome – версія 20 або новіша;
- Opera – версія 12 або новіша.

Рекомендується використовувати останні версії цих браузерів.

4
Програма використовує бібліотеку, котра знаходиться в каталозі EDIConn\lib. Програма була
протестована з доданими версіями бібліотек. Користувач, котрий оновив дані бібліотеки, бере на
себе повну відповідальність за роботу програми після таких змін.

5
 3. Встановлення рівня безпеки – доступ до програми
Щоб встановити додаток для роботи належним чином, необхідно виконати ряд вимог, пов'язаних
з налаштуванням безпеки, а саме:

- Робоче місце повинне містити порт 8080 (або інший, який буде обраний під час
встановлення). Це необхідно зробити для того, щоб мати можливість віддалено
користуватися програмою.
- В мережі Інтернет повинні бути допущені до комунікаційного порту 80 і 443 ( з’єднання з
WebService здійснюється через протокол HTTPS ).
- У випадку, коли використовуєте віддалені каталоги, необхідно надати доступ програмі до
цих файлів.
- Потрібно відключити брандмауер в системі де є віддаленні каталоги.

6
 4. Встановлення програми.
Нижче описаний процес встановлення програми Comarch EDI Connector Premium.

1. При запуску програми з'являється вікно установки з вибором мови. Мовою по замовченню
є польська, вибрати також можна англійську, російську, французьку, німецьку і угорську.

Вибір мови

Після вибору мови необхідно натиснути кнопку „OK”.

Увага: на кожному кроці можна перервати інсталяцію за допомогою кнопки „Выход”, що

знаходиться в правому нижньому куті вікна. За допомогою кнопки „Назад” можна повернутися
до попереднього етапу інсталяції.

2. В наступному вікні, що продовжує процес встановлення необхідно натиснути „Далее”.

3. На наступному етапі відображається інформація щодо ліцензії програми. Щоб продовжити

встановлення необхідно погодитися натисканням кнопки „Далее”.

4. У верхній частині вікна знаходиться поле, в якому необхідно вказати номер порту веб-
додатків. Порт за замовчуванням - 8080. Можна вибрати інший. Якщо вказаний порт під
час встановлення не доступний, то виберіть наступний доступний. На даному етапі також
можна налаштувати проксі-сервер. Якщо значення не вводяться, проксі-сервер
налаштований.

7
 Вибір порта та проксі-сервера

5. Потім виберіть базу даних, з якої програма буде отримувати дані - програма може
працювати з однією із п'яти баз даних - MySQL, MS SQL Server, Oracle, FirebirdlubPostgreSQL.

УВАГА: Після встановлення програми, зміна бази даних можлива, але тільки для тих
користувачів які обізнані в цьому. Налаштування нової бази даних можливе після втрати
доступу до поточної бази. Потрібно створювати як при спробі повторної конфігурації бази
даних, котра використовувалася до сих пір, однак змінюючи сервер баз даних на той, що
вимагається. Жодні дані користувача не будуть перенесені до нової бази. Детальніше в
розділі 6.5.

5.1 Якщо користувач володіє доступом до однієї з цих баз, і хоче, щоб програма з неї
користувалася, тоді слід відмітити варіант я "Сервер базы даннях уже имеется". База
даних користувача має бути вже на цьому етапі інсталяції програми доступна і в
кодуванні UTF- 8.
а) Після цього, щоб задекларувати використання власної бази слід зазначити відповідну
позицію.

8
 Вибір встановленої бази даних

Після обрання відповідної бази слід натиснути кнопку "Далее".

б) У наступному вікні введіть інформацію для бази даних, з якої програма буде отримувати
інформацію.

Конфігурація встановленої бази даних

9
Поля "Host" та "Порт" заповнюються значеннями за замовчуванням, але можна змінити.
Обов'язково слід заповнити поля "Имя пользователя" також "Название БД". Якщо обрана база
даних захищена паролем - необхідно також ввести в поле "Пароль" також "Повторите пароль".
Потім слід натиснути кнопку "Далее".

5.2. Якщо жодна з вищезгаданих даних баз не встановлена, можна тоді скористатися
залученою до програми базою даних. З цією метою вибрати слід варіант "Установить сервер
“Firebird” і "Далее".

УВАГА: У цьому випадку програма встановить базу даних Firebird і створить користувача бази
даних з ім'ям sysdba та встановить пароль tracking. Програма в базі даних Firebird встановить
кодування UTF-8.

а) У наступному вікні можна вибрати каталог, в якому база даних буде встановлена.

Вибір каталогу інсталяції бази даних

Якщо база даних повинна бути встановлена в іншому каталозі, не в тому, що за замовчуванням, то
у вікні установки каталогу необхідно вказати шлях до потрібного каталогу - ви можете зробити це
вручну або за допомогою кнопки "Обзор", натиснувши на яку можна вибрати відповідний каталог.
Після встановлення каталогу бази даних, натисніть “Далее”.

6. Наступне вікно дозволяє встановити каталоги для програми Comarch EDI Connector
Premium і дані для користувача (документи, логи, Firebird базу даних, якщо її було вибрано). Якщо
Ви бажаєте зробити це по іншому, ніж за замовчуванням, Ви можете змінити (або вручну, або за
допомогою кнопки "Обзор").

10
 Вибір каталогу інсталяції додатку

Після вибору каталогу інсталяції потрібно натиснути «Далее».

а) Якщо вибраний каталог не існує, одразу з’явиться запит на його створення. Потрібно натиснути
«ОК».

Запит на створення каталогу інсталяції

11
б) Якщо для інсталяції додатку був вибраний каталог, що вже існує, одразу з‘явиться табличка з
попередженням, що у випадку продовження інсталяції в цьому каталозі, файли, що в ньому
існують, будуть перезаписані. Якщо так має бути, оберіть «Да».

Повідомлення про існування вибраного каталогу

7. В наступному вікні бачимо прогрес інсталяції. Після її закінчення потрібно натиснути «Далее».

8. В наступному вікні представлено можливість створення ярликів додатку.

12
 Налаштування ярликів

- Вибір функції «Создать ярлыки» призведе до створення ярлика для додатку в меню
«Старт». Місце, де з’явиться ярлик, можна вибрати зі списку, що висвітлиться або
залишити за замовчуванням.

- Якщо Ви оберете функцію «Создать ярлыки на рабочем столе», то ярлик для додатку буде
створено на робочому столі комп’ютера.

- Також можна обрати чи ярлики мають бути створені для поточного користувача чи для всіх
користувачів даного комп’ютера.

Створення ярликів для додатку не є обов’язковим – якщо жодна з функцій не буде

вибрана, то і ярлики не будуть створені. Після закінчення конфігурації ярликів, потрібно
натиснути «Далее».

9. В наступному вікні бачимо прогрес опрацювання. Після закінчення опрацювання, необхідно

натиснути «Далее», пізніше «Закончить». Після цього програма буде запущена в браузері за
замовчуванням.

13
 5. Конфігурація послуги
Конфігурація програми є обов’язковою для того, щоб її запустити. Після закінчення встановлення
програма запускається автоматично з відкритою вкладкою "Основная конфигурация службы".

Проведення інших доступних налаштувань не є обов’язковим для коректної роботи програми.

Налаштування можна змінити в будь-який момент, натиснувши на вкладку «Конфигурация», а

потім, обираючи опцію, котра має бути змінена.

Вкладка «Конфигурация»

В будь-який момент зміни налаштувань є можливість повернутись до передніх налаштувань,

натиснувши «Предыдущий». Натиснувши «Отменить» можна в будь-який момент припинити
налаштування і дані, що були введені, не будуть збережені.

Кнопки навігації

14
 5.1 Конфігурація головної послуги
На першому етапі «Конфігурації головної послуги» бачимо наступне вікно:

Налаштування головної послуги – користувачі

У відповідних полях потрібно записати назву користувача Comarch EDI та пароль. Якщо програмою
буде користуватись більш, ніж один користувач Comarch EDI, то потрібно написнути кнопку
«Добавить следующего пользователя». Внесений попередньо користувач буде відображатися
справа, а в пустих полях можна записати дані наступного користувача.

Налаштування головної послуги – додавання наступного користувача

Щоб видалити попередньо записаного користувача чи редагувати його дані, за допомогою кнопок
«Предыдущий» або «Следующий», потрібно записати його дані в полях «Имя пользователя» або
«Пароль». В момент, коли бачимо дані відповідного користувача, є можливим редагування або
видалення за допомогою кнопки «Удалить пользователя».

15
Після введення даних всіх Користувачів, потрібно, за допомогою кнопки «Следующий» перейти до
вікна «Отправленные файлы».

В вікні «Отправленные файлы» видно таблицю з усіма зв’язками, в котрих внесений раніше
Користувач (або Користувачі) є стороною, котра надсилає документи.

Налаштування головної послуги – документи надіслані

Для кожного з зв’язків можна побачити користувача (цей стовпець бачимо лише у випадку, якщо
попередньоми ми внесли більше, ніж одного користувача), також його GLN (стовпець GLN
вихідний), назву партнера, котрому у даному зв’язку надсилаються документи та його GLN (GLN
поставки), та номер ID зв’язку. Також видно таку інформацію, як тип висланого документу по
даному зв’язку, стандарт, тип, версія та чи даний зв’язку є тестовим. В стовпці «Кодирование»
встановлено кодування згідно якого прочитані документи є надісланими. Кожний зв’язок можна
змінити, розробляючи список опцій та обираючи відповідну.

16
 Налаштування головної послуги – вибір кодування

Для кожного зв’язку потрібно встановити каталог, з котрого на дані зв’язки будуть вислані
документи – каталог обміну документами.

Для цього спершу можна встановити базовий каталог – основний каталог для всіх контрольованих
каталогів для вихідних зв’язків. Виходить, що це каталог „Output” в інсталяційному каталозі даних
додатків. Щоб це змінити, в полі «Основний каталог» потрібно вписати шлях до вибраного
каталогу або натиснути кнопку зі знаком лупи для перегляду каталогів, що знаходить
безпосередньо біля вікна «Основний каталог». Після обрання основного каталогу потрібно,
натиснути «Применить». Це призведе до зміни всіх шляхів для каталогів обміну документами.

Налаштування головної послуги – базовий каталог

Очевидно, контрольовані каталогі є створені в базовому, а їх назви утворюються згідно зразку:

OUT_[Typ_dokumentu]_[GLN_docelowy]_[ID]. У випадку бажання зміни назви каталогу обміну
17
документами або бажання зміни шляху його локалізації або нової назви каталогу можна
встановити у відповідному полі в стовпці «Каталог мониторинга».

Каталоги обміну документами не повинні бути на комп’ютері, на котрому програма була

заінстальована. Щоб налаштувати каталог обміну документами, як віддалений, в останньому
стовпці потрібно вибрати опцію «Удаленный путь», а потім натиснути на піктограму поруч, щоб
налаштувати доступ до віддаленого каталогу. Не можна використовувати підключені мережеві
диски. Обов’язковим є введення повного шляху в полі «Удаленный путь». Поля «Пользователь» та
«Логин» є обов’язковими.

Після налаштування каталогу обміну документами, створюються два підкаталоги: Backup oraz Fail.
В перший потрапляють копії документів, коректно надісланих через програму. Якщо документ не
може бути перенесений в папку Backup (наприклад, немає доступу до цієї папки), змінюється його
назва на {nazwa_pliku}.backup lub {nazwa_pliku} _1.backup (якщо такий документ вже існував).
Якщо документ не був висланий або закінчилися невдачею всі спроби його ретрансмісії, то
користувач повідомлений про це відповідним повідомленням в журналі або банером, що
висвітлюється над закладками в головному вікні програми (коли користувач натискає на банер,
стає зрозумілим, що документ із зазначеного шляху не було відправлено). Додатково не
надісланий документ переноситься в каталог Fail. Якщо програма проводить перенесення
документу в папку Fail, а документ в цей момент недоступний (наприклад, відсутність
повноважень), то документ змінює назву на {nazwa_pliku}.failed і повторно не надсилається.

Налаштування головної послуги – Налаштування доступу

Після встановлення назв та локалізації каталогів обміну документами для усіх зв’язків потрібно
натиснути «Следующий».

Наступне вікно – «Входящие документы», в котрому є видимі всі зв’язки, для котрих вказаний
Користувач (або Користувачі) є стороною, що приймає документи. Для цих зв’язків потрібно
визначити каталоги, в котрі будуть приходити документи, що поступають з індивідуальних
зв’язків.

18
За замовчуванням як базовий каталог, поданий каталог „Input” в застосуванні інсталяційного
каталогу, а назви каталогів для окремих зв’язків формуються за зразком:
IN_[Typ_dokumentu]_[GLN_źródłowy]_[ID]. Подібно як у випадку вихідних зв’язків, так і тут є
можливою зміна основного каталогу, як і окремих каталогів локалізації. Можливим також є
застосування віддалених шляхів для контрольованих каталогів. На цьому етапі можливо також
обирати кодування, яке буде установлене для відібраних документів. Після закінчення
налаштування потрібно натиснути «Следующий».

У вікні «Режим роботи» потрібно встановити режим роботи програми, тобто, коли програма буде
розпочинати процес надсилання або завантаження файлів.

Налаштування головної послуги – режим праці

Зліва можемо вибрати дні тижня. Далі обираємо годину початку та годину припинення режиму
праці та тривалість в полі «Интервал запуска», що визначає частоту початку процесів обміну даних
у вказаній годині початку та закінчення. Наприклад, вибори на верхньому малюнку означають, що
надсилання та завантаження документів буде відбуватися по понеділках та четвергах,
розпочинаючись у 8.00 годині та закінчуючись у 20.00 кожних 10 хвилин, а отже 8.00, 8.10, 8.20 і
так дальше кожних 10 хвилин аж до 20.00.

Після встановлення режиму праці слід натиснути «Следующий».

В наступному вікні бачимо підсумок внесених змін. Якщо котрісь з них є невластивими, за
допомогою кнопки «Предыдущий» існує можливість повернення до відповідного екрану і
виправлення налаштувань.

19
 Налаштування головної послуги – Підсумок

Якщо все правильно, потрібно натиснути «Закончить».

Трансмісія і ретрансмісія

Програма проводить трансмісію документів в пачках, що не перевищують 1 Мб і не більше 10

файлів. Якщо розмір файла, що надсилається, перевищує 1 Мб, то він надсилається по-одному.

Якщо документ з якоїсь причини не надсилається, програма розпочинає спробу ретрансмісії. На

першому етапі програма виконує спробу кожних 6 хвилин протягом 72 годин роботи програми (3
доби). Якщо ці спроби є невдалими, то наступні спроби тривають 90 раз на добу. Якщо документ
після цього не буде надісланим, то буде пересланим до підкаталогу Fail в контрольованому
каталозі (наскільки він є доступним). Ретрансмісія не надісланого раніше документу відбувається
окремо.

Увага: У випадку ретрансмісії документів з віддалених каталогів остання ретрансмісія з

запланованого графіку виконується для кожного документу окремо з погляду на пробу
надсилання документів до каталогу Fail, що блокує інші можливі ретрансмісії. При подальшому
рахунку документів, що пройшли ретрансмісію з віддалених каталогів (стосується лише останньої
запланованої трансмісії) з погляду на мережеві затримки, може відбутися затримка можливих
ретрансмісій інших документів.

20
 5.2. Конфігурація сервера SMTP
Програма Comarch EDI Connector Premium дає можливість інформування користувача про
помилки, що виступили, за допомогою e-mail повідомлень. Щоб використати цю можливість,
потрібно зробити налаштування сервера SMTP, а саме подати дані рхунку, з якого будуть надіслані
повідомлення або e-mail-адреси, на котрі повідомлення будуть надіслані.

Для цього у вкладці «Конфигурация» потрібно зайти в «Конфигурация сервера SMTP», яка
відкриває налаштування сервера SMTP. У відповідних полях потрібно ввести інформацію про
адресу, з якої будуть відправлятися повідомлення – в полі «Порт» за замовчування стоїть значення
25, але якщо це необхідно його можна змінити.

Конфігурація сервера SMTP

Для того, щоб послуга була запущена потрібно заповнити поля Узел, Порт i Отправитель. Поля Имя
Пользователя i Пароль є не обов’язковими для заповнення. Після введення потрібних даних
потрібно натиснути «Следующий»

У вікні «Е-mail адрес» можна вказати адресатів повідомлень про помилки.

Конфігурація сервера SMTP – адреса e-mail

21
Для цього в полі «Новый е-mail адрес» потрібно вписати e-mail адресу на яку будуть відправлятись
повідомлення, а з випадаючого списку потрібно вибрати, чи повідомлення будуть відправлятись
тільки під час критичних помилок, чи для всіх помилок.

«Критическая ошибка» - означає неправильні завершення додатка, вхід на рівні критичної

помилки.
«Все ошибки» - це критичні помилка або також ті, що не ведуть за собою помилкове завершення
роботи додатку, але які інформують про проблеми у зв’язку з COMARCH EDI, інформують про
проблеми з відправленням і отриманням даних. Вхід з рівнем помилки або вище.

Після введення адреси і виставлення рівня повідомлень, потрібно натиснути «Додати адресу».
Дана адреса з'явиться в списку адрес.

Конфігурація сервера SMTP – додавання адреси e-mail

Також можна додати кілька e-mail адрес і для кожної встановити рівень повідомлень. Всі додані
адреси (які були додані за допомогою натискання «Добавить e-mail») представлені в таблиці.

22
 Конфігурація сервера SMTP – додавання кількох e-mail адрес

Адреса електронної пошти, що додана до списку, може бути видалена натиснувши на відповідний
рядок у таблиці. Потім вибрана адреса з’явиться у вікні «Новый e-mail адрес» з можливістю її
видалення зі списку (натиснувши «Удалить») або редагувати (після внесення відповідних змін в
адресі, потрібно натиснути кнопку «Сохранить» після чого зміни будуть збережені).

Конфігурація сервера SMTP – редагування e-mail адреси

Після добавлення до списку всіх адрес потрібно натиснути «Конец».

23
 5.3 Налаштування формату назви документа
Додаток дає можливість вибрати назву файлів отриманих документів. За замовчуванням
встановлений формат [дата_отримання]_[id_повідомлення]. Щоб його змінити, потрібно в
закладці «Конфигурация» вибрати «Конфигурация названия формата файла полученных
документов». Далі потрібно вибрати відповідний формат з наведених в списку, відзначивши його у
вікні вибору.

Конфигурация названия формата файла полученных документов

Після вибору потрібно нажати «Следующий», після цього відбудеться перехід до вікна закінчення
дії. В цьому вікні відображається раніше обраний формат назви документа.

Конфігурація формату назви файла - підсумок

Якщо ж цього не відбулось, то за допомогою кнопки «Отменить», ви можете повернутись до вікна

вибору формату. Якщо формат наведений правильно, натисніть «Готово».

24
 5.4 Налаштування мовних параметрів Логів
В додатку можна змінювати мову логів в які записується інформація про помилки. Для того щоб це
зробити, потрібно у вкладці «Конфигурация» перейти до «Файлы логов языковой конфигурации» і
з списку вибрати потрібну мову.

Конфігурація мови логів

Після вибору мови потрібно натиснути кнопку «Следующий», після чого з’явиться вікно
підтвердження. Щоб підтвердити вибір мови потрібно натиснути «Конец».

Зміна мови логів не впливає на помилки які вже були записані – далі вони будуть відображатись
мовою, якою були записані в попередній раз.

25
 5.5 Конфігурація доступу до мережевої служби Comarch EDI
Наступна функція, що стосується конфігурації послуги, це можливість змінити адресу за якою є
доступна мережева служба. Під час звичайної роботи програми немає необхідності втручатись в
це налаштування.

Конфігурація доступу до мережевої служби Comarch EDI

26
 5.6 Конфігурація проксі-сервера
Налаштування проксі-сервера є необов’язковим і є доступним під час встановлення додатку або в
налаштуваннях програми після її становлення. Користувач проксі-сервера повинен в
налаштуваннях вказати наступні дані: Узел, Порт, Имя пользователя і Пароль (і підтвердження
пароля). Якщо поле Host буде вибране, то поле Port є обов’язковим. Після заповнення відповідних
даних користувач повинен підтвердити їх натиснувши кнопку «Следующий», яка його переведе у
вікно підтвердження, де будуть відображені заповнені дані. Якщо дані правильні, тоді потрібно
натиснути «Конец», щоб нові дані були записані. Якщо у вікні підтвердження дані потрібно
виправити, то для цього потрібно настинути «Предыдущий».

Підсумок для налаштування проксі-сервера

Після налаштування проксі сервера можна змінити його параметри шляхом зміни його
конфігурацій або зміни бажаних значень. Якщо всі дані будуть видалені, а користувач підтвердить
це натиснувши «Следующий» або «Конец», то після цього жоден проксі-сервер не буде
використовуватися.

Скасування налаштувань для проксі-сервера

27
 6. Робота програми
Налаштована і запущена програма працює в фоновому режимі і автоматично запускається при
старті операційної системи.

28
 6.1 Запуск програми
Запустити програму можна за допомогою ярлика на робочому столі або меню Пуск (якщо вони
були створені в процесі встановлення). Програма по замовчуванню відкривається за допомогою
інтернет браузера.

Програму можна також відкрити, якщо в адресному вікні інтернет браузера вставити посилання
«http://localhost» або з номером порту «http://localhost:8080».

Також можливий доступ до програми з іншого комп’ютера, на якому не був встановлений даний
додаток. Щоб це було можливо, комп’ютер на якому був встановлений додаток має бути
включений і на ньому має бути виключений брандмауер.

Для того щоб увійти в програму з іншого комп’ютера на якому не встановлена дана програма,
потрібно в адресній стрічці інтернет браузера вписати ІР комп’ютера, на якому встановлена
програма, і номер порту додатку, наприклад «http://212.11.6.211:8080».

Після вписання адреси в поданій вище формі відкриється вікно для входу. Потрібно буде вписати
ім’я користувача і пароль до системи на якому встановлена програма. Всі поля є обов’язковими.

Після запуску програми в верхній частині вікна буде видно стрічку з закладками – Надіслані
документи, Опрацьовані документи, Налаштування та логи.

Закладки

Для того щоб перейти до потрібної закладки потрібно на неї натиснути.

Крім цих закладок в правій стороні екрану знаходиться вкладка «Изменить дату». Після
натискання по цій кнопці, незалежно він встановленого в процесі конфігурації режиму роботи,
починається надсилання і приймання документів які очкуються на відправку/прийом.
З правої сторони вікна знаходяться піктограми «Язык», натиснувши на відповідний прапорець,
мова буде змінена.

Піктограми зміни мови

В наступних розділах докладно описані функції окремих закладок.

29
 6.2 Вихідні документи

В закладці «Вихідні документи» відображається інформація відправлених документів за

допомогою додатку. Функція пошуку дає змогу знайти потрібний документ або групу документів.
Також можливе сортування знайдених документів.

Пошук

Документ можна знайти за допомогою 4-х критеріїв:

- Абсолютный путь;
- ID Передачи - унікальний номер документу під час надсилання;
- Создать дату из;
- Статус обработки;

Вихідні документи

Для пошуку документів за критеріями Абсолютный путь і ID передачи потрібно заповнити

відповідні критерії в поля після чого натиснути кнопку «Поиск». У таблиці нижче будуть
відображені документи, які відповідають заданим критеріям пошуку.

УВАГА - незалежно від заданих критеріїв пошуку, додаток покаже максимально 1000
документів.

30
Під час пошуку документів можна використовувати символ «*», який означає будь-який довільну
кількість знаків. Наприклад, якщо у вікні ID передачи написати «1*» тоді пошук документів буде
відбуватись за ID номером в якому перша цифра «1».

Надіслані файли – знайдені з використанням „*”

Якщо ввести дані в поле «Создать дату из» і натиснути «Поиск», то будуть відображені документи
відправлені в зазначений день і пізніше, і навпаки, якщо ввести дані в поле «Создать дату в», то
будуть відображені документи як відправлені до зазначеної дати. Також можливе одночасне
використання цих полів. Дати, встановлені, як показано на рисунку нижче, будуть відображати
документи відправлені в період з 1 січня по 10 лютого 2014 року.

Надіслані файли – приклад пошуку за датою

Дані в поля дати можна також вводити вручну, але для цього потрібно дотримуватись
відповідного формату Рік-Місяць-День. Також можна використовувати піктограму календаря яка
знаходиться з правої сторони вікна вводу, якщо натиснути на дану іконку відкриється календар в
якому можна вибрати потрібну дату.
31
 Календар

Поле обведене чорним означає поточну дату. Якщо день має бути з іншого місяця, то потрібного
вибрати відповідний місяць за допомогою натискання на ліву і праву стрілки, яка знаходяться біля
назви місяця. Після вибору відповідного місяця для того, щоб вибрати день потрібно на нього
натиснути. Для того щоб закрити календар потрібно натиснути на знак закриття в правому
верхньому куті вікна.
Щоб знайти документ за статусом обробки потрібно вибрати відповідний статус зі списку біля поля
статус опрацювання і натиснути пошук.

Надіслані файли - статус опрацювання

Статус «Отправлено к COMARCH EDI» надається документам, що були надіслані програмою, а

статус «Обработано в COMARCH EDI» відповідає тим документам, які вже опрацьовані на
платформі COMARCH EDI.
Також є можливість пошуку по більш ніж одному параметру. Отож, можна, як на рисунку
поданному нижче, знайти документ по його абсолютному шляху, котрий був надісланий 14 і 15
березня.

32
 Надіслані файли– пошук за декількома параметрами

Презентація списку документів

Знайдені документи відображаються списком результатів. В данному списку подані такі

параметри документів, як абсолютний шлях, дата створення, submission ID, а також статус
опрацювання.

Надіслані файли – список результатів

Для документів зі статусом опрацювання: „Документ був правильно опрацьований через Comarch
EDI” додатково появляється колонка Документи, в котрій присутні піктограми, які надають
можливість переглядати дані документи в закладці „Документи опрацьовані” (після натискання на
піктограму відкривається закладка Документи опрацьовані, а там в таблиці результатів
відображається відповідний документ). Якщо висланий файл містив кілька документів, то поруч з
піктограмою, в останній колонці, буде відображена кількість документів, що міститяся в даному
файлі, а натиснувши на дану піктограму всі документи з даного файлу будуть відображені в
закладці „Документи опрацьовані”.

На одній сторінці максимально відображається 20 документів. Якщо критеріям пошуку відповідає

більша кількість документів, в такому разі, можна їх побачити переміщуючись між сторінками за
допомогою навігації, розташованій по правій стороні під таблицею.

Список результатів- пошук між сторінками

33
Натиснувши на подвійну стрілку з правої сторонни, відбудеться перехід до останньої сторінки, а
подвійна стрілка по лівій стороні – до першої сторінки. Стрілки одинарні надають можливість
перейти, відповідно, до наступної або попередньої сторінки, а натиснувши на номер сторінки
спричинить перехід до тої сторінки.

Сортування

Знайдені документи подані у списку в порядку, в котрому були надіслані, починаючи від висланих
раніше. Існує можливість сортування цих документів на основі обраних параметрів. Параметри, на
основі котрих є можливим сортування в таблиці, відображаються підкресленням. У випадку
закладки «Отправленные файли» існує можливість сортування відображених документів на основі
абсолютного шляху або дати створення.

Щоб це зробити потрібно натиснути в назві колонки, на основі котрої документи мають бути
посортовані. Вона буде відмічена, а з правої сторони з’явиться стрілка, що означатиме, чи
документи посортовані за зростанням чи за зменшенням.

Сортування за зростанням

На рисунку поданому вище, документи посортовані на основі дати створення, за зростанням – а

отже від дати найраніше до найпізніше. Щоб скасувати сортування ( а отже сортувати від дати
найпізніше до найраніше) належить ще раз натиснути на назву колонки. При назві колонки
з’явиться стрілка направлена вниз, що означатиме – сортування за зменшенням.

Сортування за зменшенням

Аналогічно поступаючи, можна посортувати документи на основі абсолютного шляху.

34
 6.3 Документи опрацьовані
В закладці «Обработанные документы» є можливість переглядати всі документи, котрі були
опрацьовані через платформу Comarch EDI, а програма отримала про це інформацію.

Пошук

Документи в закладці «Обработанные документы» можна шукати за допомогою:

- Номеру GLN відправника та отримувача документа

- Назви партнера відправника та отримувача документа
- Напрямку – чи документ був надісланий, чи прийнятий;
- Номеру GLN місця доставки - взятого із вмісту документу;
- Message ID – індивідуальний номер, що надається документові через
платформу Comarch EDI;
- Номеру документа - взятого із вмісту документа;
- Типу бізнесу;
- Дати документа – взятого із змісту документу;
- Дати опрацьовання;
- Статусу опрацьовання – стосується лише документів надісланих.

Документи опрацьовані – критерії пошуку

Пошук документів відбувається аналогічно до пошуку документів в закладці

«Отправленные файли».

Презентація списку документів

Знайдені документи відображаються в таблиці разом з такою інформацією, як ID

повыдомлення, Дата опрацьовання, Номер документа, Дата документа, GLN місця
доставки, Відправник, GLN відправника, Отримувач, GLN отримувача, напрямок, бізнес-
тип, Статус опрацювання.
35
 Документи опрацьовані – список результатів

Якщо мова йде про статуси опрацювання в останній колонці, то вони відображаються
лише для документів надісланих. Натиснувши на статус опрацювання данного документа,
відобразиться історія його опрацювання.

Таблиця історії опрацювання містить таку інформацію, як Дата, Тип транспорту, Тип, Етап,
Стан, а також Опис. Можливим є сортування історії даного файла використовуючи всі
параметри, окрім опису.

Щоб закрити вікно історії опрацювання, потрібно натиснути хрестик в його правому
верхньому куті.

Якщо кількість знайдених документів є більша, ніж двадцять, вони відображаються на

відповідній кількості сторінок, по котрих можна переміщатися так, як описано для
закладки «Отправленные файлы».

Сортування

В закладці «Обработанные документы» є можливим сортування знайдених документів

використовуючи параметри Дата опрацювання, Номер документу, Дата документа, GLN
місця доставки, Партнер та GLN відправника, Партнер та GLN получателя, Напрямок та тип
бызнесу. Саме сортування відбувається так само, як в закладці «Отправление файлы».

36
 6.4 Логи
Закладка «Логи» надає можливість швидко і зручно переглядати логи програми. Кожний лог, що
записаний за допомогою програми Comarch EDI Connector Premium має приписаний один з
чотирьох рівнів:

- Помилка критична – так записуються помилки, що спричиняють неправильну затримку

додатку; то помилки, котрі при конфігурації сервера SMTP описані як «Помилки критичні»;

- Помилка – так записуються помилки, не спричиняючі затримку додатку, що стосуються

напр. проблем комунікації з платформою Comarch EDI, проблем з надсиланням і прийманням
документів чи проблем з отриманням даних;

Помилки логування з рівнями Помилка критична чи Помилка, при конфігурації сервера SMTP
описані як «Все ошибки»;

- Попередження – це є рівень «попереджувальних», логів таких як напр. запис інформації

про брак конфігурації для послуг повідомлень e-mail чи невдалої спроби надсилання документа;

- Інформація – це є рівень логів інформуючи про нормальну роботу додатку, напр. Про
отримання документів.

Пошук

Система пошуку логів є схожою до попередніх закладок. Щоб була можливість шукати логи,
потрібно встановити відповідні значення в двох попередніх полях:

- В полі «Логи файла» потрібно вибрати файл, з котрого будуть прочитані логи;
o Файл core_log.txt містить логи, що стосуються механізму передачі документів.
Якщо розмір файлу core_log.txt перевищить 100 MB, то буде архівований зі зміною назви, а
наступні логи будуть записуватися до нового файла core_log.txt.
Це означає, що поміж файлів логів, можна буде вибрати додаткову позицію з
заархівованим файлом.
o Файл web_log.txt стосується діяльності додатку, що представляє результати
користувачу;
- В полі Рівень логів потрібно обрати рівень логів, що відображаються;

Пошук логів можна здійснювати за датою створення, а також за назвою повідомлення. У випадку
коли буде відмічено вікно «Больше одного вставлено», що знаходиться під полем «Сообщение»,
будуть відображені всі повідомлення за винятком тих, назви котрих вписані в поле «Сообщение».

37
 Лог – критерії пошуку

Після встановлення критеріїв пошуку потрібно натиснути на кнопку «Поиск».

Презентація списку логів

Логи, що відповідають критеріям пошуку, відображаються в таблиці, котра містить три колонки:
дата створення, рівень логів та повідомлення.

Лог– список результатів

У випадку, коли кількість логів більша, ніж двадцять, вони відображаються на відповідній кількості
сторінок, по котрих можна переміщуватися в спосіб, раніше описаний для закладки
«Отправленные файлы». Назви деяких повідомлень підкреслені (приклад на рисунку поданому
вище – перший лог «Запуск приложения»), це означає, що лог містить більше інформації, ніж ті, що
відображені в полі «Сообщение». Щоб побачити цілком повідомлення, потрібно натиснути на його
назву. Тоді в новому вікні появиться повна інформація про даний лог. Щоб закрити вікно потрібно
натиснути на хрестик в правому верхньому куті.

Лог – деталі
38
 6.5 Втрата з’єднання з базою даних
В деяких випадках з’єднання з базою даних може бути втрачене (напр. зміна паролю до бази,
зміна розташування бази, недоступність бази). Про даний факт користувач є поінформований за
допомогою банера.

Інформація про втрату з’єднання з базою даних

Після натиснення на банер користувач заново переміщується до вікна конфігурації бази даних.

УВАГА: зміна сервера бази даних після інсталяції додатку є можлива лише у випадку втрати
з’єднання з актуально сконфігурованою базою. Якщо користувач бажає змінити базу, котру він
актуально використовує, на іншу, то повинен на першому кроці обрати бажаний новий сервер
бази даних, а потім подати дані для доступу до нової бази.

В першому вікні потрібно вказати сервер бази даних, до котрого додаток втратив з’єднання, а
потім затвердити цей вибір натиснувши «Следующий».

Вибір бази даних для відновлення конфігурації

В наступному вікні будуть прийняті дані доступу до бази даних, вказані під час інсталяції додатку.
На цьому етапі потрібно перевірити, чи подані дані доступу правильні. Помилкові дані потрібно
виправити. Пароль є зашифрований. Якщо був змінений, потрібно ввести правильний пароль в
поле «Пароль» та «Подтверждение пароля». Введені дані потрібно підтвердити кнопкою
«Следующий». Якщо доступ до бази відновлено, користувач може перервати конфігурацію за
допомогою кнопки «Отменить». Натиснувши на кнопку «Предыдущий» користувач повертається
до вікна вибору сервера бази даних.

39
 Дані доступу до конфігурації бази даних

В наступному вікні подано підсумок введених даних доступу. Якщо подані дані правильні,
потрібно натиснути кнопку «Конец», котра запустить перезагрузку програми з новими …

Підсумок з введеними даними доступу

Інформація про перезагрузку програми

40
 6.6 Оновлення програми
Програма містить функціональність оновлення. Інформація про доступне оновлення
відображається в додатку за допомогою банера.

Оновлення програми не виконується автоматично. Однак рекомендовано його виконання. Щоб це

зробити, потрібно натиснути на банер, що інформує про доступні оновлення. Тоді користувач
переходить до нового вікна, в котрому є можливе запуск оновлення. Щоб це виконати потрібно
натиснути на кнопку «Обновление».

Після натиснення даної кнопки, запускається оновлення, а користувачу відображається вікно з

повідомленням про те, що актуалізація розпочалася.

В процесі оновлення замінюються відповідні файли та перезапускаються сервіси. Після закінчення

цього процесу, відображається банер з інформацією, що додаток оновлено. Натиснення на цей
банер, нічого, окрім його зникнення, не спричиняє.

41
 6.7 Реінсталяція
Запуск інсталяційного файла Comarch EDI Connector Premium у випадку, коли додаток
заінстальований, ініціює процес реінсталяції. Цей процес, подібно до інсталяції, починається від
вибору мови. На наступному кроці користувач інформується про знайдену версію програми, а
також про версію, котру користувач має намір заінсталювати. Підтвердження цього вибору
відбувається через натискання кнопки «Да». Якщо користувач обере «Нет», процес реінсталяції
закінчується.

Інформація про знайдену версію програми

На наступних кроках реінсталіяції інсталюються нові файли додатку та заново запускаються

сервіси. На останньому кроці відображається інформація про статус проведеної реінсталяції. Цю
інформацію потрібно підтвердити натиснувши на кнопку «Готово».

Інформація про закінчення реінсталяції

42
 6.8 Деінсталяція
З ціллю деінсталяції програми потрібно запустити деінсталятор, що знаходиться в папці Uninstaller,
котра знаходиться в інсталяційній папці додатку.

Після запуску з’являється вікно деінсталятора.

Вікно деінсталятора перед деінсталяцією

Якщо перед деінсталяцією додатку буде зазначена опція «Удалить все подкаталоги…», тоді в
процесі деінсталяції буде усунений весь вміст інсталяційної папки. Якщо опція не буде зазначена,
тоді після деінсталяції в інсталяційній папці залишуться, між іншим, логи та конфігураційний файл,
файл бази даних Firebird, а також (якщо знаходилися в цій папці) папки з файлами прийнятими та
надісланими.

З метою запуску деінсталятора потрібно натиснути кнопку «Удалить установленные програмы».

Після закінчення деінсталяції на стрічці прогресу появиться відповідна інформація.

Вікно де інсталятора після деінсталяції

Щоб закрити деінсталятор потрібно натиснути кнопку «Выход».

43