> ## Documentation Index
> Fetch the complete documentation index at: https://docs.flexoworks.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Встановлення сервісу CDI

> Встановіть сервіс Windows, підключіть його до Flexoworks і перевірте журнали діагностики.

Встановіть **Flexoworks CDI Service** на станцію Windows, яка має доступ до CDI
та папок DFS. Сервіс працює як фоновий сервіс Windows, підключається до
Flexoworks через вихідні HTTPS-з’єднання та передає стан і журнали в розділ
**Організація → Сервіси CDI**.

Використовуйте актуальний інсталятор із Flexoworks. Знімки хмарної програми
містять демонстраційні дані. Знімки вікна Windows показують версію 0.2.6 на
Windows Server 2022; нові версії та Windows 11 можуть виглядати інакше.

Сервіс читає черги CDI, знаходить машинні розкладки, копіює затверджені LEN
і доставляє збережені файли `.cdi` до DFS. Оператор відкриває розкладку в DFS,
перевіряє CDI та профіль експонування й надсилає її. Виробничий процес описано
в [інструкції CDI](https://docs.flexoworks.com/uk/guides/cdi-workspace.md).

## Що підготувати

* Станцію з **64-бітною Windows 11** у мережі DFS/CDI та права адміністратора
  Windows для встановлення програм.
* Обліковий запис Flexoworks із роллю **Адмін організації** та обладнання CDI,
  додане в **Організація → Виробничі майданчики та обладнання**.
* Ім’я хоста або IP-адресу CDI, яку використовує DFS. Скопіюйте її з
  **DFS → Edit Device List**; сервіс не сканує всю мережу.
* Точні папки DFS для перевірки та права облікового запису сервісу Windows
  на їх читання. Оператор допоможе знайти ці папки.
* Вихідний HTTPS-доступ до API Flexoworks і файлового сховища для
  завантаження файлів та передавання архівів. Для зв’язку з хмарою не потрібні
  вхідний порт з інтернету або VPN. Станції також потрібен локальний мережевий
  доступ до CDI та спільних папок DFS.

Пакет містить власне середовище виконання. Окремо встановлювати PowerShell,
компілятор або .NET не потрібно.

> [!WARNING]
>
> Цей пілотний інсталятор не підписаний. Якщо політика компанії блокує MSI
> або програму, зверніться до ІТ для погодження пакета. Збережіть точне
> повідомлення Windows і код помилки; вимикати захист Windows для
> встановлення не потрібно.

## 1. Завантажте інсталятор і налаштування

У Flexoworks відкрийте **Організація → Сервіси CDI** та натисніть
**Завантажити сервіс Windows**. Збережіть `Flexoworks-CDI-Service.zip`, щоб
перенести його на станцію Windows.

Натисніть **Додати станцію**, щоб відкрити вікно реєстрації, та заповніть поля:

| Поле | Що ввести |
| - | - |
| **Назва станції** | Зрозумілу назву, наприклад `Станція DFS 1`. |
| **IP-адреса станції** | Необов’язкова адреса комп’ютера Windows. Сервіс також повідомляє його локальні IP. |
| **Обладнання** | Виберіть наявний CDI. Для кожного наступного натисніть **Додати CDI**. |
| **Ім’я хоста або IP CDI** | Адресу пристрою з DFS без `http://`, порту чи шляху до папки. |
| **Папка призначення DFS** | Обов’язкова папка для запису й перевірки затверджених LEN та експортованих розкладок. Вкажіть повний локальний або UNC-шлях. |
| **Імпортувати робочий CDI** | Для кожного CDI виберіть робочий файл `.cdi` з цього обладнання, щоб задати барабан і робочу область. |
| **Папки DFS для запису** | По одному повному шляху в рядку. Для мережевих папок використовуйте UNC-шляхи. Їх можна додати або виправити пізніше у вікні сервісу Windows. |

![Українське вікно додавання станції з папкою призначення DFS та імпортом робочого CDI](https://mintcdn.com/flexoworks/mQ-upAWnU4Vp715W/images/uk/production-update/cdi-add-station.png?fit=max\&auto=format\&n=mQ-upAWnU4Vp715W\&q=85\&s=3e2eedc823343ec30786437d0bfb2c65)

Зареєструйте станцію, вкажіть папку призначення DFS і налаштуйте кожен CDI.

Натисніть **Додати станцію**, потім **Завантажити service.json**. Перенесіть
ZIP і `service.json` на станцію Windows. Завантажте налаштування до оновлення
або закриття сторінки: файл доступний лише протягом поточного сеансу
налаштування.

![Українське вікно «Станцію додано» з кнопкою «Завантажити service.json» та інструкціями встановлення MSI](https://mintcdn.com/flexoworks/9tcQH9PpObUJV_Za/images/uk/cdi-agent-setup/cloud-configuration.png?fit=max\&auto=format\&n=9tcQH9PpObUJV_Za\&q=85\&s=0899692e56dbceffd73a66bf84e38e2b)

Після створення станції завантажте service.json. Цей файл прив’язує сервіс до вашої організації.

> [!WARNING]
>
> Завантажений `service.json` містить ключ доступу станції. Не додавайте його
> до спільної документації або звернення в підтримку. Кожній станції
> потрібні власні налаштування; не використовуйте один файл на кількох комп’ютерах.

## 2. Встановіть MSI у Windows

1. Закрийте вікно старої переносної версії сервісу, якщо воно відкрите.
2. Розпакуйте `Flexoworks-CDI-Service.zip` у Провіднику.
3. Двічі натисніть **Flexoworks-CDI-Service.msi** в розпакованій папці.
4. Виконайте кроки інсталятора, залиште стандартну папку встановлення та
   підтвердьте запит прав адміністратора Windows, коли він з’явиться.
5. Відкрийте **Пуск → Flexoworks → Flexoworks CDI Service**.
   Для відкриття програми налаштування також потрібні права адміністратора.

Інсталятор реєструє та запускає сервіс **Flexoworks CDI Service**. Сервіс
сам створює папки `Data`; робити це вручну не потрібно. До прив’язки
стан очікування налаштувань або запуску є нормальним.

## 3. Імпортуйте налаштування

У нижній частині вікна виберіть **Українська** або **English**. Натисніть
**Імпортувати налаштування…**, відкрийте завантажений `service.json` і
підтвердьте повідомлення.

![Українське вікно Flexoworks CDI Service 0.2.6 з імпортом налаштувань, адресою CDI, папками DFS, станом і експортом журналів](https://mintcdn.com/flexoworks/9tcQH9PpObUJV_Za/images/uk/cdi-agent-setup/windows-setup.png?fit=max\&auto=format\&n=9tcQH9PpObUJV_Za\&q=85\&s=01acc3b8cfb4468f31fac16b263b5010)

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

Імпорт зберігає налаштування й перезапускає сервіс. Встановлений ключ захищено
шифруванням Windows. Локальна **Адреса CDI** використовується для діагностики,
запущеної у вікні Windows. Хмарне читання черг використовує адреси з налаштувань
організації. **Папки DFS** можна змінити локально кнопкою **Зберегти й перезапустити**.

### Керуйте CDI станції

У **Організація → Сервіси CDI** виберіть станцію й натисніть **Редагувати станцію**.
Вкажіть IP станції, виберіть наявне обладнання та введіть адресу кожного CDI.
Змініть список кнопками **Додати CDI** й **Від’єднати CDI**, потім натисніть
**Зберегти станцію**. Щоб перенести CDI на іншу станцію, спочатку від’єднайте його
від попередньої. Це ті самі записи обладнання, що й у розділі **Локації та обладнання**
та робочому просторі CDI.
Зміна або від’єднання CDI скасовує його команди, що очікують виконання.
Команди, які вже виконуються, продовжуються до завершення.

Стан і останній контакт станції стосуються сервісу Windows. Для кожного CDI окремо
показано стан з’єднання, **Останнє підключення** й **Остання перевірка**. Для імені
хоста сервіс повідомляє IP, до якого підключився. Якщо CDI недоступний, остання
успішно прочитана черга залишається видимою. Зміна адреси починає нові перевірки,
зберігаючи історію попередньої адреси.

Перед діагностикою чи захопленням виберіть **CDI для діагностики**. Зміна
призначень не потребує нового ключа або повторного імпорту `service.json`.

### Імпортуйте робочу область

Перед експортом розкладки Flexoworks відкрийте **Редагувати станцію** та
натисніть **Імпортувати робочий CDI** для потрібного обладнання. Виберіть
доступний файл `.cdi` розміром до 64 КБ, який правильно відкривається на цій
машині з потрібною робочою областю, потім натисніть **Зберегти станцію**.

Імпортуються лише барабан, робоча область і налаштування hotfolder. Зразок
не вибирає макет або профіль експонування. Зміни діють для нових експортів;
наявний експорт зберігає початкову геометрію. Якщо експорт повідомляє про
відсутню геометрію, імпортуйте зразок і створіть новий експорт.

![Сторінка сервісів CDI українською зі станом робочої станції та обладнання](https://mintcdn.com/flexoworks/mQ-upAWnU4Vp715W/images/uk/production-update/cdi-services.png?fit=max\&auto=format\&n=mQ-upAWnU4Vp715W\&q=85\&s=24fcad00b66b1190afe3b157aa01b67c)

Перед роботою з папкою DFS перевірте зв’язок із сервісом та кожним CDI окремо.

Історія станції спочатку показує 20 останніх записів журналу та 5 діагностичних звітів. Натисніть **Показати ще**, щоб розгорнути список. Вікно сервісу Windows окремо показує події, діагностичні звіти та помилки запуску; виберіть звіт і натисніть **Зберегти звіт…**, щоб експортувати ZIP.

## 4. Перевірте папки DFS і доступ сервісу

Перевірте, чи сервіс може записувати файли в **Папку призначення DFS**. Це
окреме налаштування від **Папок DFS для запису**, які потрібні для діагностики.

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

Для підключеного мережевого диска використовуйте його UNC-шлях. Наприклад,
якщо `Z:` відповідає `\\dfs-station\DFS`, введіть
`\\dfs-station\DFS\Layouts` замість `Z:\Layouts`. Вказуйте по одній
папці в рядку та вибирайте лише потрібні для запису папки, а не весь диск.

За замовчуванням сервіс працює від **LocalSystem**. Папка, яку ви відкриваєте
у Провіднику, може бути недоступна сервісу. Попросіть ІТ надати доступ його
обліковому запису або налаштувати відповідний обліковий запис у сервісах
Windows. Після зміни облікового запису відкрийте налаштування сервісу від
адміністратора перед запуском сервісу, щоб оновити права на локальні дані.
Не вписуйте мережеві паролі у шляхи. Окремому обліковому запису сервісу
також потрібні права Windows для мережевого запису.

## 5. Перевірте підключення та діагностику

1. У Windows дочекайтеся **Сервіс: Працює** та
   **Хмара: Підключено до Flexoworks**. Запущений сервіс сам по собі не
   підтверджує зв’язок із хмарою.
2. Поверніться в **Організація → Сервіси CDI** та виберіть нову
   **Робочу станцію**.
3. Перевірте стан **На зв’язку**, свіжий **Останній зв’язок** і
   чи **Версія сервісу** відповідає встановленій версії. Сторінка
   оновлюється автоматично.
4. Натисніть **Зібрати діагностику**. Перегляньте **Останні команди** та
   **Журнал діагностики**. Розгорніть події, щоб побачити подробиці;
   увімкніть **Попередження та помилки**, щоб зосередитися на збоях.
5. Переконайтеся, що вказані папки DFS доступні сервісу. Перегляньте
   результати перевірки CDI та завантажте ZIP із розділу
   **Архіви діагностики**, коли він з’явиться.

Стан **На зв’язку** означає, що сервіс звернувся до Flexoworks. Відповідь
на можливому порту підтверджує лише доступність мережевого вузла.
**Діагностику завершено** не означає, що CDI прийняв або експонував завдання.

Після перевірки зв’язку видаліть завантажений незашифрований `service.json`
і копії, використані для перенесення. Залиште встановлені налаштування в
`C:\ProgramData\FlexoworksCdiAgent`.

Сервіс запускається автоматично після перезавантаження Windows, ще до входу
користувача. Вікно налаштувань можна закрити: сервіс працюватиме далі.
За потреби відкрийте його з меню Пуск. У зручний час перезавантажте станцію
та перевірте свіжий **Останній зв’язок** у Flexoworks.

## Запишіть одне надсилання з DFS

Коли зв’язок і доступ до папок працюють, погодьте з оператором відоме
тестове завдання:

1. Натисніть **Записати надсилання з DFS** у хмарі або
   **Записати надсилання DFS** у вікні Windows та підтвердьте запит.
2. Дочекайтеся **Запис готовий — надішліть тестове завдання через DFS**
   у хмарному журналі або `CAPTURE_READY` у журналі Windows.
3. Попросіть оператора надіслати це завдання звичайним способом через DFS.
4. Дочекайтеся завершення 120-секундного запису та завантажте ZIP із
   розділу **Архіви діагностики**.

Запис охоплює трафік до вказаного CDI та зміни у вибраних папках DFS.
Мережеві дані можуть містити відомості про завдання й облікові дані;
передавайте приватний архів лише учасникам перевірки інтеграції. Якщо
сервіс зупинити під час запису, версія 0.2.1 збереже частковий архів і
поставить його в чергу на завантаження після запуску. Перервана команда
потребує перевірки та не виконується повторно автоматично.

## Якщо щось не працює

| Що ви бачите | Що зробити |
| - | - |
| Інсталятор заблоковано або відмовлено в правах адміністратора | Збережіть точне повідомлення та попросіть ІТ погодити MSI й програму. |
| **Очікування налаштувань** | Імпортуйте потрібний `service.json`. Якщо файл втрачено до імпорту, відкличте невикористаний запис у хмарі й додайте станцію заново. |
| **Сервіс: Зупинено** | Натисніть **Запустити / перезапустити сервіс**. Якщо він зупиниться знову, перегляньте останні помилки. |
| **Немає зв’язку з Flexoworks** або **Не на зв’язку** у хмарі | Перевірте вихідний доступ, DNS, проксі чи міжмережевий екран і помилку у вікні Windows. Локальні журнали доступні й без зв’язку з хмарою. |
| **Доступ відкликано** | Створіть нові налаштування станції та імпортуйте їх на цьому комп’ютері. |
| `CDI_HOST_MISMATCH` у старій команді | Оновіть сервіс до 0.2.7 або новішої, перевірте адресу через **Редагувати станцію** та повторіть діагностику. |
| Експорт просить робочий зразок CDI | Імпортуйте зразок для цього обладнання, збережіть станцію та створіть новий експорт. |
| Папка DFS недоступна | Перевірте повний UNC-шлях і права облікового запису сервісу, потім повторіть діагностику. |
| Не визначається адреса CDI або недоступні можливі порти | Перевірте адресу в DFS і локальне з’єднання разом з оператором чи ІТ. Не змінюйте налаштування виробничого пристрою лише за результатом перевірки можливого порту. |
| Мережевий запис недоступний | Експортуйте журнали, щоб ІТ перевірили права запису або інший активний сеанс. Діагностика папок може залишатися доступною. |

### Експортуйте журнали

Натисніть **Експортувати журнали…** у вікні Windows. ZIP містить останні
події, стан, доступні помилки запуску та збережений журнал встановлення
MSI. Чутливі дані в текстових журналах приховано; архіви мережевого запису
зберігаються окремо.

Якщо налаштування не відкриваються, ІТ можуть виконати команду в
**Командному рядку** від адміністратора:

```bat theme={null}
"C:\Program Files\Flexoworks CDI Agent\FlexoworksCdiAgent.exe" --export-support "%USERPROFILE%\Desktop\Flexoworks-support.zip"
```

Встановлена папка та виконуваний файл зберігають початкові технічні назви
для сумісності з наявними встановленнями. Вікно налаштувань також приймає
старі завантажені файли `agent.json`.

Експорт працює, навіть якщо сервіс не може створити основну папку `Data`.
Помилки запуску також можуть бути в `%TEMP%\FlexoworksCdiAgent`,
`C:\Windows\SystemTemp\FlexoworksCdiAgent` або в старішому розташуванні
`C:\Windows\Temp\FlexoworksCdiAgent`.

У разі помилки встановлення запустіть MSI з розпакованої папки, вказавши
відоме ім’я журналу:

```bat theme={null}
msiexec /i "Flexoworks-CDI-Service.msi" /L*V "%TEMP%\Flexoworks-install.log"
```

Передайте підтримці точну помилку, версію інсталятора, журнал MSI або
ZIP із журналами та приблизний час збою. Не надсилайте `service.json`.

## Оновлення, відновлення та видалення

У **Організація → Сервіси CDI** виберіть станцію та ввімкніть
**Автоматично оновлювати сервіс**, щоб встановлювати нові версії, коли сервіс
вільний. Типово цей параметр вимкнено. Потрібна версія 0.2.4 або новіша,
що працює від LocalSystem. Windows автоматично не перезапускається.

Також можна встановити новіший MSI вручну на тому самому комп’ютері.
Налаштування й архіви зберігаються.
Після оновлення знову перевірте версію та свіжий зв’язок із хмарою.
За потреби відновіть або видаліть програму через **Інстальовані програми**
Windows. Видалення зберігає налаштування та діагностику в
`C:\ProgramData\FlexoworksCdiAgent` і не відкликає хмарний доступ.
Коли станцію виводять з експлуатації, натисніть **Відкликати доступ** у Flexoworks.

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


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.