מבנה מודול

1C: Enterprise 8.2 /
למפתחים /
מוסכמות קוד

תוכן עניינים

1.1. במודול התוכנית (מודולים כלליים, מודולים של אובייקטים, מודולים של מנהלי אובייקטים, מודולים של טפסים, פקודות וכו ') במקרה הכללי עשויים להיות הסעיפים הבאים בפרק הבא. רצפים :

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

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

1.2. קטעי תבנית (ריק להעתקה) למודולים נפוצים:

//</em></ul></ul><ul> <li> //</em></em> // // // / / / / / / / //</em></ul></ul><ul> <li> //</em></ul></ul><ul> <li> //</em></im> // // SOFTWARE INTERFACE // //</em></ul></ul><ul> <li> //</em></ul></ul><ul> <li> תהליכי שירות ותפקודים

• הסעיף "ממשק תוכנה" מכיל נהלי ייצוא ופונקציות המיועדות לשימוש על ידי אובייקטים אחרים של תצורה או תוכניות אחרות (למשל באמצעות חיבור חיצוני).
• החלק "נהלי שירות ותפקודים" כולל את הנהלים והפונקציות המרכיבות את היישום הפנימי של מודול משותף. במקרים בהם המודול המשותף הוא חלק מהם פונקציונלי מערכות משנה הכוללות מספר אובייקטים של מטא נתונים, סעיף זה יכול להכיל גם נהלי ייצוא ושירותים ופונקציות המיועדות רק להתקשר מאובייקטים אחרים של תת-מערכת זו.
  עבור מודולים נפוצים בתפזורת, מומלץ לחלק חלק זה לחלקי משנה, בהתאם לתכונה הפונקציונאלית. מקדימים תת-חלקים לפרשנות, שמומלץ להנפיק בצורה דומה. לדוגמא:

//</em></ul></ul><ul> <li> //</em></ul><ul> <li> עדכון בסיס המידע

1.3. תבנית לעיצוב מדורים למודולי אובייקט, מנהלים, ערכות רשומות, טיפולים, דוחות וכו ':

//</em></ul></ul><ul> <li> //</em> // // / / / / / / / / / SOFTWARE INTERFACE // / / / / / / / / / / / //</em></ul></ul><ul> <li> //</14/19/19/14 // מעבד אירועים // / / / / / / / / / / / / / / / /. //</em></ul></ul><ul> <li> נהלי שירות ותפקודים

• הסעיף "ממשק תכניות" מכיל נהלי ייצוא ופונקציות המיועדות לשימוש במודולי תצורה אחרים או בתוכניות אחרות (למשל באמצעות חיבור חיצוני). אין צורך להציב בסעיף זה פונקציות ונהלי ייצוא המיועדים להיקרא אך ורק מהמודולים של האובייקט עצמו, צורותיו ופקודותיו. לדוגמה, הנהלים לאכלוס חלק הטבלה של מסמך שנקראים מעיבוד המילוי במודול האובייקט ומטופס המסמך בטופס פקודות הטופס אינם מודול ממשק תוכנית. נקראים רק במודול עצמו ומהצורות של אותו אובייקט. יש להציב אותם בקטע "נהלי שירות ופונקציות שירות."
• הקטע " מטפלי אירועים" מכיל מטפלים באירועים עבור מודול האובייקט ( Prizavisi , PRO וכו ')
• לסעיף "נהלי שירות ותפקידים" יש אותה מטרה כמו במודולים הכלליים.

1.4. תבנית עיצוב מדורים למודולי טופס:

//</em></ul></ul><ul> <li> //</em></ul></ul><ul><ul><ul> <li> מטפל אירועים בפורום //</em> /// //</em></ul></ul><ul> <li> //</em></ul></ul><ul><ul><ul> <li> מטפלים באירועים של אלמנטים של צורת הפורום // / / / / / / / / / / / / / / / / / / /. //</em></ul></ul><ul> <li> // // מעצבי טבלאות טפסים של אירועים /// / / / / / / / / / / / / / / / / / / / / / / / / / / / / / / / / //צ"צ"צ // // <br/> // מעצבים לצוותים של הפורום // // /// //</em></ul></ul><ul> <li> //</em></ul></ul><ul><ul> <li> תהליכי שירות ותפקודים

• הקטע "טופס מטפלים באירועים" מכיל את נהלי הטיפול באירועים בטופס: על יצירת שרת , פתיחה וכו '.
• החלק "מטפלים באלמנטים של טופס" מכיל נהלים לעיבוד אלמנטים שנמצאים בחלק העיקרי של הטופס (כל מה שלא קשור לטבלאות בטופס).
• בסעיפים "מטפלים באירועים של טבלת הטפסים <טבלת טופס שם>" ישנם נהלים למטפלים של טבלת הטפסים ואלמנטים בטבלה. לגבי נהלי המטפל, על כל טבלה להיות מחיצה משלה.
• החלק "מטפלי פקודות טופס" מכיל נהלים למטפלי פקודות טופס (ששמותיהם מוגדרים במאפיין הפעולה של פקודות טפסים).
• לסעיף "נהלי שירות ותפקידים" יש אותה מטרה כמו במודולים הכלליים.

ראה גם: כללים ליצירת מודולי טופס

2. דרישות כלליות לקטעי מודולי תוכנה.

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

//</em></ul></ul><ul> <li> //</em></ul></ul><ul><ul> <li> פרוצדורות ותפקידי לקוח של מטרה כללית: // - לעבודה עם רשימות בצורות; // - לעבוד עם היומן; // - לעיבוד פעולות משתמש בתהליך עריכה // רב שכבתי טקסט למשל הערות במסמכים; // - אחר. // //</14/15/15/14/19/ //</em></ul><ul> <li>

עבור מודולי טופס מומלץ למקם תיאור של פרמטרי הטופס בכותרת.

2.2. פרק תיאור משתנה . שמות משתנים מוקצים על פי הכלל כללי שם משתנה , והשימוש בהם מתואר במאמר. שימוש במשתנים גלובליים במודולי תוכנה .

יש לספק לכל משתני המודול הערה המספיקה בכדי להבין את מטרתם. מומלץ לפרוש את הפרשנות באותה שורה בה מוצהרים המשתנה.
דוגמה:

מטבע Pem ייצוא חשבונאות; // מטבע בו הנהלת החשבונאות מנוהלת כתובת Perem תומכת בייצוא; // כתובת דוא"ל שאליה נשלחות הודעות שגיאה

2.3. ממשק תוכנה נהלי ייצוא ופונקציות המרכיבות את ממשק התכנות שלה ממוקמים מיד לאחר תיאור המשתנים. נהלים ופונקציות כאלה מיועדים לשימוש על ידי אובייקטים אחרים של תצורה או תוכניות אחרות (למשל באמצעות חיבור חיצוני), ולכן עליהם להיות ממוקמים במקום "גלוי לעין" במודול.

ראה גם: תיאור הנהלים והפונקציות.

2.4.1 טופס מטפלים, פקודות ורכיבי טופס אירועים . לפני נהלי השירות והפונקציות במודול הטופס, מטפלים באירועים של הטופס נמצאים, כמו גם מטפלים באירועים לפקודות ואלמנטים בטופס.

המלצה שיטתית (ייעוץ שימושי)

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

2.4.2. לכל אירוע חייב להיות הליך מטפל משלו. אם יש לבצע את אותן פעולות כאשר אירועים מתרחשים באלמנטים שונים של הטופס:

• צור נוהל נפרד (פונקציה) המבצע את הפעולות הנחוצות

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

• התקשר לפרוצדורה (פונקציה) הנדרשת מכל מטפל.

לדוגמה, טועה:

נוהל & OnClient לביצוע פרמטרים של בחירת יישומים (רכיב) = תאימות חדשה (); בחירת אפשרויות. הדבק ("לפי מחבר", לפי מחבר); בחירת אפשרויות. הדבק ("מנהלים", מנהל); הגדר בחירת רשימה (רשימה, אפשרויות בחירה); EndProcedure נוהל על ידי הלקוח על ידי שינוי (אלמנט) לניהול על ידי שינוי (לא מוגדר); EndProcedure

נכון:

נוהל OnClient לביצועי אינדיקציה (פריט) SetSelection (); נוהל סיום ובנוהל הלקוח על ידי שינוי מחבר (רכיב) התקנת בחירה (); EndProcedures & OnServer Procedure SetSelection () פרמטרי בחירה = תאימות חדשה (); בחירת אפשרויות. הדבק ("לפי מחבר", לפי מחבר); בחירת אפשרויות. הדבק ("מנהלים", מנהל); הגדר בחירת רשימה (רשימה, אפשרויות בחירה); EndProcedure

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

2.5. מטפלי האירועים עבור מודולי האובייקט ומנהל האובייקטים ממוקמים לאחר הייצוא, אך לפני נהלי השירות ופונקציות המודול.

המלצה שיטתית (ייעוץ שימושי)

מומלץ למקם מטפלים, בהתאם לדרישותיהם הבאים בתיאור השפה המוטמעת.

2.6. נהלי שירות ופונקציות מודול שאינם מטפלים באירועים, אך מהווים יישום פנימי של מודול, ממוקמים במודול לצד מטפלי אירועים.

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

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

2.7. פרק האתחול מכיל הצהרות המאתחלות את המשתנים של המודול או האובייקט (טופס). לדוגמא:

כתובת תמיכה = "[email protected]"; // כתובת ליצירת קשר עם התמיכה הטכנית בצע אתחול ();

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

חומרים מהקטע: 1C: Enterprise 8.2 / מפתחים / הסכמים בעת כתיבת קוד

חומרים אחרים בנושא:

תיאור הנהלים והפונקציות

תכונות של קנה מידה עבור האובייקט שנבחר

העברת תצורות בפלטפורמת 1C: Enterprise 8.2 לפלטפורמה 1C: Enterprise 8.3 ללא מצב תאימות לגירסה 8.2

שמות הנהלים והתפקודים

משתמש במצב הרשאה

אנו מוצאים: המבנה של מודול 1c הוא , נהלי שירות ופונקציות , מודול, נוהל שיחת מודול מנהל 1c 8 2, איך לקרוא נוהל ממודול אחר 1c, כותרת מודול אנגלית, 1c מצורת עיבוד נוהל מודול שיחה, 1c 8 2 להתקשר לנוהל ממודול המנהל, 1