יצירת מופעים של מטא-נתונים

במדריך הזה מוסבר איך ליצור מופעים של מטא-נתונים בענן בקטגוריות של מטא-נתונים. ב-Manufacturing Data Engine‏ (MDE) יש שתי דרכים ליצירת מופעים של מטא-נתונים:

  1. באמצעות Metadata API או ממשק האינטרנט (כל המאגרי מידע).
  2. באופן דינמי ממנתחי נתונים (רק עבור דליים של רשומות ותגים).

לפני שמתחילים

כדי להשלים את המדריך הזה, צריך ליצור דלי מטא-נתונים.

יצירת מופעים של מטא-נתונים באמצעות Metadata API או המסוף

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

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

REST

POST metadata/v1/buckets/BUCKET_NAME/BUCKET_VERSION/instances

{
    "naturalKey": "NATURAL_KEY",
    "instance": METADATA_INSTANCE_OBJECT
}

מחליפים את מה שכתוב בשדות הבאים:

  • BUCKET_NAME בשם הקטגוריה שבה רוצים ליצור מופע של מטא-נתונים.
  • BUCKET_VERSION עם הגרסה של קטגוריית המטא-נתונים שבה רוצים ליצור מופע של מטא-נתונים.
  • NATURAL_KEY עם המפתח הטבעי של מופע המטא-נתונים. הערך צריך להיות tagName אם BUCKET_NAME מתאים לקטגוריית תגים. אם BUCKET_NAME מתאים למאגר רשומות והמפתח הטבעי מושמט, המפתח הטבעי מוגדר אוטומטית כגיבוב של הערך.
  • METADATA_INSTANCE_OBJECT עם אובייקט המטא-נתונים של המופע. אובייקט המטא-נתונים של המופע צריך להיות תואם לסכימה שמוגדרת עבור BUCKET_NAME ו-BUCKET_VERSION.

המסוף

פותחים את הקטע CLOUD TAGS בתפריט העליון של ממשק המשתמש כדי ליצור Metadata Instance. תצוגת ברירת המחדל מספקת רשימה של התגים הזמינים במופע MDE:

קטע מטא-נתונים – רשימה

בממשק המשתמש אפשר לערוך רק דליים של מטא-נתונים של תגים. אפשר ליצור מופעים של סוגי Bucket אחרים רק באמצעות ה-API. כדי ליצור Tag Metadata Instance:

  1. לוחצים על סמל הפעולות בתג שנבחר מהרשימה.
  2. בוחרים באפשרות צפייה או עריכה.

    הקטע Tag (תג) – עריכת תג

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

  4. לוחצים על התג של ה-Bucket שרוצים להטמיע. המאפיינים של הדלי מופיעים מתחתיו.

    Tag Section – Edit Tag Metadata

  5. משנים את המאפיינים הקיימים או מוסיפים מאפיינים חדשים לפי הצורך. אפשר לערוך את המאפיינים האלה ולשנות אותם.

  6. מוסיפים את הערכים שנבחרו בכל אחת מהתיבות בטופס.

  7. אחרי שמסיימים את המופע, לוחצים על שמירה.

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

יצירה דינמית של מופעי מטא-נתונים מנתחי נתונים

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