Плагін Конвертера
Конвертуйте документи у 45 цільових форматів
Плагін Конвертер перетворює Doconut у сервіс конвертації документів. Він забезпечує рушій, що стоїть за публічним фасадом DocumentConverter, і — за бажанням — готовий віджет зі своїм HTTP‑контрактом, тож ви можете конвертувати документи з C#, з віджета або з фронтенду, який створите самостійно.
| Середовище | Коли використовувати |
|---|---|
DocumentConverter (C#) | Ви конвертуєте на сервері, без участі браузера |
Drop-in widget (doconutConverter.js) | Ви хочете готовий інтерфейс завантаження, конвертації та завантаження у вашій сторінці |
HTTP endpoints (?convert=open|run|download) | Ви створюєте власний інтерфейс конвертації згідно задокументованого серверного контракту |
Встановлення пакету
Встановіть останню стабільну версію плагіна Конвертер:
dotnet add package Doconut.NET8.ConverterЩоб зафіксувати плагін на випуску, описаному в цій документації, передайте версію окремо:
dotnet add package Doconut.NET8.Converter --version 26.10.0Тримайте пакет Конвертер на тій же версії, що і Doconut.NET8. Ідентифікатор пакету — Doconut.NET8.Converter; .<version> з’являється лише у назві завантаженого файлу .nupkg.
Файл ліцензії плагіна, Doconut.Viewer.Converter.lic, розташовується у тій же теці, що й Doconut.Viewer.lic; його читають разом з ліцензією переглядача.
Платформи. Плагін працює там, де працює Doconut.NET8: Windows та Linux на базі glibc для x64 (не Alpine та інші дистрибутиви на musl). У Linux встановіть бібліотеку налаштування шрифтів перед відкриттям першого документа:
apt-get update && apt-get install -y libfontconfig1У дистрибутивах RHEL, Fedora та подібних пакет називається fontconfig. Без нього відкриття документа завершується помилкою The system library libfontconfig1 is missing. Install it (Debian/Ubuntu: apt-get install -y libfontconfig1) and see the Linux section of the Doconut documentation..
Реєстрація плагіна
Методу AddConverter() не існує — модель плагінів Doconut уніфікована. Кожен плагін, включно з Конвертером, реєструється однаково: викличте AddPlugin<TPlugin>() всередині AddDoconut(). ConverterPlugin постачається у власному пакеті NuGet, Doconut.NET8.Converter, встановленому разом із базовим пакетом переглядача.
builder.Services.AddDoconut(options =>
{
options.LicensePath = "Doconut.Viewer.lic";
options.AddPlugin<Doconut.Plugins.Converter.ConverterPlugin>();
});Це все, що потрібно фасаду C#. Віджет та його HTTP‑конечні точки — це окрема опція, AddConverterWidget() (див. Вбудований віджет).
Плагіну потрібна ліцензія, що надає можливість Converter. Без неї AddDoconut() генерує InvalidOperationException під час запуску, до того як застосунок обробляє запит:
The Converter plugin is registered via AddPlugin but no active license grants Converter. Remove the AddPlugin<...>() call or install a license (or trial/demo) that includes Converter.Він генерує помилку у випадку відсутності ліцензії, застарілого файлу TRIAL, ліцензії без Converter та платної ліцензії, використаної поза її часовим вікном. Приймаються тимчасові ліцензії Demo/NFR. Безкоштовного «тихого» рівня немає. Див. Налаштування ліцензії щодо завантаження ліцензій.
Ліцензування та водяний знак
| Стан ліцензії | Запуск | Результат конвертації |
|---|---|---|
Платна ліцензія переглядача, що надає Converter, у межах її версійного вікна | Запускається | Чистий — watermarked: false |
| Активна тимчасова (Demo/NFR) ліцензія | Запускається | Конвертує з водяним знаком оцінки — watermarked: true |
| Протермінована тимчасова (Demo/NFR) ліцензія | Запускається | Конвертує з водяним знаком оцінки — watermarked: true |
Відсутня ліцензія, застарілий файл TRIAL, ліцензія без Converter або платна ліцензія поза її версійним вікном | генерує AddDoconut() | — |
Обидва шляхи виклику обчислюють прапорець за тим же правилом: C# фасад DocumentConverter отримує його внутрішньо з стану ліцензії IsViewerLicensed та IsTemporary, а обробник ?convert=run віджета виконує еквівалентну перевірку (IsViewerLicensed && !IsTrial && !IsTemporary), щоб заповнити поле watermarked, яке він повертає. Інтеграцію можна створити та протестувати повністю на оцінковій ліцензії перед покупкою — змінюються лише байти вихідних даних.
Джерело DICOM (.dcm, .ima) також потребує можливості Dicom. Без неї ConvertAsync генерує LicenseException (Converting '.dcm' requires the Dicom capability license.), а відповіді open віджета — 403.
Використання з C#
Кожне перетворення повертає придатний до пошуку MemoryStream, розташований у позиції 0, готовий до читання або копіювання одразу. Отримайте DocumentConverter з DI там, де він потрібен — він безстановий за дизайном, тому одну інстанцію безпечно повторно використовувати в різних запитах.
// Впровадьте DocumentConverter; його конструктор є internal, тому ніколи не `new` його.
Stream pdf = await converter.ConvertAsync("contract.docx", ConversionTarget.Pdf, ct: ct);// sourceExtension включає початкову крапку. password дорівнює null, якщо документ не захищений.
Stream png = await converter.ConvertAsync(stream, ".xlsx", ConversionTarget.Png, password: null, ct: ct);Stream html = await converter.WordToHtmlAsync("report.docx", ct);// html: Stream, що містить HTML для перетворення назад у документ Word, наприклад результат WordToHtmlAsync.
Stream docx = await converter.HtmlToWordAsync(html, ConversionTarget.Docx, ct);Два нюанси, які легко помилитися: sourceExtension у перевантаженні потоку має включати початкову крапку (".xlsx", а не "xlsx") — конвертер порівнює її з каталогом форматів, і чисте розширення не буде розпізнано. І, незважаючи на назву, WordToHtmlAsync повертає Task<Stream>, а не Task<string> — ви отримуєте HTML‑документ (зображення вбудовані як Base64) у вигляді потоку, так само, як і будь‑який інший результат перетворення.
Викликаюча сторона володіє повернутим потоком і повинна його звільнити після копіювання або повернення вмісту. Сервіс DocumentConverter сам отримується через впровадження залежностей; не створюйте і не звільняйте його вручну.
Цільові формати
ConversionTarget (простір імен Doconut.Configs.Conversion) має 45 членів:
Pdf, Docx, Doc, Html, Xlsx, Pptx, Png, Jpeg, Csv, Tiff, Bmp, Gif, Svg, Xml,
Txt, Xls, Jp2, Rtf, Odt, Ods, Odp, Epub, Xps, Webp, Msg, Eml, Emlx, Mhtml,
Xlsm, Xlsb, Ppt, Docm, Dot, Dotx, Dotm, Vsdx, Vssx, Vstx, Vsdm, Vssm, Vstm,
Vdx, Vsx, Vtx, IcoНе кожне джерело конвертується у кожну ціль — плагін відображає сімейство форматів кожного джерела (Word, Excel, PowerPoint, PDF, CAD, Image, Email, Diagram, Project/Task, PSD, веб‑документ, DICOM) у власний фіксований набір дозволених цілей. Перетворення DICOM‑джерела (.dcm, .ima) також потребує ліцензії, що надає можливість Dicom; його цілі — Pdf, Png, Jpeg, Bmp, Tiff і Gif. Не жорстко кодуйте цей enum як список цілей у вашому інтерфейсі: ?convert=open повертає фактичний allowedTargets для будь‑якого лише що завантаженого файлу, і саме це має керувати вибором.
Вбудований віджет
Увімкнення кінцевих точок
Кінцеві точки ?convert=open|run|download віджету є опційними та вимкненими за замовчуванням — безпечно за замовчуванням. Увімкніть їх на сервері разом з реєстрацією плагіну:
builder.Services.AddDoconut(options =>
{
options.LicensePath = "Doconut.Viewer.lic";
options.AddPlugin<Doconut.Plugins.Converter.ConverterPlugin>();
options.AddConverterWidget(widget =>
{
widget.MaxUploadMb = 25;
});
});AddConverterWidget() без аргументу вмикає віджет з параметрами за замовчуванням (MaxUploadMb = 25). Він сам по собі не надає прав на конвертацію: потрібен AddPlugin<ConverterPlugin>(), інакше AddDoconut() генерує виключення:
AddConverterWidget() was called but the Converter plugin is not registered. Add options.AddPlugin<Doconut.Plugins.Converter.ConverterPlugin>() (the widget needs it), or remove the AddConverterWidget() call.Без AddConverterWidget() три кінцеві точки ?convert= відповідають 404 — проте сам файл JS все одно подається (це простий вбудований статичний ресурс; лише кінцеві точки, до яких він звертається, захищені).
Вбудувати його
<div id="doconut-convert"></div>
<script src="/doconut-res/js/doconutConverter.js"></script>
<script>
Doconut.convert('#doconut-convert', { basePath: '/doconut', resPath: '/doconut-res', maxUploadMb: 25 });
</script>Doconut.convert(selectorOrElement, options) приймає CSS‑селектор або елемент, генерує виключення, якщо монтування не знайдено, і повертає дескриптор. Віджет завантажує файл, показує попередній перегляд сторінки 1, дозволяє користувачеві вибрати один із allowedTargets, конвертує, попередньо переглядає результат, коли це можливо, і пропонує завантаження.
Параметри
| Параметр | Тип | За замовчуванням | Примітки |
|---|---|---|---|
basePath | string | /doconut | Базовий шлях для кінцевих точок ?convert=; він має відповідати гілці ASP.NET, де UseDoconut() фактично змонтовано (зазвичай координується через MiddlewarePath) |
resPath | string | /doconut-res | Приймається для узгодженості конфігурації з іншими віджетами Doconut; віджет конвертера наразі не створює жодного URL з нього |
maxUploadMb | number | 25 | Лише попередня перевірка на боці клієнта — відхиляє занадто великий файл перед завантаженням. Сервер самостійно застосовує власне обмеження і відповідає 413, якщо воно перевищено |
licenseUrl | string | null | null | Якщо встановлено, перетворює повідомлення про водяний знак на екрані результату у посилання на цей URL |
labels | object | {} | Перезаписує будь‑яку підмножину англійських рядків за замовчуванням віджета (текст перетягування, кнопки, оголошення aria‑live, повідомлення про помилки) |
Зворотні виклики
| Зворотний виклик | Викликається коли | Вміст |
|---|---|---|
onReady() | Віджет відобразив свій екран очікування/перетягування | — |
onSourceLoaded({ token, pages, sourceExt, allowedTargets }) | ?convert=open успішно завершується | токен сесії джерела, кількість сторінок, розширення джерела (без крапки), список дозволених цілей |
onConverted({ downloadToken, resultToken, resultPages, downloadName, watermarked, target }) | ?convert=run успішно завершується | ті ж поля, що й у відповіді run, плюс запитаний target |
onDownload({ downloadName, downloadToken }) | Користувач натискає посилання Завантажити | викликається разом з вбудованим завантаженням браузера — не перехоплює і не замінює його |
onError({ phase, message }) | Запит open або run не вдається | phase є 'open' або 'run'; message — це очищена помилка сервера (або повідомлення на боці клієнта для попередньої перевірки розміру завантаження) |
Виклик зворотного виклику, який генерує виключення, перехоплюється та записується в журнал; він ніколи не порушує роботу віджета.
Імперативний дескриптор
Doconut.convert() повертає сам екземпляр віджета — збережіть його, щоб керувати віджетом програмно:
const conv = Doconut.convert('#doconut-convert', { basePath: '/doconut' });
const file = document.querySelector('#picker').files[0]; // файл з вашого власного <input type="file" id="picker">
conv.reset(); // повернутись до екрану бездіяльності/скидання; не викликає повторно onReady
conv.loadFile(file); // починає потік з об’єктом File; нічого не робить, якщо не в стані бездіяльності
conv.destroy(); // видаляє слухачі, очищає mount; екземпляр стає непридатним після цьогоМітки
Кожен рядок має англійський варіант за замовчуванням; labels перезаписує будь‑яку підмножину, а решта залишається англійською. Фрагменти, які змінюються під час виконання, використовують {placeholders}, наприклад uploading: 'Uploading {name}…' та pages: '{n} pages'.
| Ключ | Англійський варіант за замовчуванням |
|---|---|
dropPrompt | Drag & drop a document here |
dropHint | PDF, Word, Excel, PowerPoint, images and more |
chooseFile | Choose file |
uploading | Uploading {name}… |
page / pages | 1 page / {n} pages |
noTargets | No conversion targets are available for this file. |
convertTo / convert | Convert to / Convert |
converting | Converting to {target}… |
readyToDownload | Ready to download |
download / convertAnother | Download / Convert another |
watermarkNotice | Output is watermarked — get a license to remove it. |
retry | Retry |
genericError | Something went wrong. Please try again. |
sizeLimit | That file is larger than the {mb} MB upload limit. Please choose a smaller file. |
serverError | The server could not process this request. Please try again. |
networkError | Could not reach the server. Please check your connection and try again. |
Додаткові ключі охоплюють aria-label зони перетягування (dropAriaLabel), тексти попереднього перегляду alt (previewAlt, resultAlt), пов’язану форму повідомлення про водяний знак, що використовується з licenseUrl (watermarkNoticePrefix, watermarkNoticeLink, watermarkNoticeSuffix), нечитаючу відповідь (badResponse) та оголошення aria-live (annReady, annUploading, annLoaded, annLoadedNoTargets, annConverting, annDone, annError).
Помилка JSON від сервера відображається так, як її записав сервер; serverError використовується лише коли невдала відповідь не містить помилки JSON, наприклад 404 вимкненого віджета.
Тематизація
Віджет додає клас dcw до свого елементу монтування та читає його кольори, радіус і шрифт із користувацьких властивостей CSS, тому ви можете налаштувати його тему, не торкаючись внутрішньої реалізації:
#doconut-convert.dcw {
--dcw-accent: #6b46c1;
--dcw-radius: 12px;
--dcw-font: "Inter", system-ui, sans-serif;
}Типові значення: --dcw-accent: #2b6cb0, --dcw-bg: #ffffff, --dcw-fg: #1a202c, --dcw-muted: #718096, --dcw-border: #cbd5e0, --dcw-radius: 8px та системний UI шрифт для --dcw-font.
Створіть власний інтерфейс
Віджет — це лише клієнт для цього HTTP‑контракту — створіть власний інтерфейс, працюючи безпосередньо з ним, для іншого UX. Усі три маршрути розташовані під гілкою ASP.NET, де монтується UseDoconut() (зазвичай /doconut), і вони відповідають 404, доки не буде викликано AddConverterWidget(). Помилки містять тіло у форматі JSON, { "error": "..." }, за винятком випадків, коли в таблиці зазначено «лише статус». Невідоме значення ?convert= відповідає 400.
| Маршрут | Призначення | Відповідь при успіху |
|---|---|---|
POST ?convert=open (multipart, один файл) | Завантажити та відкрити вихідний документ для попереднього перегляду | 200 — { token, pages, sourceExt, allowedTargets } |
POST ?token=<token>&convert=run&target=<ext> | Перетворити збережене джерело у target | 200 — { downloadToken, resultToken, resultPages, downloadName, watermarked } |
GET ?convert=download&token=<downloadToken> | Транслювати перетворений файл | 200 — file bytes, Content-Disposition: attachment, Cache-Control: no-store |
sourceExt у відповіді open не має початкової крапки (наприклад, "docx") — протилежна конвенція щодо параметра sourceExtension у DocumentConverter.ConvertAsync, який вимагає крапку. allowedTargets перераховує назви цілей у нижньому регістрі ("pdf", "html", …); передайте одну з них як target, який порівнюється без урахування регістру. open використовує перший файл у multipart‑тілі.
resultToken — це null, а resultPages — це 0, коли результат неможливо переглянути. downloadName — це назва вихідного файлу з розширенням цільового формату.
Зображення попереднього перегляду використовують стандартний маршрут зображень переглядача, {basePath}?token={token}&page=1&thumb=1&width={px}, з token від open або resultToken від run. Віджет запитує width=240.
Завантажені байти джерела зберігаються на сервері та утримуються протягом 30 хвилин після останнього читання; коли цей проміжок закінчується, run відповідає 404 і файл потрібно знову відкрити. Перетворений результат зберігається в тому ж сховищі — downloadToken отримує власний новий 30‑хвилинний інтервал після завершення конвертації — тоді як resultToken є звичайним токеном сесії переглядача для попереднього перегляду результату. Коли результат можна переглянути, downloadToken і resultToken мають однакове значення. Закриття результату переглядача не видаляє ще дійсне сховище завантаження, і скидання віджета в браузері не продовжує жоден з інтервалів.
Режими помилок, згруповані за маршрутом:
| Маршрут | Статус | Коли | Тіло |
|---|---|---|---|
| будь‑який | 404 | Віджет не ввімкнено (AddConverterWidget() ніколи не викликався) — перевіряється до обробки будь‑якого з трьох маршрутів | лише статус |
| будь‑який | 405 | Неправильний HTTP‑метод (open/run вимагає POST; download вимагає GET) | лише статус |
open | 400 | Не multipart‑завантаження | Expected a multipart file upload. |
open | 400 | Відсутній файл або порожній | No file uploaded. |
open | 400 | Розширення джерела, яке не можна конвертувати | This file type cannot be converted. |
open | 403 | Тип файлу потребує можливості, яку ліцензія не надає (файл DICOM без Dicom) | Converting this file type requires the Dicom capability license. |
open | 413 | Завантажений файл перевищує MaxUploadMb, перевіряється проти Content-Length під час читання завантаження | File is too large. |
run | 400 | Некоректний токен (не GUID) | Invalid token. |
run | 400 | target, який не розбирається у ConversionTarget | Unknown target format. |
run | 400 | target відсутній у allowedTargets джерела | That target format is not available for this file. |
run | 404 | Збережене завантаження прострочилося або токен ніколи не був відкритий | Upload expired — please re-open the file. |
open, run | 500 | Обробка завершилась помилкою всередині | Очищене повідомлення — очищене так само, як і всі інші шляхи помилок Doconut; ніколи не розкриває внутрішні деталі |
download | 400 | Некоректний токен (не GUID) | лише статус |
download | 404 | Невідомий або прострочений токен завантаження | лише статус |
Повний цикл запиту з fetch:
// file: Файл для конвертації, наприклад з <input type="file">.
async function convertFile(file) {
const base = '/doconut';
// 1. open: завантажити файл
const form = new FormData();
form.append('file', file, file.name);
const openResp = await fetch(base + '?convert=open', { method: 'POST', body: form });
if (!openResp.ok) throw new Error((await openResp.json()).error);
const opened = await openResp.json();
// 2. run: конвертувати у PDF, коли це дозволено, інакше у перший дозволений цільовий формат
const target = opened.allowedTargets.includes('pdf') ? 'pdf' : opened.allowedTargets[0];
const runResp = await fetch(base + '?token=' + encodeURIComponent(opened.token) +
'&convert=run&target=' + target, { method: 'POST' });
if (!runResp.ok) throw new Error((await runResp.json()).error);
const converted = await runResp.json();
// 3. download: простий GET, який може виконати браузер
window.location.href = base + '?convert=download&token=' + encodeURIComponent(converted.downloadToken);
}Кінцеві точки є same-origin: ця версія не підтримує CORS. Розміщуйте ваш інтерфейс та скрипт віджета з того ж походження, що й Doconut, або використовуйте reverse‑proxy для обох шляхів /doconut (шлях middleware та шлях ресурсів) під вашим походженням UI.
У продакшн
- Встановіть плагін поруч із основним пакетом, тієї ж версії:
dotnet add package Doconut.NET8.Converter. - Додайте файл ліцензії. Помістіть
Doconut.Viewer.Converter.licу ту ж папку, що іDoconut.Viewer.lic. - Встановіть ліміт сервера.
MaxUploadMbуAddConverterWidget— це обмеження, яке застосовує сервер;maxUploadMbвіджета — лише перевірка на боці клієнта. Тримайте їх рівними. - Обслуговуйте UI з того ж походження, що і кінцеві точки Doconut, або використовуйте reverse-proxy (дивіться Створіть власний інтерфейс).
- Звільняйте результати конвертації. Потік, який повертає
ConvertAsync, використовується з пулу; його звільнення повертає буфери в пул.
Веб‑ферми
Віджет зберігає кожне завантаження та його результат у пам'яті на вузлі, який обслуговував open. За навантажувальником без sticky‑сесій, пізніший запит run, download або попереднього перегляду може потрапити на інший вузол і не знайти завантаження. Зареєструйте спільне, зашифроване сховище віджета один раз, після AddDoconut():
byte[] farmKey = Convert.FromBase64String(builder.Configuration["Doconut:FarmKey"]);
builder.Services.AddDoconutDistributedWidgets(store =>
{
store.RootPath = @"\\fileshare\doconut"; // папку, яку кожен вузол може читати та записувати
store.FarmKey = farmKey; // принаймні 32 байти, ідентичні на кожному вузлі
// store.Ttl = TimeSpan.FromMinutes(30); // як довго зберігається завантаження (за замовчуванням)
});- Один сервер нічого не потребує: без цього виклику використовується сховище в пам'яті.
- Завантаження та результати зашифровані у спокої на спільному сховищі (AES-256, encrypt-then-MAC), і кожен файл прив'язаний до свого токена, тому один токен ніколи не може прочитати файл іншого.
- На спільному сховищі завантаження або результат зберігаються протягом
Ttlпісля запису; читання не продовжує цей інтервал. FarmKeyмає бути щонайменше 32 байти і однаковим на всіх вузлах. Завантажте його з секретного сховища; ніколи не вбудовуйте його в код. Реєстрація генеруєArgumentException, колиRootPathвідсутній абоFarmKeyкоротший за 32 байти.- Вкажіть
RootPathна те саме спільне розташування, яке використовує розподілений переглядач.
Довідка API
Фасад і параметри віджета знаходяться в просторі імен Doconut; ConversionTarget — у Doconut.Configs.Conversion. ConverterPlugin — у Doconut.Plugins.Converter.
DocumentConverter
public sealed class DocumentConverter
{
public Task<Stream> ConvertAsync(
string filePath, ConversionTarget target,
string? password = null, CancellationToken ct = default);
public Task<Stream> ConvertAsync(
Stream source, string sourceExtension, ConversionTarget target,
string? password = null, CancellationToken ct = default);
public Task<Stream> WordToHtmlAsync(string filePath, CancellationToken ct = default);
public Task<Stream> HtmlToWordAsync(
Stream htmlSource, ConversionTarget outputFormat = ConversionTarget.Docx,
CancellationToken ct = default);
}Отримується через впровадження залежностей; конструктор є internal. sourceExtension включає початкову крапку. HtmlToWordAsync записує файл .doc, коли outputFormat є ConversionTarget.Doc, і файл .docx для будь-якого іншого значення.
ConversionTarget
45 форматів виводу, перелічених у Формати цілей.
ConverterWidgetOptions
public sealed class ConverterWidgetOptions
{
public int MaxUploadMb { get; set; } = 25;
}Встановлюється через DoconutOptions.AddConverterWidget(Action<ConverterWidgetOptions>? configure = null), який повертає DoconutOptions, щоб виклики можна було ланцюжити.
Усунення неполадок
| Симптом | Причина | Виправлення |
|---|---|---|
AddDoconut() викидає The Converter plugin is registered via AddPlugin but no active license grants Converter. | Відсутня ліцензія, файл TRIAL, ліцензія без Converter, або платна ліцензія поза її часовим вікном | Встановіть ліцензію, яка надає Converter, або видаліть AddPlugin<ConverterPlugin>() |
AddDoconut() викидає AddConverterWidget() was called but the Converter plugin is not registered. | Віджет увімкнено без його плагіна | Додайте options.AddPlugin<Doconut.Plugins.Converter.ConverterPlugin>() |
Розв'язання DocumentConverter викидає No IDocumentConverter is registered. Add the converter plugin: options.AddPlugin<Doconut.Plugins.Converter.ConverterPlugin>(). | ConverterPlugin не зареєстровано | Додайте AddPlugin<ConverterPlugin>() всередині AddDoconut() |
| Конвертація потоку повідомляє, що формат не підтримується | sourceExtension не має початкової крапки | Передайте ".xlsx", а не "xlsx" |
ConvertAsync викидає Converting '.dcm' requires the Dicom capability license. | Джерело DICOM, і ліцензія не надає Dicom | Використайте ліцензію, яка надає Dicom |
| Вивід має водяний знак | Ліцензія тимчасова (Demo/NFR) | Використайте платну ліцензію, яка надає Converter |
Віджет завантажується, але його запити відповідають 404 | AddConverterWidget() не був викликаний, або basePath не відповідає гілці, де змонтовано UseDoconut() | Викличте AddConverterWidget(); виправте basePath |
open відповідає 403 Converting this file type requires the Dicom capability license. | Завантаження DICOM, і ліцензія не надає Dicom | Використайте ліцензію, яка надає Dicom |
open відповідає 413 File is too large. | Завантаження перевищує MaxUploadMb | Підніміть MaxUploadMb у AddConverterWidget; maxUploadMb віджета — лише перевірка на боці клієнта |
run відповідає 400 That target format is not available for this file. | Ціль не є однією з allowedTargets джерела | Пропонуйте лише allowedTargets з open |
run або download відповідає 404 (Upload expired — please re-open the file. з run) | 30‑хвилинне вікно минуло, або вузол веб‑ферми не має завантаження | Відкрийте файл знову; у фермі зареєструйте AddDoconutDistributedWidgets |
| Віджет падає, коли UI знаходиться на іншому походженні | Кінцеві точки не підтримують CORS | Обслуговуйте UI з того ж походження, або використовуйте reverse-proxy для шляхів Doconut |
| Тема не застосовується | Змінні встановлені на предка або на елемент всередині монту; правило .dcw віджета встановлює їх на монту | Цільте саму монту: #doconut-convert.dcw або #doconut-convert |
Чи була ця сторінка корисною?