עבודה עם ספריית מציג המסמכים – תומכת בפורמטים PDF, Office ו‑CAD עם אנוטציות מובנות, חיפוש והדפסה: מדריך מעשי

ספריית מציג המסמכים ב‑Doconut מאפשרת לך לרנדר קבצי PDF, Office ו‑CAD, להוסיף אנוטציות, לחפש בתוכן ולהדפיס — הכל מרכיב .NET יחיד.
אם אתה בונה פורטל ממוקד מסמכים, מנהל מקרים בטכנולוגיית משפט, או כלי סקירת שרטוטים הנדסיים, אתה צריך מציג שעובד כפי שהמשתמשים שלך מצפים: מיידי, מאובטח וללא שירותים חיצוניים. Doconut מספקת חוויה זו במקום, בתוך יישום ASP.NET או .NET Core שלך, תוך שמירה על קוד נקי וטביעת פריסה קטנה.

במדריך המעשי הזה נעבור על זרימת העבודה המרכזית של ספריית מציג המסמכים, נציג כיצד לשלב אותה, ונדגים את שלושת העמודים שהופכים אותה לחיונית — אנוטציה, חיפוש (כולל OCR) והדפסה מבוקרת. בסיום, יהיה לך אבטיפוס מוכן להפעלה ותמונה ברורה כיצד Doconut יכולה להפוך לעמוד השדרה של כל פתרון ארגוני כבד במסמכים.

---

פריסת Windows ואפשרויות גרסת ניסיון חינמית

ספריית Doconut פועלת על .NET 6 ותומכת במלואה בסביבות Windows. בין אם אתה מארח את האפליקציה שלך ב‑Azure, AWS או במקומות פנימיים, היא מספקת רינדור ואנוטציה עקביים.

כדי להתחיל במהירות, Doconut מציעה גרסת ניסיון חינמית הכוללת גישה מלאה למנוע האנוטציה, חיפוש עם OCR ותכונות הדפסה מבוקרת. הירשם באתר הרשמי, הורד רישיון ניסיון, ופעל לפי שלבי האינטגרציה למטה כדי לראות את הספרייה בפעולה תוך דקות.

---

למה ספריית מציג המסמכים היא שינוי משחק עבור ארגוני .NET

ארגונים המנהלים חוזים, סכמות הנדסיות או רשומות עובדים מתמודדים עם שלושה אתגרים חוזרים:

1. מגוון פורמטים – קבצי PDF, מסמכי Word, גיליונות Excel ושרטוטי CAD מתעוררים באותו המאגר.
2. סקירה שיתופית – משתמשי העסק צריכים להדגיש, להגיב או להטביע חותמת על המסמך מבלי לעזוב את האפליקציה.
3. גישה מוסדרת – הדפסה חייבת להיות ניתנת לביקורת, וטקסט חיפוש חייב להיות זמין גם עבור תמונות סרוקות.

ספריית מציג המסמכים של Doconut פותרת את שלושת האתגרים עם רכיב .NET יחיד בצד השרת התומך ביותר מ‑33 סוגי קבצים — כולל DOCX, XLSX, PPTX, DWG ו‑DXF — ישירות מהקופסה. הספרייה מרנדרת כל פורמט באופן מקורי, ללא צורך ב‑Microsoft Office, Acrobat או שירותי המרה חיצוניים. מכיוון שהרינדור מתבצע בשרת, הנתונים הרגישים נשארים מאחורי חומת האש, דבר קריטי לתחומי הבריאות, המשפט והפיננסים.

מנוע האנוטציה המובנה מאפשר הוספת הדגשות, ציורים חופשיים או חותמות אישור ישירות לקנבס של המציג. האנוטציות נשמרות כ‑XML קל משקל, מה שמקל על שמירתן בבסיס נתונים או במערכת בקרת גרסאות. תוסף החיפוש מספק חיפוש טקסט מיידי בכל מסמך פתוח; כאשר המקור הוא תמונה סרוקה, מנוע ה‑OCR מחלץ מחרוזות חיפוש בזמן אמת. לבסוף, תכונת הדפסה מבוקרת מאפשרת להגדיר מגבלות טווחי עמודים, סימני מים או יומני ביקורת הדפסה, הכל באמצעות קריאה יחידה ל‑API.

ביחד, יכולות אלו מאפשרות לך להחליף ערימת מציגים של צד שלישי, תוספי JavaScript ושירותי המרה חיצוניים ב‑ספרייה יחידה, ניתנת לתחזוקה המתאימה למספר משתמשים קטן ועד לפריסות ארגוניות רחבות.

---

הטמעת המציג: אינטגרציה שלב‑אחר‑שלב ב‑ASP.NET Core

להלן תיאור תמציתי של השלבים הדרושים לשילוב ספריית מציג המסמכים של Doconut באפליקציית ASP.NET Core:

1. רישום ה‑middleware של Doconut – הגדר את ה‑middleware UseDoconut לטיפול בנקודת הקצה הפנימית DocImage.axd. נקודת קצה זו משדרת דפי רינדור כ‑tiles בפורמט PNG, מה שמבטיח ממשק משתמש מגיב גם עבור קבצי CAD גדולים.
2. טעינת הרישיון – ספק את קובץ הרישיון של Doconut (למשל DoconutLicense.xml) כקובץ במערכת הקבצים או כ‑stream. הספרייה קוראת את הרישיון אוטומטית ביצירת המופע הראשון של המציג.
3. יצירת מופע מציג – אתחל את המחלקה Viewer, והעבר שירותים נדרשים כגון cache מבוזר או IHttpContextAccessor.
4. הגדרת אפשרויות רינדור – צור אובייקט תצורה (לדוגמה PdfConfig) לשליטה בהתנהגות רינדור ברירת המחדל, חילוץ קישורים והגדרת רזולוציית רסטר לשרטוטי CAD.
5. פתיחת מסמך – קרא למתודה OpenDocument עם נתיב הקובץ (או stream) והתצורה שהוגדרה קודם. המתודה מחזירה טוקן מאובטח שה‑JavaScript בצד הלקוח משתמש בו לבקשת תמונות דפים, אנוטציות ותוצאות חיפוש.

שלבים אלה מניבים מציג בצד השרת עבור סביבות Windows הפועלות על .NET 6. הגישה מבוססת טוקן משאירה את ה‑client קל: החזית צריכה רק להפנות לרכיב המציג של Doconut ב‑https://doconut.app.

---

אנוטציות מובנות לתהליכי סקירה בזמן אמת

אנוטציות ממירות מציג פסיבי למרחב עבודה שיתופי. מנהל האנוטציות של Doconut פועל על בסיס דף ושומר הכל כ‑XML, מה שמאפשר גרסאות, ביקורות או מיזוג שינויים בבסיס הנתונים בקלות.

זרימת עבודה טיפוסית של אנוטציה

1. קבל את מנהל האנוטציות לדף הנוכחי באמצעות קריאה ל‑GetAnnotationManager של המציג, תוך העברת ממדי הדף.
2. צור אובייקט אנוטציה (למשל חותמת תמונה, הדגשה או ציור חופשי) וקבע את המיקום, הגודל והמאפיינים החזותיים.
3. הוסף את האנוטציה למנהל.
4. שמור את ה‑XML של האנוטציה באמצעות GetAnnotationXml והכנס אותו למאגר הנתונים שלך.
5. כאשר המסמך נפתח מחדש, טען את ה‑XML השמור חזרה למציג בעזרת LoadAnnotationXML.

תרחישים ארגוניים

• טכנולוגיית משפט – עורכי דין מוסיפים חותמת “חתימה” לחוזה, ואז שולחים את ה‑XML לשירות ניהול מקרים לביקורת.
• סקירת הנדסה – מעצבים מוסיפים שרטוטי קו‑אדום ישירות לדף DWG; ה‑XML של האנוטציה נשמר לצד היסטוריית הגרסאות.
• משאבי אנוש וגיוס – מגייסים מדגישים קטעים מרכזיים בקורות חיים, מוסיפים הערות, ודוחפים את הגרסה המונוטת לפרופיל המועמד.

מאחר שהנתונים של האנוטציה מתארחים בשרת, אתה שומר על שליטה מלאה במי יכול לערוך, לצפות או להדפיס. ה‑API מתוכנן להיות דק: רק שליפת מנהל, הוספה וטעינה, ואתה יכול לבנות תכונות UI נוספות (undo/redo, כלים מותאמים) מבלי למשוך תלותיות נוספות.

---

חיפוש מיידי ו‑OCR: הפיכת כל מסמך לניתן למציאה

מאגר מסמכים הוא בעל ערך רק כאשר משתמשים יכולים לאתר את המידע הדרוש להם בשניות. תוסף החיפוש של Doconut מציע חיפוש טקסט מלא מיידי בכל קובץ פתוח. עבור PDF רקורסי או שרטוטי CAD סרוקים, מנוע ה‑OCR המובנה מחלץ טקסט לפי דרישה, והופך תמונות לתוכן שניתן לחיפוש ללא שלב קדם נפרד.

זרימת עבודה טיפוסית של חיפוש

1. קרא למתודת החיפוש של המציג (החשופה על‑ידי תוסף החיפוש) עם מילת המפתח הרצויה.
2. קבל רשימת מספרי דפים ותיאומי כל התאמה.
3. עבור כל התאמה, קבל את מנהל האנוטציות של הדף והוסף אנוטציית הדגשה זמנית כדי להציג למשתמש היכן המילה מופיעה.

כאשר משתמש פותח PDF סרוק של חשבונית, המציג מריץ OCR אוטומטית על כל דף בזמן הרינדור. הטקסט המחולץ מאונדקס בזיכרון, מה שהופך חיפושים נוספים למיידיים. גישה זו מבטלת צורך בשירות OCR חיצוני, מצמצמת השהייה ומבטיחה שהטקסט החיפושי לעולם לא יעזוב את הסביבה המאובטחת שלך.

יתרונות ארגוניים

• פורטלים ללקוחות יכולים לחשוף סעיפים רלוונטיים מחוזה בלחיצה אחת.
• כלי דיווח פיננסיים מאפשרים אנליסטים לאתר שורה ספציפית במאות הצהרות סרוקות.
• מערכות רשומות בריאות הופכות לחיפושיות עבור שמות תרופות בתוך פתקים סרוקים של רופאים, משפרות את בטיחות המטופל.

כל זאת מושג ללא תלותיות של צד שלישי, מה שמקטין את ערימת הטכנולוגיה ואת משטח הציות.

---

הדפסה מבוקרת מהמציג – אבטחה פוגשת נוחות

הדפסה היא לעיתים הקשר החלש ביותר באבטחת מסמכים. תכונת ההדפסה המבוקרת של Doconut מעניקה לך את הסמכות להחליט מה, מתי ואיך ניתן להדפיס מסמך, תוך שמירה על חוויית הדפסת דפדפן מוכרת.

זרימת עבודה טיפוסית של הדפסה

1. הגדר אובייקט PrintConfig עם אפשרויות כגון מגבלות טווחי עמודים, סימני מים והאם לתעד כל בקשת הדפסה.
2. העבר את התצורה יחד עם טוקן המסמך למתודה Print של המציג.
3. המציג מרנדר את העמודים שנבחרו בשרת, מוסיף סימני מים לפי הצורך, ומשדר את קובץ ה‑PDF המודפס חזרה לדפדפן של הלקוח.
4. נוצר רשומת ביקורת אוטומטית, המאפשרת למנהלים לעקוב אחרי מי הדפיס מה ומתי.

על‑ידי טיפול בהדפסה בשרת, Doconut מבטיח שהמסמך המקורי לעולם לא יעזוב את הסביבה המוגנת שלך, ואתה שומר על נראות מלאה של פעילות ההדפסה — דרישה קריטית לתעשיות מוסדרות.

---

סיכום

ספריית מציג המסמכים של Doconut מעניקה לצוותי .NET רכיב יחיד, מאובטח ועשיר בתכונות לרינדור PDFs, קבצי Office ושרטוטי CAD, עם אנוטציות, חיפוש עם OCR והדפסה מבוקרת. עם עיבוד בצד השרת, המרה מובנית ותמיכה בלמעלה מ‑33 פורמטים, ניתן לחסל תלותיות יקרות של צד שלישי ולשמור על נתונים רגישים תחת שליטתך הישירה.

מוכן לעדכן את זרימת העבודה המסמכתית של הארגון שלך? התחל היום עם גרסת הניסיון החינמית של Doconut, הורד את הספרייה ופעל לפי שלבי האינטגרציה שלמעלה כדי להביא יכולות צפייה, אנוטציה וחיפוש חזקות לאפליקציית .NET שלך בתוך דקות.