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.
| Powierzchnia | Uż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:
dotnet add package Doconut.NET8.ConverterAby przypiąć wtyczkę do wersji opisanej w tej dokumentacji, przekaż wersję osobno:
dotnet add package Doconut.NET8.Converter --version 26.10.0Utrzymuj 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:
apt-get update && apt-get install -y libfontconfig1W 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.
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:
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 licencji | Uruchomienie | Wynik konwersji |
|---|---|---|
Płatna licencja podglądu przyznająca Converter, w ramach swojego okna wersji | Uruchamia się | Czysty — watermarked: false |
| Aktywna tymczasowa (Demo/NFR) licencja | Uruchamia się | Konwertuje, z znakiem wodnym oceny — watermarked: true |
| Wygasła tymczasowa (Demo/NFR) licencja | Uruchamia się | Konwertuje, z znakiem wodnym oceny — watermarked: true |
Brak licencji, starszy plik TRIAL, licencja bez Converter, lub płatna licencja poza oknem wersji | AddDoconut() 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.
// Wstrzyknij DocumentConverter; jego konstruktor jest wewnętrzny, więc nigdy nie `new` go.
Stream pdf = await converter.ConvertAsync("contract.docx", ConversionTarget.Pdf, ct: ct);// 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);Stream html = await converter.WordToHtmlAsync("report.docx", ct);// 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:
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, IcoNie 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:
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:
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
<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
| Opcja | Typ | Domyślne | Notatki |
|---|---|---|---|
basePath | string | /doconut | Podstawowa ś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) |
resPath | string | /doconut-res | Akceptowane w celu zachowania spójności konfiguracji z innymi widżetami Doconut; widżet konwertera obecnie nie tworzy z tego żadnego adresu URL |
maxUploadMb | number | 25 | Tylko 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 |
licenseUrl | string | null | null | Po ustawieniu zamienia powiadomienie znaku wodnego na ekranie wyników w link do tego adresu URL |
labels | object | {} | 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 zwrotne | Wyzwalane gdy | Ładunek |
|---|---|---|
onReady() | Widżet wyświetlił swój ekran bezczynności/upuszczenia | — |
onSourceLoaded({ token, pages, sourceExt, allowedTargets }) | ?convert=open zakończyło się sukcesem | token 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ę sukcesem | te same pola co odpowiedź uruchomienia, plus żądany target |
onDownload({ downloadName, downloadToken }) | Użytkownik kliknął link Pobierz | uruchamia 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:
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 tymEtykiety
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'.
| Klucz | Domyślny angielski |
|---|---|
dropPrompt | Drag & drop a document here |
dropHint | PDF, Word, Excel, PowerPoint, images and more |
chooseFile | Choose file |
uploading | Uploading {name}… |
page / pages | 1 page / {n} pages |
noTargets | No conversion targets are available for this file. |
convertTo / convert | Convert to / Convert |
converting | Converting to {target}… |
readyToDownload | Ready to download |
download / convertAnother | Download / Convert another |
watermarkNotice | Output is watermarked — get a license to remove it. |
retry | Retry |
genericError | Something went wrong. Please try again. |
sizeLimit | That file is larger than the {mb} MB upload limit. Please choose a smaller file. |
serverError | The server could not process this request. Please try again. |
networkError | Could 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:
#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.
| Trasa | Cel | Odpowiedź sukcesu |
|---|---|---|
POST ?convert=open (multipart, one file) | Prześlij i otwórz dokument źródłowy do podglądu | 200 — { token, pages, sourceExt, allowedTargets } |
POST ?token=<token>&convert=run&target=<ext> | Konwertuj przechowywane źródło do target | 200 — { downloadToken, resultToken, resultPages, downloadName, watermarked } |
GET ?convert=download&token=<downloadToken> | Strumieniuj przekonwertowany plik | 200 — 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:
| Trasa | Status | Kiedy | Treść |
|---|---|---|---|
| any | 404 | Widżet nie jest włączony (AddConverterWidget() nigdy nie został wywołany) — sprawdzane przed obsłużeniem którejkolwiek z trzech tras | status only |
| any | 405 | Nieprawidłowy czasownik HTTP (open/run wymagają POST; download wymaga GET) | status only |
open | 400 | Brak przesyłania multipart | Expected a multipart file upload. |
open | 400 | Brak pliku lub plik pusty | No file uploaded. |
open | 400 | Rozszerzenie źródłowe, którego nie można skonwertować | This file type cannot be converted. |
open | 403 | Typ pliku wymaga funkcji, której licencja nie przyznaje (plik DICOM bez Dicom) | Converting this file type requires the Dicom capability license. |
open | 413 | Przesłany plik przekracza MaxUploadMb, sprawdzany względem Content-Length i podczas odczytu przesyłania | File is too large. |
run | 400 | Nieprawidłowy token (nie jest GUID) | Invalid token. |
run | 400 | target, który nie parsuje do ConversionTarget | Unknown target format. |
run | 400 | target nie znajduje się w allowedTargets źródła | That target format is not available for this file. |
run | 404 | Przechowywane przesłanie wygasło lub token nigdy nie został otwarty | Upload expired — please re-open the file. |
open, run | 500 | Przetwarzanie nie powiodło się wewnętrznie | Zsanityzowana wiadomość — zsanityzowana w ten sam sposób co każda inna ścieżka błędu Doconut; nigdy nie ujawnia szczegółów wewnętrznych |
download | 400 | Nieprawidłowy token (nie jest GUID) | status only |
download | 404 | Nieznany lub wygasły token pobrania | status only |
Pełny cykl z fetch:
// 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
- Zainstaluj wtyczkę obok pakietu podstawowego, w tej samej wersji:
dotnet add package Doconut.NET8.Converter. - Dodaj plik licencji. Umieść
Doconut.Viewer.Converter.licw tym samym folderze coDoconut.Viewer.lic. - Ustaw limit serwera.
MaxUploadMbwAddConverterWidgetjest limitem wymuszanym przez serwer;maxUploadMbw widżecie jest tylko sprawdzeniem po stronie klienta. Utrzymaj oba równe. - Serwuj interfejs UI z tego samego pochodzenia co końcówki Doconut, lub odwróć proxy (zobacz Zbuduj własny frontend).
- Zwolnij wyniki konwersji. Strumień zwracany przez
ConvertAsyncjest 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():
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
Ttlpo zapisaniu; odczytanie go nie wydłuża tego okna. FarmKeymusi 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łaszaArgumentException, gdyRootPathjest brakujący lubFarmKeyjest krótszy niż 32 bajty.- Ustaw
RootPathna 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
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
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
| Objaw | Przyczyna | Rozwią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 wersji | Zainstaluj 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 wtyczki | Dodaj 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 zarejestrowany | Dodaj AddPlugin<ConverterPlugin>() wewnątrz AddDoconut() |
| Konwersja strumienia informuje, że format jest nieobsługiwany | sourceExtension nie ma wiodącej kropki | Użyj ".xlsx", nie "xlsx" |
ConvertAsync rzuca Converting '.dcm' requires the Dicom capability license. | Źródło DICOM i licencja nie przyznaje Dicom | Użyj licencji, która przyznaje Dicom |
| Wyjście jest oznaczone znakiem wodnym | Licencja jest tymczasowa (Demo/NFR) | Użyj płatnej licencji, która przyznaje Converter |
Widżet ładuje się, ale jego żądania zwracają 404 | AddConverterWidget() 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 Dicom | Użyj licencji, która przyznaje Dicom |
open odpowiada 413 File is too large. | Przesył przekracza MaxUploadMb | Zgł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ła | Udostę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łania | Otwórz plik ponownie; w farmie, zarejestruj AddDoconutDistributedWidgets |
| Widżet nie działa, gdy UI znajduje się na innym pochodzeniu | Końcówki nie obsługują CORS | Serwuj UI z tego samego pochodzenia, lub odwróć proxy ścieżki Doconut |
| Motyw nie jest stosowany | Zmienne są ustawione na przodku lub na elemencie wewnątrz montażu; własna reguła .dcw widżetu ustawia je na montażu | Celuj w sam montaż: #doconut-convert.dcw lub #doconut-convert |
Czy ta strona była pomocna?