שני

אפשר להשתמש במחבר של Monday כדי לבצע פעולות של הוספה, מחיקה, עדכון וקריאה ב-Monday.com.

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

לפני שמשתמשים במחבר של Monday, צריך לבצע את המשימות הבאות:

  • בפרויקט שלכם ב-Google Cloud:
    • מוודאים שהגדרתם חיבור לרשת. מידע על תבניות רשת זמין במאמר קישוריות לרשת.
    • נותנים למשתמש שמגדיר את המחבר את תפקיד ה-IAM‏ roles/connectors.admin.
    • מקצים לחשבון השירות שרוצים להשתמש בו עבור המחבר את תפקידי ה-IAM הבאים:
      • roles/secretmanager.viewer
      • roles/secretmanager.secretAccessor

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

    • מפעילים את השירותים הבאים:
      • ‫secretmanager.googleapis.com (Secret Manager API)
      • ‫connectors.googleapis.com (Connectors API)

      במאמר הפעלת שירותים מוסבר איך להפעיל שירותים.

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

  • מידע על קבלת אסימון API לאימות זמין במאמר בנושא אסימון API.
  • מידע על אימות אפליקציות של Monday באמצעות OAuth 2.0 זמין במאמר בנושא OAuth 2.0.

הגדרת המחבר

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

  1. במסוף Cloud, עוברים לדף Integration Connectors > Connections ובוחרים או יוצרים פרויקט בענן.

    כניסה לדף Connections

  2. לוחצים על + יצירת חיבור חדש כדי לפתוח את הדף יצירת חיבור.
  3. בקטע מיקום, בוחרים את המיקום של החיבור.
    1. אזור: בוחרים מיקום מהרשימה הנפתחת.

      אזורים נתמכים למחברים:

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

    2. לוחצים על הבא.
  4. בקטע פרטי החיבור, ממלאים את הפרטים הבאים:
    1. מחבר: בוחרים באפשרות Monday מתוך הרשימה הנפתחת של המחברים הזמינים.
    2. גרסת כלי החיבור: בוחרים את גרסת כלי החיבור מהרשימה הנפתחת של הגרסאות הזמינות.
    3. בשדה Connection Name (שם החיבור), מזינים שם למופע החיבור.

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

      • שמות החיבורים יכולים לכלול אותיות, מספרים או מקפים.
      • האותיות צריכות להיות קטנות.
      • שמות החיבורים צריכים להתחיל באות ולהסתיים באות או במספר.
      • שמות החיבורים לא יכולים לכלול יותר מ-49 תווים.
    4. אפשר גם להזין תיאור למופע החיבור.
    5. אופציונלי: מפעילים את Cloud logging ובוחרים רמת יומן. כברירת מחדל, רמת היומן מוגדרת כ-Error.
    6. חשבון שירות: בוחרים חשבון שירות שיש לו את התפקידים הנדרשים.
    7. אופציונלי: מגדירים את ההגדרות של צומת החיבור:

      • מספר מינימלי של צמתים: מזינים את המספר המינימלי של צמתי חיבור.
      • מספר הצמתים המקסימלי: מזינים את מספר צמתי החיבור המקסימלי.

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

    8. שימוש ב-proxy: מסמנים את התיבה הזו כדי להגדיר שרת proxy לחיבור.
      • Proxy Auth Scheme (סכימת אימות של שרת proxy): סוג האימות שבו יש להשתמש כדי לבצע אימות לשרת ה-proxy של ProxyServer.
      • משתמש proxy: שם משתמש שישמש לאימות ל-proxy של ProxyServer.
      • סיסמת שרת proxy: סיסמה שתשמש לאימות בשרת ה-proxy ‏ProxyServer.
      • סוג ה-SSL של ה-Proxy: סוג ה-SSL שבו יש להשתמש כשמתחברים ל-ProxyServer proxy.
    9. אופציונלי: לוחצים על + הוספת תווית כדי להוסיף תווית לקישור בצורה של צמד מפתח/ערך.
    10. לוחצים על הבא.
  5. בקטע יעדים, מזינים את הפרטים של המארח המרוחק (מערכת העורף) שאליו רוצים להתחבר.
    1. סוג היעד: אפשר לציין את פרטי היעד ככתובת מארח או כקובץ מצורף של שירות. בוחרים באחד מסוגי היעדים הבאים:
      • כתובת המארח: אם רוצים לציין את שם המארח או את כתובת ה-IP של היעד.
      • צירוף שירות: אם רוצים לציין את נקודת הקצה הפרטית לכתובות ה-IP הפנימיות. קובץ ה-Service Attachment מאפשר לכם להסתיר את כתובות ה-IP הפנימיות מהרשת החיצונית. אפשר ליצור קובץ מצורף עם השירות ב-Google Cloud באמצעות התכונה Private Service Connect. מידע על הגדרת Private Service Connect זמין במאמר פרסום שירותים מנוהלים.

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

      כדי להזין יעדים נוספים, לוחצים על +הוספת יעד.

    2. לוחצים על הבא.
  6. בקטע אימות, מזינים את פרטי האימות.
    1. בוחרים סוג אימות ומזינים את הפרטים הרלוונטיים.

      החיבור ל-Monday תומך בסוגי האימות הבאים:

      • OAuth 2.0
      • טוקן API
    2. כדי להבין איך להגדיר את סוגי האימות האלה, אפשר לעיין במאמר בנושא הגדרת אימות.

    3. לוחצים על הבא.
  7. בדיקה: בודקים את פרטי החיבור והאימות.
  8. לוחצים על יצירה.

הגדרת אימות

מזינים את הפרטים בהתאם לאימות שבו רוצים להשתמש.

  • OAuth 2.0
    • Client ID: מזהה הלקוח שמשמש לבקשת אסימוני גישה.
    • סוד הלקוח: סוד הלקוח שמשמש לבקשת אסימוני גישה.
    • אסימון גישה ל-OAuth: אסימון הגישה שמשמש לאימות בקשות עם חיבורים שמבוססים על תהליך הרשאה עם קוד.
  • API Token

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

    • API Token: טוקן ה-API שמתקבל מחשבון Monday.

דוגמאות להגדרת חיבור

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

סוג החיבור של טוקן ה-API

שם השדה פרטים
מיקום europe-west1
מחבר שני
גרסת המחבר 1
שם החיבור monday-new-connector
הפעלת Cloud Logging כן
רמת הרישום ביומן ניפוי באגים
חשבון השירות SERVICE_ACCOUNT_NAME@PROJECT_ID.iam.gserviceaccount.com
מספר הצמתים המינימלי 2
מספר הצמתים המקסימלי 50
סוג היעד כתובת המארח
מארח 1 https://your-domain.monday.com/
אימות כן
טוקן API API_TOKEN
גרסה של סוד 1

הפורמט של שם המשאב של גרסת הסוד הוא: projects/PROJECT_NUMBER/secrets/CONNECTOR/versions/1

סוג החיבור OAuth 2.0

שם השדה פרטים
מיקום europe-west1
מחבר שני
גרסת המחבר 1
שם החיבור monday-oauth-conn
הפעלת Cloud Logging כן
רמת הרישום ביומן שגיאה
חשבון השירות SERVICE_ACCOUNT_NAME@PROJECT_ID.iam.gserviceaccount.com
מספר הצמתים המינימלי 2
מספר הצמתים המקסימלי 50
סוג היעד כתובת המארח
מארח 1 https://your-domain.monday.com/
אימות כן
מזהה לקוח CLIENT_ID
סוד לקוח CLIENT_SECRET
גרסה של סוד 1

הפורמט של שם המשאב של גרסת הסוד הוא: projects/PROJECT_NUMBER/secrets/CONNECTOR/versions/1

היקף account:read, users:read, assets:read, boards:read, boards:write, docs:read, docs:write, me:read, notifications:write, tags:read, teams:read, updates:read, updates:write, users:read, users:write, workspaces:read, workspaces:write,

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

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

מידע על המגבלות שחלות על Integration Connectors זמין במאמר מגבלות.

שימוש בחיבור ל-monday בשילוב

אחרי שיוצרים את החיבור, הוא זמין גם ב-Apigee Integration וגם ב-Application Integration. אפשר להשתמש בחיבור בשילוב באמצעות המשימה Connectors (מחברים).

  • כדי להבין איך ליצור ולהשתמש במשימה Connectors ב-Apigee Integration, אפשר לעיין במאמר משימת Connectors.
  • מידע על יצירה ושימוש במשימת Connectors ב-Application Integration זמין במאמר משימת Connectors.

ישויות, פעולות ופעולות

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

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

    עם זאת, יכול להיות שמחבר לא תומך בישויות או שאין לו ישויות, ובמקרה כזה הרשימה Entities תהיה ריקה.

  • פעולה: פעולה היא הפעילות שאפשר לבצע על ישות. אפשר לבצע כל אחת מהפעולות הבאות בישות:

    בחירה של ישות מתוך הרשימה הזמינה יוצרת רשימה של פעולות שזמינות לישות. תיאור מפורט של הפעולות זמין במאמר פעולות על ישויות של משימת המחברים. עם זאת, אם מחבר לא תומך באף אחת מהפעולות על ישויות, הפעולות הלא נתמכות האלה לא יופיעו ברשימה Operations.

  • פעולה: פעולה היא פונקציה מסוג first class שזמינה לשילוב דרך ממשק המחבר. פעולה מאפשרת לבצע שינויים בישות אחת או בכמה ישויות, והיא משתנה ממתחם למתחם. בדרך כלל, לפעולה יהיו כמה פרמטרים של קלט ופרמטר של פלט. עם זאת, יכול להיות שמחבר לא תומך באף פעולה, ובמקרה כזה הרשימה Actions תהיה ריקה.

פעולות

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

פעולת CreateNotification

הפעולה הזו יוצרת התראה חדשה.

פרמטרים של קלט לפעולה CreateNotification

שם הפרמטר סוג נתונים חובה תיאור
UserId String כן המזהה הייחודי של המשתמש
TargetType String כן סוג היעדים(פרויקט או פוסט).
TargetId String כן המזהה הייחודי של היעד
טקסט String כן טקסט ההתראה

דוגמה להגדרת הפעולה CreateNotification מופיעה במאמר דוגמאות.

פעולת MoveItemToBoard

הפעולה הזו מעבירה את הלוחות או הקבצים ממופע אחד למופע אחר.

פרמטרים של הקלט של הפעולה MoveItemToBoard

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

דוגמה להגדרת הפעולה MoveItemToBoard מופיעה במאמר דוגמאות.

פעולה DuplicateItem

הפעולה הזו משכפלת פריט קיים.

פרמטרים של קלט לפעולה DuplicateItem

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

דוגמה להגדרת הפעולה DuplicateItem מופיעה במאמר דוגמאות.

פעולת עדכון לייק

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

פרמטרים של קלט לפעולה LikeUpdate

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

דוגמה להגדרת הפעולה LikeUpdate מופיעה במאמר דוגמאות.

פעולת AddFileToColumn

הפעולה הזו מוסיפה קובץ לעמודה.

פרמטרים של קלט לפעולה AddFileToColumn

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

דוגמה להגדרת הפעולה AddFileToColumn מופיעה במאמר דוגמאות.

הפעולה AddFileToUpdate

הפעולה הזו מוסיפה קובץ לעדכון.

פרמטרים של קלט לפעולה AddFileToUpdate

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

דוגמה להגדרת הפעולה AddFileToUpdate מופיעה במאמר דוגמאות.

פעולת שכפול הלוח

הפעולה הזו משכפלת נתונים של פעולה מסוימת.

פרמטרים של קלט לפעולה DuplicateBoard

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

דוגמה להגדרת הפעולה DuplicateBoard מופיעה במאמר דוגמאות.

פעולה DuplicateGroup

הפעולה הזו משכפלת נתונים של קבוצה.

פרמטרים של קלט לפעולה DuplicateGroup

שם הפרמטר סוג נתונים חובה תיאור
BoardId String כן המזהה הייחודי של הלוח
GroupId String כן המזהה הייחודי של הקבוצה.
AddToTop בוליאני כן מציין אם הקבוצה החדשה נוספת לחלק העליון.
GroupTitle String כן שם הקבוצה.

דוגמה להגדרת הפעולה DuplicateGroup מופיעה במאמר דוגמאות.

דוגמאות לפעולות

בקטע הזה מוסבר איך לבצע חלק מהפעולות במחבר הזה.

דוגמה – CreateNotification

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Actions.
  2. בוחרים את הפעולה CreateNotification ולוחצים על סיום.
  3. בקטע Task Input (קלט המשימה) של המשימה Connectors (מחברים), לוחצים על connectorInputPayload ואז מזינים ערך שדומה לערך הבא בשדה Default Value:
        {
          "UserId": "64384966",
          "TargetType": "Project",
          "TargetId": "1899350039",
          "Text": "This is notification from google Cloud."
        }
        
  4. אם הפעולה מצליחה, ערך הפרמטר CreateNotification response connectorOutputPayload של המשימה יהיה דומה לדוגמה הבאה:

        [{
          "notificationid": "-1"
        }] 
        

דוגמה – MoveItemToBoard

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Actions.
  2. בוחרים את הפעולה MoveItemToBoard ולוחצים על סיום.
  3. בקטע Task Input (קלט המשימה) של המשימה Connectors (מחברים), לוחצים על connectorInputPayload ואז מזינים ערך שדומה לערך הבא בשדה Default Value:
        {
          "BoardId": "1900739644",
          "GroupId": "topics",
          "ItemId": "1901835960"
        }
        
  4. אם הפעולה מצליחה, ערך הפרמטר MoveItemToBoard response connectorOutputPayload של המשימה יהיה דומה לדוגמה הבאה:

      
        [{
          "itemid": "1901835960"
        }]
        

דוגמה – DuplicateItem

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Actions.
  2. בוחרים את הפעולה DuplicateItem ולוחצים על סיום.
  3. בקטע Task Input (קלט המשימה) של המשימה Connectors (מחברים), לוחצים על connectorInputPayload ואז מזינים ערך דומה לערך הבא בשדה Default Value:
     
      {
        "ItemId": "1901835811",
        "BoardId": "1899350039",
        "WithUpdates": true
      }
      
  4. אם הפעולה מצליחה, ערך הפרמטר DuplicateItem response connectorOutputPayload של המשימה יהיה דומה לדוגמה הבאה:

      [{
        "itemid": "1901835960"
      }]
      

דוגמה – LikeUpdate

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Actions.
  2. בוחרים את הפעולה LikeUpdate ולוחצים על סיום.
  3. בקטע Task Input (קלט המשימה) של המשימה Connectors (מחברים), לוחצים על connectorInputPayload ואז מזינים ערך דומה לערך הבא בשדה Default Value:
      {
        "UpdateId": "18397960"
      }
      
  4. אם הפעולה מצליחה, ערך הפרמטר LikeUpdate response connectorOutputPayload של המשימה יהיה דומה לדוגמה הבאה:

      [{
        "updateid": "690939"
      }] 
      

דוגמה – AddFileToColumn

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Actions.
  2. בוחרים את הפעולה AddFileToColumn ולוחצים על סיום.
  3. בקטע Task Input (קלט המשימה) של המשימה Connectors (מחברים), לוחצים על connectorInputPayload ואז מזינים ערך דומה לערך הבא בשדה Default Value:
      {
        "ItemId": "1901866680",
        "ColumnId": "files",
        "Content": "HI Team"
      }
      
  4. אם הפעולה מצליחה, ערך הפרמטר AddFileToColumn response connectorOutputPayload של המשימה יהיה דומה לדוגמה הבאה:

      [{
        "assetid": "13325557"
      }]
      

דוגמה – AddFileToUpdate

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Actions.
  2. בוחרים את הפעולה AddFileToUpdate ולוחצים על סיום.
  3. בקטע Task Input (קלט המשימה) של המשימה Connectors (מחברים), לוחצים על connectorInputPayload ואז מזינים ערך דומה לערך הבא בשדה Default Value:
      {
        "UpdateId": "18397903",
        "Content": "Integration Testing File Updated."
      }
      
  4. אם הפעולה מצליחה, ערך הפרמטר AddFileToUpdate response connectorOutputPayload של המשימה יהיה דומה לדוגמה הבאה:

      [{
        "assetid": "13325933"
      }]
    

דוגמה – DuplicateGroup

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Actions.
  2. בוחרים את הפעולה DuplicateGroup ולוחצים על סיום.
  3. בקטע Task Input (קלט המשימה) של המשימה Connectors (מחברים), לוחצים על connectorInputPayload ואז מזינים ערך דומה לערך הבא בשדה Default Value:
      {
        "BoardId": "1899350039",
        "GroupId": "new_demo_group4869__1",
        "AddToTop": true,
        "GroupTitle": "Duplicate Group"
      }
    
  4. אם הפעולה מצליחה, ערך הפרמטר DuplicateGroup response connectorOutputPayload של המשימה יהיה דומה לדוגמה הבאה:

      [{
        "assetid": "13325933"
      }]
    

דוגמה – DuplicateBoard

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Actions.
  2. בוחרים את הפעולה DuplicateBoard ולוחצים על סיום.
  3. בקטע Task Input (קלט המשימה) של המשימה Connectors (מחברים), לוחצים על connectorInputPayload ואז מזינים ערך דומה לערך הבא בשדה Default Value:
      {
        "BoardId": "1900733069",
        "DuplicateType": "duplicate_board_with_structure"
      }
      
  4. אם הפעולה מצליחה, ערך הפרמטר DuplicateBoard response connectorOutputPayload של המשימה יהיה דומה לדוגמה הבאה:

      [{
        "assetid": "13325933"
      }]
      

דוגמאות לפעולות על ישויות

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

דוגמה – פעולת רשימה עבור סביבות עבודה

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
  2. בוחרים באפשרות Workspaces מהרשימה Entity.
  3. בוחרים את הפעולה List ולוחצים על סיום.
  4. בקטע Task Input (קלט למשימה) של המשימה Connectors (מחברים), אפשר להגדיר את filterClause (סעיף מסנן) בהתאם לדרישות הלקוח. אתם יכולים לסנן את קבוצת התוצאות על ידי ציון פסקה של מסנן. תמיד מציינים את הערך של סעיף המסנן בתוך גרשיים בודדים (').

אפשר לבצע פעולת רשימה בישויות הבאות:

Folders, Boards, BoardViews, BoardUsers, BoardTeams, ActivityLogs, Webhook, Tags, Users, Doc, DocBlocks, Teams, MoveItemToBoard, Groups, Updates, WorkspaceTeams, WorkspaceUsers, TeamUsers, Columns

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

דוגמה – שליפת רשומה יחידה מ-Workspaces

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
  2. בוחרים באפשרות Workspaces מהרשימה Entity.
  3. בוחרים את הפעולה Get ולוחצים על סיום.
  4. מגדירים את מזהה הישות ל-961430, שהוא המפתח שצריך להעביר. כדי להגדיר את מזהה הישות, בקטע Data Mapper שבData Mapping, לוחצים על Open Data Mapping Editor, מזינים "961430" בשדה Input Value ובוחרים באפשרות EntityId בתור Local variable.

אם לישות יש מפתח ראשי מורכב, אפשר לציין פסוקית מסנן.

אפשר לבצע פעולת Get על הישויות הבאות:

לוחות, תצוגות לוח, יומני פעילות, WebHook, תגים, נכס, משתמשים, מסמך, בלוק מסמך, צוות, עדכונים, עמודות

דוגמה – מחיקת רשומה מהישות Workspaces

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
  2. בוחרים באפשרות Workspaces מהרשימה Entity.
  3. בוחרים את הפעולה Delete ולוחצים על סיום.
  4. מגדירים את מזהה הישות לערך 961430, שהוא המפתח שיועבר.כדי להגדיר את מזהה הישות, בקטע Data Mapper של Data Mapping, לוחצים על Open Data Mapping Editor, מזינים "961430" בשדה Input Value ובוחרים באפשרות EntityId בתור Local variable.

    לחלופין, אם לישות יש שני מפתחות עסקיים מורכבים או מפתחות ראשיים במקום המאפיין entityId, אפשר גם להגדיר את filterClause לערך id='961430'.

אפשר לבצע פעולת מחיקה על הישויות הבאות:

תיקיות, לוחות, WebHook, קבוצות, SubItem, ‏ DocBlock, ‏ TeamUser, ‏ WorkspaceUser, ‏ Boards, ‏ BoardTeams,‏ BoardUsers, ‏ Updates, ‏ Columns

דוגמה – יצירת ישות Workspace

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
  2. בוחרים באפשרות Workspace מהרשימה Entity.
  3. בוחרים את הפעולה Create ולוחצים על סיום.
  4. בקטע Data Mapper (מיפוי נתונים) במשימה Data Mapping (מיפוי נתונים), לוחצים על Open Data Mapping Editor, מזינים ערך דומה לערך הבא בשדה Input Value ובוחרים באפשרות EntityId/ConnectorInputPayload כמשתנה מקומי.
    {
      "Name": "Riky's Workspace",
      "Kind": "open",
      "Description": "This is Riky's Workspace"
    }
    

    בדוגמה הזו, ייווצר חשבון Workspace. אם השילוב יצליח, לפרמטר התגובה connectorOutputPayload של המשימה Workspace יהיה ערך שדומה לזה:

     
    {
      "Id": "964218"
    }
    

דוגמה – יצירת ישות Workspaceuser (משתמש יחיד)

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
  2. בוחרים באפשרות Workspaceuser מהרשימה Entity.
  3. בוחרים את הפעולה Create ולוחצים על סיום.
  4. בקטע Data Mapper (מיפוי נתונים) במשימה Data Mapping (מיפוי נתונים), לוחצים על Open Data Mapping Editor, מזינים ערך דומה לערך הבא בשדה Input Value ובוחרים באפשרות EntityId/ConnectorInputPayload כמשתנה מקומי.
    {
      "WorkspaceId": "952743",
      "Kind": "subscriber",
      "Id": "'64427450'"
    }

    בדוגמה הזו מוסבר איך להוסיף משתמש יחיד ב-Workspace. אם השילוב יצליח, לפרמטר התגובה connectorOutputPayload של המשימה Workspaceuser יהיה ערך שדומה לערך הבא:

    {
      "Success": true
    }
    

דוגמה – יצירת ישות Workspaceuser (כמה משתמשים)

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
  2. בוחרים באפשרות Workspaceuser מהרשימה Entity.
  3. בוחרים את הפעולה Create ולוחצים על סיום.
  4. בקטע Data Mapper (מיפוי נתונים) במשימה Data Mapping (מיפוי נתונים), לוחצים על Open Data Mapping Editor, מזינים ערך דומה לערך הבא בשדה Input Value ובוחרים באפשרות EntityId/ConnectorInputPayload כמשתנה מקומי.
    {
      "WorkspaceId": "1027130",
      "Kind": "subscriber",
      "Id": "64427450,64426103,65189599"
    }

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

    {
      "Id": "64426103",
      "WorkspaceId": "1027130"
    }
    

דוגמה – יצירת ישות WorkspaceTeams (צוות יחיד)

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
  2. בוחרים באפשרות WorkspaceTeams מהרשימה Entity.
  3. בוחרים את הפעולה Create ולוחצים על סיום.
  4. בקטע Data Mapper (מיפוי נתונים) במשימה Data Mapping (מיפוי נתונים), לוחצים על Open Data Mapping Editor, מזינים ערך דומה לערך הבא בשדה Input Value ובוחרים באפשרות EntityId/ConnectorInputPayload כמשתנה מקומי.
    {
      "WorkspaceId": "1027130",
      "Kind": "subscriber",
      "Id": "16516"
    }

    בדוגמה הזו מוסבר איך להוסיף צוות יחיד בסביבת עבודה. אם השילוב יצליח, לפרמטר התגובה connectorOutputPayload של המשימה WorkspaceTeams יהיה ערך שדומה לזה:

    {
      "Id": "16516",
      "WorkspaceId": "1027130"
    }
    

דוגמה – יצירת ישות WorkspaceTeams (כמה צוותים)

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
  2. בוחרים באפשרות WorkspaceTeams מהרשימה Entity.
  3. בוחרים את הפעולה Create ולוחצים על סיום.
  4. בקטע Data Mapper (מיפוי נתונים) במשימה Data Mapping (מיפוי נתונים), לוחצים על Open Data Mapping Editor, מזינים ערך דומה לערך הבא בשדה Input Value ובוחרים באפשרות EntityId/ConnectorInputPayload כמשתנה מקומי.
    {
      "WorkspaceId": "1027130",
      "Kind": "subscriber",
      "Id": "16516,15056,14926"
    }

    בדוגמה הזו מוסבר איך להוסיף כמה צוותים בסביבת עבודה. אם השילוב יצליח, לפרמטר התגובה connectorOutputPayload של המשימה WorkspaceTeams יהיה ערך שדומה לזה:

    {
      "Id": "16516",
      "WorkspaceId": "1027130"
    }

דוגמה – יצירת ישות TeamUser (משתמש יחיד)

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
  2. בוחרים באפשרות TeamUser מהרשימה Entity.
  3. בוחרים את הפעולה Create ולוחצים על סיום.
  4. בקטע Data Mapper (מיפוי נתונים) במשימה Data Mapping (מיפוי נתונים), לוחצים על Open Data Mapping Editor, מזינים ערך דומה לערך הבא בשדה Input Value ובוחרים באפשרות EntityId/ConnectorInputPayload כמשתנה מקומי.
    {
      "TeamId": "15056",
      "Id": "64427450"
    }

    בדוגמה הזו מוסבר איך להוסיף משתמש יחיד לצוות. אם השילוב יצליח, לפרמטר התגובה TeamUser של המשימה connectorOutputPayload יהיה ערך שדומה לערך הבא:

    {
      "Id": "64427450",
      "TeamId": 15056
    }

דוגמה – יצירת ישות TeamUser (MultipleUsers)

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
  2. בוחרים באפשרות TeamUser מהרשימה Entity.
  3. בוחרים את הפעולה Create ולוחצים על סיום.
  4. בקטע Data Mapper (מיפוי נתונים) במשימה Data Mapping (מיפוי נתונים), לוחצים על Open Data Mapping Editor, מזינים ערך דומה לערך הבא בשדה Input Value ובוחרים באפשרות EntityId/ConnectorInputPayload כמשתנה מקומי.
    {
      "TeamId": "16516",
      "Id": "64427450,64426103,65189599"
    }

    בדוגמה הזו מוסבר איך להוסיף כמה משתמשים לצוות. אם השילוב יצליח, לפרמטר התגובה TeamUser של המשימה connectorOutputPayload יהיה ערך שדומה לערך הבא:

    {
      "Id": "64427450",
      "TeamId": "16516"
    }

דוגמה – יצירת לוחות ישויות

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
  2. בוחרים באפשרות Boards מהרשימה Entity.
  3. בוחרים את הפעולה Create ולוחצים על סיום.
  4. בקטע Data Mapper (מיפוי נתונים) במשימה Data Mapping (מיפוי נתונים), לוחצים על Open Data Mapping Editor, מזינים ערך דומה לערך הבא בשדה Input Value ובוחרים באפשרות EntityId/ConnectorInputPayload כמשתנה מקומי.
    {
      "Name": "New Demo Board",
      "BoardKind": "public"
    }

    בדוגמה הזו ייצרו לוחות. אם השילוב יצליח, לפרמטר התגובה connectorOutputPayload של המשימה Boards יהיה ערך שדומה לזה:

    {
      "Id": "1900733069"
    }
    

דוגמה – יצירת ישות Boardusers (משתמש יחיד)

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
  2. בוחרים באפשרות Boardusers מהרשימה Entity.
  3. בוחרים את הפעולה Create ולוחצים על סיום.
  4. בקטע Data Mapper (מיפוי נתונים) במשימה Data Mapping (מיפוי נתונים), לוחצים על Open Data Mapping Editor, מזינים ערך דומה לערך הבא בשדה Input Value ובוחרים באפשרות EntityId/ConnectorInputPayload כמשתנה מקומי.
    {
      "BoardId": "1900739644",
      "Id": "64385055",
      "Kind": "subscriber"
    }

    בדוגמה הזו מוסבר איך להוסיף משתמש יחיד ללוח, ואם השילוב מצליח, לפרמטר התגובה Boardusers של המשימה connectorOutputPayload יהיה ערך שדומה לערך הבא:

    {
      "Id": "64385055",
      "BoardId": null
    } 
    

דוגמה – יצירת הישות Boardusers (כמה משתמשים)

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
  2. בוחרים באפשרות Boardusers מהרשימה Entity.
  3. בוחרים את הפעולה Create ולוחצים על סיום.
  4. בקטע Data Mapper (מיפוי נתונים) במשימה Data Mapping (מיפוי נתונים), לוחצים על Open Data Mapping Editor, מזינים ערך דומה לערך הבא בשדה Input Value ובוחרים באפשרות EntityId/ConnectorInputPayload כמשתנה מקומי.
    {
      "BoardId": "1899350039",
      "Id": "64427450,64426103,65189599",
      "Kind": "subscriber"
    }
    

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

    {
    "Id": "64426103",
    "BoardId": "1899350039"
    }
    

דוגמה – יצירת הישות BoardTeam (צוות יחיד)

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
  2. בוחרים באפשרות BoardTeam מהרשימה Entity.
  3. בוחרים את הפעולה Create ולוחצים על סיום.
  4. בקטע Data Mapper (מיפוי נתונים) במשימה Data Mapping (מיפוי נתונים), לוחצים על Open Data Mapping Editor, מזינים ערך דומה לערך הבא בשדה Input Value ובוחרים באפשרות EntityId/ConnectorInputPayload כמשתנה מקומי.
    {
      "BoardId": "1899350039",
      "Id": "14926",
      "Kind": "subscriber"
     }

    בדוגמה הזו מוסבר איך להוסיף צוות אחד ללוח. אם השילוב יצליח, לפרמטר התגובה connectorOutputPayload של המשימה BoardTeam יהיה ערך שדומה לזה:

    {
      "Id": "14926",
      "BoardId": null
    }
    

דוגמה – יצירת הישות BoardTeam (כמה צוותים)

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
  2. בוחרים באפשרות BoardTeam מהרשימה Entity.
  3. בוחרים את הפעולה Create ולוחצים על סיום.
  4. בקטע Data Mapper (מיפוי נתונים) במשימה Data Mapping (מיפוי נתונים), לוחצים על Open Data Mapping Editor, מזינים ערך דומה לערך הבא בשדה Input Value ובוחרים באפשרות EntityId/ConnectorInputPayload כמשתנה מקומי.
     {
      "BoardId": "1919494280",
      "Id": "16516,15056,14926",
      "Kind": "subscriber"
    }
    

    בדוגמה הזו מוסבר איך להוסיף כמה צוותים ללוח. אם השילוב יצליח, לפרמטר התגובה connectorOutputPayload של המשימה BoardTeam יהיה ערך שדומה לערך הבא:

    {
      "Id": "16516",
      "BoardId": "1919494280"
    } 
    

דוגמה – יצירת ישות Group

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
  2. בוחרים באפשרות Group מהרשימה Entity.
  3. בוחרים את הפעולה Create ולוחצים על סיום.
  4. בקטע Data Mapper (מיפוי נתונים) במשימה Data Mapping (מיפוי נתונים), לוחצים על Open Data Mapping Editor, מזינים ערך דומה לערך הבא בשדה Input Value ובוחרים באפשרות EntityId/ConnectorInputPayload כמשתנה מקומי.
    {
      "BoardId": "1899350039",
      "Title": "New Demo Group",
      "RelativeTo": "mohit group",
      "PositionRelativeMethod": "after_at",
      "Color": "#FFCB00"
    }
    

    בדוגמה הזו תיווצר הקבוצה. אם השילוב יצליח, לפרמטר התגובה connectorOutputPayload של המשימה Group יהיה ערך שדומה לזה:

    {
      "Id": "new_demo_group29615__1",
      "BoardId": "1899350039"
    }
    

דוגמה – יצירת עמודות של ישות

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
  2. בוחרים באפשרות Columns מהרשימה Entity.
  3. בוחרים את הפעולה Create ולוחצים על סיום.
  4. בקטע Data Mapper (מיפוי נתונים) במשימה Data Mapping (מיפוי נתונים), לוחצים על Open Data Mapping Editor, מזינים ערך דומה לערך הבא בשדה Input Value ובוחרים באפשרות EntityId/ConnectorInputPayload כמשתנה מקומי.
    {
      "BoardId": "1922602090",
      "Type": "people",
      "Title": "PeopleInfo",
      "Id": "people1"
    }
    

    בדוגמה הזו נוצרת העמודה, ואם השילוב מצליח, לפרמטר התגובה connectorOutputPayload של המשימה Columns יהיה ערך שדומה לערך הבא:

     {
      "Id": "people1",
      "BoardId": "1922602090"
    }
    

דוגמה – יצירת ישות Columns(Date)

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
  2. בוחרים באפשרות Columns מהרשימה Entity.
  3. בוחרים את הפעולה Create ולוחצים על סיום.
  4. בקטע Data Mapper (מיפוי נתונים) במשימה Data Mapping (מיפוי נתונים), לוחצים על Open Data Mapping Editor, מזינים ערך דומה לערך הבא בשדה Input Value ובוחרים באפשרות EntityId/ConnectorInputPayload כמשתנה מקומי.
    {
      "Title": "Date",
      "Type": "date",
      "BoardId": "1922602090",
      "Id": "date"
    }
     

    בדוגמה הזו תיצור עמודה של תאריכים. אם השילוב יצליח, לפרמטר התגובה connectorOutputPayload של המשימה Columns יהיה ערך שדומה לזה:

    {
      "Id": "date",
      "BoardId": "1922602090"
    }
    

דוגמה – יצירת עמודות של ישות(תפריט נפתח)

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
  2. בוחרים באפשרות Columns מהרשימה Entity.
  3. בוחרים את הפעולה Create ולוחצים על סיום.
  4. בקטע Data Mapper (מיפוי נתונים) במשימה Data Mapping (מיפוי נתונים), לוחצים על Open Data Mapping Editor, מזינים ערך דומה לערך הבא בשדה Input Value ובוחרים באפשרות EntityId/ConnectorInputPayload כמשתנה מקומי.
    {
      "BoardId": "1922602090",
      "Type": "dropdown",
      "Title": "Dropdown",
      "Id": "dropdown_1"
    }
    

    בדוגמה הזו, תיווצר עמודה של תפריט נפתח. אם השילוב יצליח, לפרמטר התגובה connectorOutputPayload של המשימה Columns יהיה ערך שדומה לזה:

     {
      "Id": "dropdown_1",
      "BoardId": "1922602090"
    }
    

דוגמה – יצירת עמודות של ישות(אימייל)

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
  2. בוחרים באפשרות Columns מהרשימה Entity.
  3. בוחרים את הפעולה Create ולוחצים על סיום.
  4. בקטע Data Mapper (מיפוי נתונים) במשימה Data Mapping (מיפוי נתונים), לוחצים על Open Data Mapping Editor, מזינים ערך דומה לערך הבא בשדה Input Value ובוחרים באפשרות EntityId/ConnectorInputPayload כמשתנה מקומי.
    {
      "BoardId": "1922602090",
      "Type": "email",
      "Title": "Mail",
      "Id": "mail_11"
    }
    

    בדוגמה הזו, תיווצר העמודה Email. אם השילוב יצליח, לפרמטר התגובה connectorOutputPayload של המשימה Columns יהיה ערך שדומה לזה:

    {
      "Id": "mail_11",
      "BoardId": "1922602090"
    }
    

דוגמה – יצירת עמודות של ישויות(LongText)

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
  2. בוחרים באפשרות Columns מהרשימה Entity.
  3. בוחרים את הפעולה Create ולוחצים על סיום.
  4. בקטע Data Mapper (מיפוי נתונים) במשימה Data Mapping (מיפוי נתונים), לוחצים על Open Data Mapping Editor, מזינים ערך דומה לערך הבא בשדה Input Value ובוחרים באפשרות EntityId/ConnectorInputPayload כמשתנה מקומי.
    {
      "BoardId": "1922602090",
      "Type": "long_text",
      "Title": "Longtext",
      "Id": "longtext1"
    }
    

    בדוגמה הזו נוצרת העמודה LongText. אם השילוב יצליח, לפרמטר התגובה connectorOutputPayload של המשימה Columns יהיה ערך שדומה לזה:

    {
      "Id": "longtext1",
      "BoardId": "1922602090"
    }
    

דוגמה – יצירת עמודות של ישות(מספר)

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
  2. בוחרים באפשרות Columns מהרשימה Entity.
  3. בוחרים את הפעולה Create ולוחצים על סיום.
  4. בקטע Data Mapper (מיפוי נתונים) במשימה Data Mapping (מיפוי נתונים), לוחצים על Open Data Mapping Editor, מזינים ערך דומה לערך הבא בשדה Input Value ובוחרים באפשרות EntityId/ConnectorInputPayload כמשתנה מקומי.
     {
      "BoardId": "1922602090",
      "Type": "numbers",
      "Title": "Number",
      "Id": "number"
    }
    

    בדוגמה הזו, תיווצר העמודה 'מספר'. אם השילוב יצליח, לפרמטר התגובה connectorOutputPayload של המשימה Columns יהיה ערך שדומה לזה:

    {
      "Id": "number",
      "BoardId": "1922602090"
    }
    

דוגמה – יצירת עמודות של ישות(טלפון)

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
  2. בוחרים באפשרות Columns מהרשימה Entity.
  3. בוחרים את הפעולה Create ולוחצים על סיום.
  4. בקטע Data Mapper (מיפוי נתונים) במשימה Data Mapping (מיפוי נתונים), לוחצים על Open Data Mapping Editor, מזינים ערך דומה לערך הבא בשדה Input Value ובוחרים באפשרות EntityId/ConnectorInputPayload כמשתנה מקומי.
    {
      "BoardId": "1922602090",
      "Type": "phone",
      "Title": "PhoneNumber",
      "Id": "phone43"
    }
    

    בדוגמה הזו, העמודה Phone (טלפון) תיווצר. אם השילוב יצליח, לפרמטר התגובה connectorOutputPayload של המשימה Columns יהיה ערך שדומה לזה:

    {
      "Id": "phone43",
      "BoardId": "1922602090"
    }
    

דוגמה – יצירת עמודות של ישויות(טקסט)

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
  2. בוחרים באפשרות Columns מהרשימה Entity.
  3. בוחרים את הפעולה Create ולוחצים על סיום.
  4. בקטע Data Mapper (מיפוי נתונים) במשימה Data Mapping (מיפוי נתונים), לוחצים על Open Data Mapping Editor, מזינים ערך דומה לערך הבא בשדה Input Value ובוחרים באפשרות EntityId/ConnectorInputPayload כמשתנה מקומי.
    {
      "BoardId": "1922602090",
      "Type": "text",
      "Title": "Text",
      "Id": "text18"
    }
    

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

     {
      "Id": "text18",
      "BoardId": "1922602090"
    }
    

דוגמה – יצירת עמודות של ישות (תלות)

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
  2. בוחרים באפשרות Columns מהרשימה Entity.
  3. בוחרים את הפעולה Create ולוחצים על סיום.
  4. בקטע Data Mapper (מיפוי נתונים) במשימה Data Mapping (מיפוי נתונים), לוחצים על Open Data Mapping Editor, מזינים ערך דומה לערך הבא בשדה Input Value ובוחרים באפשרות EntityId/ConnectorInputPayload כמשתנה מקומי.
     {
      "BoardId": "1922602090",
      "Type": "dependency",
      "Title": "Dependency",
      "Id": "dependency_1"
    }
     

    בדוגמה הזו, העמודה Dependency (תלות) תיווצר. אם השילוב יצליח, לפרמטר התגובה connectorOutputPayload של המשימה Columns יהיה ערך שדומה לזה:

    {
      "Id": "dependency_1",
      "BoardId": "1922602090"
    }
    

דוגמה – יצירת עמודות של ישויות (אנשים)

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
  2. בוחרים באפשרות Columns מהרשימה Entity.
  3. בוחרים את הפעולה Create ולוחצים על סיום.
  4. בקטע Data Mapper (מיפוי נתונים) במשימה Data Mapping (מיפוי נתונים), לוחצים על Open Data Mapping Editor, מזינים ערך דומה לערך הבא בשדה Input Value ובוחרים באפשרות EntityId/ConnectorInputPayload כמשתנה מקומי.
    {
      "BoardId": "1922602090",
      "Type": "people",
      "Title": "PeopleInfo",
      "Id": "people123"
    }
     

    בדוגמה הזו, תיווצר העמודה 'אנשים'. אם השילוב יצליח, לפרמטר התגובה connectorOutputPayload של המשימה Columns יהיה ערך שדומה לזה:

     {
      "Id": "people123",
      "BoardId": "1922602090"
    }
    

דוגמה – יצירת עמודות של ישויות (מדינה)

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
  2. בוחרים באפשרות Columns מהרשימה Entity.
  3. בוחרים את הפעולה Create ולוחצים על סיום.
  4. בקטע Data Mapper (מיפוי נתונים) במשימה Data Mapping (מיפוי נתונים), לוחצים על Open Data Mapping Editor, מזינים ערך דומה לערך הבא בשדה Input Value ובוחרים באפשרות EntityId/ConnectorInputPayload כמשתנה מקומי.
    {
      "BoardId": "1922602090",
      "Type": "country",
      "Title": "Country",
      "Id": "country"
    }
    

    בדוגמה הזו, העמודה Country (מדינה) תיווצר. אם השילוב יצליח, לפרמטר התגובה connectorOutputPayload של המשימה Columns יהיה ערך שדומה לזה:

    {
      "Id": "country",
      "BoardId": "1922602090"
    }
    

דוגמה – יצירת עמודות של ישות (שעה)

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
  2. בוחרים באפשרות Columns מהרשימה Entity.
  3. בוחרים את הפעולה Create ולוחצים על סיום.
  4. בקטע Data Mapper (מיפוי נתונים) במשימה Data Mapping (מיפוי נתונים), לוחצים על Open Data Mapping Editor, מזינים ערך דומה לערך הבא בשדה Input Value ובוחרים באפשרות EntityId/ConnectorInputPayload כמשתנה מקומי.
    {
      "BoardId": "1922602090",
      "Type": "hour",
      "Title": "Hour",
      "Id": "hour"
    }
     

    בדוגמה הזו, העמודה Hour (שעה) תיווצר. אם השילוב יצליח, לפרמטר התגובה connectorOutputPayload של המשימה Columns יהיה ערך שדומה לזה:

    {
      "Id": "hour",
      "BoardId": "1922602090"
    }
    
  1. בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
  2. בוחרים באפשרות Columns מהרשימה Entity.
  3. בוחרים את הפעולה Create ולוחצים על סיום.
  4. בקטע Data Mapper (מיפוי נתונים) במשימה Data Mapping (מיפוי נתונים), לוחצים על Open Data Mapping Editor, מזינים ערך דומה לערך הבא בשדה Input Value ובוחרים באפשרות EntityId/ConnectorInputPayload כמשתנה מקומי.
    {
      "BoardId": "1922602090",
      "Type": "link",
      "Title": "LINK",
      "Id": "linkurl"
    }
     

    בדוגמה הזו, העמודה Link (קישור) תיווצר. אם השילוב יצליח, לפרמטר התגובה connectorOutputPayload של המשימה Columns יהיה ערך שדומה לזה:

     {
      "Id": "linkurl",
      "BoardId": "1922602090"
    }
    

דוגמה – יצירת עמודות של ישויות (מיקום)

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
  2. בוחרים באפשרות Columns מהרשימה Entity.
  3. בוחרים את הפעולה Create ולוחצים על סיום.
  4. בקטע Data Mapper (מיפוי נתונים) במשימה Data Mapping (מיפוי נתונים), לוחצים על Open Data Mapping Editor, מזינים ערך דומה לערך הבא בשדה Input Value ובוחרים באפשרות EntityId/ConnectorInputPayload כמשתנה מקומי.
    {
      "BoardId": "1922602090",
      "Type": "location",
      "Title": "Location",
      "Id": "location"
    }
     

    בדוגמה הזו, תיווצר העמודה 'מיקום'. אם השילוב יצליח, לפרמטר התגובה connectorOutputPayload של המשימה Columns יהיה ערך שדומה לזה:

    {
      "Id": "location",
      "BoardId": "1922602090"
    }
    

דוגמה – יצירת עמודות של ישות(דירוג)

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
  2. בוחרים באפשרות Columns מהרשימה Entity.
  3. בוחרים את הפעולה Create ולוחצים על סיום.
  4. בקטע Data Mapper (מיפוי נתונים) במשימה Data Mapping (מיפוי נתונים), לוחצים על Open Data Mapping Editor, מזינים ערך דומה לערך הבא בשדה Input Value ובוחרים באפשרות EntityId/ConnectorInputPayload כמשתנה מקומי.
    {
      "BoardId": "1922602090",
      "Type": "rating",
      "Title": "Rating",
      "Id": "rating123"
    }
     

    בדוגמה הזו, העמודה Rating (דירוג) תיווצר. אם השילוב יצליח, לפרמטר התגובה connectorOutputPayload של המשימה Columns יהיה ערך שדומה לזה:

     {
      "Id": "rating123",
      "BoardId": "1922602090"
    }
    

דוגמה – יצירת עמודות של ישות(ציר זמן)

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
  2. בוחרים באפשרות Columns מהרשימה Entity.
  3. בוחרים את הפעולה Create ולוחצים על סיום.
  4. בקטע Data Mapper (מיפוי נתונים) במשימה Data Mapping (מיפוי נתונים), לוחצים על Open Data Mapping Editor, מזינים ערך דומה לערך הבא בשדה Input Value ובוחרים באפשרות EntityId/ConnectorInputPayload כמשתנה מקומי.
      {
      "BoardId": "1922602090",
      "Type": "timeline",
      "Title": "Timeline",
      "Id": "timeline"
    }
     

    בדוגמה הזו, העמודה 'ציר זמן' תיווצר. אם השילוב יצליח, לפרמטר התגובה connectorOutputPayload של המשימה Columns יהיה ערך שדומה לזה:

    {
      "Id": "timeline",
      "BoardId": "1922602090"
    }
    

דוגמה – יצירת עמודות של ישות(שבוע)

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
  2. בוחרים באפשרות Columns מהרשימה Entity.
  3. בוחרים את הפעולה Create ולוחצים על סיום.
  4. בקטע Data Mapper (מיפוי נתונים) במשימה Data Mapping (מיפוי נתונים), לוחצים על Open Data Mapping Editor, מזינים ערך דומה לערך הבא בשדה Input Value ובוחרים באפשרות EntityId/ConnectorInputPayload כמשתנה מקומי.
      {
      "BoardId": "1922602090",
      "Type": "week",
      "Title": "Week",
      "Id": "week_12"
    }
    

    בדוגמה הזו, תיווצר העמודה Week. אם השילוב יצליח, לפרמטר התגובה connectorOutputPayload של המשימה Columns יהיה ערך שדומה לזה:

    {
      "Id": "week_12",
      "BoardId": "1922602090"
    }
    

דוגמה – יצירת עמודות של ישות(שעון עולמי)

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
  2. בוחרים באפשרות Columns מהרשימה Entity.
  3. בוחרים את הפעולה Create ולוחצים על סיום.
  4. בקטע Data Mapper (מיפוי נתונים) במשימה Data Mapping (מיפוי נתונים), לוחצים על Open Data Mapping Editor, מזינים ערך דומה לערך הבא בשדה Input Value ובוחרים באפשרות EntityId/ConnectorInputPayload כמשתנה מקומי.
    {
      "BoardId": "1922602090",
      "Type": "world_clock",
      "Title": "World Clock",
      "Id": "world_clock1"
    }
    

    בדוגמה הזו נוצרת העמודה 'שעון עולמי'. אם השילוב יצליח, לפרמטר התגובה connectorOutputPayload של המשימה Columns יהיה ערך שדומה לזה:

     {
      "Id": "world_clock1",
      "BoardId": "1922602090"
    }
    

דוגמה – יצירת ישות GoogleTestingProject(SubItem)

הישות GoogleTestingProject היא ישות שנחשפת באופן דינמי. באמצעות הישות הזו, אפשר לבצע פעולות CRUD על פריטים ועל כל סוג של עמודה.
  1. בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
  2. בוחרים באפשרות GoogleTestingProject מהרשימה Entity.
  3. בוחרים את הפעולה Create ולוחצים על סיום.
  4. בקטע Data Mapper (מיפוי נתונים) במשימה Data Mapping (מיפוי נתונים), לוחצים על Open Data Mapping Editor, מזינים ערך דומה לערך הבא בשדה Input Value ובוחרים באפשרות EntityId/ConnectorInputPayload כמשתנה מקומי.
    {
      "ParentItemId": "1901835811",
      "Subitem": "Cloud_Sub-Item NAme"
    }
     

    בדוגמה הזו ייווצר SubItem. אם השילוב יצליח, לפרמטר התגובה connectorOutputPayload של המשימה GoogleTestingProject יהיה ערך שדומה לזה:

    {
      "ItemId": "1901893886"
    }
    

דוגמה – עדכון הישות Workspaces

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
  2. בוחרים באפשרות Workspaces מהרשימה Entity.
  3. בוחרים את הפעולה Update ולוחצים על סיום.
  4. בקטע Data Mapper (מיפוי נתונים) במשימה Data Mapping (מיפוי נתונים), לוחצים על Open Data Mapping Editor, מזינים ערך דומה לערך הבא בשדה Input Value ובוחרים באפשרות EntityId/ConnectorInputPayload/FilterClause כמשתנה מקומי.
    {
      "Description": "Updated Workspace",
      "Name": "Riky's Updated Workspace"
    }
    
  5. במקום לציין את entityId, אפשר גם להגדיר את filterClause לערך 964218.

    אם השילוב יצליח, בשדה connectorOutputPayload של משימת המחבר יופיע ערך שדומה לערך הבא:

    {
      "Id": "964218"
    }
    

דוגמה – עדכון של ישות Boards

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
  2. בוחרים באפשרות Boards מהרשימה Entity.
  3. בוחרים את הפעולה Update ולוחצים על סיום.
  4. בקטע Data Mapper (מיפוי נתונים) במשימה Data Mapping (מיפוי נתונים), לוחצים על Open Data Mapping Editor, מזינים ערך דומה לערך הבא בשדה Input Value ובוחרים באפשרות EntityId/ConnectorInputPayload/FilterClause כמשתנה מקומי.
    {
      "State": "archived"
    }
    
  5. במקום לציין את entityId, אפשר גם להגדיר את filterClause לערך 1899875405.

    אם השילוב יצליח, בשדה connectorOutputPayload של משימת המחבר יופיע ערך שדומה לערך הבא:

    {
      "Id": "1899875405"
    }
    

דוגמה – עדכון של ישות מסוג Group

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
  2. בוחרים באפשרות Group מהרשימה Entity.
  3. בוחרים את הפעולה Update ולוחצים על סיום.
  4. בקטע Data Mapper (מיפוי נתונים) במשימה Data Mapping (מיפוי נתונים), לוחצים על Open Data Mapping Editor, מזינים ערך דומה לערך הבא בשדה Input Value ובוחרים באפשרות EntityId/ConnectorInputPayload/FilterClause כמשתנה מקומי.
    {
      "Color": "#FFCB00"
    }
    
  5. במקום לציין את entityId, אפשר גם להגדיר את filterClause ל-Id='new_demo_group4301__1' ול-BoardId='1899350039'.

    אם השילוב יצליח, בשדה connectorOutputPayload של משימת המחבר יופיע ערך שדומה לערך הבא:

    {
      "Id": "new_demo_group4301__1",
      "BoardId": "1899350039"
    }
    

דוגמה – עדכון עמודות של ישות

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
  2. בוחרים באפשרות Columns מהרשימה Entity.
  3. בוחרים את הפעולה Update ולוחצים על סיום.
  4. בקטע Data Mapper (מיפוי נתונים) במשימה Data Mapping (מיפוי נתונים), לוחצים על Open Data Mapping Editor, מזינים ערך דומה לערך הבא בשדה Input Value ובוחרים באפשרות EntityId/ConnectorInputPayload/FilterClause כמשתנה מקומי.
     {
      "Description": "People Information"
    } 
    
  5. במקום לציין את entityId, אפשר גם להגדיר את filterClause לערך 1922602090.

    אם השילוב יצליח, בשדה connectorOutputPayload של משימת המחבר יופיע ערך שדומה לערך הבא:

    {
      "Id": "people1",
      "BoardId": "1922602090"
    }
    

יצירת חיבורים באמצעות Terraform

אפשר להשתמש במשאב של Terraform כדי ליצור חיבור חדש.

כדי ללמוד איך להחיל הגדרות ב-Terraform או להסיר אותן, ראו פקודות בסיסיות ב-Terraform.

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

קבלת עזרה מקהילת Google Cloud

אתם יכולים לפרסם את השאלות שלכם ולדון במחבר הזה בקהילת Google Cloud בפורומים של Cloud.

המאמרים הבאים