Плагін Конвертера

Конвертуйте документи у 45 цільових форматів

Плагін Конвертера перетворює Doconut у сервіс конвертації документів. Він забезпечує движок, що стоїть за публічним фасадом DocumentConverter, і — за бажанням — готовий віджет зі своїм HTTP‑контрактом, тож ви можете конвертувати документи з C#, з віджету або з фронтенду, який створите самі.

СередовищеКоли використовувати
DocumentConverter (C#)Ви конвертуєте на сервері, без використання браузера
Drop-in widget (doconutConverter.js)Ви хочете готовий інтерфейс завантаження, конвертації та завантаження у вашій сторінці
HTTP endpoints (?convert=open|run|download)Ви створюєте власний інтерфейс конвертації, спираючись на задокументований серверний контракт

Встановлення пакету

Встановіть останню стабільну версію плагіна Конвертера:

bash
dotnet add package Doconut.NET6.Converter

Щоб зафіксувати плагін на випуску, який описано в цій документації, передайте версію окремо:

bash
dotnet add package Doconut.NET6.Converter --version 26.10.0

Тримайте пакет Конвертера на тій же версії, що й Doconut.NET6. Ідентифікатор пакету — Doconut.NET6.Converter; .<version> з'являється лише у назві завантаженого файлу .nupkg.

Файл ліцензії плагіна, Doconut.Viewer.Converter.lic, розташовується у тій же папці, що й Doconut.Viewer.lic; його читають разом з ліцензією переглядача.

Платформи. Плагін працює там, де працює Doconut.NET6: Windows та Linux на базі glibc для x64 (не Alpine та інші дистрибутиви на musl). У Linux встановіть бібліотеку налаштування шрифтів перед відкриттям першого документа:

bash
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.NET6.Converter, встановленому разом із базовим пакетом переглядача.

csharp
builder.Services.AddDoconut(options =>
{
    options.LicensePath = "Doconut.Viewer.lic";
    options.AddPlugin<Doconut.Plugins.Converter.ConverterPlugin>();
});

Це все, що потрібно фасаду C#. Віджет та його HTTP‑ендпоінти — окрема опція, AddConverterWidget() (див. Вбудований віджет).

Плагіну потрібна ліцензія, що надає можливість Converter. Без неї AddDoconut() генерує InvalidOperationException під час запуску, до того як застосунок обробляє запит:

text
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 там, де він потрібен — він безстановий за замовчуванням, тому один екземпляр безпечно повторно використовувати в різних запитах.

csharp
// Впровадьте DocumentConverter; його конструктор є internal, тому ніколи не `new` його.
Stream pdf = await converter.ConvertAsync("contract.docx", ConversionTarget.Pdf, ct: ct);
csharp
// sourceExtension включає початкову крапку. password дорівнює null, якщо документ не захищений.
Stream png = await converter.ConvertAsync(stream, ".xlsx", ConversionTarget.Png, password: null, ct: ct);
csharp
Stream html = await converter.WordToHtmlAsync("report.docx", ct);
csharp
// html: Stream, що містить HTML для перетворення назад у документ Word, наприклад результат WordToHtmlAsync.
Stream docx = await converter.HtmlToWordAsync(html, ConversionTarget.Docx, ct);

Дві деталі, які легко переплутати: sourceExtension у перевантаженні stream має включати початкову крапку (".xlsx", а не "xlsx") — конвертер порівнює її з каталогом форматів, і сама по собі розширення не буде розпізнано. І, незважаючи на назву, WordToHtmlAsync повертає Task<Stream>, а не Task<string> — ви отримуєте HTML‑документ (зображення вбудовані як Base64) у вигляді потоку, так само, як і будь‑який інший результат перетворення.

Викликаючий володіє поверненим потоком і повинен його звільнити після копіювання або повернення його вмісту. Сервіс DocumentConverter сам отримується через впровадження залежностей; не створюйте і не звільняйте його вручну.

Цільові формати

ConversionTarget (простір імен Doconut.Configs.Conversion) має 45 членів:

text
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 віджету є опційними та вимкненими за замовчуванням — безпечно за замовчуванням. Увімкніть їх на сервері разом із реєстрацією плагіну:

csharp
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() викидає виключення:

text
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 все одно подається (це простий вбудований статичний ресурс; лише кінцеві точки, до яких він звертається, захищені).

Вбудувати його

html
<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, конвертує, попередньо переглядає результат, коли це можливо, і пропонує завантаження.

Опції

ПараметрТипЗа замовчуваннямПримітки
basePathstring/doconutБазовий шлях для кінцевих точок ?convert=; він має відповідати гілці ASP.NET, де фактично змонтовано UseDoconut() (зазвичай координується через MiddlewarePath)
resPathstring/doconut-resПриймається для узгодженості конфігурації з іншими віджетами Doconut; віджет конвертера наразі не створює жодного URL з нього
maxUploadMbnumber25Лише передперевірка на боці клієнта — відхиляє файл, що перевищує розмір, перед завантаженням. Сервер самостійно застосовує власне обмеження і відповідає 413, якщо воно перевищене
licenseUrlstring | nullnullЯкщо встановлено, перетворює повідомлення про водяний знак на екрані результату у посилання на цей URL
labelsobject{}Перезаписує будь-яку підмножину англійських рядків за замовчуванням віджета (текст підказки, кнопки, оголошення aria-live, повідомлення про помилки)

Зворотні виклики

Зворотний викликВикликається колиНавантаження
onReady()Віджет відобразив свій екран очікування/перетягування—
onSourceLoaded({ token, pages, sourceExt, allowedTargets })?convert=open успішно завершуєтьсятокен сесії джерела, кількість сторінок, розширення джерела (без крапки), список дозволених цілей
onConverted({ downloadToken, resultToken, resultPages, downloadName, watermarked, target })?convert=run успішно завершуєтьсяті ж поля, що й у відповіді на запуск, плюс запитаний target
onDownload({ downloadName, downloadToken })Користувач натискає посилання Завантажитивиконується разом із вбудованим завантаженням браузера — не перехоплює і не замінює його
onError({ phase, message })Запит відкриття або запуску не вдаєтьсяphase є 'open' або 'run'; message — це очищена помилка сервера (або повідомлення на боці клієнта для передперевірки розміру завантаження)

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

Імперативний дескриптор

Doconut.convert() повертає сам екземпляр віджета — збережіть його, щоб керувати віджетом програмно:

javascript
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; no-op якщо не в стані бездіяльності
conv.destroy();       // видаляє слухачі, очищає mount; екземпляр після цього непридатний до використання

Мітки

Кожен рядок має англійський варіант за замовчуванням; labels перезаписує будь-яку підмножину, а решта залишається англійською. Фрагменти, які змінюються під час виконання, використовують {placeholders}, наприклад uploading: 'Uploading {name}…' та pages: '{n} pages'.

КлючАнглійський варіант за замовчуванням
dropPromptDrag & drop a document here
dropHintPDF, Word, Excel, PowerPoint, images and more
chooseFileChoose file
uploadingUploading {name}…
page / pages1 page / {n} pages
noTargetsNo conversion targets are available for this file.
convertTo / convertConvert to / Convert
convertingConverting to {target}…
readyToDownloadReady to download
download / convertAnotherDownload / Convert another
watermarkNoticeOutput is watermarked — get a license to remove it.
retryRetry
genericErrorSomething went wrong. Please try again.
sizeLimitThat file is larger than the {mb} MB upload limit. Please choose a smaller file.
serverErrorThe server could not process this request. Please try again.
networkErrorCould 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, тому ви можете оформити його без зміни внутрішньої структури:

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": "..." }, за винятком випадків, коли в таблиці зазначено «status only». Невідоме значення ?convert= відповідає 400.

МаршрутПризначенняВідповідь при успіху
POST ?convert=open (multipart, one file)Завантажити та відкрити вихідний документ для попереднього перегляду200 — { token, pages, sourceExt, allowedTargets }
POST ?token=<token>&convert=run&target=<ext>Перетворити збережений вихідний файл у target200 — { downloadToken, resultToken, resultPages, downloadName, watermarked }
GET ?convert=download&token=<downloadToken>Транслювати перетворений файл200 — байти файлу, 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 мають однакове значення. Закриття результату переглядача не видаляє ще дійсне сховище завантаження, і скидання віджету в браузері не продовжує жоден з інтервалів.

Режими відмов, згруповані за маршрутом:

МаршрутСтатусКолиТіло
any404Віджет не ввімкнено (AddConverterWidget() ніколи не викликався) — перевіряється до обробки будь‑якого з трьох маршрутівлише статус
any405Неправильний HTTP‑метод (open/run вимагає POST; download вимагає GET)лише статус
open400Не multipart‑завантаженняExpected a multipart file upload.
open400Відсутній файл або порожній файлNo file uploaded.
open400Розширення джерела, яке не може бути конвертованоThis file type cannot be converted.
open403Тип файлу потребує можливості, яку ліцензія не надає (файл DICOM без Dicom)Converting this file type requires the Dicom capability license.
open413Завантажений файл перевищує MaxUploadMb, перевіряється проти Content-Length під час читання завантаженняFile is too large.
run400Некоректний токен (не GUID)Invalid token.
run400target, який не розбирається у ConversionTargetUnknown target format.
run400target не знаходиться у allowedTargets вихідногоThat target format is not available for this file.
run404Збережене завантаження прострочилося або токен ніколи не був відкритийUpload expired — please re-open the file.
open, run500Внутрішня помилка обробкиОчищене повідомлення — очищене так само, як і всі інші шляхи помилок Doconut; ніколи не розкриває внутрішні деталі
download400Некоректний токен (не GUID)лише статус
download404Невідомий або прострочений токен завантаженнялише статус

Повний цикл з fetch:

javascript
// file: 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. Розміщуйте ваш UI та скрипт віджету з того ж походження, що й Doconut, або використовуйте reverse‑proxy для обох шляхів /doconut (шлях проміжного програмного забезпечення та шлях ресурсів) під вашим походженням UI.

У продакшн

  1. Встановіть плагін поруч із основним пакетом, тієї ж версії: dotnet add package Doconut.NET6.Converter.
  2. Додайте файл ліцензії. Помістіть Doconut.Viewer.Converter.lic у ту ж папку, що і Doconut.Viewer.lic.
  3. Встановіть ліміт сервера. MaxUploadMb у AddConverterWidget — це обмеження, яке застосовує сервер; maxUploadMb віджета — лише клієнтська перевірка. Тримайте їх рівними.
  4. Обслуговуйте UI з того ж походження, що й кінцеві точки Doconut, або використовуйте reverse-proxy (див. Створіть власний інтерфейс).
  5. Вивільняйте результати конвертації. Потік, який повертає ConvertAsync, використовується з пулу; його вивільнення повертає буфери в пул.

Веб‑ферми

Віджет зберігає кожне завантаження та його результат у пам'яті на вузлі, який обслуговував open. За навантажувальником без sticky‑сесій, пізніший запит run, download або попереднього перегляду може потрапити на інший вузол і не знайти завантаження. Зареєструйте спільне, зашифроване сховище віджета один раз, після AddDoconut():

csharp
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

csharp
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

csharp
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
Віджет завантажується, але його запити відповідають 404AddConverterWidget() не був викликаний, або 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

Чи була ця сторінка корисною?