Wtyczka konwertera

Konwertuj dokumenty do 45 formatów docelowych

Wtyczka Converter przekształca Doconut w usługę konwersji dokumentów. Dostarcza silnik stojący za publiczną fasadą DocumentConverter oraz — opcjonalnie — gotowy widżet z własnym kontraktem HTTP, dzięki czemu możesz konwertować dokumenty z C#, z widżetu lub z własnego frontendu.

PowierzchniaUżyj, gdy
DocumentConverter (C#)Konwertujesz na serwerze, bez udziału przeglądarki
Drop-in widget (doconutConverter.js)Chcesz gotowy ekran przesyłania, konwersji i pobierania na swojej stronie
HTTP endpoints (?convert=open|run|download)Budujesz własny interfejs konwersji korzystając z udokumentowanego kontraktu serwera

Zainstaluj pakiet

Zainstaluj najnowszą stabilną wtyczkę Converter:

bash
dotnet add package Doconut.NET8.Converter

Aby przypiąć wtyczkę do wersji opisanej w tej dokumentacji, przekaż wersję osobno:

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

Utrzymuj pakiet Converter w tej samej wersji co Doconut.NET8. Identyfikator pakietu to Doconut.NET8.Converter; .<version> pojawia się tylko w pobranej nazwie pliku .nupkg.

Plik licencji wtyczki, Doconut.Viewer.Converter.lic, znajduje się w tym samym folderze co Doconut.Viewer.lic; jest odczytywany razem z licencją podglądu.

Platformy. Wtyczka działa wszędzie tam, gdzie działa Doconut.NET8: Windows oraz Linux oparty na glibc na x64 (nie Alpine ani inne dystrybucje oparte na musl). Na Linuxie zainstaluj bibliotekę konfiguracji czcionek przed otwarciem pierwszego dokumentu:

bash
apt-get update && apt-get install -y libfontconfig1

W dystrybucjach RHEL, Fedora i podobnych pakiet to fontconfig. Bez niego otwieranie dokumentu kończy się niepowodzeniem z The system library libfontconfig1 is missing. Install it (Debian/Ubuntu: apt-get install -y libfontconfig1) and see the Linux section of the Doconut documentation.

Zarejestruj wtyczkę

Nie ma metody AddConverter() — model wtyczek Doconut jest jednolity. Każda wtyczka, w tym Converter, rejestruje się w ten sam sposób: wywołaj AddPlugin<TPlugin>() wewnątrz AddDoconut(). ConverterPlugin jest dostarczany w własnym pakiecie NuGet, Doconut.NET8.Converter, zainstalowany obok podstawowego pakietu podglądu.

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

To wszystko, czego potrzebuje fasada C#. Widżet i jego endpointy HTTP to oddzielna opcja, AddConverterWidget() (zobacz Widżet typu drop‑in).

Wtyczka wymaga licencji, która przyznaje możliwość Converter. Bez niej, AddDoconut() zgłasza InvalidOperationException przy uruchomieniu, zanim aplikacja obsłuży żądanie:

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.

Zgłasza to brak licencji, starszy plik TRIAL, licencję bez Converter oraz płatną licencję używaną poza oknem wersji. Akceptowane są tymczasowe licencje Demo/NFR. Nie ma cichego darmowego poziomu. Zobacz Konfiguracja licencji, aby dowiedzieć się, jak ładowane są licencje.

Licencjonowanie i znak wodny

Stan licencjiUruchomienieWynik konwersji
Płatna licencja podglądu przyznająca Converter, w ramach swojego okna wersjiUruchamia sięCzysty — watermarked: false
Aktywna tymczasowa (Demo/NFR) licencjaUruchamia sięKonwertuje, z znakiem wodnym oceny — watermarked: true
Wygasła tymczasowa (Demo/NFR) licencjaUruchamia sięKonwertuje, z znakiem wodnym oceny — watermarked: true
Brak licencji, starszy plik TRIAL, licencja bez Converter, lub płatna licencja poza oknem wersjiAddDoconut() zgłasza—

Obie ścieżki wywołań obliczają flagę na podstawie tej samej reguły: fasada C# DocumentConverter wyprowadza ją wewnętrznie z stanu licencji IsViewerLicensed i IsTemporary, a obsługa ?convert=run widżetu wykonuje równoważne sprawdzenie (IsViewerLicensed && !IsTrial && !IsTemporary), aby wypełnić pole watermarked, które zwraca. Integrację można zbudować i przetestować end‑to‑end na licencji ewaluacyjnej przed zakupem — zmieniają się tylko bajty wyjściowe.

Źródło DICOM (.dcm, .ima) również wymaga możliwości Dicom. Bez niej, ConvertAsync zgłasza LicenseException (Converting '.dcm' requires the Dicom capability license.), a open widżetu odpowiada 403.

Użycie z C#

Każda konwersja zwraca wyszukiwalny MemoryStream ustawiony na 0, gotowy do odczytu lub kopiowania od razu. Rozwiąż DocumentConverter z DI, gdziekolwiek go potrzebujesz — jest bezstanowy z założenia, więc pojedyncza instancja może być bezpiecznie ponownie używana w wielu żądaniach.

csharp
// Wstrzyknij DocumentConverter; jego konstruktor jest wewnętrzny, więc nigdy nie `new` go.
Stream pdf = await converter.ConvertAsync("contract.docx", ConversionTarget.Pdf, ct: ct);
csharp
// sourceExtension zawiera wiodącą kropkę. password jest null, chyba że dokument jest chroniony.
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 zawierający HTML, który ma zostać przekształcony z powrotem w dokument Word, np. wynik WordToHtmlAsync.
Stream docx = await converter.HtmlToWordAsync(html, ConversionTarget.Docx, ct);

Dwa szczegóły, które łatwo pomylić: sourceExtension w przeciążeniu strumienia musi zawierać początkową kropkę (".xlsx", a nie "xlsx") — konwerter dopasowuje ją do katalogu formatów i sama rozszerzenie nie zostanie rozpoznane. I pomimo nazwy, WordToHtmlAsync zwraca Task<Stream>, a nie Task<string> — otrzymujesz dokument HTML (obrazy osadzone jako Base64) jako strumień, tak jak każdy inny wynik konwersji.

Wywołujący jest właścicielem zwróconego strumienia i powinien go zwolnić po skopiowaniu lub zwróceniu jego zawartości. Usługa DocumentConverter jest rozwiązywana z wstrzykiwania zależności; nie twórz jej ani nie zwalniaj ręcznie.

Formaty docelowe

ConversionTarget (przestrzeń nazw Doconut.Configs.Conversion) ma 45 elementów:

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

Nie każdy źródłowy format konwertuje się na każdy docelowy — wtyczka mapuje rodzinę formatu źródłowego (Word, Excel, PowerPoint, PDF, CAD, Image, Email, Diagram, Project/Task, PSD, dokument internetowy, DICOM) na własny stały zestaw dozwolonych celów. Konwersja źródła DICOM (.dcm, .ima) wymaga również licencji, która przyznaje możliwość Dicom; jej cele to Pdf, Png, Jpeg, Bmp, Tiff i Gif. Nie koduj na sztywno tego wyliczenia jako listy docelowej w interfejsie użytkownika: ?convert=open zwraca rzeczywisty allowedTargets dla dowolnego właśnie przesłanego pliku i to powinno sterować wyborem.

Wtyczka typu Drop-in

Włączanie punktów końcowych

Punkty końcowe ?convert=open|run|download wtyczki są opcjonalne i domyślnie wyłączone — zabezpieczone domyślnie. Włącz je po stronie serwera, razem z rejestracją wtyczki:

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

AddConverterWidget() bez argumentu włącza wtyczkę z ustawieniami domyślnymi (MaxUploadMb = 25). Nie przyznaje ona samodzielnie praw do konwersji: potrzebuje AddPlugin<ConverterPlugin>(), w przeciwnym razie AddDoconut() zgłasza wyjątek:

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.

Bez AddConverterWidget(), trzy punkty końcowe ?convert= zwracają 404 — ale sam plik JS jest nadal udostępniany (to zwykły osadzony zasób statyczny; tylko punkty końcowe, z którymi się komunikuje, są zabezpieczone).

Osadź go

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) przyjmuje selektor CSS lub element, zgłasza wyjątek, jeśli miejsce montowania nie zostanie znalezione, i zwraca uchwyt. Wtyczka przesyła plik, wyświetla podgląd strony 1, pozwala użytkownikowi wybrać jedną z allowedTargets, konwertuje, podgląda wynik, gdy jest dostępny, i oferuje pobranie.

Opcje

OpcjaTypDomyślneNotatki
basePathstring/doconutPodstawowa ścieżka dla punktów końcowych ?convert=; musi odpowiadać gałęzi ASP.NET, w której UseDoconut() jest faktycznie zamontowany (zwykle koordynowane przez MiddlewarePath)
resPathstring/doconut-resAkceptowane w celu zachowania spójności konfiguracji z innymi widżetami Doconut; widżet konwertera obecnie nie tworzy z tego żadnego adresu URL
maxUploadMbnumber25Tylko wstępna kontrola po stronie klienta — odrzuca zbyt duży plik przed wysłaniem. Serwer niezależnie egzekwuje własny limit i odpowiada 413, jeśli zostanie przekroczony
licenseUrlstring | nullnullPo ustawieniu zamienia powiadomienie znaku wodnego na ekranie wyników w link do tego adresu URL
labelsobject{}Zastępuje dowolny podzbiór domyślnych angielskich ciągów widżetu (tekst upuszczenia, przyciski, komunikaty aria-live, komunikaty o błędach)

Wywołania zwrotne

Wywołanie zwrotneWyzwalane gdyŁadunek
onReady()Widżet wyświetlił swój ekran bezczynności/upuszczenia—
onSourceLoaded({ token, pages, sourceExt, allowedTargets })?convert=open zakończyło się sukcesemtoken sesji źródła, liczba stron, rozszerzenie źródła (bez wiodącej kropki), lista dozwolonych celów
onConverted({ downloadToken, resultToken, resultPages, downloadName, watermarked, target })?convert=run zakończyło się sukcesemte same pola co odpowiedź uruchomienia, plus żądany target
onDownload({ downloadName, downloadToken })Użytkownik kliknął link Pobierzuruchamia się równolegle z natywnym pobieraniem przeglądarki — nie przechwytuje ani nie zastępuje go
onError({ phase, message })Żądanie otwarcia lub uruchomienia nie powiodło sięphase jest 'open' lub 'run'; message to oczyszczony błąd serwera (lub komunikat po stronie klienta dla wstępnej kontroli rozmiaru przesyłanego)

Wywołanie zwrotne, które rzuca wyjątek, jest przechwytywane i logowane; nigdy nie przerywa przepływu widżetu.

Imperatywna obsługa

Doconut.convert() zwraca samą instancję widżetu — zachowaj ją, aby sterować widżetem programowo:

javascript
const conv = Doconut.convert('#doconut-convert', { basePath: '/doconut' });
const file = document.querySelector('#picker').files[0]; // Plik z własnego <input type="file" id="picker">
conv.reset();         // powrót do ekranu bezczynności/upuść; nie wywołuje ponownie onReady
conv.loadFile(file);  // rozpoczyna przepływ z obiektem File; nie robi nic, chyba że aktualnie bezczynny
conv.destroy();       // usuwa nasłuchiwacze, opróżnia mount; instancja jest nieużyteczna po tym

Etykiety

Każdy ciąg ma domyślną wersję angielską; labels zastępuje dowolny podzbiór, a pozostałe pozostają po angielsku. Fragmenty, które zmieniają się w czasie działania, używają {placeholders}, takie jak uploading: 'Uploading {name}…' i pages: '{n} pages'.

KluczDomyślny angielski
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.

Dalsze klucze obejmują aria-label strefy upuszczania (dropAriaLabel), teksty podglądu alt (previewAlt, resultAlt), powiązaną formę powiadomienia znaku wodnego używaną z licenseUrl (watermarkNoticePrefix, watermarkNoticeLink, watermarkNoticeSuffix), nieczytelną odpowiedź badResponse oraz ogłoszenia aria-live (annReady, annUploading, annLoaded, annLoadedNoTargets, annConverting, annDone, annError).

Błąd JSON z serwera jest wyświetlany tak, jak serwer go zapisał; serverError jest używany tylko wtedy, gdy nieudana odpowiedź nie zawiera błędu JSON, na przykład 404 wyłączonego widżetu.

Motywy

Widżet dodaje klasę dcw do swojego elementu montowania i odczytuje jego kolory, promień oraz czcionkę z własności CSS, dzięki czemu możesz go tematyzować bez modyfikowania jego wewnętrznych elementów:

css
#doconut-convert.dcw {
  --dcw-accent: #6b46c1;
  --dcw-radius: 12px;
  --dcw-font: "Inter", system-ui, sans-serif;
}

Domyślne: --dcw-accent: #2b6cb0, --dcw-bg: #ffffff, --dcw-fg: #1a202c, --dcw-muted: #718096, --dcw-border: #cbd5e0, --dcw-radius: 8px oraz systemowa czcionka UI dla --dcw-font.

Zbuduj własny interfejs

Widżet jest jedynie klientem tego kontraktu HTTP — zbuduj własny interfejs bezpośrednio na jego bazie, aby uzyskać inne doświadczenie użytkownika. Wszystkie trzy trasy znajdują się pod gałęzią ASP.NET, gdzie UseDoconut() jest zamontowany (zwykle /doconut), i zwracają 404 aż do wywołania AddConverterWidget(). Błędy zawierają ciało JSON, { "error": "..." }, z wyjątkiem przypadków, w których tabela podaje „status only”. Nieznana wartość ?convert= zwraca 400.

TrasaCelOdpowiedź sukcesu
POST ?convert=open (multipart, one file)Prześlij i otwórz dokument źródłowy do podglądu200 — { token, pages, sourceExt, allowedTargets }
POST ?token=<token>&convert=run&target=<ext>Konwertuj przechowywane źródło do target200 — { downloadToken, resultToken, resultPages, downloadName, watermarked }
GET ?convert=download&token=<downloadToken>Strumieniuj przekonwertowany plik200 — file bytes, Content-Disposition: attachment, Cache-Control: no-store

sourceExt w odpowiedzi open nie ma wiodącej kropki (np. "docx") — odwrotna konwencja w stosunku do parametru sourceExtension w DocumentConverter.ConvertAsync, który wymaga kropki. allowedTargets wymienia nazwy docelowe w małych literach ("pdf", "html", …); przekaż jedną z nich jako target, która jest dopasowywana bez uwzględniania wielkości liter. open używa pierwszego pliku w ciele multipart.

resultToken jest null, a resultPages jest 0, gdy wynik nie może być podglądany. downloadName to nazwa pliku źródłowego z rozszerzeniem docelowym.

Obrazy podglądu używają standardowej trasy obrazu przeglądarki, {basePath}?token={token}&page=1&thumb=1&width={px}, z token z open lub resultToken z run. Widżet żąda width=240.

Przesłane bajty źródłowe są przechowywane po stronie serwera i zachowywane przez 30 minut po ostatnim odczycie; po upływie tego okna, run zwraca 404 i plik musi zostać ponownie otwarty. Przekonwertowany wynik znajduje się w tym samym schowku — downloadToken otrzymuje własne świeże 30‑minutowe okno po zakończeniu konwersji — podczas gdy resultToken jest zwykłym tokenem sesji przeglądarki do podglądu wyniku. Gdy wynik może być podglądany, downloadToken i resultToken mają tę samą wartość. Zamknięcie wyniku przeglądarki nie usuwa nadal ważnego schowka pobierania, a resetowanie widżetu przeglądarki nie wydłuża żadnego z okien.

Tryby awarii, pogrupowane według trasy:

TrasaStatusKiedyTreść
any404Widżet nie jest włączony (AddConverterWidget() nigdy nie został wywołany) — sprawdzane przed obsłużeniem którejkolwiek z trzech trasstatus only
any405Nieprawidłowy czasownik HTTP (open/run wymagają POST; download wymaga GET)status only
open400Brak przesyłania multipartExpected a multipart file upload.
open400Brak pliku lub plik pustyNo file uploaded.
open400Rozszerzenie źródłowe, którego nie można skonwertowaćThis file type cannot be converted.
open403Typ pliku wymaga funkcji, której licencja nie przyznaje (plik DICOM bez Dicom)Converting this file type requires the Dicom capability license.
open413Przesłany plik przekracza MaxUploadMb, sprawdzany względem Content-Length i podczas odczytu przesyłaniaFile is too large.
run400Nieprawidłowy token (nie jest GUID)Invalid token.
run400target, który nie parsuje do ConversionTargetUnknown target format.
run400target nie znajduje się w allowedTargets źródłaThat target format is not available for this file.
run404Przechowywane przesłanie wygasło lub token nigdy nie został otwartyUpload expired — please re-open the file.
open, run500Przetwarzanie nie powiodło się wewnętrznieZsanityzowana wiadomość — zsanityzowana w ten sam sposób co każda inna ścieżka błędu Doconut; nigdy nie ujawnia szczegółów wewnętrznych
download400Nieprawidłowy token (nie jest GUID)status only
download404Nieznany lub wygasły token pobraniastatus only

Pełny cykl z fetch:

javascript
// file: File do konwersji, na przykład z <input type="file">.
async function convertFile(file) {
  const base = '/doconut';

  // 1. open: prześlij plik
  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: konwertuj do PDF, gdy jest to dozwolone, w przeciwnym razie do pierwszego dozwolonego celu
  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: zwykłe żądanie GET, które przeglądarka może wykonać
  window.location.href = base + '?convert=download&token=' + encodeURIComponent(converted.downloadToken);
}

Punkty końcowe są same-origin: ta wersja nie obsługuje CORS. Udostępnij swój interfejs i skrypt widżetu z tej samej domeny co Doconut, lub zastosuj reverse-proxy dla obu ścieżek /doconut (ścieżka middleware i ścieżka zasobów) pod domeną twojego UI.

W produkcji

  1. Zainstaluj wtyczkę obok pakietu podstawowego, w tej samej wersji: dotnet add package Doconut.NET8.Converter.
  2. Dodaj plik licencji. Umieść Doconut.Viewer.Converter.lic w tym samym folderze co Doconut.Viewer.lic.
  3. Ustaw limit serwera. MaxUploadMb w AddConverterWidget jest limitem wymuszanym przez serwer; maxUploadMb w widżecie jest tylko sprawdzeniem po stronie klienta. Utrzymaj oba równe.
  4. Serwuj interfejs UI z tego samego pochodzenia co końcówki Doconut, lub odwróć proxy (zobacz Zbuduj własny frontend).
  5. Zwolnij wyniki konwersji. Strumień zwracany przez ConvertAsync jest z puli; zwolnienie go zwraca jego bufor do puli.

Farmy webowe

Widżet przechowuje każde przesłanie i jego wynik w pamięci na węźle, który obsłużył open. Za load balancerem bez sesji przyklejonych, późniejsze żądanie run, download lub podglądu może trafić na inny węzeł i nie znaleźć przesłania. Zarejestruj współdzielony, zaszyfrowany magazyn widżetu raz, po AddDoconut():

csharp
byte[] farmKey = Convert.FromBase64String(builder.Configuration["Doconut:FarmKey"]);

builder.Services.AddDoconutDistributedWidgets(store =>
{
    store.RootPath = @"\\fileshare\doconut";   // folder, który każdy węzeł może odczytywać i zapisywać
    store.FarmKey = farmKey;                   // co najmniej 32 bajtów, identyczne na każdym węźle
    // store.Ttl = TimeSpan.FromMinutes(30);   // jak długo przesył jest przechowywany (domyślnie)
});
  • Pojedynczy serwer nie potrzebuje nic: bez tego wywołania używany jest pamięciowy magazyn.
  • Przesyłane pliki i wyniki są szyfrowane w spoczynku na udziale (AES-256, encrypt-then-MAC), a każdy plik jest powiązany ze swoim tokenem, więc żaden token nie może odczytać pliku innego tokena.
  • Na udziale, przesłanie lub wynik jest przechowywany przez Ttl po zapisaniu; odczytanie go nie wydłuża tego okna.
  • FarmKey musi mieć co najmniej 32 bajty i być taki sam na każdym węźle. Załaduj go z tajnego magazynu; nigdy nie koduj na stałe. Rejestracja zgłasza ArgumentException, gdy RootPath jest brakujący lub FarmKey jest krótszy niż 32 bajty.
  • Ustaw RootPath na tę samą współdzieloną lokalizację, której używa rozproszony podgląd.

Referencja API

Fasada i opcje widżetu znajdują się w przestrzeni nazw Doconut; ConversionTarget jest w Doconut.Configs.Conversion. ConverterPlugin jest w 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);
}

Rozwiązywane przez wstrzykiwanie zależności; konstruktor jest wewnętrzny. sourceExtension zawiera wiodącą kropkę. HtmlToWordAsync zapisuje plik .doc, gdy outputFormat jest ConversionTarget.Doc, oraz plik .docx dla każdej innej wartości.

ConversionTarget

45 formatów wyjściowych wymienionych w Formatach docelowych.

ConverterWidgetOptions

csharp
public sealed class ConverterWidgetOptions
{
    public int MaxUploadMb { get; set; } = 25;
}

Ustawiane przez DoconutOptions.AddConverterWidget(Action<ConverterWidgetOptions>? configure = null), który zwraca DoconutOptions, aby wywołania można było łańcuchować.

Rozwiązywanie problemów

ObjawPrzyczynaRozwiązanie
AddDoconut() rzuca The Converter plugin is registered via AddPlugin but no active license grants Converter.Brak licencji, plik TRIAL, licencja bez Converter, lub płatna licencja poza jej oknem wersjiZainstaluj licencję, która przyznaje Converter, lub usuń AddPlugin<ConverterPlugin>()
AddDoconut() rzuca AddConverterWidget() was called but the Converter plugin is not registered.Widżet jest włączony bez swojej wtyczkiDodaj options.AddPlugin<Doconut.Plugins.Converter.ConverterPlugin>()
Rozwiązywanie DocumentConverter rzuca No IDocumentConverter is registered. Add the converter plugin: options.AddPlugin<Doconut.Plugins.Converter.ConverterPlugin>().ConverterPlugin nie jest zarejestrowanyDodaj AddPlugin<ConverterPlugin>() wewnątrz AddDoconut()
Konwersja strumienia informuje, że format jest nieobsługiwanysourceExtension nie ma wiodącej kropkiUżyj ".xlsx", nie "xlsx"
ConvertAsync rzuca Converting '.dcm' requires the Dicom capability license.Źródło DICOM i licencja nie przyznaje DicomUżyj licencji, która przyznaje Dicom
Wyjście jest oznaczone znakiem wodnymLicencja jest tymczasowa (Demo/NFR)Użyj płatnej licencji, która przyznaje Converter
Widżet ładuje się, ale jego żądania zwracają 404AddConverterWidget() nie został wywołany, lub basePath nie pasuje do gałęzi, w której zamontowano UseDoconut()Wywołaj AddConverterWidget(); napraw basePath
open odpowiada 403 Converting this file type requires the Dicom capability license.Przesył DICOM i licencja nie przyznaje DicomUżyj licencji, która przyznaje Dicom
open odpowiada 413 File is too large.Przesył przekracza MaxUploadMbZgłoś MaxUploadMb w AddConverterWidget; maxUploadMb widżetu jest tylko sprawdzeniem po stronie klienta
run odpowiada 400 That target format is not available for this file.Cel nie jest jednym z allowedTargets źródłaUdostępnij tylko allowedTargets z open
run lub download odpowiada 404 (Upload expired — please re-open the file. z run)Okno 30 minut upłynęło, lub węzeł farmy webowej nie ma przesłaniaOtwórz plik ponownie; w farmie, zarejestruj AddDoconutDistributedWidgets
Widżet nie działa, gdy UI znajduje się na innym pochodzeniuKońcówki nie obsługują CORSSerwuj UI z tego samego pochodzenia, lub odwróć proxy ścieżki Doconut
Motyw nie jest stosowanyZmienne są ustawione na przodku lub na elemencie wewnątrz montażu; własna reguła .dcw widżetu ustawia je na montażuCeluj w sam montaż: #doconut-convert.dcw lub #doconut-convert

Czy ta strona była pomocna?