top of page

IDoc Basics For Functional Consultants:

הקדמה:
כיום, משתמשים ב-IDocs ברוב אפליקציות ה-SAP על מנת לשנע הודעות (נתונים) ממערכת SAP למערכות אחרות וההיפך. למרות שקיימת הרבה ספרות בנושא לגבי IDocs, עדיין קשה ליועצים פונקציונליים להבין את המסמכים האלו בגלל הטבע הטכני שלהם. יועץ פונקציונלי אינו מצופה לדעת את הקונספטים של ה-IDoc בצורה מלאה, לכן במאמר זה ננסה ללכד את האינפורמציה המינימאלית ההכרחית שיועץ פונקציונלי צריך להכיר על מנת לטפל בפרויקט או לתמוך בסוגיות שקשורות ל-IDocs.
סקירה כללית:
IDoc זהו אובייקט SAP שנושא נתונים של טרנזקציה עסקית מסוימת ממערכת אחרת לאחרת בצורה של הודעה אלקטרונית. IDoc אלו ר"ת של Indermediate Document. המטרה של IDoc היא שינוע נתונים או מידע ממערכת SAP למערכות אחרות ולהיפך. השינוע ממערכת SAP למערכת שאינה SAP מתבצע ע"י מערכות EDI (ר"ת של Electronic Data Interchange) כאשר על מנת לשנע נתונים בין 2 מערכות SAP, משתמשים ב-ALE. ניתן להתניע IDoc ממערכת SAP או מתת-מערכת EDI. זה תלוי בכיוון שה-IDoc נשלח ממנו, ישנו IDoc מסוג: Inbound IDoc וישנו IDoc מסוג Outbound IDoc. במקרה של תנועה החוצה (ממערכת SAP למערכת שאינה SAP), ה-IDoc מותנע ב-SAP דרך ה-document message control ולאחר מכן נשלח לתת-מערכת ה-EDI. תת-מערכת ה-EDI מבצעת המרה של הנתונים
מ-IDoc לכדי XML (או פורמט תואם אחר) ולאחר מכן שולחת את הנתונים למערכת שותפה (partner system) דרך האינטרנט. בתנועה פנימה (ממערכת שאינה SAP למערכת ה-SAP), תת-מערכת ה-EDI ממירה את הנתונים מהמערכת השותפה ונוצר IDoc ב-SAP. לאחר עיבוד מוצלח של ה-IDoc, נוצר Application Document ומפורסם ב-SAP.

 

IDoc_Flow.PNG

סטנדרטים של EDI ו-IDoc:
EDI משמעותו העברה אלקטרונית של מסמכים עסקיים בין מערכות מחשוב של שותפים עסקיים, תוך שימוש בפורמט סטנדרטי על גבי רשת התקשורת. EDI אלו ר"ת של Electronic Data Interchange. על מנת לשנע נתונים בצורה אלקטרונית, משתמשים ב-2 סטנדרטים עיקריים והם: ANSI ASC X12 ו-EDIFACT. ANSI ASC X12 זוהי ועידה שמורכבת מנציגים של ארגונים מרכזיים, גופים ממשלתיים וחברות תוכנה של EDI שהגדירו סטדנרטיים וקווים מנחים לשינוע נתונים על גבי EDI. 
UN/EDIFACT זה בעצם: United Nations EDI for Administrations, commerce and Transport הוקם ב-1985 תוך שימוש ב-ANSI X12 ו-UNTDI (ר"ת של: United Nations Trade Data interchange) שהיוו את הסטנדרטים הבסיסיים להקמתו. ANSI X12 מתאר מסמך עסקי כטרנזקציות כך שלכל טרנזקציה יש ייצוג בעל 3 ספרות, למשל: 850 - הזמנת רכש, 855 - אישור על הזמנת רכש. EDIFACT מתאר מסמך עסקי כהודעה, שמיוצגת ע"י שמות סטנדרטיים כגון: ORDERS עבור הזמנת רכש.
מונחים של IDoc:
IDOC - BASIC - TYPE:
סוגי IDoc מבוססים על סטדנרטים של EDI ולרוב על סטדנרטים של EDIFACT. Basic Types (או: IDoc Type) מגדיר את המבנה של IDoc. כל basic type מגדיר את המקטעים הסטנדרטיים של IDoc, פורמט של שדות נתונים והגודל שלהם. Basic Type גם מגדיר מספר מקטעים ושדות ב-IDoc. כל השדות שחיוניים לשידור בהודעה 
של טרנזקציה עסקית ספציפית ממופים למקטעים שונים. בנוסף זה מגדיר את המבנה והיחסים של מקטעי IDoc ביחד עם מקטעים אופציונליים או מקטעי חובה.

 

IDoc_Basic.PNG

הרחבות של IDOC:
ה-Basic type מכיל את כל השדות הסטנדרטיים שנחוצים על מנת להוציא לפועל טרנזקציה עסקית מסוימת. אך, אם למשל אנחנו נדרשים להעביר ערכים נוספים לשותף אז אנחנו צריכים להשתמש בתכונה שנקראת: IDoc Extension. ה-IDoc extension זוהי הרחבה של ה-basic type שמכילה מקטעי IDoc נוספים (מותאים אישית) וכן שדות נוספים שלא זמינים ב-basic type הסטנדרטי.
מקטעי IDOC:
מקטעי ה-IDoc מכילים את הנתונים בפועל שנשלחים או שמתקבלים מהשותף. המקטעים האלו מכילים את הערכים בפועל שנשלחים כחלק משידור ה-IDoc.

IDoc_Segment.PNG

מקטעי אב ובן:
מקטע IDoc מכונה Parent Segment אם הוא מכיל את ה-Segments שלו בעצמו. ה-Segments שתלויים בו נקראים גם: child segments.

IDoc_Parent_Child.PNG

INBOUND/OUTBOUND IDOCS:
IDocs שנשלחים מחוץ למערכת נקראים גם: Outbound IDocs וה-IDocs שמתקבלים לתוך המערכת, נקראים גם: Inbound IDocs.

IDoc_IN_OUT.PNG

כיוון ה-IDOC:
מציין את הכיוון שבו האינפורמציה נשלחת והוא דומה לטרמינולוגיה שמשתמשים בה במיילים. כאשר האינפורמציה נשלחת מחוץ למערכת אז הכיוון הוא: outbox, כאשר היא מתקבלת לתוך המערכת אז הכיוון הוא: inbox. במערכת ה-SAP, כיוון ה-Outbox מיוצג ע"י הספרה "1" (לציין outbox) וכן כיוון ה-inbox מיוצג ע"י הספרה "2".

IDoc_Direct.PNG

PARTNER:
Partner זהו השותף העסקי שאיתו אנחנו מבצעים חילופי נתונים תוך שימוש ב-IDoc. הוא יכול להיות ספק/לקוח/כל מערכת אחרת. כתלות בכיוון שבו הנתונים נשלחים, הוא ממלא תפקיד של: "sending partner" או "receiving partner".

IDoc_Partner.PNG

PARTNER TYPE:
סוג/תפקיד השותף משמש על מנת לזהות שותפים בתוך מערכות ה-SAP. עבור לקוח, סוג השותף יהיה: KU, עבור ספק סוג השותף יהיה: LI, ועבור מערכת לוגית סוג השותף יהיה: LS.

IDoc_Partner_Type.PNG

סוג הודעה:
עיבוד של IDoc מערב שליחה או קבלה של מסמך בצורה של הודעה, כל אחד מאלו מייצג מסמך במערכת ה-SAP. המסמכים האלו יכולים להיות: הזמנה, אישור משלוח, התראה על משלוח מורחב, קבלת טובין או קבלה. ה-Message type מקושר ל-Basic IDoc Type - Basic Type ומגדיר את הסוג של הנתונים או המסמך שמועבר בינינו לבין השותף.
קוד תהליך:
קוד התהליך מכיל את הפרטים של ה-Function Module שנמצא בשימוש לעיבוד ה-IDoc. ה-Message Type יכול להיות מקושר ל-Process code.
PORT:
ה-IDoc Port מכיל את הנתונים לגבי הצורה שבה המידע נשלח בין מערכת המקור למערכת היעד. סוג ה-port מגדירה את האינפורמציה שמוכלת בתוך ה-port. עבור port מסוג של "Internet" הוא יכיל כתובת IP של מערכת היעד. עבור port מסוג "קובץ", תתוחזק בו שם ספריה או שם קובץ. עבור port מסוג של "tRFC" הוא יכיל אינפורמציה לגבי יעד ה-RFC במערכת היעד. עבור שידור של IDoc  תוך שימוש ב-ALE משתמשים ב-ports מסוג של "tRFC".

bottom of page