Acumatica

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

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

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

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

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

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

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

פעולות

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

הפעולה ExecuteAction

הפעולה הזו מאפשרת לכם לבצע פעולה.

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

פרמטרים של פלט של הפעולה ExecuteAction

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

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

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

דוגמה – ביצוע פעולה

הפעולה הזו מבצעת את הפעולה שצוינה.

1. בתיבת הדו-שיח Configure connector task, לוחצים על Actions.
2. בוחרים את הפעולה ExecuteAction ולוחצים על סיום.
3. בקטע Task Input (קלט המשימה) של המשימה Connectors (מחברים), לוחצים על connectorInputPayload ואז מזינים ערך דומה לערך הבא בשדה Default Value:

   {
   "ActionName": "PrintSalesOrder",   
   "TopLevelEntity": "SalesOrder"
   "EntityRecord": "{
   "Type": {
     "value": "IN"
   },
   "OrderNbr": {
     "value": "000007"
   },
   "CustomerID": {
     "value": "CANDYY"
   },
   "LocationID": {
     "value": "MAIN"
   }}}"

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

[{
"Status": "Success",   
"AffectedRecords": "1"
}] 

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

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

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

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

דוגמה – הצגת רשימה של כל העסקאות ביומן

1. בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
2. בוחרים באפשרות JournalTransaction מהרשימה Entity.
3. בוחרים את הפעולה List ולוחצים על סיום.

דוגמה – הצגת רשימה של כל הזמנות המכירה

1. בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
2. בוחרים באפשרות SalesOrder מהרשימה Entity.
3. בוחרים את הפעולה List ולוחצים על סיום.

דוגמה – קבלת פרטים של הזמנת רכש

1. בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
2. בוחרים באפשרות PurchaseOrder מהרשימה Entity.
3. בוחרים את הפעולה Get ולוחצים על סיום.
4. מגדירים את מזהה הישות כדי לקבל את פרטי הזמנת הרכש. כדי להגדיר את מזהה הישות, בקטע מיפוי נתונים של מיפוי הנתונים, לוחצים על פתיחת כלי מיפוי הנתונים, מזינים 000001 בשדה ערך קלט ובוחרים באפשרות EntityId כמשתנה מקומי.

דוגמה – קבלת פרטים של איש מכירות

1. בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
2. בוחרים באפשרות Salesperson מהרשימה Entity.
3. בוחרים את הפעולה Get ולוחצים על סיום.
4. מגדירים את מזהה הישות כדי לקבל את פרטי איש המכירות. כדי להגדיר את מזהה הישות, בקטע מיפוי נתונים של מיפוי הנתונים, לוחצים על פתיחת כלי מיפוי הנתונים, מזינים SP0001 בשדה ערך קלט ובוחרים באפשרות EntityId כמשתנה מקומי.

דוגמה – קבלת פרטים של ספק

1. בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
2. בוחרים באפשרות Vendor מהרשימה Entity.
3. בוחרים את הפעולה Get ולוחצים על סיום.
4. מגדירים את מזהה הישות כדי לקבל את פרטי הספק. כדי להגדיר את מזהה הישות, בקטע מיפוי נתונים של מיפוי הנתונים, לוחצים על פתיחת כלי מיפוי הנתונים, מזינים ACMEDO בשדה ערך קלט ובוחרים באפשרות EntityId כמשתנה מקומי.

דוגמה – מחיקת חשבון

1. בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
2. בוחרים באפשרות Account מהרשימה Entity.
3. בוחרים את הפעולה Delete ולוחצים על סיום.
4. מגדירים את מזהה הישות כדי למחוק חשבון. כדי להגדיר את מזהה הישות, בקטע מיפוי נתונים של מיפוי הנתונים, לוחצים על פתיחת כלי מיפוי הנתונים, מזינים 10250 בשדה ערך קלט ובוחרים באפשרות EntityId כמשתנה מקומי.

דוגמה – מחיקת לקוח

1. בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
2. בוחרים באפשרות Customer מהרשימה Entity.
3. בוחרים את הפעולה Delete ולוחצים על סיום.
4. מגדירים את מזהה הישות כדי למחוק לקוח. כדי להגדיר את מזהה הישות, בקטע מיפוי נתונים של מיפוי הנתונים, לוחצים על פתיחת כלי מיפוי הנתונים, מזינים SANDWICH בשדה ערך קלט ובוחרים באפשרות EntityId כמשתנה מקומי.

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

1. בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
2. בוחרים באפשרות Salesperson מהרשימה Entity.
3. בוחרים את הפעולה Delete ולוחצים על סיום.
4. מגדירים את מזהה הישות למחיקת איש מכירות. כדי להגדיר את מזהה הישות, בקטע מיפוי נתונים של מיפוי הנתונים, לוחצים על פתיחת כלי מיפוי הנתונים, מזינים SP0004 בשדה ערך קלט ובוחרים באפשרות EntityId כמשתנה מקומי.

דוגמה – יצירת תנועת יומן

1. בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
2. בוחרים באפשרות JournalTransaction מהרשימה Entity.
3. בוחרים את הפעולה Create ולוחצים על סיום.
4. בקטע Task Input (קלט המשימה) של המשימה Connectors (מחברים), לוחצים על connectorInputPayload ואז מזינים ערך דומה לערך הבא בשדה Default Value:

   {
     "Description": "go again",
     "BatchNbr": "000008",
     "CurrencyID": "INR",
     "Module": "GL" 
       }
     

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

   [{
       "BatchNbr": "000016",   "Module": "GL" 
       }]
       

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

1. בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
2. בוחרים באפשרות Customer מהרשימה Entity.
3. בוחרים את הפעולה Create ולוחצים על סיום.
4. בקטע מיפוי נתונים של המשימה, לוחצים על OpenDataMapping עורך ואז מזינים ערך דומה לערך הבא ב field:

   {
        "LocationName": "Primary Location",
        "StatementCycleID": "WEEKLY",
        "CustomerClass": "CSTMRCLAS1",
        "CurrencyID": "INR",
        "CustomerID": "BISCCITY",
        "CustomerName": "Biscuit City Cafe" 
        }

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

   {
        "CustomerID": "BISCCITY"
        }

דוגמה – יצירת הזמנת מכירה

1. בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
2. בוחרים באפשרות SalesOrder מהרשימה Entity.
3. בוחרים את הפעולה Create ולוחצים על סיום.
4. בקטע מיפוי נתונים של המשימה, לוחצים על OpenDataMapping עורך ואז מזינים ערך דומה לערך הבא ב field:

   {
        "Approved": true,
        "BaseCurrencyID": "INR",
        "CashAccount": "10200",
        "ControlTotal": 30.0,
        "CustomerID": "BISCCITY",
        "Description": "SO--0016"
        }

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

   {
        "OrderNbr": "000025",
        "OrderType": "CS" 
        }

דוגמה – יצירת הזמנת רכש

1. בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
2. בוחרים באפשרות PurchaseOrder מהרשימה Entity.
3. בוחרים את הפעולה Create ולוחצים על סיום.
4. בקטע מיפוי נתונים של המשימה, לוחצים על OpenDataMapping עורך ואז מזינים ערך דומה לערך הבא ב field:

   {
        "ControlTotal": 200.0,
        "CurrencyID": "INR",
        "Description": "PO--14",
        "VendorID": "ACMEDO"
        }

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

   {
        "OrderNbr": "000021",
        "Type": "Normal"
        }

דוגמה – יצירת איש מכירות

1. בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
2. בוחרים באפשרות Salesperson מהרשימה Entity.
3. בוחרים את הפעולה Create ולוחצים על סיום.
4. בקטע מיפוי נתונים של המשימה, לוחצים על OpenDataMapping עורך ואז מזינים ערך דומה לערך הבא ב field:

   {
        "Name": "Sales person 0009",
        "SalespersonID": "SP0009",
        "DefaultCommission": 10.0
        }

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

   {
        "SalespersonID": "SP0009" 
        }

דוגמה – יצירת ספק

1. בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
2. בוחרים באפשרות Vendor מהרשימה Entity.
3. בוחרים את הפעולה Create ולוחצים על סיום.
4. בקטע מיפוי נתונים של המשימה, לוחצים על OpenDataMapping עורך ואז מזינים ערך דומה לערך הבא ב field:

   {
        "APAccount": "20000",
        "CashAccount": "10200",
        "LocationName": "Secondary Location",
        "MaxReceipt": 100.0,
        "MinReceipt": 0.0,
        "VendorClass": "DEFAULTV",
        "VendorID": "ALLFRUITS"
        }

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

   {
        "VendorID": "ALLFRUITS"
        }

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

1. בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
2. בוחרים באפשרות Bill מהרשימה Entity.
3. בוחרים את הפעולה Create ולוחצים על סיום.
4. בקטע מיפוי נתונים של המשימה, לוחצים על OpenDataMapping עורך ואז מזינים ערך דומה לערך הבא ב field:

   {
        "Amount": 10.0,
        "Description": "new test",
        "DueDate": "2024-01-26 00:00:00.0",
        "LocationID": "MAIN",
        "Terms": "30D",
        "Vendor": "TESTVENDOR"
        }

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

   {
        "ReferenceNbr": "000020",
        "Type": "Bill"
        }

דוגמה – יצירת בדיקה

1. בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
2. בוחרים באפשרות Check מהרשימה Entity.
3. בוחרים את הפעולה Create ולוחצים על סיום.
4. בקטע מיפוי נתונים של המשימה, לוחצים על OpenDataMapping עורך ואז מזינים ערך דומה לערך הבא ב field:

   {
        "Description": "check check check",
        "CurrencyID": "INR",
        "CashAccount": "10200",
        "PaymentMethod": "CHECK",
        "Vendor": "ACMEDO"
        }

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

   {
        "ReferenceNbr": "000013",
        "Type": "Payment"
        }

דוגמה – יצירת חשבונית מכירה

1. בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
2. בוחרים באפשרות SalesInvoice מהרשימה Entity.
3. בוחרים את הפעולה Create ולוחצים על סיום.
4. בקטע מיפוי נתונים של המשימה, לוחצים על OpenDataMapping עורך ואז מזינים ערך דומה לערך הבא ב field:

   {
        "Description": "testing custom",
        "Amount": 10.0,
        "Balance": 0.0,
        "CustomerID": "BISCCITY",
        "DueDate": "2023-04-21 00:00:00.0"
        }

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

   {
        "ReferenceNbr": "000024",
        "Type": "Invoice"
        }

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

1. בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
2. בוחרים באפשרות Invoice מהרשימה Entity.
3. בוחרים את הפעולה Create ולוחצים על סיום.
4. בקטע מיפוי נתונים של המשימה, לוחצים על OpenDataMapping עורך ואז מזינים ערך דומה לערך הבא ב field:

   { 
        "Terms": "30D",
        "Description": "forever",
        "LocationID": "MAIN",
        "Customer": "BISCCITY", 
        "LinkARAccount": "11000"
        }

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

   {
        "ReferenceNbr": "000026",
        "Type": "Invoice"
        }

דוגמה – עדכון פרטי הזמנת מכירות

1. בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
2. בוחרים באפשרות SalesOrder מהרשימה Entity.
3. בוחרים את הפעולה Update ולוחצים על סיום.
4. בקטע Task Input (קלט המשימה) של המשימה Connectors (מחברים), לוחצים על connectorInputPayload ואז מזינים ערך דומה לערך הבא בשדה Default Value:

   {
         "Approved": true,
         "Description": "SO--0014"
           }
     

5. לוחצים על entityId ואז מזינים 000025 בשדה ערך ברירת מחדל.

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

   [{
         "OrderNbr": "000025",
         "OrderType": "CS"
           }]
     

דוגמה – עדכון פרטי תשלום

1. בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
2. בוחרים באפשרות Payment מהרשימה Entity.
3. בוחרים את הפעולה Update ולוחצים על סיום.
4. מגדירים את מזהה הישות כדי לעדכן את פרטי התשלום. כדי להגדיר את מזהה הישות, בקטע Data mapper של Tasks, לוחצים על FilterClause ואז מזינים ReferenceNbr='000007' AND Type='Payment' בשדה שמופיע.
5. בקטע מיפוי נתונים של המשימה, לוחצים על OpenDataMapping editor ומזינים ערך דומה לערך הבא ב field:

   {
   "CurrencyID": "INR"
   }
   

במקום לציין את entityId, אפשר גם להגדיר את filterClause לערך ReferenceNbr='000007' AND Type='Payment'.

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

{
"ReferenceNbr": "000007",
"Type": "Payment" 
}

דוגמה – עדכון פרטי עסקה בפרויקט

1. בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
2. בוחרים באפשרות ProjectTransaction מהרשימה Entity.
3. בוחרים את הפעולה Update ולוחצים על סיום.
4. מגדירים את מזהה הישות כדי לעדכן את פרטי העסקה של הפרויקט. כדי להגדיר את מזהה הישות, בקטע Data mapper של Tasks, לוחצים על FilterClause ואז מזינים Module='PM' AND ReferenceNbr='PM00000003' בשדה שמופיע.
5. בקטע מיפוי נתונים של המשימה, לוחצים על OpenDataMapping editor ומזינים ערך דומה לערך הבא ב field:

   {
   "Description": "updated"
   }
   

במקום לציין את entityId, אפשר גם להגדיר את filterClause לערך Module='PM' AND ReferenceNbr='PM00000003'.

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

{
"Module": "PM",
"ReferenceNbr": "PM00000003"
}

דוגמה – עדכון פרטי עסקה של תנועה ביומן

1. בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
2. בוחרים באפשרות JournalTransaction מהרשימה Entity.
3. בוחרים את הפעולה Update ולוחצים על סיום.
4. מגדירים את מזהה הישות כדי לעדכן את פרטי העסקה ביומן. כדי להגדיר את מזהה הישות, בקטע Data mapper של Tasks, לוחצים על FilterClause ואז מזינים BatchNbr='000016' AND Module='GL' בשדה שמופיע.
5. בקטע מיפוי נתונים של המשימה, לוחצים על OpenDataMapping editor ומזינים ערך דומה לערך הבא ב field:

    
   {
   "BatchNbr": "000012",
   "CurrencyID": "INR",
   "Description": "updated",
   "Module": "GL"
   }
   

במקום לציין את entityId, אפשר גם להגדיר את filterClause לערך BatchNbr='000016' AND Module='GL'.

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

{
"BatchNbr": "000012",
"Module": "GL"
}

דוגמה – עדכון פרטי לקוח

1. בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
2. בוחרים באפשרות Customer מהרשימה Entity.
3. בוחרים את הפעולה Update ולוחצים על סיום.
4. הגדרת מזהה הישות לעדכון פרטי לקוח. כדי להגדיר את מזהה הישות, בקטע Data mapper של Tasks, לוחצים על entityId ואז מזינים BISCCITY בשדה שמופיע.
5. בקטע מיפוי נתונים של המשימה, לוחצים על OpenDataMapping editor ומזינים ערך דומה לערך הבא ב field:

   {
   "LocationName": "Primary Location",
   "StatementCycleID": "DAILY",
   "CustomerID": "BISCCITY",
   "CustomerClass": "CSTMRCLAS1",
   "Terms": "30D"
   }
   

במקום לציין את entityId, אפשר גם להגדיר את filterClause לערך BISCCITY.

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

 {
"CustomerID": "BISCCITY"
} 

דוגמה – עדכון פרטים של הזמנת רכש

1. בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
2. בוחרים באפשרות PurchaseOrder מהרשימה Entity.
3. בוחרים את הפעולה Update ולוחצים על סיום.
4. מגדירים את מזהה הישות כדי לעדכן את פרטי הזמנת הרכש. כדי להגדיר את מזהה הישות, בקטע Data mapper של Tasks, לוחצים על FilterClause ואז מזינים OrderNbr='000025' AND OrderType='CS' בשדה שמופיע.
5. בקטע מיפוי נתונים של המשימה, לוחצים על OpenDataMapping editor ומזינים ערך דומה לערך הבא ב field:

   {
   "Approved": true,
   "Description": "SO--0014"
   }
   

במקום לציין את entityId, אפשר גם להגדיר את filterClause לערך OrderNbr='000025' AND OrderType='CS'.

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

{
"OrderNbr": "000025",
"OrderType": "CS"
}

דוגמה – עדכון פרטים של איש מכירות

1. בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
2. בוחרים באפשרות Salesperson מהרשימה Entity.
3. בוחרים את הפעולה Update ולוחצים על סיום.
4. מגדירים את מזהה הישות כדי לעדכן את הפרטים של איש מכירות. כדי להגדיר את מזהה הישות, בקטע Data mapper של Tasks, לוחצים על entityId ואז מזינים SP0009 בשדה שמופיע.
5. בקטע מיפוי נתונים של המשימה, לוחצים על OpenDataMapping editor ומזינים ערך דומה לערך הבא ב field:

   {
   "DefaultCommission": 20.0
   }
   

במקום לציין את entityId, אפשר גם להגדיר את filterClause לערך SP0009.

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

{
"SalespersonID": "SP0009"
}

דוגמה – עדכון פרטי חשבון לתשלום

1. בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
2. בוחרים באפשרות Bill מהרשימה Entity.
3. בוחרים את הפעולה Update ולוחצים על סיום.
4. מגדירים את מזהה הישות כדי לעדכן את פרטי החיוב. כדי להגדיר את מזהה הישות, בקטע Data mapper של Tasks, לוחצים על FilterClause ואז מזינים ReferenceNbr='000019' AND Type='Bill' בשדה שמופיע.
5. בקטע מיפוי נתונים של המשימה, לוחצים על OpenDataMapping editor ומזינים ערך דומה לערך הבא ב field:

   {
   "Amount": 10.0,
   "Description": "updated"
   }
   

במקום לציין את entityId, אפשר גם להגדיר את filterClause לערך ReferenceNbr='000019' AND Type='Bill'.

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

{
"ReferenceNbr": "000019",
"Type": "Bill"
}

דוגמה – עדכון פרטי צ'ק

1. בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
2. בוחרים באפשרות Check מהרשימה Entity.
3. בוחרים את הפעולה Update ולוחצים על סיום.
4. מגדירים את מזהה הישות כדי לעדכן את פרטי הבדיקה. כדי להגדיר את מזהה הישות, בקטע Data mapper של Tasks, לוחצים על FilterClause ואז מזינים ReferenceNbr='000013' AND Type='Payment' בשדה שמופיע.
5. בקטע מיפוי נתונים של המשימה, לוחצים על OpenDataMapping editor ומזינים ערך דומה לערך הבא ב field:

   {
   "Description": "updated check"
   }
   

במקום לציין את entityId, אפשר גם להגדיר את filterClause לערך ReferenceNbr='000013' AND Type='Payment'.

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

{
"ReferenceNbr": "000013",
"Type": "Payment"
}

דוגמה – עדכון פרטים בחשבונית מכירה

1. בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
2. בוחרים באפשרות SalesInvoice מהרשימה Entity.
3. בוחרים את הפעולה Update ולוחצים על סיום.
4. מגדירים את מזהה הישות כדי לעדכן את פרטי חשבונית המכירה. כדי להגדיר את מזהה הישות, בקטע Data mapper של Tasks, לוחצים על FilterClause ואז מזינים ReferenceNbr='000024' בשדה שמופיע.
5. בקטע מיפוי נתונים של המשימה, לוחצים על OpenDataMapping editor ומזינים ערך דומה לערך הבא ב field:

    
   {
   "Description": "shipping pastries"
   }
   

במקום לציין את entityId, אפשר גם להגדיר את filterClause לערך ReferenceNbr='000024'.

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

 {
"ReferenceNbr": "000024",
"Type": "Invoice"
}