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

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

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

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

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

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

bash
dotnet add package Doconut.NETStandard.Converter

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

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

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

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

Реєстрація плагіну

Методу AddConverter() не існує — модель плагінів Doconut уніфікована. Кожен плагін, включаючи Конвертер, реєструється однаково: викличте AddPlugin<TPlugin>() всередині AddDoconut(). ConverterPlugin постачається у власному пакеті NuGet, Doconut.NETStandard.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. Не жорстко кодуйте цей перелік у вашому інтерфейсі: ?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();       // видаляє listeners, очищає mount; instance після цього не придатний до використання

Мітки

Кожен рядок має англійський варіант за замовчуванням; 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 (мультипарт, один файл)Завантажити та відкрити вихідний документ для попереднього перегляду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 використовує перший файл у мультипарт-тілі.

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Не мультипарт-завантаження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
// файл: Файл для конвертації, наприклад з <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.NETStandard.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 bytes, ідентичні на кожному вузлі
    // 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

Примітки до фреймворку

  • viewer.Converter.GetConverter() тут не існує. Конвертація більше не здійснюється через екземпляр переглядача: замість цього інжектуйте Doconut.DocumentConverter.
  • Цей ConversionTarget enum охоплює всі сімейства джерел. Попередня бібліотека мала тип *ConfigConverter для кожного сімейства — WordConfigConverter, ExcelConfigConverter тощо — кожен зі своїм вкладеним enum EnTargetFormat, плюс enum SourceFormatConverter для вводу. Усі вони видалені; дивіться посібник з міграції.
  • Тільки Windows, як і решта пакету .NET Standard.

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