תוסף הממיר

המרת מסמכים ל-45 פורמטים שונים

תוסף הממיר הופך את Doconut לשירות המרת מסמכים. הוא תורם את המנוע מאחורי המעטפת הציבורית DocumentConverter, ו‑— opt‑in — וידג'ט נשלף עם חוזה HTTP משלו, כך שאתה יכול להמיר מסמכים מ‑C#, מהוידג'ט, או מממשק קדמי שאתה בונה בעצמך.

ממשקמתי להשתמש
DocumentConverter (C#)אתה ממיר על השרת, ללא דפדפן
וידג'ט נשלף (doconutConverter.js)אתה רוצה מסך העלאה, המרה והורדה מוכן לשימוש בדף שלך
נקודות קצה HTTP (?convert=open|run|download)אתה בונה ממשק המרה משלך על פי חוזה שרת מתועד

התקנת החבילה

התקן את תוסף הממיר היציב האחרון:

bash
dotnet add package Doconut.NET8.Converter

כדי לקבע את התוסף לגרסה שהמסמך מתאר, העבר את הגרסה בנפרד:

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

שמור על חבילת הממיר באותה גרסה כמו Doconut.NET8. מזהה החבילה הוא Doconut.NET8.Converter; .<version> מופיע רק בשם הקובץ שהורד .nupkg.

קובץ הרישיון של התוסף, Doconut.Viewer.Converter.lic, נמצא באותו תיקייה כמו Doconut.Viewer.lic; הוא נקרא יחד עם רישיון הצופה.

פלטפורמות. התוסף פועל בכל מקום שבו Doconut.NET8 פועל: Windows ולינוקס מבוסס glibc על x64 (לא Alpine או הפצות אחרות מבוססות musl). בלינוקס, התקן את ספריית תצורת הפונטים לפני שהמסמך הראשון נפתח:

bash
apt-get update && apt-get install -y libfontconfig1

ב‑RHEL, Fedora והפצות דומות החבילה היא fontconfig. ללא זאת, פתיחת מסמך נכשלת עם The system library libfontconfig1 is missing. Install it (Debian/Ubuntu: apt-get install -y libfontconfig1) and see the Linux section of the Doconut documentation.

רישום התוסף

אין שיטה AddConverter() — מודל הפלאגינים של Doconut אחיד. כל פלאגין, כולל הממיר, נרשם באותו אופן: קרא AddPlugin<TPlugin>() בתוך AddDoconut(). ConverterPlugin מגיע בחבילת NuGet משלו, Doconut.NET8.Converter, מותקן לצד חבילת הצופה הבסיסית.

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

זה כל מה שהמעטפת C# צריכה. הווידג'ט ונקודות הקצה HTTP שלו הם אפשרות נפרדת, AddConverterWidget() (ראה ווידג'ט נשלף).

התוסף צריך רישיון שמעניק את היכולת Converter. ללא רישיון, AddDoconut() זורק InvalidOperationException בעת ההפעלה, לפני שהאפליקציה מגישה בקשה:

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.

הוא זורק במקרה של חוסר רישיון, קובץ ישן 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 בכל מקום שבו אתה זקוק לו — הוא חסר מצב בתכנון, ולכן מופע יחיד בטוח לשימוש חוזר בין בקשות.

csharp
// הזרק DocumentConverter; הבנאי שלו פנימי, ולכן לעולם אל תשתמש ב-`new`.
Stream pdf = await converter.ConvertAsync("contract.docx", ConversionTarget.Pdf, ct: ct);
csharp
// sourceExtension כולל את הנקודה המקדימה. password הוא null אלא אם המסמך מוגן.
Stream png = await converter.ConvertAsync(stream, ".xlsx", ConversionTarget.Png, password: null, ct: ct);
csharp
Stream html = await converter.WordToHtmlAsync("report.docx", ct);
csharp
// 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 חברים:

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

לא כל מקור מתורגם לכל יעד — התוסף ממפה כל משפחת פורמט של מקור (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 של הווידג׳ט הם אופציונליים ומושבתים כברירת מחדל — מאובטחים כברירת מחדל. הפעל אותם בצד השרת, יחד עם רישום התוסף:

csharp
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() נקרא אך תוסף ה‑Converter אינו רשום...

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.

בלי AddConverterWidget(), שלושת הקצוות ?convert= משיבים 404 — אך קובץ ה‑JS עצמו עדיין מוגש בכל מקרה (זהו משאב סטטי משובץ פשוט; רק הקצוות שהוא מתקשר אליהם מוגבלים).

הטמע אותו

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) מקבל בורר CSS או אלמנט, זורק אם המיקום לא נמצא, ומחזיר מצביע. הווידג׳ט מעלה קובץ, מציג תצוגה מקדימה של דף 1, מאפשר למשתמש לבחור אחד מה‑allowedTargets, ממיר, מציג תצוגה מקדימה של התוצאה כשזה אפשרי, ומציע את ההורדה.

אפשרויות

אפשרותסוגברירת מחדלהערות
basePathstring/doconutנתיב הבסיס עבור נקודות הקצה של ?convert=; הוא חייב להתאים לענף ASP.NET שבו UseDoconut() מותקן בפועל (בדרך כלל מתואם דרך MiddlewarePath)
resPathstring/doconut-resמתקבל לשמירה על עקביות תצורה עם וידג'טים אחרים של Doconut; וידג'ט הממיר כרגע אינו בונה שום כתובת ממנו
maxUploadMbnumber25בדיקה מקדימה בצד הלקוח בלבד — דוחה קובץ גדול מדי לפני ההעלאה. השרת אוכף את המגבלה שלו באופן עצמאי ומשיב 413 אם היא חורגת
licenseUrlstring | nullnullכאשר מוגדר, הופך את הודעת סימן המים במסך התוצאה לקישור לכתובת זו
labelsobject{}עוקף כל תת‑קבוצה של מחרוזות ברירת המחדל באנגלית של הווידג'ט (טקסט גרירה, כפתורים, הודעות aria‑live, הודעות שגיאה)

קריאות חזרה

קריאה חזרהמתרחשת כאשרתוכן
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 הוא שגיאת השרת המנוקה (או הודעת צד‑לקוח עבור בדיקת גודל העלאה מראש)

קריאת חזרה שמקפיצה נלכדת ונרשמת; היא לעולם לא משבשת את זרימת הווידג'ט.

מטפל אימפרטיבי

Doconut.convert() מחזיר את מופע הווידג'ט עצמו — החזיקו בו כדי לשלוט בווidget באופן תכנותי:

javascript
const conv = Doconut.convert('#doconut-convert', { basePath: '/doconut' });
const file = document.querySelector('#picker').files[0]; // קובץ File משלך <input type="file" id="picker">
conv.reset();         // חזרה למסך הממתין/השלכה; לא מפעיל מחדש onReady
conv.loadFile(file);  // מתחיל את הזרימה עם אובייקט File; no-op אלא אם הוא כרגע idle
conv.destroy();       // מסיר מאזינים, מרוקן את ה‑mount; המופע אינו ניתן לשימוש לאחר זאת

תוויות

לכל מחרוזת יש ברירת מחדל באנגלית; labels עוקף כל תת‑קבוצה והיתר נשארים באנגלית. קטעים שמשתנים בזמן ריצה משתמשים ב{placeholders}, כגון uploading: 'Uploading {name}…' ו‑pages: '{n} pages'.

מפתחברירת מחדל באנגלית
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.

מפתחות נוספים מכסים את 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 מותאמים, כך שניתן לעצב אותו מבלי לגעת בפנים שלו:

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 (רב‑חלקי, קובץ אחד)העלה ופתח מסמך מקור לתצוגה מקדימה200 — { token, pages, sourceExt, allowedTargets }
POST ?token=<token>&convert=run&target=<ext>המרת המקור השמור לtarget200 — { 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 משתמש בקובץ הראשון בגוף הרב‑חלקי.

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 הם אותו ערך. סגירת תוצאת הצופה אינה מוחקת מאגר הורדה שעדיין בתוקף, והפעלת הווידג'ט מחדש בדפדפן אינה מאריכה אף אחד מהחלונות.

מצבי כשל, מקובצים לפי נתיב:

נתיבסטטוסמתיגוף
any404הווידג'ט אינו מופעל (AddConverterWidget() לא נקרא מעולם) — נבדק לפני שהנתיבים שלושתיים נשלחיםסטטוס בלבד
any405מתודה HTTP שגויה (open/run דורש POST; download דורש GET)סטטוס בלבד
open400לא העלאה מרובת חלקיםExpected a multipart file upload.
open400אין קובץ, או קובץ ריקNo file uploaded.
open400הרחבה של מקור שלא ניתן להמירThis file type cannot be converted.
open403סוג הקובץ דורש יכולת שהרשיון אינו מעניק (קובץ DICOM ללא Dicom)Converting this file type requires the Dicom capability license.
open413קובץ שהועלה חורג מMaxUploadMb, נבדק כנגד Content-Length ובזמן קריאת ההעלאהFile is too large.
run400אסימון פגום (לא GUID)Invalid token.
run400target שלא ניתן לפענח לConversionTargetUnknown target format.
run400target אינו בallowedTargets של המקורThat target format is not available for this file.
run404ההעלאה השמורה פגה או שהאסימון מעולם לא נפתחUpload expired — please re-open the file.
open, run500העיבוד נכשל פנימיתהודעה מסוננת — מסוננת באותו אופן כמו כל נתיב שגיאה של Doconut; לעולם לא חושפת פרטים פנימיים
download400אסימון פגום (לא GUID)סטטוס בלבד
download404אסימון הורדה לא ידוע או פג תוקףסטטוס בלבד

סיבוב שלם עם fetch:

javascript
// file: ה-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 (נתיב המידלוור ונתיב המשאבים) תחת המקור של הממשק שלך.

בייצור

  1. התקן את התוסף לצד חבילת הליבה, באותה גרסה: dotnet add package Doconut.NET8.Converter.
  2. הוסף את קובץ הרישיון. שים Doconut.Viewer.Converter.lic באותו תיקייה כמו Doconut.Viewer.lic.
  3. הגדר את המגבלה של השרת. MaxUploadMb בAddConverterWidget הוא המגבלה שהשרת אוכף; הmaxUploadMb של הווידג'ט הוא רק בדיקה בצד הלקוח. שמור את השניים שווים.
  4. הגש את הממשק מהמקור עצמו כמו נקודות הקצה של Doconut, או הפוך‑פרוקסי אותם (ראה בנה את הממשק שלך).
  5. השלך תוצאות המרה. הזרם ConvertAsync שמוחזר הוא משותף; השמדתו מחזירה את המאגרים שלו לבריכה.

חוות רשת

הווידג'ט שומר כל העלאה ותוצאתה בזיכרון על המחשב (node) שסיפק את open. מאחורי מאזן עומס ללא מושב דביק, בקשה מאוחרת של run, download או תצוגה מקדימה יכולה להגיע למחשב אחר ולא למצוא את ההעלאה. רשום את מאגר הווידג'ט המשותף והמוצפן פעם אחת, אחרי AddDoconut():

csharp
byte[] farmKey = Convert.FromBase64String(builder.Configuration["Doconut:FarmKey"]);

builder.Services.AddDoconutDistributedWidgets(store =>
{
    store.RootPath = @"\\fileshare\doconut";   // תיקייה שכל צומת יכול לקרוא ולכתוב
    store.FarmKey = farmKey;                   // לפחות 32 bytes, זהה בכל צומת
    // 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

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);
}

מתקבל מהזרקת תלות; הבונה הוא פנימי. sourceExtension כולל את הנקודה המקדימה. HtmlToWordAsync כותב קובץ .doc כאשר outputFormat הוא ConversionTarget.Doc, וקובץ .docx לכל ערך אחר.

ConversionTarget

ה‑45 פורמטים של פלט המופיעים בפורמטים יעד.

ConverterWidgetOptions

csharp
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
הווידג'ט נטען אך הבקשות שלו מחזירות 404AddConverterWidget() לא נקרא, או 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

האם דף זה היה מועיל?