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

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

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

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

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

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

bash
dotnet add package Doconut.NET8.Converter

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

bash
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 встановіть бібліотеку налаштування шрифтів перед відкриттям першого документа:

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.NET8.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 у перевантаженні потоку має включати початкову крапку (".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 успішно завершуєтьсяті ж поля, що й у відповіді run, плюс запитаний target
onDownload({ downloadName, downloadToken })Користувач натискає посилання Завантажитивикликається разом з вбудованим завантаженням браузера — не перехоплює і не замінює його
onError({ phase, message })Запит open або run не вдається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; нічого не робить, якщо не в стані бездіяльності
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": "..." }, за винятком випадків, коли в таблиці зазначено «лише статус». Невідоме значення ?convert= відповідає 400.

МаршрутПризначенняВідповідь при успіху
POST ?convert=open (multipart, один файл)Завантажити та відкрити вихідний документ для попереднього перегляду200 — { token, pages, sourceExt, allowedTargets }
POST ?token=<token>&convert=run&target=<ext>Перетворити збережене джерело у target200 — { 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)лише статус
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: Файл для конвертації, наприклад з <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.

У продакшн

  1. Встановіть плагін поруч із основним пакетом, тієї ж версії: dotnet add package Doconut.NET8.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

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