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 widget z własnym kontraktem HTTP, dzięki czemu możesz konwertować dokumenty z C#, z widgetu lub z własnego frontendu.

PowierzchniaKiedy używać
DocumentConverter (C#)Konwertujesz na serwerze, bez udziału przeglądarki
Widget wstawiany (doconutConverter.js)Chcesz gotowy ekran przesyłania, konwersji i pobierania na swojej stronie
Endpointy HTTP (?convert=open|run|download)Budujesz własny interfejs konwersji zgodny z udokumentowanym kontraktem serwera

Zainstaluj pakiet

Zainstaluj najnowszą stabilną wtyczkę Converter:

bash
dotnet add package Doconut.NETStandard.Converter

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

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

Utrzymuj pakiet Converter w tej samej wersji co Doconut.NETStandard. Identyfikator pakietu to Doconut.NETStandard.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ą przeglądarki.

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.NETStandard.Converter, zainstalowanym razem z podstawowym pakietem przeglądarki.

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

To wszystko, czego potrzebuje fasada C#. Widget i jego endpointy HTTP są oddzielnym, opcjonalnym elementem, AddConverterWidget() (zobacz Widget wstawiany).

Wtyczka wymaga licencji, która przyznaje możliwość Converter. Bez niej, AddDoconut() rzuca 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.

Rzuca wyjątek przy braku licencji, przy starszym pliku TRIAL, przy licencji bez Converter oraz przy płatnej licencji użytej poza jej okresem wersji. Licencje tymczasowe Demo/NFR są akceptowane. 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 przeglądarki przyznająca Converter, w ramach swojego okna wersjiUruchamia sięCzysty — watermarked: false
Aktywna tymczasowa (Demo/NFR) licencjaUruchamia sięKonwertuje, z znakiem wodnym ewaluacji — watermarked: true
Wygasła tymczasowa (Demo/NFR) licencjaUruchamia sięKonwertuje, z znakiem wodnym ewaluacji — watermarked: true
Brak licencji, starszy plik TRIAL, licencja bez Converter lub płatna licencja poza oknem wersjiAddDoconut() rzuca—

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 widgetu 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 rzuca LicenseException (Converting '.dcm' requires the Dicom capability license.), a open widgetu odpowiada 403.

Use from 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 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, 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.

Target formats

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ę formatów każdego ź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 dowolnego właśnie przesłanego pliku i to powinno sterować wyborem.

Drop-in widget

Enable the endpoints

Punkty końcowe ?convert=open|run|download widgetu są opcjonalne i domyślnie wyłączone — zabezpieczone z góry. 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 on 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ź to

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, rzuca wyjątek, jeśli nie znajdzie montażu, i zwraca uchwyt. Widżet przesyła plik, wyświetla podgląd strony 1, pozwala użytkownikowi wybrać jeden z allowedTargets, konwertuje, podgląda wynik, gdy jest dostępny, i oferuje pobranie.

Opcje

OpcjaTypDomyślnieUwagi
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 buduje z tego żadnego URL
maxUploadMbnumber25Tylko wstępna kontrola po stronie klienta — odrzuca zbyt duży plik przed wysłaniem. Serwer egzekwuje własny limit niezależnie i zwraca 413, jeśli zostanie przekroczony
licenseUrlstring | nullnullGdy ustawione, zamienia powiadomienie o znaku wodnym na ekranie wyniku w link do tego 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 gdyDane
onReady()Widżet wyświetlił 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 kropki), lista dozwolonych docelowych
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 pobraniem 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.

Imperatywny uchwyt

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 File z własnego <input type="file" id="picker">
conv.reset();         // z powrotem do ekranu bezczynności/upuść; nie wywołuje ponownie onReady
conv.loadFile(file);  // rozpoczyna przepływ z obiektem File; brak operacji, 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ślny angielski tekst; 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 o znaku wodnym 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.

Tematyzacja

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 ingerencji w jego wewnętrzne elementy:

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 frontend

Widżet jest jedynie klientem tego kontraktu HTTP — zbuduj własny frontend bezpośrednio przeciwko niemu, aby uzyskać inne doświadczenie użytkownika. Wszystkie trzy trasy znajdują się pod gałęzią ASP.NET, w której zamontowano UseDoconut() (zwykle /doconut), i zwracają 404 aż do wywołania AddConverterWidget(). Błędy zawierają ciało JSON, { "error": "..." }, z wyjątkiem przypadków, gdy tabela podaje „tylko status”. 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 przechowywany źródłowy do target200 — { downloadToken, resultToken, resultPages, downloadName, watermarked }
GET ?convert=download&token=<downloadToken>Strumieniuj przekonwertowany plik200 — bajty pliku, Content-Disposition: attachment, Cache-Control: no-store

sourceExt w odpowiedzi open nie ma wiodącej kropki (np. "docx") — jest to 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 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 wywołaniem 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 funkcji, której licencja nie zapewnia (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 pobraniatylko status

Pełny cykl z fetch:

javascript
// file: plik 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 może wykonać przeglądarka
  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 i skrypt widżetu z tej samej domeny co Doconut, lub odwróć proxy oba ścieżki /doconut (ścieżkę pośrednią i ścieżkę zasobów) pod domeną Twojego UI.

W produkcji

  1. Zainstaluj wtyczkę obok pakietu core, w tej samej wersji: dotnet add package Doconut.NETStandard.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 narzucanym przez serwer; maxUploadMb w widżecie to jedynie sprawdzenie po stronie klienta. Utrzymaj oba na tym samym poziomie.
  4. Serwuj interfejs UI z tego samego pochodzenia co endpointy Doconut, lub użyj reverse-proxy (zobacz Zbuduj własny interfejs).
  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łanego pliku. 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 bajty, identyczne na każdym węźle
    // store.Ttl = TimeSpan.FromMinutes(30);   // jak długo przechowywany jest upload (domyślnie)
});
  • Pojedynczy serwer nie potrzebuje nic: 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 zgłasza ArgumentException gdy RootPath jest brakujący lub FarmKey jest krótszy niż 32 bajty.
  • Wskaż RootPath na tę samą współdzieloną lokalizację, której używa rozproszony podgląd.

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

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 okresem 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 kropkiPrzekaż ".xlsx", a 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 to jedynie sprawdzenie 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, lub węzeł farmy sieciowej nie ma przesłanego plikuOtwórz plik ponownie; w farmie zarejestruj AddDoconutDistributedWidgets
Widżet nie działa, gdy UI znajduje się 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

Notatki dotyczące frameworka

  • viewer.Converter.GetConverter() nie istnieje tutaj. Konwersja nie jest już osiągana przez instancję przeglądarki: wstrzyknij Doconut.DocumentConverter zamiast tego.
  • Ten ConversionTarget enum obejmuje każdą rodzinę źródeł. Poprzednia biblioteka miała typ *ConfigConverter dla każdej rodziny — WordConfigConverter, ExcelConfigConverter i tak dalej — każdy z własnym zagnieżdżonym enumem EnTargetFormat, plus enum SourceFormatConverter dla wejścia. Wszystkie zostały usunięte; zobacz przewodnik migracji.
  • Tylko Windows, jak reszta pakietu .NET Standard.

Czy ta strona była pomocna?