Plugin Convertisseur
Convertir des documents en 45 formats cibles
Le plugin Converter transforme Doconut en un service de conversion de documents. Il fournit le moteur derrière la façade publique DocumentConverter, et — en option — un widget prêt à l'emploi avec son propre contrat HTTP, afin que vous puissiez convertir des documents depuis C#, depuis le widget, ou depuis une interface que vous créez vous-même.
| Interface | Quand l'utiliser |
|---|---|
DocumentConverter (C#) | Vous convertissez sur le serveur, sans navigateur impliqué |
Widget intégré (doconutConverter.js) | Vous souhaitez un écran d'upload, conversion et téléchargement prêt à l'emploi dans votre page |
Points de terminaison HTTP (?convert=open|run|download) | Vous créez votre propre interface de conversion en vous basant sur un contrat serveur documenté |
Installer le paquet
Installez le dernier plugin Converter stable :
dotnet add package Doconut.NET6.ConverterPour fixer le plugin à la version décrite dans cette documentation, transmettez la version séparément :
dotnet add package Doconut.NET6.Converter --version 26.10.0Conservez le package Converter à la même version que Doconut.NET6. L'ID du package est
Doconut.NET6.Converter ; .<version> n'apparaît que dans le nom de fichier .nupkg téléchargé.
Le fichier de licence du plugin, Doconut.Viewer.Converter.lic, se place dans le même dossier que Doconut.Viewer.lic ; il est lu conjointement avec la licence du visualiseur.
Plateformes. Le plugin s'exécute partout où Doconut.NET6 s'exécute : Windows et Linux basé sur glibc en x64 (pas Alpine ou autres distributions basées sur musl). Sous Linux, installez la bibliothèque de configuration des polices avant l'ouverture du premier document :
apt-get update && apt-get install -y libfontconfig1La bibliothèque système libfontconfig1 peut être absente sur certaines distributions ; installez‑la via le gestionnaire de paquets.
Sur RHEL, Fedora et les distributions similaires, le package est fontconfig. Sans cela, l'ouverture d'un document échoue avec The system library libfontconfig1 is missing. Install it (Debian/Ubuntu: apt-get install -y libfontconfig1) and see the Linux section of the Doconut documentation.
Enregistrer le plugin
Il n'existe pas de méthode AddConverter() — le modèle de plugin de Doconut est uniforme. Chaque plugin, y compris Converter, s'enregistre de la même façon : appelez AddPlugin<TPlugin>() à l'intérieur de AddDoconut(). ConverterPlugin est fourni dans son propre package NuGet, Doconut.NET6.Converter, installé à côté du package du visualiseur de base.
builder.Services.AddDoconut(options =>
{
options.LicensePath = "Doconut.Viewer.lic";
options.AddPlugin<Doconut.Plugins.Converter.ConverterPlugin>();
});C'est tout ce dont la façade C# a besoin. Le widget et ses points de terminaison HTTP sont une option séparée, AddConverterWidget() (voir Widget intégré).
Le plugin nécessite une licence qui accorde la capacité Converter. Sans celle‑ci, AddDoconut() lance un(e) InvalidOperationException au démarrage, avant que l'application ne traite une requête :
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.Il se déclenche en l'absence de licence, avec un fichier legacy TRIAL, une licence sans Converter, et une licence payante utilisée en dehors de sa fenêtre de version. Les licences temporaires Démo/NFR sont acceptées. Il n'existe pas de niveau gratuit silencieux. Voir Configuration de la licence pour savoir comment les licences sont chargées.
Licence & filigrane
| État de la licence | Démarrage | Sortie de conversion |
|---|---|---|
Licence de visualiseur payante accordant Converter, dans sa fenêtre de version | Démarre | Propre — watermarked: false |
| Licence temporaire active (Démo/NFR) | Démarre | Convertit, avec le filigrane d'évaluation — watermarked: true |
| Licence temporaire expirée (Démo/NFR) | Démarre | Convertit, avec le filigrane d'évaluation — watermarked: true |
Pas de licence, un fichier legacy TRIAL, une licence sans Converter, ou une licence payante hors de sa fenêtre de version | AddDoconut() lance | — |
Les deux chemins d'appel calculent le drapeau selon la même règle : la façade C# DocumentConverter le dérive en interne à partir des états IsViewerLicensed et IsTemporary de la licence, et le gestionnaire ?convert=run du widget effectue la même vérification (IsViewerLicensed && !IsTrial && !IsTemporary) pour remplir le champ watermarked qu'il renvoie. Une intégration peut être construite et testée de bout en bout avec une licence d'évaluation avant l'achat — seuls les octets de sortie changent.
Une source DICOM (.dcm, .ima) nécessite également la capacité Dicom. Sans celle‑ci, ConvertAsync lance un(e) LicenseException (Converting '.dcm' requires the Dicom capability license.) et le open du widget répond 403.
Utilisation depuis C#
Chaque conversion renvoie un MemoryStream recherchable positionné à 0, prêt à être lu ou copié immédiatement. Résolvez DocumentConverter depuis l’injection de dépendances où vous en avez besoin — il est sans état par conception, ainsi une seule instance est sûre à réutiliser entre les requêtes.
// Injectez DocumentConverter ; son constructeur est interne, donc ne le `new` jamais.
Stream pdf = await converter.ConvertAsync("contract.docx", ConversionTarget.Pdf, ct: ct);// sourceExtension inclut le point initial. password est null sauf si le document est protégé.
Stream png = await converter.ConvertAsync(stream, ".xlsx", ConversionTarget.Png, password: null, ct: ct);Stream html = await converter.WordToHtmlAsync("report.docx", ct);// html: un Stream contenant le HTML à reconvertir en document Word, comme le résultat de WordToHtmlAsync.
Stream docx = await converter.HtmlToWordAsync(html, ConversionTarget.Docx, ct);Deux détails faciles à se tromper : sourceExtension sur la surcharge de flux doit inclure le point initial (".xlsx", pas "xlsx") — le convertisseur le compare au catalogue de formats et une extension seule ne sera pas résolue. Et malgré son nom, WordToHtmlAsync renvoie Task<Stream>, pas Task<string> — vous obtenez le document HTML (images intégrées en Base64) sous forme de flux, comme chaque autre résultat de conversion.
L’appelant possède le flux retourné et doit le libérer après l’avoir copié ou renvoyé son contenu. Le service DocumentConverter lui‑même est résolu via l’injection de dépendances ; ne le construisez ni ne le libérez manuellement.
Formats cibles
ConversionTarget (espace de noms Doconut.Configs.Conversion) comporte 45 membres :
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, IcoTous les formats source ne se convertissent pas en tous les formats cible — le plugin associe chaque famille de format source (Word, Excel, PowerPoint, PDF, CAD, Image, Email, Diagram, Project/Task, PSD, document web, DICOM) à son propre ensemble fixe de cibles autorisées. Convertir une source DICOM (.dcm, .ima) nécessite également une licence accordant la capacité Dicom ; ses cibles sont Pdf, Png, Jpeg, Bmp, Tiff et Gif. Ne codez pas en dur cet enum comme liste de cibles de votre interface : ?convert=open renvoie le allowedTargets réel pour le fichier qui vient d’être téléchargé, et c’est ce qui doit alimenter le sélecteur.
Widget intégré
Activer les points de terminaison
Les points de terminaison ?convert=open|run|download du widget sont opt‑in et désactivés par défaut — sécurisés par défaut. Activez‑les côté serveur, en même temps que l’enregistrement du plugin :
builder.Services.AddDoconut(options =>
{
options.LicensePath = "Doconut.Viewer.lic";
options.AddPlugin<Doconut.Plugins.Converter.ConverterPlugin>();
options.AddConverterWidget(widget =>
{
widget.MaxUploadMb = 25;
});
});AddConverterWidget() sans argument active le widget avec les valeurs par défaut (MaxUploadMb = 25). Cela ne confère pas les droits de conversion à lui seul : il faut AddPlugin<ConverterPlugin>(), sinon AddDoconut() lève une exception :
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.Sans AddConverterWidget(), les trois points de terminaison ?convert= répondent 404 — mais le fichier JS lui‑même est toujours servi (c’est une ressource statique intégrée simple ; seuls les points de terminaison qu’il interroge sont protégés).
L’intégrer
<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) accepte un sélecteur CSS ou un élément, lève une exception si le montage n’est pas trouvé, et renvoie une poignée. Le widget téléverse un fichier, affiche un aperçu de la page 1, laisse l’utilisateur choisir l’un des allowedTargets, convertit, prévisualise le résultat lorsqu’il le peut, et propose le téléchargement.
Options
| Option | Type | Valeur par défaut | Remarques |
|---|---|---|---|
basePath | string | /doconut | Chemin de base pour les points de terminaison ?convert= ; il doit correspondre à la branche ASP.NET où UseDoconut() est réellement montée (généralement coordonnée via MiddlewarePath) |
resPath | string | /doconut-res | Accepté pour la cohérence de configuration avec les autres widgets Doconut ; le widget de conversion ne génère actuellement aucune URL à partir de celui‑ci |
maxUploadMb | number | 25 | Vérification préliminaire côté client uniquement — rejette un fichier trop volumineux avant le téléchargement. Le serveur applique sa propre limite de façon indépendante et renvoie 413 si elle est dépassée |
licenseUrl | string | null | null | Lorsqu'il est défini, transforme l'avis de filigrane sur l'écran de résultat en un lien vers cette URL |
labels | object | {} | Remplace tout sous‑ensemble des chaînes par défaut en anglais du widget (texte de dépôt, boutons, annonces aria‑live, messages d'erreur) |
Rappels
| Rappel | Déclenchement | Charge utile |
|---|---|---|
onReady() | Le widget a rendu son écran d'attente/de dépôt | — |
onSourceLoaded({ token, pages, sourceExt, allowedTargets }) | ?convert=open réussit | jeton de session source, nombre de pages, extension source (sans point initial), liste des cibles autorisées |
onConverted({ downloadToken, resultToken, resultPages, downloadName, watermarked, target }) | ?convert=run réussit | mêmes champs que la réponse d'exécution, plus le target demandé |
onDownload({ downloadName, downloadToken }) | L'utilisateur clique sur le lien Télécharger | se déclenche en même temps que le téléchargement natif du navigateur — il n'intercepte ni ne remplace celui‑ci |
onError({ phase, message }) | Une requête d'ouverture ou d'exécution échoue | phase est 'open' ou 'run' ; message est l'erreur serveur nettoyée (ou un message côté client pour la vérification de taille de téléchargement) |
Un rappel qui lève une exception est intercepté et consigné ; il ne rompt jamais le flux du widget.
Gestion impérative
Doconut.convert() renvoie l'instance du widget elle‑même — conservez‑la pour piloter le widget de façon programmatique :
const conv = Doconut.convert('#doconut-convert', { basePath: '/doconut' });
const file = document.querySelector('#picker').files[0]; // un fichier provenant de votre propre <input type="file" id="picker">
conv.reset(); // retour à l'écran d'inactivité/dépose ; ne relance pas onReady
conv.loadFile(file); // démarre le flux avec un objet File ; no-op sauf si actuellement inactif
conv.destroy(); // supprime les écouteurs, vide le montage ; l'instance devient inutilisable après celaÉtiquettes
Chaque chaîne possède une valeur par défaut en anglais ; labels remplace tout sous‑ensemble et le reste reste en anglais. Les fragments qui changent à l'exécution utilisent {placeholders}, comme uploading: 'Uploading {name}…' et pages: '{n} pages'.
| Clé | Valeur par défaut en anglais |
|---|---|
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. |
D'autres clés couvrent le aria-label de la zone de dépôt (dropAriaLabel), les textes d'aperçu alt (previewAlt, resultAlt), la forme liée de l'avis de filigrane utilisé avec licenseUrl (watermarkNoticePrefix, watermarkNoticeLink, watermarkNoticeSuffix), une réponse illisible (badResponse) et les annonces aria-live (annReady, annUploading, annLoaded, annLoadedNoTargets, annConverting, annDone, annError).
Une erreur JSON du serveur est affichée telle qu'elle a été écrite par le serveur ; serverError n'est utilisé que lorsqu'une réponse en échec ne contient aucune erreur JSON, comme le 404 d'un widget désactivé.
Thématisation
Le widget ajoute la classe dcw à son élément de montage et lit ses couleurs, son rayon et sa police à partir des propriétés personnalisées CSS, de sorte que vous pouvez le thématiser sans toucher à ses internes :
#doconut-convert.dcw {
--dcw-accent: #6b46c1;
--dcw-radius: 12px;
--dcw-font: "Inter", system-ui, sans-serif;
}Valeurs par défaut : --dcw-accent: #2b6cb0, --dcw-bg: #ffffff, --dcw-fg: #1a202c, --dcw-muted: #718096, --dcw-border: #cbd5e0, --dcw-radius: 8px, et une police d'interface système pour --dcw-font.
Créez votre propre interface
Le widget n'est qu'un client pour ce contrat HTTP — créez votre propre interface directement contre celui‑ci pour une expérience utilisateur différente. Les trois routes se trouvent sous la branche ASP.NET où UseDoconut() est monté (normalement /doconut), et elles répondent 404 jusqu'à ce que AddConverterWidget() soit appelé. Les erreurs contiennent un corps JSON, { "error": "..." }, sauf lorsque le tableau indique « status only ». Une valeur ?convert= inconnue répond 400.
| Route | Objectif | Réponse réussie |
|---|---|---|
POST ?convert=open (multipart, un fichier) | Téléverser et ouvrir un document source pour l'aperçu | 200 — { token, pages, sourceExt, allowedTargets } |
POST ?token=<token>&convert=run&target=<ext> | Convertir la source mise en mémoire tampon en target | 200 — { downloadToken, resultToken, resultPages, downloadName, watermarked } |
GET ?convert=download&token=<downloadToken> | Diffuser le fichier converti | 200 — octets du fichier, Content-Disposition: attachment, Cache-Control: no-store |
sourceExt dans la réponse open n'a pas de point initial (par ex. "docx") — la convention opposée du paramètre sourceExtension sur DocumentConverter.ConvertAsync, qui en nécessite un. allowedTargets répertorie les noms de cibles en minuscules ("pdf", "html", …) ; transmettez‑en un comme target, qui est comparé sans tenir compte de la casse. open utilise le premier fichier dans le corps multipart.
resultToken est null, et resultPages est 0, lorsque le résultat ne peut pas être prévisualisé. downloadName est le nom du fichier source avec l'extension de la cible.
Les images d'aperçu utilisent la route d'image du visualiseur standard, {basePath}?token={token}&page=1&thumb=1&width={px}, avec le token provenant de open ou le resultToken provenant de run. Le widget demande width=240.
Les octets source téléversés sont stockés côté serveur et conservés pendant 30 minutes après leur dernière lecture ; une fois cette période écoulée, run répond 404 et le fichier doit être rouvert. Le résultat converti vit dans le même stockage — downloadToken obtient sa propre fenêtre fraîche de 30 minutes lorsque la conversion se termine — tandis que resultToken est un jeton de session de visualiseur ordinaire pour prévisualiser le résultat. Lorsque le résultat peut être prévisualisé, downloadToken et resultToken ont la même valeur. Fermer un résultat de visualiseur ne supprime pas un stockage de téléchargement encore valide, et réinitialiser le widget du navigateur n'étend aucune des deux fenêtres.
Modes d'échec, regroupés par route :
| Route | Statut | Quand | Corps |
|---|---|---|---|
| any | 404 | Le widget n'est pas activé (AddConverterWidget() n'a jamais été appelé) — vérifié avant que l'une des trois routes ne soit dispatchée | statut uniquement |
| any | 405 | Verbe HTTP incorrect (open/run nécessitent POST ; download nécessite GET) | statut uniquement |
open | 400 | Pas un téléversement multipart | Expected a multipart file upload. |
open | 400 | Aucun fichier, ou un fichier vide | No file uploaded. |
open | 400 | Une extension source qui ne peut pas être convertie | This file type cannot be converted. |
open | 403 | Le type de fichier nécessite une capacité que la licence ne fournit pas (un fichier DICOM sans Dicom) | Converting this file type requires the Dicom capability license. |
open | 413 | Le fichier téléversé dépasse MaxUploadMb, vérifié contre Content-Length et pendant la lecture du téléversement | File is too large. |
run | 400 | Jeton mal formé (pas un GUID) | Invalid token. |
run | 400 | Un(e) target qui ne se parse pas en ConversionTarget | Unknown target format. |
run | 400 | target n'est pas dans le allowedTargets de la source | That target format is not available for this file. |
run | 404 | Le téléversement stocké a expiré ou le jeton n'a jamais été ouvert | Upload expired — please re-open the file. |
open, run | 500 | Le traitement a échoué en interne | Un message assaini — assaini de la même façon que chaque autre chemin d'erreur Doconut ; n'expose jamais les détails internes |
download | 400 | Jeton mal formé (pas un GUID) | statut uniquement |
download | 404 | Jeton de téléchargement inconnu ou expiré | statut uniquement |
Un parcours complet avec fetch :
// file: le File à convertir, par exemple depuis un <input type="file">.
async function convertFile(file) {
const base = '/doconut';
// 1. open: téléverser le fichier
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: convertir en PDF lorsqu'il est autorisé, sinon vers la première cible autorisée
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: un simple GET que le navigateur peut suivre
window.location.href = base + '?convert=download&token=' + encodeURIComponent(converted.downloadToken);
}Les points de terminaison sont same-origin : cette version ne prend pas en charge CORS. Servez votre interface utilisateur et le script du widget depuis la même origine que Doconut, ou utilisez un reverse‑proxy sur les deux chemins /doconut (le chemin du middleware et le chemin des ressources) sous l'origine de votre UI.
En production
- Installez le plugin à côté du paquet principal, à la même version :
dotnet add package Doconut.NET6.Converter. - Ajoutez le fichier de licence. Placez
Doconut.Viewer.Converter.licdans le même dossier queDoconut.Viewer.lic. - Définissez la limite du serveur.
MaxUploadMbdansAddConverterWidgetest la limite imposée par le serveur ; lemaxUploadMbdu widget n'est qu'une vérification côté client. Gardez les deux égaux. - Servez l'interface utilisateur depuis la même origine que les points de terminaison Doconut, ou faites un reverse-proxy (voir Construisez votre propre interface).
- Libérez les résultats de conversion. Le flux retourné par
ConvertAsyncest mis en pool ; le libérer renvoie ses tampons au pool.
Fermes Web
Le widget conserve chaque téléchargement et son résultat en mémoire sur le nœud qui a servi open. Derrière un équilibreur de charge sans sessions persistantes, une requête run, download ou de prévisualisation ultérieure peut atteindre un autre nœud et ne pas trouver le téléchargement. Enregistrez le magasin partagé et chiffré du widget une seule fois, après AddDoconut() :
byte[] farmKey = Convert.FromBase64String(builder.Configuration["Doconut:FarmKey"]);
builder.Services.AddDoconutDistributedWidgets(store =>
{
store.RootPath = @"\\fileshare\doconut"; // un dossier que chaque nœud peut lire et écrire
store.FarmKey = farmKey; // au moins 32 octets, identique sur chaque nœud
// store.Ttl = TimeSpan.FromMinutes(30); // combien de temps un téléchargement est conservé (par défaut)
});- Un serveur unique n'a besoin de rien : sans cet appel, le magasin en mémoire est utilisé.
- Les téléchargements et les résultats sont chiffrés au repos sur le partage (AES-256, encrypt-then-MAC), et chaque fichier est lié à son jeton, de sorte qu'un jeton ne peut jamais lire le fichier d'un autre.
- Sur le partage, un téléchargement ou un résultat est conservé pendant
Ttlaprès son écriture ; le lire n'étend pas cette fenêtre. FarmKeydoit faire au moins 32 octets et être identique sur chaque nœud. Chargez‑le depuis un magasin secret ; ne le codez jamais en dur. L'enregistrement lève unArgumentExceptionlorsqueRootPathest manquant ou queFarmKeyest plus court que 32 octets.- Pointez
RootPathvers le même emplacement partagé utilisé par le visualiseur distribué.
Référence API
La façade et les options du widget se trouvent dans l'espace de noms Doconut ; ConversionTarget est dans Doconut.Configs.Conversion. ConverterPlugin est dans 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);
}Résolu par injection de dépendances ; le constructeur est interne. sourceExtension inclut le point initial. HtmlToWordAsync écrit un fichier .doc lorsque outputFormat est ConversionTarget.Doc, et un fichier .docx pour toute autre valeur.
ConversionTarget
Les 45 formats de sortie répertoriés dans Formats cibles.
ConverterWidgetOptions
public sealed class ConverterWidgetOptions
{
public int MaxUploadMb { get; set; } = 25;
}Défini via DoconutOptions.AddConverterWidget(Action<ConverterWidgetOptions>? configure = null), qui renvoie le DoconutOptions afin que les appels puissent être enchaînés.
Dépannage
| Symptôme | Cause | Solution |
|---|---|---|
AddDoconut() lance The Converter plugin is registered via AddPlugin but no active license grants Converter. | Pas de licence, un fichier TRIAL, une licence sans Converter, ou une licence payante hors de sa fenêtre de version | Installez une licence qui accorde Converter, ou supprimez AddPlugin<ConverterPlugin>() |
AddDoconut() lance AddConverterWidget() was called but the Converter plugin is not registered. | Le widget est activé sans son plugin | Ajoutez options.AddPlugin<Doconut.Plugins.Converter.ConverterPlugin>() |
La résolution de DocumentConverter lance No IDocumentConverter is registered. Add the converter plugin: options.AddPlugin<Doconut.Plugins.Converter.ConverterPlugin>(). | ConverterPlugin n'est pas enregistré | Ajoutez AddPlugin<ConverterPlugin>() à l'intérieur de AddDoconut() |
| La conversion du flux indique que le format n'est pas pris en charge | sourceExtension n'a pas de point initial | Passez ".xlsx", pas "xlsx" |
ConvertAsync lance Converting '.dcm' requires the Dicom capability license. | Une source DICOM, et la licence n'accorde pas Dicom | Utilisez une licence qui accorde Dicom |
| La sortie est filigranée | La licence est temporaire (Démo/NFR) | Utilisez une licence payante qui accorde Converter |
Le widget se charge mais ses requêtes répondent 404 | AddConverterWidget() n'a pas été appelé, ou basePath ne correspond pas à la branche où UseDoconut() est monté | Appelez AddConverterWidget() ; corrigez basePath |
open répond 403 Converting this file type requires the Dicom capability license. | Un téléchargement DICOM, et la licence n'accorde pas Dicom | Utilisez une licence qui accorde Dicom |
open répond 413 File is too large. | Le téléchargement dépasse MaxUploadMb | Levez MaxUploadMb dans AddConverterWidget ; le maxUploadMb du widget n'est qu'une vérification côté client |
run répond 400 That target format is not available for this file. | La cible n'est pas l'une des allowedTargets de la source | Proposez uniquement le allowedTargets provenant de open |
run ou download répond 404 (Upload expired — please re-open the file. de run) | La fenêtre de 30 minutes s'est écoulée, ou un nœud de ferme web n'a pas le téléchargement | Ouvrez à nouveau le fichier ; dans une ferme, enregistrez AddDoconutDistributedWidgets |
| Le widget échoue lorsque l'UI est sur une autre origine | Les points de terminaison n'ont pas de support CORS | Servez l'UI depuis la même origine, ou faites un reverse-proxy des chemins Doconut |
| Le thème ne s'applique pas | Les variables sont définies sur un ancêtre ou sur un élément à l'intérieur du montage ; la règle .dcw du widget les définit sur le montage | Ciblez le montage lui‑même : #doconut-convert.dcw ou #doconut-convert |
Cette page était-elle utile ?