שילוב SDK של מציג מסמכים עם אחסון ענן ופלטפורמות שיתוף פעולה
← Back to Blog7 min read

שילוב SDK של מציג מסמכים עם אחסון ענן ופלטפורמות שיתוף פעולה

שילוב SDK של מציג מסמכים עם אחסון ענן ופלטפורמות שיתוף פעולה
שילוב SDK של מציג מסמכים עם אחסון ענן ופלטפורמות שיתוף פעולה
שילוב SDK של מציג מסמכים עם אחסון ענן ופלטפורמות שיתוף פעולה מאפשר לספק חוויות מסמכים חלקות, מאובטחות וניתנות לחיפוש ישירות מהיישום שלך ב‑.NET. עם Doconut—מציג מסמכים אוניברסלי עבור backend‑ים של .NET—ניתן לעבד קבצי PDF, קבצי Office, שרטוטי CAD ותמונות באופן מקורי, להוסיף חיפוש מבוסס OCR, לאפשר הערות בזמן אמת ולשלוט בהדפסה, וכל זאת תוך שמירת הנתונים בענן שבחרת או בסביבה מקומית. מדריך זה מציג למפתחים בכירים ולאדריכלי תוכנה כיצד לחבר את Doconut ל‑Azure Blob, Amazon S3 או Google Cloud Storage, וכיצד לחשוף את המציג דרך פורטלים שיתופיים כגון Microsoft Teams, SharePoint או סביבת עבודה מותאמת ב‑React.


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

עקביות חוצת פלטפורמות עם ליבת .NET אחת

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

הפחתת השהייה ורוחב פס

כאשר מסמך מאוחסן ב‑Azure Blob Storage, הורדת הקובץ המלא ללקוח רק כדי לצפות בעמוד הראשון יוצרת השהייה מיותרת. Doconut תומך ביצירת תמונות ממוזערות לפי דרישה, כך שניתן לבקש תחילה תצוגה ברזולוציה נמוכה ולשלוף את הרינדור המלא רק כאשר המשתמש גולל. תבנית זו חשובה במיוחד עבור שרטוטי CAD גדולים (DWG, DXF) שיכולים להגיע למאות מגהבייטים.

עיבוד עם דגש על אבטחה

כל העיבוד הכבד נשאר בשרת. באמצעות יכולות עיבוד בצד השרת של Doconut, נשמרים קבצי PDF סודיים, חוזים משפטיים או רשומות רפואיות בתוך ה‑VNet הפרטי שלך או מאחורי חומת אש ארגונית. אין קריאה לשירות SaaS של צד שלישי, והמציג לעולם לא משדר בתים גולמיים למנוע בצד הדפדפן—רק אריחי תמונה או קטעי HTML שאתה מייצר מאחורי הקלעים.


חיבור Doconut לשירותי אחסון ענן פופולריים

גישה כללית לאינטגרציה

  1. קבלת זרם המסמך – השתמש ב‑SDK של ספק הענן שבחרת (Azure Blob, Amazon S3, Google Cloud Storage) כדי להוריד את הקובץ אל אובייקט Stream.
  2. העברת ה‑Stream ל‑Doconut – מציג Doconut מקבל זרם יחד עם אפשרויות רינדור אופציונליות. פעולה זו מבטלת צורך בקבצים זמניים על ה‑web server.
  3. יצירת אסימון מציג – Doconut מחזיר אסימון שמזהה באופן ייחודי את המסמך הפתוח עבור הסשן הנוכחי. ניתן להחזיר את האסימון ל‑front‑end כ‑JSON ולהשתמש בו לבקשות רינדור עמודים או הערות נוספות.
  4. רינדור עמודים לפי דרישה – ה‑front‑end קורא ל‑endpoint של Doconut עם האסימון ומספר העמוד הרצוי; Doconut משדר חזרה תמונה או קטע HTML.

מאחר שהזרימה היא מבוססת רק על Streams, החלפת קוד Azure בקוד של Amazon S3 או Google Cloud Storage דורשת שינוי יחיד בקריאת ה‑SDK של הענן שמייצרת את ה‑Stream; שאר צינור העבודה של Doconut נשאר זהה.

טיפול באחסון מרובה‑שוכרים (multi‑tenant)

ב‑SaaS DMS, לכל שוכר עשוי להיות דלי או קידומת נפרדים. מכיוון ש‑Doconut עובד עם Streams, ניתן לפתור את הדלי המתאים בזמן ריצה, לפתוח את המסמך ולשמור את האסימון במסגרת ההרשאות של המשתמש. ניתן להגדיר את המטמון הפנימי של Doconut (IDistributedCache) להשתמש ב‑Redis או ב‑Azure Cache for Redis, כך שהבקשות החוזרות לאותו עמוד ייטענו מהזיכרון במקום לרינדור מחדש.


אפשרות להערות בזמן אמת ו‑OCR בתוך תהליכים שיתופיים

תוסף ההערות: הפיכת מציג סטטי למרכז ביקורת

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

חיפוש מבוסס OCR עבור PDF סרוקים

חוזים, קבלות או תמונות רפואיות סרוקות מגיעים לעיתים כ‑PDFים המכילים רק תמונות. תוסף החיפוש של Doconut מריץ OCR אוטומטית בצד השרת כאשר הוא מופעל בתצורת המציג. מנוע ה‑OCR פועל בתוך ערימת ה‑server‑side, ולכן הטקסט המופק לעולם אינו עוזב את הסביבה המוגנת שלך. לאחר סיום ה‑OCR, ניתן לקרוא ל‑API החיפוש כדי לקבל מספרי עמודים ותיבות גבול תואמות, שה‑UI יכול להדגיש. מכיוון שה‑OCR רץ בשרת, ניתן גם לאנדקס את הטקסט המופק ב‑Azure Cognitive Search, Elasticsearch או כל שירות חיפוש אחר כדי לספק חיפוש טקסט מלא מיידי על כל המאגר.

שיתוף באמצעות אסימונים משותפים

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


המרה מאובטחת בצד השרת והדפסה מבוקרת עם Doconut

חברות רבות צריכות להמיר קבצי Word, Excel או CAD ל‑PDF לצורך ארכוב, או לאכוף מדיניות “הדפסה רק אם אושרה”. תוסף הממיר של Doconut מטפל בתרחישים אלה ללא צורך ב‑Microsoft Office או שירותי צד שלישי. אתה קורא ל‑API ההמרה בשרת, מעביר את נתיב הקובץ המקורי (או Stream) ואת פורמט הפלט הרצוי. ההמרה מתבצעת במלואה בצד ה‑back‑end, ומייצרת PDF שניתן לאחסן במאגר המסמכים שלך.

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

ביקורת פעילות הדפסה

מאחר ובקשת ההדפסה עוברת דרך middleware של Doconut, ניתן לתפוס אותה בצינור הלוגים של ASP.NET Core כדי לתעד מי הדפיס מה, ומתי. שמור את רשומת הביקורת בטבלה ב‑SQL או העבר אותה למערכת SIEM לצורך דיווח ציות—חשוב במיוחד בפתרונות טכנולוגיה משפטית או בריאות שבהם כל גישה למסמך חייבת להיות ניתנת למעקב.


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

  1. ניצול מטמון מבוזר – מטמון אריחי העמוד הפנימי של Doconut ניתן לגיבוי ב‑Redis, Azure Cache או כל מימוש של IDistributedCache. כלול את hash גרסת המסמך במפתחות המטמון כדי למנוע הצגת תמונות מיושנות לאחר המרה.
  2. שימוש בעבודות רקע להמרות בכמות – בעת העלאת ארכיון גדול, הצב משימות המרה בתור עם Hangfire או Azure Functions. מחלקת המציג של Doconut עובדת עם IHostedService מכיוון שהיא מקבלת Streams ומחזירה אסימונים ללא צורך בהקשר HTTP.
  3. כוונון רזולוציית תמונה לפי מכשיר – מכשירים ניידים מרוויחים מ‑ImageResolution נמוך (150‑200 DPI), בעוד תחנות עבודה שולחניות יכולות לבקש 300 DPI לפרטי CAD. שנה את הרזולוציה על בסיס מחרוזת ה‑user‑agent או הגדרה בצד הלקוח.
  4. הפעלת טעינה עצלה של הערות – אחסן את XML ההערות בטבלה נפרדת וטען אותו רק כאשר המשתמש פותח את לוח ההערות. פעולה זו מצמצמת את העומס הראשוני ומאיצה את רינדור העמוד הראשון.
  5. מעקב אחרי ניצול זיכרון – רינדור עמודי CAD ברזולוציה גבוהה דורש זיכרון משמעותי. הגדר את ה‑.NET GC למצב server במוצר הסופי (<gcServer enabled="true"/>) וקבע timeout סביר כדי למנוע משימות רינדור מתמשכות.
  6. הטמעת CDN עבור נכסים סטטיים – חבילות ה‑JavaScript וה‑CSS של המציג הן סטטיות. הגש אותן דרך Azure CDN, CloudFront או Cloudflare כדי לחסוך מילישניות מטעינת העמוד הראשונית, במיוחד עבור צוותים גלובליים.

על‑פי הנחיות אלו, ניתן לתמוך באלפי משתמשים מקבילים ברחבי העולם תוך שמירה על זמן השהייה של פחות מ‑200 ms לעמוד הראשון – מדד שהפורטלים הארגוניים רבים שואפים אליו.


התחלה מהירה עם גרסת הניסיון החינמית של Doconut

הדרך המהירה ביותר להעריך את Doconut היא להוריד את גרסת הניסיון מהאתר הרשמי, להוסיף את חבילת ה‑NuGet לפרויקט ASP.NET Core חדש, ולפעול לפי מדריך ההתחלה המהירה. תוך דקות ספורות יהיה לך מציג פעיל שיכול למשוך מסמכים מ‑Azure Blob, להפעיל הערות, להריץ חיפוש מבוסס OCR ולבצע המרות מאובטחות בצד השרת. לקבלת הוראות שלב‑אחר‑שלב, בקר בתיעוד של Doconut והתחל לבנות היום חוויית מסמכים מבוססת ענן לכל יישום .NET.

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

#document viewer#.NET#cloud integration#collaboration#OCR#מציג מסמכים#שילוב ענן#שיתוף פעולה