💡 דוגמה מלאה עובדת זמינה ב‑GitHub:
one-line-document-merge-and-split-dotnet

היכן משימות המסמכים של המשרד האחורי מתרחשות בפועל

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

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

GroupDocs.Merger.LowCode הוא חבילה ב‑.NET שממירה משימה כזו – חיבור, פיצול או הסרת דף – לקריאה אחת של בנאי, נפרדת מה‑class הכללי Merger שהמשימות האלו לעולם אינן זקוקות לו. כל אחד משבעת המוצרים שלו מקבל את המקור ואת האפשרויות בבנאי, ב‑C#, ופועל רק כאשר נקראת Save, באותה צורה בין אם המשימה היא PDF, מסמך Word או מצגת PowerPoint.

למה תיקונים כלליים אינם מתאימים כאן

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

  • ביצוע ידני בעורך שולחני: מתאים למסמך אחד, בלתי אפשרי לתזמון, ואף אחד לא מאשר שלב ידני שמתרחש ב‑2 לפנות בוקר.
  • כתיבת סקריפט חד‑פעמי נגד API קבצים גולמי: עובד עד שמופיע פורמט קלט חדש, והסקריפט מתפתח ל‑client הכללי שהוא נועד להימנע ממנו.
  • שימוש ב‑class המלא Merger לקריאה אחת: נכון, אך מוסיף משטח API רחב יותר מאשר נדרש לפעולה אחת.

GroupDocs.Merger.LowCode קיים בדיוק למלא את הפער האחרון: קריאה אחת לכל פעולה, ללא צורך בלמידה נוספת.


הפתרון: GroupDocs.Merger.LowCode לצינורות המשרד האחורי

חבילת GroupDocs.Merger.LowCode מכילה שבעה מוצרים חד‑מטרתיים מאחורי הצורה של בנאי‑אחר‑Save. JoinPdf ו‑JoinDocx מצרפים מסמך לאחר אחר; JoinPptx עושה זאת עבור מצגות; SplitPdf, SplitDocx ו‑SplitPptx מחלצים דפים או שקפים נבחרים לקבצים משלהם; RemovePagesPdf מסיר דפים מבלי לגעת במקור. כל אחד משבעת המוצרים מקבל את המקור כנתיב או זרם ובודק את המקור, יחד עם כל קובץ שמועבר אליו, מול הפורמט שלו לפני כתיבה, כך שהצינור לעולם לא צריך לנחש מדוע פלט יצא שגוי.

כדי לעקוב אחרי המימוש למטה, תזדקק ל‑:

  • .NET 6.0 או גרסה מאוחרת יותר (הפרויקט בדוגמה ממקד ב‑net8.0)
  • חבילת NuGet נפרדת GroupDocs.Merger.LowCode
  • רישיון זמני, אם ברצונך לראות פלט ללא מגבלות ההערכה המתוארות בהמשך
dotnet add package GroupDocs.Merger.LowCode

החבילה זמינה בנפרד ב‑NuGet מהספרייה הראשית GroupDocs.Merger.


יישום שלב‑אחר‑שלב של משימת Reporting‑Pack

להלן הצורה שכל אחד משבעת המוצרים פועל לפי, מודגמת עם חיבור שמוסיף דף שער ל‑PDF חודשי.

שלב 1: צביעת המוצר למקור שלו

הבנאי של JoinPdf מקבל את מסמך המקור, את כל הקבצים שיש לצרף, ואת מופע JoinOptions; עדיין לא מתבצע דבר.

var join = new JoinPdf("report.pdf", new[] { "appendix.pdf" }, new JoinOptions());

שלב 2: החלטה היכן יישמר התוצאה

Save(outputPath) הוא המקום שבו המשימה מתבצעת בפועל. נתיב יחסי נפתר יחסית לתיקיית העבודה הנוכחית של התהליך, ו‑Save יוצר את תיקיית הפלט אם היא אינה קיימת, כך שהצינור שכותב לתיקייה של חודש חדש בכל ריצה אינו זקוק לשלב נפרד ליצירתה.

string outputPath = "output/monthly/report-with-appendix.pdf";

מדוע זה חשוב למשימה ללא פיקוח:

  • נתיב בשליטתך: בנה את נתיב הפלט מהגדרות או מפרמטר משימה, לעולם לא ישירות מקלט שלא אומת; Save זורק ArgumentNullException אם הנתיב ריק או null.
  • התיקייה שהיא יוצרת: משימה מתוזמנת שכותבת ליעד חדש בכל ריצה אינה צריכה שלב נפרד של “ודא שהספרייה קיימת”.

שלב 3: הרץ ותפוס את מה שחזר

קריאת Save מריצה את החיבור מיד; אין שלב בנייה‑אחר‑הרצה נפרד.

join.Save(outputPath);
var sizeInBytes = new FileInfo(outputPath).Length;

בבדיקה שלנו על קבצי הדוגמה, הקריאה חיברה קובץ report.pdf של 2 דפים עם appendix.pdf של 2 דפים לתוך קובץ של 4 דפים, בגודל 257 987 בתים בשם report-with-appendix.pdf.

שלב 4: החזר את התוצאה לצינור

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

if (sizeInBytes == 0)
{
    throw new InvalidOperationException("Join produced an empty file.");
}

האם GroupDocs.Merger.LowCode מקבל זרם במקום נתיב קובץ?

כן, בצד הקלט. כל אחד משבעת המוצרים מקבל את המקור שלו כזרם באותו מיקום של בנאי שבו היה נתיב קובץ, מה שמועיל כאשר קלט המשימה מגיע מאחסון Blob או מתור במקום מהדיסק המקומי. Save עדיין כותב את התוצאה לנתיב פלט, ובכל מקרה הזרמת הפלט נשארת ב‑class המלא Merger.


זרימת עבודה אמיתית: דחיית קובץ לפני שהוא מגיע לארכיון

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

try
{
    new JoinPdf("report.pdf", new[] { "contract.docx" }, new JoinOptions())
        .Save("output/mixed.pdf");
}
catch (FileTypeNotSupportedException exception)
{
    Console.WriteLine(exception.Message);
}

בבדיקה שלנו, כאשר הנתיבים נבנו מתיקיית resources, ההודעה הייתה: Input format does not match the expected format 'PDF'; the joined file 'resources\contract.docx' is 'Microsoft Word Open XML Document (.docx)'.

המשימה שלמעלה לעולם לא כותבת output/mixed.pdf כאשר מתרחשת החריגה, ולכן צינור החוזים יכול להעביר את ההודעה ישירות לכל מערכת התראות או תור כרטיסים שכבר בשימוש, במקום לגלות רשומה פגומה בארכיון כמה ימים מאוחר יותר.


תרחישים נוספים במשרד האחורי שבהם תבנית זו מתאימה

לאחר שהחיבור שלמעלה פועל, אותה צורת בנאי‑אחר‑Save מכסה מספר משימות שמשרד אחורי מריץ בתזמון:

  • קיצוץ דף לפני שהמסמך יוצא מהבניין: RemovePagesPdf מסיר את הדפים שנבחרו וכותב קובץ חדש מבלי לגעת במקור, כך שהמקור נשאר זמין לביקורת לאחר שהעותק הקצוץ נשלח. בריצה שלנו, הסרת דף 2 מ‑report.pdf יצרה קובץ של דף אחד, בגודל 86 647 בתים בשם report-without-page-2.pdf, והקובץ report.pdf נשאר ללא שינוי.
  • פיצול מצגת עבור מחלק אחד: SplitPptx מחלץ את השקפים המבוקשים לקבצים משלהם, בשם לפי טוקן {0} בתבנית הפלט או, ללא טוקן, עם מספר חלק מצורף באותה תיקייה, באותה תבנית שבה SplitPdf פוצל דפי PDF.
  • מיזוג מסמכי Word במקום PDF: JoinDocx פועל בדיוק לפי צורת בנאי‑אחר‑Save כמו JoinPdf, ומציב את המסמך המצורף אחרי העמוד האחרון של המקור.

בלי רישיון, כל אחת מהפעולות האלו פועלת במצב הערכה. בריצה שלנו ללא רישיון, קבצי ה‑PDF וה‑Word הממוזגים נחתכו ל‑3 עמודים כל אחד, למרות שכל ששת הפלטים של הדוגמה נוצרו; יש להחיל רישיון עם License.Set לפני כל ריצה בלתי מפוקחת בייצור.


התחלה בצינור המשרד האחורי שלך

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

  • הצצה לתמונה המלאה: מדריך ה‑use‑case guide מלווה את כל שש הפעולות של הדוגמה, שיטה אחרי שיטה, עם FAQ מלא.
  • העמקה כאשר המשימה מתרחבת: ה‑full GroupDocs.Merger API מכסה יותר מהתבנית הזו ברגע שהצינור חורג מפעולה אחת.
  • עיון בקוד: ה‑complete sample on GitHub כולל את כל קבצי הקלט שהשתמשנו בהם למעלה.
  • התקנה: דף ה‑installation page מסביר על החבילה הנפרדת וה‑frameworks הנתמכים.
  • הסרת מגבלות ההערכה: קבל temporary license לפני הרצה בייצור.
  • שאלות: support forum הוא המקום שבו הצוות משיב על שאלות יישום.

משאבים