עסקאות שנקראו

קריאת העסקה

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

קריאת פעולת הבקשה

כיוון: יוזם -> יעד

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

• Attribute Requests: רשימה של אפס או יותר מאפיינים של היעד. הרשימה הזו מורכבת מאפס או יותר נתיבים למאפיינים המבוקשים של היעד.
• בקשות לאירועים: רשימה של אפס או יותר נתיבים לאירועים המבוקשים של היעד.

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

פעולה לגבי נתוני דיווח

כיוון: יעד -> יוזם

בפעולה הזו, המטרה מגיבה עם:

• Attribute Reports: רשימה של אפס או יותר מאפיינים שדווחו, שנדרשו בבקשת פעולת הקריאה.
• דוחות על אירועים: רשימה של אפס או יותר אירועים שדווחו.
• ‫Suppress Response: דגל שקובע אם צריך להשבית את תגובת הסטטוס לפעולה הזו.
• מזהה מינוי: אם הדוח הזה הוא חלק מעסקת מינוי, הוא צריך לכלול מספר שלם שמשמש לזיהוי עסקת המינוי.

פעולת תגובה לסטטוס

כיוון: Target -> Initiator או Initiator -> Target

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

אחרי שהפעולה Status Response נשלחת על ידי הגורם היוזם, או שהפעולה Report Data מתקבלת על ידי הגורם היוזם עם הדגל Suppress Response מופעל, השאילתה read/report מסתיימת.

פעולת התגובה של הסטטוס מכילה רק את השדה status שיאשר את הצלחת הפעולה או יציג קוד שגיאה.

הגבלות קריאה

הפעולות Read Request Action ו-Report Data Action הן פעולות Unicast בלבד. בנוסף, יכול להיות שהנתיבים של הבקשות האלה לא יפנו לקבוצת צמתים.

הפעולה 'תגובה עם סטטוס' היא רק Unicast ואי אפשר ליצור אותה כתגובה לשיחה קבוצתית.

עסקת מינוי

פעולה של בקשת הרשמה

כיוון: יוזם -> יעד

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

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

פעולה של בקשת הרשמה מכילה:

• Min Interval Floor (מרווח מינימלי): המרווח המינימלי בין דוחות.
• Max Interval Ceiling (מרווח מקסימלי): המרווח המקסימלי בין דוחות.
• דוחות מאפיינים: רשימה של אפס או יותר מהמאפיינים המדווחים שנדרשו בבקשת פעולת הקריאה.
• דוחות אירועים: רשימה של אפס או יותר אירועים שדווחו.

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

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

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

פעולת תגובה להרשמה

כיוון: יעד -> יוזם

זו הפעולה האחרונה בעסקה של המינוי, והיא מסיימת את התהליך. היא כוללת:

• ‫Subscription ID: מספר שלם שמזהה את המינוי.
• ‫Min Interval (מרווח מינימלי): המרווח המינימלי הסופי והמוגדר בין דוחות.
• Max Interval (מרווח מקסימלי): המרווח המקסימלי הסופי והמוגדר בין הדוחות.

הגבלות על הרשמה

• הפעולה Subscribe Request Action והפעולה Subscribe Response Action הן פעולות מסוג Unicast בלבד.
• לכל הפעולות של נתוני הדוחות באינטראקציה עם מינוי צריך להיות אותו מזהה מינוי.
• אם המנוי לא יקבל פעולה של נתוני דוחות בתוך המרווח המקסימלי שסוכם בין הפעולות, המינוי יבוטל.
• כתוצאה מהכלל הקודם, בעל האתר יכול להפסיק אינטראקציה של מינוי פשוט על ידי הפסקת השליחה של פעולות נתוני דוחות תקופתיות.
• המשתמש שנרשם למינוי יכול לסיים את האינטראקציה עם המינוי בתגובה לפעולה 'דיווח על נתונים' עם קוד סטטוס INACTIVE_SUBSCRIPTION.