תוסף ממיר
המרת מסמכים ל‑45 פורמטים שונים
תוסף הממיר הופך את Doconut לשירות המרת מסמכים. הוא תורם את המנוע שמאחורי המעטפת הציבורית DocumentConverter, ו‑— באפשרות בחירה — וידג'ט נשלף עם חוזה HTTP משלו, כך שניתן להמיר מסמכים מ‑C#, מהוידג'ט, או מממשק קדמי שאתה בונה בעצמך.
| ממשק | מתי להשתמש |
|---|---|
DocumentConverter (C#) | אתה ממיר בשרת, ללא דפדפן מעורב |
Drop-in widget (doconutConverter.js) | אתה רוצה מסך העלאה, המרה והורדה מוכן מראש בדף שלך |
HTTP endpoints (?convert=open|run|download) | אתה בונה ממשק משתמש להמרה משלך נגד חוזה שרת מתועד |
התקנת החבילה
התקן את תוסף הממיר היציב האחרון:
dotnet add package Doconut.NETStandard.Converterכדי לקבע את התוסף לגרסה שהמסמך הזה מתאר, העבר את הגרסה בנפרד:
dotnet add package Doconut.NETStandard.Converter --version 26.10.0שמור את חבילת הממיר באותה גרסה כמו Doconut.NETStandard. מזהה החבילה הוא Doconut.NETStandard.Converter; .<version> מופיע רק בשם הקובץ שהורד .nupkg.
קובץ הרישיון של התוסף, Doconut.Viewer.Converter.lic, נמצא באותו תיקייה כמו Doconut.Viewer.lic; הוא נקרא יחד עם רישיון הצופה.
רישום התוסף
אין שיטה AddConverter() — מודל התוספים של Doconut אחיד. כל תוסף, כולל הממיר, נרשם באותו אופן: קרא AddPlugin<TPlugin>() בתוך AddDoconut(). ConverterPlugin מגיע בחבילת NuGet משלו, Doconut.NETStandard.Converter, מותקן לצד חבילת הצופה הבסיסית.
builder.Services.AddDoconut(options =>
{
options.LicensePath = "Doconut.Viewer.lic";
options.AddPlugin<Doconut.Plugins.Converter.ConverterPlugin>();
});זה כל מה שהמעטפת של C# צריכה. הווידג'ט והקצוות HTTP שלו הם אפשרות נפרדת, AddConverterWidget() (ראה וידג'ט נשלף).
התוסף דורש רישיון שמעניק את היכולת Converter. ללא רישיון, AddDoconut() זורק InvalidOperationException בעת ההפעלה, לפני שהאפליקציה מגישה בקשה:
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.הוא זורק כאשר אין רישיון, קובץ TRIAL ישן, רישיון ללא Converter, ורישיון בתשלום שנעשה בו שימוש מחוץ לחלון הגרסה שלו. רישיונות זמניים (Demo/NFR) מתקבלים. אין רמת חינם שקטה. ראה הגדרת רישיון לקבלת מידע על איך רישיונות נטענים.
רישוי וסימן מים
| מצב רישיון | הפעלה | תוצאת המרה |
|---|---|---|
רישיון צופה בתשלום המעניק Converter, בתוך חלון הגרסה שלו | מתחיל | נקי — watermarked: false |
| רישיון זמני פעיל (Demo/NFR) | מתחיל | ממיר, עם סימן המים של ההערכה — watermarked: true |
| רישיון זמני פג (Demo/NFR) | מתחיל | ממיר, עם סימן המים של ההערכה — watermarked: true |
אין רישיון, קובץ TRIAL ישן, רישיון ללא Converter, או רישיון בתשלום מחוץ לחלון הגרסה שלו | AddDoconut() זורק | — |
שתי דרכי הקריאה מחשבות את הדגל מאותו כלל: המעטפת C# של DocumentConverter מקבלת אותו פנימית ממצב IsViewerLicensed ו‑IsTemporary של הרישיון, והמתאם ?convert=run של הווידג'ט מבצע את הבדיקה המקבילה (IsViewerLicensed && !IsTrial && !IsTemporary) כדי למלא את השדה watermarked שהוא מחזיר. ניתן לבנות אינטגרציה ולבדוק אותה מקצה לקצה ברישיון הערכה לפני הרכישה — רק בתים הפלט משתנים.
מקור DICOM (.dcm, .ima) גם הוא זקוק ליכולת Dicom. ללא זאת, ConvertAsync זורק LicenseException (Converting '.dcm' requires the Dicom capability license.) והמתאם של הווידג'ט open משיב 403.
שימוש מ‑C#
כל המרה מחזירה MemoryStream שניתן לחיפוש ממוקם ב‑0, מוכן לקריאה או העתקה מיידית. יש לפתור את DocumentConverter מה‑DI בכל מקום שבו אתה צריך אותו — הוא חסר מצב לפי תכנון, ולכן ניתן להשתמש במופע יחיד בבטחה במקביל לבקשות.
// הזרק את DocumentConverter; הבנאי שלו פנימי, ולכן לעולם לא `new` אותו.
Stream pdf = await converter.ConvertAsync("contract.docx", ConversionTarget.Pdf, ct: ct);// sourceExtension כולל את הנקודה המקדימה. password הוא null אלא אם המסמך מוגן.
Stream png = await converter.ConvertAsync(stream, ".xlsx", ConversionTarget.Png, password: null, ct: ct);Stream html = await converter.WordToHtmlAsync("report.docx", ct);// html: זרם שמחזיק את ה-HTML כדי להפוך בחזרה למסמך Word, כגון תוצאת WordToHtmlAsync.
Stream docx = await converter.HtmlToWordAsync(html, ConversionTarget.Docx, ct);שני פרטים שקל לטעות בהם: sourceExtension ב‑overload של ה‑stream חייב לכלול את הנקודה המקדימה (".xlsx", ולא "xlsx") — הממיר משווה זאת מול קטלוג הפורמטים והרחבה ללא נקודה לא תיפתר. ולמרות השם שלו, WordToHtmlAsync מחזיר Task<Stream>, ולא Task<string> — אתה מקבל את מסמך ה‑HTML (תמונות משובצות כ‑Base64) כ‑stream, בדיוק כמו כל תוצאה אחרת של המרה.
הקורא הוא בעל ה‑stream שהוחזר ויש לפנות אותו לאחר ההעתקה או החזרת התוכן שלו. השירות DocumentConverter עצמו נפתר מה‑dependency injection; אל תבנה או תפסול אותו ידנית.
פורמטים יעד
ConversionTarget (מרחב שמות Doconut.Configs.Conversion) מכיל 45 חברים:
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לא כל מקור מתורגם לכל יעד — התוסף ממפה כל משפחת פורמט של מקור (Word, Excel, PowerPoint, PDF, CAD, Image, Email, Diagram, Project/Task, PSD, מסמך אינטרנט, DICOM) למערך הקבוע שלו של יעדים מותרים. המרת מקור DICOM (.dcm, .ima) דורשת גם רישיון שמעניק את היכולת Dicom; היעדים שלו הם Pdf, Png, Jpeg, Bmp, Tiff ו‑Gif. אל תקודד קבוע את המונה הזה כרשימת היעדים של הממשק שלך: ?convert=open מחזיר את ה‑allowedTargets האמיתי עבור כל קובץ שהועלה זה עתה, וזה מה שצריך להניע בורר.
וידג'ט משולב
הפעלת הקצות
הקצות ?convert=open|run|download של הווידג'ט הם אופציונליים ומושבתים כברירת מחדל — מאובטחים כברירת מחדל. הפעל אותם בצד השרת, יחד עם רישום התוסף:
builder.Services.AddDoconut(options =>
{
options.LicensePath = "Doconut.Viewer.lic";
options.AddPlugin<Doconut.Plugins.Converter.ConverterPlugin>();
options.AddConverterWidget(widget =>
{
widget.MaxUploadMb = 25;
});
});AddConverterWidget() ללא ארגומנט מפעיל את הווידג'ט עם ברירות המחדל (MaxUploadMb = 25). הוא אינו מעניק זכויות המרה בעצמו: הוא צריך AddPlugin<ConverterPlugin>(), או ש‑AddDoconut() זורק:
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.בלי AddConverterWidget(), שלושת הקצות ?convert= משיבים 404 — אך קובץ ה‑JS עצמו עדיין מוגש בכל מקרה (זה משאב סטטי משובץ פשוט; רק הקצות אליהן הוא מתקשר מגובים).
Embed it
<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) מקבל בורר CSS או אלמנט, זורק שגיאה אם לא נמצא ההרכבה, ומחזיר מצביע. הווידג'ט מעלה קובץ, מציג תצוגה מקדימה של דף 1, מאפשר למשתמש לבחור אחד מהallowedTargets, ממיר, מציג תצוגה מקדימה של התוצאה כשזה אפשרי, ומציע את ההורדה.
Options
| אפשרות | סוג | ברירת מחדל | הערות |
|---|---|---|---|
basePath | string | /doconut | נתיב הבסיס עבור נקודות הקצה של ?convert=; הוא חייב להתאים לסניף ASP.NET שבו UseDoconut() מותקן בפועל (בדרך כלל מתואם דרך MiddlewarePath) |
resPath | string | /doconut-res | מקובל לצורך עקביות תצורה עם וידג'טים אחרים של Doconut; וידג'ט הממיר כרגע אינו בונה שום URL ממנו |
maxUploadMb | number | 25 | בדיקה מוקדמת בצד הלקוח בלבד — דוחה קובץ גדול מדי לפני ההעלאה. השרת אוכף את המגבלה שלו באופן עצמאי ומשיב 413 אם היא חורגת |
licenseUrl | string | null | null | כאשר מוגדר, הופך את הודעת סימן המים על מסך התוצאה לקישור לכתובת URL זו |
labels | object | {} | עוקף כל תת‑קבוצה של מחרוזות ברירת המחדל באנגלית של הווידג'ט (טקסט גרירה, כפתורים, הודעות aria‑live, הודעות שגיאה) |
Callbacks
| קריאה חוזרת | מתרחש כאשר | תוכן |
|---|---|---|
onReady() | הווידג'ט רישם את מסך ההמתנה/גרירה שלו | — |
onSourceLoaded({ token, pages, sourceExt, allowedTargets }) | ?convert=open מצליח | אסימון סשן מקור, מספר דפים, סיומת מקור (בלי נקודה מובילה), רשימת יעדים מותרים |
onConverted({ downloadToken, resultToken, resultPages, downloadName, watermarked, target }) | ?convert=run מצליח | אותם השדות כמו בתשובת הריצה, בנוסף לtarget שהתבקש |
onDownload({ downloadName, downloadToken }) | המשתמש לוחץ על קישור ההורדה | מתרחש יחד עם ההורדה הטבעית של הדפדפן — הוא אינו חוסם או מחליף אותה |
onError({ phase, message }) | בקשת פתיחה או ריצה נכשלת | phase הוא 'open' או 'run'; message הוא השגיאה המנוקה מהשרת (או הודעת צד‑לקוח לבדיקת גודל ההעלאה) |
קריאה חוזרת שמייצרת שגיאה נתפסת ונרשמת; היא לעולם לא מפרקת את זרימת הווידג'ט.
Imperative handle
Doconut.convert() מחזיר את מופע הווידג'ט עצמו — החזק אותו כדי לשלוט בווידג'ט באופן פרוגרמי:
const conv = Doconut.convert('#doconut-convert', { basePath: '/doconut' });
const file = document.querySelector('#picker').files[0]; // קובץ משלך <input type="file" id="picker">
conv.reset(); // חזרה למסך הממתין/הפלה; לא מפעיל מחדש onReady
conv.loadFile(file); // מתחיל את הזרימה עם אובייקט File; פעולה ריקה אלא אם הוא כרגע במצב ממתין
conv.destroy(); // מסיר מאזינים, מרוקן את ה‑mount; המופע אינו ניתן לשימוש לאחר זאתLabels
כל מחרוזת בעלת ברירת מחדל באנגלית; labels עוקף כל תת‑קבוצה והשאר נשארים באנגלית. קטעים שמשתנים בזמן ריצה משתמשים ב{placeholders}, כגון uploading: 'Uploading {name}…' וpages: '{n} pages'.
| מפתח | ברירת מחדל באנגלית |
|---|---|
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. |
מפתחות נוספים מכסים את אזור הגרירה של aria-label (dropAriaLabel), את טקסטי התצוגה המקדימה של alt (previewAlt, resultAlt), את הצורה המקושרת של הודעת סימן המים המשמשת עם licenseUrl (watermarkNoticePrefix, watermarkNoticeLink, watermarkNoticeSuffix), תגובה בלתי קריאה (badResponse) ואת ההודעות של aria-live (annReady, annUploading, annLoaded, annLoadedNoTargets, annConverting, annDone, annError).
שגיאת JSON מהשרת מוצגת כפי שהשרת כתב אותה; serverError משמשת רק כאשר תגובה נכשלת אינה נושאת שגיאת JSON, כגון 404 של וידג'ט מושבת.
התאמה אישית
הווידג'ט מוסיף את המחלקה dcw לאלמנט ההרכבה שלו וקורא את הצבעים, הרדיוס והגופן שלו ממאפייני CSS מותאמים, כך שניתן להתאים אותו ללא שינוי של המנגנונים הפנימיים:
#doconut-convert.dcw {
--dcw-accent: #6b46c1;
--dcw-radius: 12px;
--dcw-font: "Inter", system-ui, sans-serif;
}ברירות מחדל: --dcw-accent: #2b6cb0, --dcw-bg: #ffffff, --dcw-fg: #1a202c, --dcw-muted: #718096, --dcw-border: #cbd5e0, --dcw-radius: 8px, וגופן מערכת UI עבור --dcw-font.
בנה ממשק משתמש משלך
הווידג'ט הוא רק לקוח של חוזה HTTP זה — ניתן לבנות ממשק משתמש משלך נגדו ישירות עבור חוויית משתמש שונה. כל שלוש הנתיבים נמצאים תחת הסניף של ASP.NET שבו UseDoconut() מותקן (בדרך כלל /doconut), והם מחזירים 404 עד שAddConverterWidget() נקרא. שגיאות מכילות גוף JSON, { "error": "..." }, למעט במקרים שבהם הטבלה מציינת "status only". ערך ?convert= לא ידוע מחזיר 400.
| נתיב | מטרה | תגובה מוצלחת |
|---|---|---|
POST ?convert=open (multipart, one file) | העלאה ופתיחה של מסמך מקור לתצוגה מקדימה | 200 — { token, pages, sourceExt, allowedTargets } |
POST ?token=<token>&convert=run&target=<ext> | המרת המקור השמור לtarget | 200 — { downloadToken, resultToken, resultPages, downloadName, watermarked } |
GET ?convert=download&token=<downloadToken> | הזרמת הקובץ המומר | 200 — בתים של הקובץ, Content-Disposition: attachment, Cache-Control: no-store |
sourceExt בתגובה open אינו כולל נקודה מקדימה (לדוגמה "docx") — בניגוד למוסכמה של הפרמטר sourceExtension בDocumentConverter.ConvertAsync, הדורש נקודה. allowedTargets מציג שמות יעד באותיות קטנות ("pdf", "html", …); העבר אחד מהם כtarget, אשר מותאם ללא תלות ברישיות. open משתמש בקובץ הראשון בגוף multipart.
resultToken הוא null, וresultPages הוא 0, כאשר התוצאה אינה ניתנת לתצוגה מקדימה. downloadName הוא שם קובץ המקור עם סיומת היעד.
תמונות התצוגה המקדימה משתמשות בנתיב התמונה הסטנדרטי של הצופה, {basePath}?token={token}&page=1&thumb=1&width={px}, עם token מopen או resultToken מrun. הווידג'ט מבקש את width=240.
בייטים של המקור שהועלו נשמרים בצד השרת ונשמרים למשך 30 דקות לאחר הקריאה האחרונה; כאשר חלון זמן זה פג, run מחזיר 404 ויש לפתוח את הקובץ מחדש. התוצאה המומרת נשמרת באותו מאגר — downloadToken מקבל חלון של 30 דקות חדש כאשר ההמרה מסתיימת — בעוד resultToken הוא אסימון סשן צופה רגיל לתצוגת התוצאה. כאשר ניתן לתצוגה מקדימה של התוצאה, downloadToken וresultToken הם אותו ערך. סגירת תוצאת הצופה אינה מוחקת מאגר הורדה שעדיין בתוקף, והפעלת הווידג'ט בדפדפן מחדש אינה מאריכה אף אחד מהחלונות.
מצבי כשל, מקובצים לפי נתיב:
| נתיב | סטטוס | מתי | גוף |
|---|---|---|---|
| כל | 404 | הווידג'ט אינו מופעל (AddConverterWidget() מעולם לא נקרא) — נבדק לפני שהנתיב הראשון מבין שלושת הנתיבים מתבצע | סטטוס בלבד |
| כל | 405 | מתודה HTTP שגויה (open/run דורשת POST; download דורשת GET) | סטטוס בלבד |
open | 400 | העלאה אינה multipart | Expected a multipart file upload. |
open | 400 | לא קובץ, או קובץ ריק | No file uploaded. |
open | 400 | הרחבה של מקור שלא ניתנת להמרה | This file type cannot be converted. |
open | 403 | סוג הקובץ דורש יכולת שהרישיון אינו מעניק (קובץ DICOM ללא Dicom) | Converting this file type requires the Dicom capability license. |
open | 413 | קובץ שהועלה חורג מMaxUploadMb, נבדק מול Content-Length ובזמן קריאת ההעלאה | File is too large. |
run | 400 | אסימון פגום (אינו GUID) | Invalid token. |
run | 400 | target שאינו מתפרש לConversionTarget | Unknown target format. |
run | 400 | target אינו נמצא בallowedTargets של המקור | That target format is not available for this file. |
run | 404 | ההעלאה השמורה פגה או שהאסימון מעולם לא נפתח | Upload expired — please re-open the file. |
open, run | 500 | העיבוד נכשל פנימית | הודעה מסוננת — מסוננת באותו אופן כמו כל נתיב שגיאה אחר של Doconut; לעולם לא חושפת פרטים פנימיים |
download | 400 | אסימון פגום (אינו GUID) | סטטוס בלבד |
download | 404 | אסימון הורדה לא ידוע או פג תוקף | סטטוס בלבד |
סיבוב מלא עם fetch:
// file: הקובץ להמרה, לדוגמה מ-<input type="file">.
async function convertFile(file) {
const base = '/doconut';
// 1. open: העלה את הקובץ
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: המר ל-PDF כאשר זה מותר, אחרת ליעד הראשון המותר
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: GET פשוט שהדפדפן יכול לבצע
window.location.href = base + '?convert=download&token=' + encodeURIComponent(converted.downloadToken);
}הקצות הקצה הן אותו מקור: לגרסה זו אין תמיכת CORS. הגש את הממשק שלך ואת סקריפט הווידג'ט מאותו מקור של Doconut, או הפוך פרוקסי לשני הנתיבים /doconut (נתיב המידלוור ונתיב המשאבים) תחת מקור הממשק שלך.
בייצור
- התקן את התוסף ליד חבילת הליבה, באותה גרסה:
dotnet add package Doconut.NETStandard.Converter. - הוסף את קובץ הרישיון. שים
Doconut.Viewer.Converter.licבאותו תיקייה כמוDoconut.Viewer.lic. - הגדר את המגבלה של השרת.
MaxUploadMbבAddConverterWidgetהוא המגבלה שהשרת אוכף; הmaxUploadMbשל הווידג'ט הוא רק בדיקה בצד הלקוח. שמור על שני הערכים שווים. - הגש את הממשק מאותו מקור כמו נקודות הקצה של Doconut, או הפוך פרוקסי אותם (ראה בנה את הממשק שלך).
- שחרר תוצאות המרה. הזרם
ConvertAsyncמחזיר הוא משותף; שחרורו מחזיר את המאגרים שלו לבריכה.
חוות רשת
הווידג'ט שומר כל העלאה ותוצאתה בזיכרון על המחשב (node) שסיפק open. מאחורי מאזן עומס ללא מושב קבוע, בקשת run, download או תצוגה מקדימה מאוחרת יכולה להגיע למחשב אחר ולא למצוא את ההעלאה. רשום את מאגר הווידג'ט המשותף והמוצפן פעם אחת, אחרי AddDoconut():
byte[] farmKey = Convert.FromBase64String(builder.Configuration["Doconut:FarmKey"]);
builder.Services.AddDoconutDistributedWidgets(store =>
{
store.RootPath = @"\\fileshare\doconut"; // תיקייה שכל צומת יכול לקרוא ולכתוב
store.FarmKey = farmKey; // לפחות 32 בתים, זהה בכל צומת
// store.Ttl = TimeSpan.FromMinutes(30); // כמה זמן העלאה נשמרת (ברירת המחדל)
});- שרת יחיד לא צריך דבר: ללא קריאה זו משתמשים במאגר הזיכרון הפנימי.
- העלאות ותוצאות מוצפנות במנוחה על השיתוף (AES-256, הצפנה‑ואחר‑אימות MAC), וכל קובץ קשור לטוקן שלו, כך שטוקן אחד לעולם לא יכול לקרוא קובץ של אחר.
- על השיתוף, העלאה או תוצאה נשמרים למשך
Ttlלאחר שנכתבו; קריאה אינה מאריכה את החלון. FarmKeyחייב להיות לפחות 32 בתים והזהה על כל מחשב. טען אותו ממאגר סודי; אל תכתוב אותו בקוד. הרישום זורקArgumentExceptionכאשרRootPathחסר או כאשרFarmKeyקצר מ‑32 בתים.- הפנה את
RootPathלאותו מיקום משותף שבו משתמש הצופה המבוזר.
הפנייה ל‑API
המחזית והאפשרויות של הווידג'ט נמצאות במרחב השמות Doconut; ConversionTarget נמצא בDoconut.Configs.Conversion. ConverterPlugin נמצא ב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);
}מתקבל מהזרקת תלות; הבונה הוא פנימי. sourceExtension כולל את הנקודה המקדימה. HtmlToWordAsync כותב קובץ .doc כאשר outputFormat הוא ConversionTarget.Doc, וקובץ .docx עבור כל ערך אחר.
ConversionTarget
ה‑45 פורמטים של פלט המופיעים בפורמטים יעד.
ConverterWidgetOptions
public sealed class ConverterWidgetOptions
{
public int MaxUploadMb { get; set; } = 25;
}הגדר דרך DoconutOptions.AddConverterWidget(Action<ConverterWidgetOptions>? configure = null), שמחזיר את DoconutOptions כדי שניתן לשלב קריאות.
פתרון בעיות
| תסמין | סיבה | פתרון |
|---|---|---|
AddDoconut() זורק The Converter plugin is registered via AddPlugin but no active license grants Converter. | אין רישיון, קובץ TRIAL, רישיון ללא Converter, או רישיון בתשלום מחוץ לחלון הגרסה שלו | התקן רישיון שמעניק Converter, או הסר AddPlugin<ConverterPlugin>() |
AddDoconut() זורק AddConverterWidget() was called but the Converter plugin is not registered. | הווידג'ט מופעל ללא התוסף שלו | הוסף options.AddPlugin<Doconut.Plugins.Converter.ConverterPlugin>() |
פתרון של DocumentConverter זורק No IDocumentConverter is registered. Add the converter plugin: options.AddPlugin<Doconut.Plugins.Converter.ConverterPlugin>(). | ConverterPlugin אינו רשום | הוסף AddPlugin<ConverterPlugin>() בתוך AddDoconut() |
| המרת הזרם אומרת שהפורמט אינו נתמך | sourceExtension אין נקודה מקדימה | העבר ".xlsx", לא "xlsx" |
ConvertAsync זורק Converting '.dcm' requires the Dicom capability license. | מקור DICOM, והרישיון אינו מעניק Dicom | השתמש ברישיון שמעניק Dicom |
| התוצאה מסומנת במים | הרישיון זמני (Demo/NFR) | השתמש ברישיון בתשלום שמעניק Converter |
הווידג'ט נטען אך הבקשות שלו מחזירות 404 | AddConverterWidget() לא נקרא, או basePath אינו תואם לסניף שבו UseDoconut() מותקן | קרא AddConverterWidget(); תקן basePath |
open משיב 403 Converting this file type requires the Dicom capability license. | העלאת DICOM, והרישיון אינו מעניק Dicom | השתמש ברישיון שמעניק Dicom |
open משיב 413 File is too large. | ההעלאה חורגת מMaxUploadMb | העלה MaxUploadMb בAddConverterWidget; הmaxUploadMb של הווידג'ט הוא רק בדיקה בצד הלקוח |
run משיב 400 That target format is not available for this file. | היעד אינו אחד מallowedTargets של המקור | הצע רק את allowedTargets מopen |
run או download משיב 404 (Upload expired — please re-open the file. מrun) | חלון של 30 דקות עבר, או שמחשב בחוות הרשת אין את ההעלאה | פתח את הקובץ שוב; בחווה, רשום AddDoconutDistributedWidgets |
| הווידג'ט נכשל כאשר הממשק נמצא במקור אחר | לנקודות הקצה אין תמיכת CORS | הגש את הממשק מאותו מקור, או הפוך פרוקסי לנתיבי Doconut |
| הנושא אינו מתיישם | המשתנים מוגדרים על אב או על אלמנט בתוך ההרכבה; כלל ה.dcw של הווידג'ט מגדיר אותם על ההרכבה | כוון את ההרכבה עצמה: #doconut-convert.dcw או #doconut-convert |
הערות מסגרת
viewer.Converter.GetConverter()אינו קיים כאן. ההמרה אינה מגיעה יותר דרך מופע הצופה: הזרקDoconut.DocumentConverterבמקום זאת.- ה‑enum
ConversionTargetהזה מכסה כל משפחת מקור. הספרייה הקודמת הייתה בעלת סוג*ConfigConverterלכל משפחה —WordConfigConverter,ExcelConfigConverter, וכן הלאה — שלכל אחד enum מקונןEnTargetFormatמשלו, בנוסף ל‑enumSourceFormatConverterלקלט. כולם נעלמו; ראו את מדריך ההגירה. - רק Windows, כמו שאר חבילת .NET Standard.
האם דף זה היה מועיל?