Wtyczka Konwertera

Konwertuj dokumenty do 45 formatów docelowych

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

PowierzchniaKiedy używać
DocumentConverter (C#)Konwertujesz na serwerze, bez udziału przeglądarki
Widżet wstawiany (doconutConverter.js)Chcesz gotowy ekran przesyłania, konwersji i pobierania w swojej stronie
Punkty końcowe HTTP (?convert=open|run|download)Budujesz własny interfejs konwersji korzystając z udokumentowanego kontraktu serwera

Zainstaluj pakiet

Zainstaluj najnowszą stabilną wtyczkę Konwertera:

bash
dotnet add package Doconut.NET6.Converter

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

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

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

Plik licencji wtyczki, Doconut.Viewer.Converter.lic, umieść 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.NET6: Windows oraz Linux oparty na glibc na architekturze 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

Na RHEL, Fedora i podobnych dystrybucjach pakiet to fontconfig. Bez niego otwarcie 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 Konwerter, rejestruje się w ten sam sposób: wywołaj AddPlugin<TPlugin>() wewnątrz AddDoconut(). ConverterPlugin jest dostarczany w własnym pakiecie NuGet, Doconut.NET6.Converter, zainstalowanym 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 są oddzielnym, opcjonalnym elementem, AddConverterWidget() (zobacz Widżet wstawiany).

Wtyczka wymaga licencji, która przyznaje możliwość Converter. Bez niej AddDoconut() zgłasza InvalidOperationException przy uruchamianiu, 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 w przypadku braku licencji, starszego pliku TRIAL, licencji bez Converter oraz płatnej licencji użytej poza oknem wersji. Licencje tymczasowe Demo/NFR są akceptowane. Nie ma cichego darmowego poziomu. Zobacz License Setup, 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 licencja (Demo/NFR)Uruchamia sięKonwertuje, z znakiem wodnym oceny — watermarked: true
Wygasła tymczasowa licencja (Demo/NFR)Uruchamia 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ę według tej samej reguły: fasada C# DocumentConverter wyprowadza ją wewnętrznie z IsViewerLicensed i stanu IsTemporary licencji, 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 odpowiedź widżetu open to 403.

Użycie z C#

Każda konwersja zwraca przeszukiwalny MemoryStream ustawiony na 0, gotowy do natychmiastowego odczytu lub kopiowania. Rozwiąż DocumentConverter z DI, gdziekolwiek go potrzebujesz — jest bezstanowy z założenia, więc pojedyncza instancja może być bezpiecznie używana wielokrotnie w różnych żą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, na przykład 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ła (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 właśnie przesłanego pliku i to powinno sterować wyborem.

Widget typu Drop-in

Włącz punkty końcowe

Punkty końcowe ?convert=open|run|download widgetu 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 widget z ustawieniami domyślnymi (MaxUploadMb = 25). Nie przyznaje 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 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 nie znajdzie miejsca montowania, i zwraca uchwyt. Widget 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ślneUwagi
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 dla 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 | nullnullGdy ustawione, zamienia powiadomienie znak wodny 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 zwrotneWywoływane gdyŁadunek
onReady()Widżet wyświetlił swój ekran bezczynności/upuszczenia—
onSourceLoaded({ token, pages, sourceExt, allowedTargets })?convert=open zakończy 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 się sukcesemte same pola co odpowiedź uruchomienia, plus żądany target
onDownload({ downloadName, downloadToken })Użytkownik klika link Pobierzwywoływane równocześnie 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 wykonuje żadnej operacji, chyba że jest aktualnie bezczynny
conv.destroy();       // usuwa nasłuchiwacze, opróżnia mount; instancja jest nieużywalna po tym

Etykiety

Każdy ciąg ma domyślnie angielską wersję; labels zastępuje dowolny podzbiór, a pozostałe pozostają po angielsku. Fragmenty zmieniające 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 znak wodny 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.

Theming

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 zmienić motyw bez modyfikowania jego wewnętrznych elementów:

Poniżej znajduje się przykładowy kod; komentarz w kodzie został przetłumaczony na język polski.

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 przeciwko niemu, aby uzyskać inne doświadczenie użytkownika. Wszystkie trzy trasy znajdują się pod gałęzią ASP.NET, gdzie zamontowano UseDoconut() (zwykle /doconut), i odpowiadają 404 aż do wywołania AddConverterWidget(). Błędy zawierają ciało w formacie JSON, { "error": "..." }, z wyjątkiem przypadków, gdy w tabeli podano „tylko status”. Nieznana wartość ?convert= zwraca 400.

TrasaCelOdpowiedź sukcesu
POST ?convert=open (multipart, jeden plik)Prześlij i otwórz dokument źródłowy do podglądu200 — { token, pages, sourceExt, allowedTargets }
POST ?token=<token>&convert=run&target=<ext>Konwertuj przechowywany źródłowy na target200 — { downloadToken, resultToken, resultPages, downloadName, watermarked }
GET ?convert=download&token=<downloadToken>Strumieniuj skonwertowany plik200 — bajty pliku, 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 małymi literami ("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 to null, a resultPages to 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 być ponownie otwarty. Skonwertowany 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 zresetowanie widżetu przeglądarki nie wydłuża żadnego z okien.

Tryby awaryjne, pogrupowane według trasy:

TrasaStatusKiedyTreść
dowolna404Widżet nie jest włączony (AddConverterWidget() nigdy nie został wywołany) — sprawdzane przed obsługą którejkolwiek z trzech trastylko status
dowolna405Nieprawidłowy czasownik HTTP (open/run wymagają POST; download wymaga GET)tylko status
open400Nie jest przesyłaniem 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 możliwości, 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 oraz 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 przesył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)tylko status
download404Nieznany lub wygasły token pobieraniatylko status

Pełny cykl z fetch:

Poniżej znajduje się przykładowy kod; komentarz w kodzie został przetłumaczony na język polski.

javascript
// file: the File to convert, for example from an <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 UI oraz skrypt widżetu z tego samego pochodzenia co Doconut, lub zastosuj reverse-proxy dla obu ścieżek /doconut (ścieżka pośrednika i ścieżka zasobów) pod pochodzeniem Twojego UI.

W produkcji

  1. Zainstaluj wtyczkę obok pakietu core, w tej samej wersji: dotnet add package Doconut.NET6.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 jedynie sprawdzeniem po stronie klienta. Utrzymaj oba równe.
  4. Serwuj UI z tego samego pochodzenia co endpointy Doconut, lub zastosuj reverse-proxy (zobacz Zbuduj własny frontend).
  5. Zwolnij wyniki konwersji. Strumień zwracany przez ConvertAsync jest z puli; zwolnienie go zwraca jego bufory do puli.

Farmy sieciowe

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 bytes, identyczne na każdym węźle
    // store.Ttl = TimeSpan.FromMinutes(30);   // jak długo przechowywany jest upload (domyślnie)
});
  • Jeden serwer nie potrzebuje niczego: bez tego wywołania używany jest magazyn w pamięci.
  • Przesyłki 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 tokenu.
  • Na udziale, przesyłka 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 rzuca ArgumentException, gdy RootPath jest brakujące lub FarmKey jest krótsze niż 32 bajty.
  • Wskaż RootPath na tę samą współdzieloną lokalizację, której używa rozproszony przeglądarka.

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ązywany 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 Formaty docelowe.

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 mogły być łańcuchowane.

Rozwiązywanie problemów

ObjawPrzyczynaRozwiązanie
AddDoconut() wyrzuca 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() wyrzuca 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 wyrzuca No IDocumentConverter is registered. Add the converter plugin: options.AddPlugin<Doconut.Plugins.Converter.ConverterPlugin>().ConverterPlugin nie jest zarejestrowaneDodaj AddPlugin<ConverterPlugin>() wewnątrz AddDoconut()
Konwersja strumienia mówi, że format jest nieobsługiwanysourceExtension nie ma wiodącej kropkiPrzekaż ".xlsx", nie "xlsx"
ConvertAsync wyrzuca Converting '.dcm' requires the Dicom capability license.Źródło DICOM i licencja nie przyznaje DicomUżyj licencji, która przyznaje Dicom
Wynik jest oznaczony 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ło wywołane, 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łanie DICOM i licencja nie przyznaje DicomUżyj licencji, która przyznaje Dicom
open odpowiada 413 File is too large.Przesyłka przekracza MaxUploadMbZgłoś MaxUploadMb w AddConverterWidget; maxUploadMb widżetu jest jedynie 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)Upłynęło 30 minut okna, lub węzeł farmy sieciowej nie ma przesłaniaOtwórz plik ponownie; w farmie, zarejestruj AddDoconutDistributedWidgets
Widżet nie działa, gdy UI jest na innym pochodzeniuEndpointy nie obsługują CORSSerwuj UI z tego samego pochodzenia, lub reverse-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?