‫Google משתמשת בטכנולוגיית AI כדי לתרגם תוכן לשפה המועדפת עליך. בתרגומים כאלו עשויות להיות שגיאות.

NetSuite

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

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

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

בפרויקט שלכם ב-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)
  במאמר הפעלת שירותים מוסבר איך להפעיל שירותים.
אם השירותים או ההרשאות האלה לא הופעלו בפרויקט שלכם בעבר, תתבקשו להפעיל אותם כשאתם מגדירים את המחבר.

הגדרת המחבר

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

במסוף Cloud, עוברים לדף Integration Connectors > Connections ובוחרים או יוצרים פרויקט בענן.
כניסה לדף Connections
לוחצים על + יצירת חיבור חדש כדי לפתוח את הדף יצירת חיבור.
בקטע מיקום, בוחרים את המיקום של החיבור.
1. אזור: בוחרים מיקום מהרשימה הנפתחת.
  אזורים נתמכים למחברים:
  רשימה של כל האזורים הנתמכים מופיעה במאמר מיקומים.
2. לוחצים על הבא.
בקטע פרטי החיבור, ממלאים את הפרטים הבאים:
1. מחבר: בוחרים באפשרות Netsuite מהרשימה הנפתחת של המחברים הזמינים.
2. גרסת כלי החיבור: בוחרים את גרסת כלי החיבור מהרשימה הנפתחת של הגרסאות הזמינות.
3. בשדה Connection Name (שם החיבור), מזינים שם למופע החיבור.
  השמות של החיבורים צריכים לעמוד בקריטריונים הבאים:
  - שמות החיבורים יכולים לכלול אותיות, מספרים או מקפים.
  - האותיות צריכות להיות קטנות.
  - שמות החיבורים צריכים להתחיל באות ולהסתיים באות או במספר.
  - שמות החיבורים לא יכולים לכלול יותר מ-49 תווים.
4. אופציונלי: מזינים תיאור למופע החיבור.
5. אופציונלי: מפעילים את Cloud Logging ואז בוחרים רמת יומן. כברירת מחדל, רמת היומן מוגדרת כ-Error.
6. חשבון שירות: בוחרים חשבון שירות שיש לו את התפקידים הנדרשים.
7. אופציונלי: מגדירים את ההגדרות של צומת החיבור:
  - מספר מינימלי של צמתים: מזינים את המספר המינימלי של צמתי חיבור.
  - מספר הצמתים המקסימלי: מזינים את מספר צמתי החיבור המקסימלי.
  צומת הוא יחידה (או עותק) של חיבור שמבצעת עיבוד של עסקאות. כדי לעבד יותר עסקאות לחיבור נדרשים יותר צמתים, ולהפך: כדי לעבד פחות עסקאות נדרשים פחות צמתים. כדי להבין איך הצמתים משפיעים על התמחור של המחבר, אפשר לעיין במאמר בנושא תמחור של צמתי חיבור. אם לא מזינים ערכים, כברירת מחדל, מספר הצמתים המינימלי מוגדר כ-2 (לזמינות טובה יותר) ומספר הצמתים המקסימלי מוגדר כ-50.
8. מזהה חשבון: החשבון של החברה ששם המשתמש משויך אליו ב-NetSuite.
9. מצב עמודה מצטברת: מציין איך צריך להתייחס לעמודות מצטברות.
10. מזהה אפליקציה: החל מגרסה 2020.1, בקשות אל NetSuite מחייבות מזהה אפליקציה.
11. ‫Custom Field Permissions: רשימה מופרדת בפסיקים של הרשאות לשדות בהתאמה אישית. האפשרות הזו מאפשרת שליטה רבה יותר מאשר IncludeCustomFieldColumns .
12. Include Child Tables: ערך בוליאני שמציין אם להציג טבלאות משניות.
13. Include Custom Field Columns: ערך בוליאני שמציין אם רוצים לכלול עמודות של שדות מותאמים אישית.
14. Include Custom List Tables: ערך בוליאני שמציין אם רוצים להשתמש בטבלאות שמבוססות על רשימות בהתאמה אישית.
15. Include Custom Record Tables (הכללת טבלאות של רשומות בהתאמה אישית): ערך בוליאני שמציין אם רוצים להשתמש בטבלאות שמבוססות על סוגי רשומות בהתאמה אישית.
16. Include Reference Columns: רשימה מופרדת בפסיקים שמייצגת את העמודות שצריך לכלול כשמאחזרים נתונים משדה שמייצג הפניה לרשומה.
17. מספר מקסימלי של סשנים בו-זמניים: המספר המקסימלי של סשנים בו-זמניים שזמינים לשימוש בחיבור.
18. פורמט התאריך ב-NetSuite: פורמט התאריך המועדף שמוגדר בממשק המשתמש של NetSuite.
19. פורמט תאריך ארוך של Net Suite: פורמט התאריך הארוך המועדף שמוגדר בממשק המשתמש של NetSuite.
20. תיקיית מטא-נתונים של NetSuite: נתיב לספרייה שממנה יורדו קובצי מטא-נתונים מ-NetSuite. כדאי להגדיר את האפשרות הזו כדי לשפר את הביצועים.
21. דיווח על מספרים כפולים כמספרים עשרוניים: מציין אם יש לדווח על מספרים כפולים כמספרים עשרוניים.
22. בקשת עסקאות שנשמרו: ערך בוליאני שמציין אם רוצים לבקש עסקאות שנשמרו כשמאחזרים עסקאות מ-NetSuite.
23. ‫Role Id: ‏RoleId הוא InternalId של התפקיד שישמש לכניסה ל-NetSuite. כדי להשתמש בתפקיד ברירת המחדל של המשתמש, משאירים את השדה ריק.
24. סכימה: סוג הסכימה שבה רוצים להשתמש. אפשר לבחור באחד מהערכים הבאים:
  - ‫SuiteTalk – לקישוריות מבוססת SOAP.
  - ‫SuiteSQL – לקישוריות מבוססת REST.
25. שימוש בשירותים אסינכרוניים: ערך בוליאני שמציין אם רוצים להשתמש בשירותים אסינכרוניים כשמוסיפים, מעדכנים ומוחקים.
26. שימוש בשמות פנימיים להתאמות אישיות: ערך בוליאני שמציין אם רוצים להשתמש בשמות פנימיים להתאמות אישיות.
27. שימוש בפעולות Upsert: ערך בוליאני שמציין אם רוצים לבצע פעולת Upsert כשמשתמשים בפעולת Insert.
28. הסטה מאזור הזמן של המשתמש: ההסטה מאזור הזמן של המשתמש כפי שהוגדרה בהעדפות NetSuite בקטע Home (דף הבית) --> Preferences (העדפות) --> Time Zone (אזור זמן). לדוגמה: EST.
29. עומק סריקת השורות: מספר השורות שייסרקו כשמגדירים באופן דינמי את העמודות של הטבלה.
30. (אופציונלי) בקטע הגדרות מתקדמות, מסמנים את התיבה שימוש ב-proxy כדי להגדיר שרת proxy לחיבור, ומגדירים את הערכים הבאים:
31. אופציונלי: לוחצים על + הוספת תווית כדי להוסיף תווית לקישור בצורה של צמד מפתח/ערך.
32. לוחצים על הבא.
בקטע יעדים, מזינים את הפרטים של המארח המרוחק (מערכת העורף) שאליו רוצים להתחבר.
1. סוג היעד: אפשר לציין את פרטי היעד ככתובת מארח או כקובץ מצורף של שירות. בוחרים באחד מסוגי היעדים הבאים:
  - כתובת המארח: אם רוצים לציין את שם המארח או את כתובת ה-IP של היעד.
  - צירוף שירות: אם רוצים לציין את נקודת הקצה הפרטית לכתובות ה-IP הפנימיות. קובץ ה-Service Attachment מאפשר לכם להסתיר את כתובות ה-IP הפנימיות מהרשת החיצונית. אפשר ליצור קובץ מצורף עם השירות ב-Google Cloud באמצעות התכונה Private Service Connect. מידע על הגדרת Private Service Connect זמין במאמר פרסום שירותים מנוהלים.
  בהתאם לסוג היעד שבחרתם, מזינים את כתובת המארח או את שם קובץ השירות.
  
  כדי להזין יעדים נוספים, לוחצים על +הוספת יעד.
2. לוחצים על הבא.
בקטע אימות, מזינים את פרטי האימות.
1. בוחרים סוג אימות ומזינים את הפרטים הרלוונטיים.
  החיבור ל-Netsuite תומך בסוגי האימות הבאים:
  - שם משתמש וסיסמה
  - אימות מבוסס-טוקן
  - הרשאת קוד אימות OAuth 2.0
2. לוחצים על הבא.
בדיקה: בודקים את פרטי החיבור והאימות.
לוחצים על יצירה.

הגדרת אימות

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

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

אימות מבוסס טוקן
אימות מבוסס-טוקן ל-Netsuite. אפשר להשתמש בזה גם בתוכניות SuiteTalk וגם בתוכניות SuiteQL.
- מזהה לקוח OAuth: טוקן הצרכן שמוצג כשיוצרים את האפליקציה.
- סוד של לקוח OAuth: סוד ב-Secret Manager שמכיל את סוד הצרכן שמוצג כשיוצרים את האפליקציה.
- אסימון גישה ל-OAuth: מזהה האסימון כשנוצר אסימון הגישה.
- סוד של אסימון גישה ל-OAuth: סוד ב-Secret Manager שמכיל את סוד האסימון כשנוצר אסימון הגישה.

OAuth 2.0 – קוד הרשאה

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

Client ID: מזהה הלקוח שמשמש לבקשת אסימוני גישה.
היקפים: רשימה מופרדת בפסיקים של ההיקפים הנדרשים.
סוד לקוח: סוד הלקוח שמשמש לבקשת טוקנים של גישה.

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

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

שלבים נוספים אחרי יצירת החיבור

אם בחרתם באפשרות OAuth 2.0 - Authorization code לאימות, אתם צריכים לבצע את השלבים הנוספים הבאים אחרי יצירת החיבור:

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

אישור מחדש של קוד הרשאה

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

לוחצים על החיבור הרצוי בדף החיבורים.
ייפתח הדף עם פרטי החיבור.
לוחצים על עריכה כדי לערוך את פרטי החיבור.
בודקים את הפרטים של OAuth 2.0 – קוד הרשאה בקטע אימות.
אם צריך, מבצעים את השינויים הנדרשים.
לוחצים על Save. הלחיצה תעביר אתכם לדף פרטי החיבור.
בקטע אימות, לוחצים על עריכת הרשאה. מוצגת החלונית Authorize (אישור).
לוחצים על Authorize.
אם ההרשאה מתבצעת בהצלחה, סטטוס החיבור יהיה פעיל בדף החיבורים.

הגדרת NetSuite

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

יוצרים שילוב חדש ב-NetSuite.
מזינים את פרטי השילוב, כמו שם, ומפעילים אימות מבוסס-אסימון.
מציינים כתובת URL לקריאה חוזרת (callback), כמו https:cloud.google.com/connectors/oauth?e=ApplicationIntegrationConnectorPaginatedFieldsLaunch%3A%3AApplicationIntegrationConnectorPaginatedFieldsEnabled&project=PROJECT_NAME.
אחרי ששולחים את השילוב, מקבלים מזהה לקוח וסוד לקוח. שומרים את הפרטים האלה.
הגדרה של רשומת משתמש לשילוב.
כדי ליצור טוקן וסוד, עוברים אל דף הבית, בוחרים באפשרות Manage Access Tokens (ניהול טוקנים לגישה) ולוחצים על New My Access Token (טוקן חדש לגישה). תשתמשו בפרטים האלה כדי ליצור אימות מבוסס-אסימון ב- Google Cloud.

מידע על הגדרת Postman זמין במאמר ייבוא של Postman Collection.

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

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

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

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

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

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

שימוש בחיבור NetSuite בשילוב

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

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

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

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

ישות	פעולות נתמכות
CreditMemo	LIST, GET, CREATE, UPDATE
לקוח/ה	LIST, GET, CREATE, UPDATE
CustomerPayment	LIST, GET, CREATE, UPDATE
ItemFulfillment	LIST, GET, CREATE
JournalEntry	LIST, GET, CREATE
PurchaseOrder	LIST, GET, CREATE, UPDATE
ReturnAuthorization	LIST, GET, CREATE
SalesOrder	LIST, GET, CREATE, UPDATE
ספק	LIST, GET, CREATE, UPDATE
VendorBill	LIST, GET, CREATE, UPDATE
VendorCredit	LIST, GET, CREATE, UPDATE
VendorPayment	LIST, GET, CREATE, UPDATE
CashRefund	LIST, GET, CREATE
CashSale	LIST, GET, CREATE
CustomerDeposit	LIST, GET
CustomerRefund	LIST, GET
עובד	LIST, GET
הערכה	LIST, GET
קובץ	LIST, GET
InventoryAdjustment	LIST, GET, CREATE
InventoryItem	LIST, GET
ItemReceipt	LIST, GET
הזדמנות	LIST, GET
PaycheckJournal	LIST, GET, CREATE
SupportCase	LIST, GET
SupportCaseIssue	LIST, GET
TransferOrder	LIST, GET, CREATE
VendorReturnAuthorization	LIST, GET
WorkOrder	LIST, GET
AssemblyItem	LIST, GET
תא אחסון	LIST, GET
CustomerCategory	LIST, GET
ItemGroup	LIST, GET
KitItem	LIST, GET
LotNumberedAssemblyItem	LIST, GET
LotNumberedInventoryItem	LIST, GET
NonInventoryPurchaseItem	LIST, GET
NonInventoryResaleItem	LIST, GET
NonInventorySaleItem	LIST, GET
OtherChargePurchaseItem	LIST, GET
OtherChargeResaleItem	LIST, GET
OtherChargeSaleItem	LIST, GET
SerializedAssemblyItem	LIST, GET
SerializedInventoryItem	LIST, GET
ServicePurchaseItem	LIST, GET
ServiceResaleItem	LIST, GET
ServiceSaleItem	LIST, GET
CreditMemo_itemList	צור
Invoice_itemList	צור
PurchaseOrder_itemList	צור
SalesOrder_itemList	צור
VendorBill_itemList	צור
VendorCredit_itemList	צור
VendorPayment_applyList	צור

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

    "`<ItemList>`\n" +
              "  <Row>\n" +
                      "    <ItemList_Item_InternalId>656</ItemList_Item_InternalId>\n" +
                      "    <ItemList_Item_Name>Iphone 15Pro</ItemList_Item_Name>\n" +
                      "    <ItemList_Line>1</ItemList_Line>\n" +
                      "    <ItemList_Description>Canon PowerShot Camera Test</ItemList_Description>\n" +
                      "    <ItemList_Amount>8500.0</ItemList_Amount>\n" +
                      "    <ItemList_Quantity>17.0</ItemList_Quantity>\n" +
                      "    <ItemList_Price_InternalId>1</ItemList_Price_InternalId>\n" +
                      "    <ItemList_Price_Name>List Price</ItemList_Price_Name>\n" +
                      "    <ItemList_Rate>500.00</ItemList_Rate>\n" +
                      "    <ItemList_Location_InternalId>1</ItemList_Location_InternalId>\n" +
                      "    <ItemList_Location_Name>02: NewYork</ItemList_Location_Name>\n" +
                      "    <ItemList_TaxCode_InternalId>-7</ItemList_TaxCode_InternalId>\n" +
                      "    <ItemList_TaxCode_Name>-Not Taxable-</ItemList_TaxCode_Name>\n" +
                      "    <ItemList_ShipGroup>1</ItemList_ShipGroup>\n" +
                      "    <ItemList_ItemIsFulfilled>false</ItemList_ItemIsFulfilled>\n" +
                      "    <CustomFieldListAggregate>\n" +
                      "      <CustomField InternalId=\"4779\" Type=\"platformCore:StringCustomFieldRef\" ScriptId=\"custcol121\">\n" +
                      "        <Value>1</Value>\n" +
                      "      </CustomField>\n" +
                      "    </CustomFieldListAggregate>\n" +
                      "  </Row>\n" +
                      "  <Row>\n" +
                      "    <ItemList_Item_InternalId>656</ItemList_Item_InternalId>\n" +
                      "    <ItemList_Item_Name>Iphone 15Pro</ItemList_Item_Name>\n" +
                      "    <ItemList_Line>4</ItemList_Line>\n" +
                      "    <ItemList_Description>Canon PowerShot Camera Test</ItemList_Description>\n" +
                      "    <ItemList_Amount>8500.0</ItemList_Amount>\n" +
                      "    <ItemList_Quantity>17.0</ItemList_Quantity>\n" +
                      "    <ItemList_Price_InternalId>1</ItemList_Price_InternalId>\n" +
                      "    <ItemList_Price_Name>List Price</ItemList_Price_Name>\n" +
                      "    <ItemList_Rate>500.00</ItemList_Rate>\n" +
                      "    <ItemList_Location_InternalId>2</ItemList_Location_InternalId>\n" +
                      "    <ItemList_Location_Name>01: California</ItemList_Location_Name>\n" +
                      "    <ItemList_TaxCode_InternalId>-7</ItemList_TaxCode_InternalId>\n" +
                      "    <ItemList_TaxCode_Name>-Not Taxable-</ItemList_TaxCode_Name>\n" +
                      "    <ItemList_ShipGroup>1</ItemList_ShipGroup>\n" +
                      "    <ItemList_ItemIsFulfilled>false</ItemList_ItemIsFulfilled>\n" +
                      "    <CustomFieldListAggregate>\n" +
                      "      <CustomField InternalId=\"4776\" Type=\"platformCore:StringCustomFieldRef\" ScriptId=\"custcol121\">\n" +
                      "        <Value>4</Value>\n" +
                      "      </CustomField>\n" +
                      "    </CustomFieldListAggregate>\n" +
                      "  </Row>\n" +
     "`</ItemList>`;"

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

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

דוגמה – קבלת רשומה של CreditMemo

בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
בוחרים באפשרות CreditMemo מהרשימה Entity.
בוחרים את הפעולה GET ולוחצים על סיום.
מגדירים את מזהה הישות ל-1083723, שהוא המפתח שצריך להעביר. כדי להגדיר את מזהה הישות, בקטע מיפוי נתונים של מיפוי הנתונים, לוחצים על פתיחת כלי מיפוי הנתונים, מזינים 1083723 בשדה ערך קלט ובוחרים באפשרות EntityId כמשתנה מקומי.
מעבירים את מזהה הישות ישירות. העברת מזהה ישות עלולה להקפיץ הודעת שגיאה אם קיימים מפתחות מורכבים. במקרים כאלה, צריך להשתמש בפסוקית הסינון כדי לציין את המזהה.

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

בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
בוחרים באפשרות PurchaseOrder מהרשימה Entity.
בוחרים את הפעולה Create ולוחצים על סיום.

בקטע Data Mapper (מיפוי נתונים) במשימה Data Mapping (מיפוי נתונים), לוחצים על Open Data Mapping Editor, מזינים ערך דומה לערך הבא בשדה Input Value ובוחרים באפשרות EntityId/ConnectorInputPayload כמשתנה מקומי.

{
          "Entity_InternalId": "2041",
          "Location_InternalId": "6",
          " + "<ItemList>\n" +
              "  <Row>\n" +
                  "    <ItemList_Item_InternalId>979</ItemList_Item_InternalId>\n" +
                  "    <ItemList_Line>2</ItemList_Line>\n" +
                  "    <ItemList_Amount>66500.0</ItemList_Amount>\n" +
                  "  </Row>\n" +
                  "  <Row>\n" +
                  "    <ItemList_Item_InternalId>979</ItemList_Item_InternalId>\n" +
                  "    <ItemList_Line>3</ItemList_Line>\n" +
                  "    <ItemList_Amount>16500.0</ItemList_Amount>\n" +
                  "  </Row>\n" +
                  "</ItemList>" + ",
          "Email": "222larabrown@gmail.com"
      }

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

 {
    "InternalId": "1093053"
  }

דוגמה – יצירה של רשומה מסוג ReturnAuthorization

בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
בוחרים באפשרות ReturnAuthorization מהרשימה Entity.
בוחרים את הפעולה Create ולוחצים על סיום.

{
          "Entity_InternalId": "1709",
          "Status": "Approved",
          " + "<ItemList>\n" +
              "  <Row>\n" +
                  "    <ItemList_Item_InternalId>945</ItemList_Item_InternalId>\n" +
                  "    <ItemList_Line>2</ItemList_Line>\n" +
                  "    <ItemList_Amount>2500.0</ItemList_Amount>\n" +
                  "  </Row>\n" +
                  "  <Row>\n" +
                  "    <ItemList_Item_InternalId>945</ItemList_Item_InternalId>\n" +
                  "    <ItemList_Line>3</ItemList_Line>\n" +
                  "    <ItemList_Amount>16500.0</ItemList_Amount>\n" +
                  "  </Row>\n" +
                  "</ItemList>" + "
      }

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

 {
    "InternalId": "1093053"
  }

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

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

{
          " + "<ItemList>\n" +
              "  <Row>\n" +
                  "    <ItemList_Item_InternalId>945</ItemList_Item_InternalId>\n" +
                  "    <ItemList_Line>1</ItemList_Line>\n" +
                  "    <ItemList_Amount>9990900.0</ItemList_Amount>\n" +
                  "  </Row>\n" +
                  "  <Row>\n" +
                  "    <ItemList_Item_InternalId>945</ItemList_Item_InternalId>\n" +
                  "    <ItemList_Amount>99900.0</ItemList_Amount>\n" +
                  "  </Row>\n" +
                  "</ItemList>" + ",
          "Entity_InternalId": "1709"
      }

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

 {
    "InternalId": "1093053"
  }

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

בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
בוחרים באפשרות CreditMemo_itemList מהרשימה Entity.
בוחרים את הפעולה Create ולוחצים על סיום.
בקטע Data Mapper (מיפוי נתונים) במשימה Data Mapping (מיפוי נתונים), לוחצים על Open Data Mapping Editor, מזינים ערך דומה לערך הבא בשדה Input Value ובוחרים באפשרות EntityId/ConnectorInputPayload כמשתנה מקומי.
```
{
    "ItemList_Item_InternalId": "945",
    "Entity_InternalId": "1709",
    "Location_InternalId": "5",
    "ItemList_Amount": 7777777.0,
    "ItemList_Description": "Created"
  }
  
```
אם השילוב מצליח, לפרמטר התגובה connectorOutputPayload של המשימה CreditMemo_itemList יש ערך שדומה לזה:
```
 {
    "InternalId": "1093053",
    "ListId": "1"
  }
  
```

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

בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
בוחרים באפשרות 'לקוח' מתוך הרשימה Entity.
בוחרים את הפעולה Create ולוחצים על סיום.
בקטע Data Mapper (מיפוי נתונים) במשימה Data Mapping (מיפוי נתונים), לוחצים על Open Data Mapping Editor, מזינים ערך דומה לערך הבא בשדה Input Value ובוחרים באפשרות EntityId/ConnectorInputPayload כמשתנה מקומי.
```
 {
    "CompanyName": "Bcone8",
    "Email": "222larabrown@gmail.com"
  }
  
```
אם השילוב מצליח, לפרמטר התגובה connectorOutputPayload של המשימה Customer יש ערך שדומה לזה:
```
{
    "InternalId": "4767"
  } 
  
```

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

בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
בוחרים באפשרות Invoice_itemList מהרשימה Entity.
בוחרים את הפעולה Create ולוחצים על סיום.
בקטע Data Mapper (מיפוי נתונים) במשימה Data Mapping (מיפוי נתונים), לוחצים על Open Data Mapping Editor, מזינים ערך דומה לערך הבא בשדה Input Value ובוחרים באפשרות EntityId/ConnectorInputPayload כמשתנה מקומי.
```
 {
    "ItemList_Item_InternalId": "945",
    "Entity_InternalId": "1709",
    "ItemList_Amount": 945.0,
    "Item": "InvoiceItem"
  }
  
```
אם השילוב מצליח, לפרמטר התגובה connectorOutputPayload של המשימה Invoice_itemList יש ערך שדומה לזה:
```
 {
    "InternalId": "1093052",
    "ListId": "1"
  } 
  
```

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

בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
בוחרים באפשרות CustomerPayment מהרשימה Entity.
בוחרים את הפעולה Create ולוחצים על סיום.
בקטע Data Mapper (מיפוי נתונים) במשימה Data Mapping (מיפוי נתונים), לוחצים על Open Data Mapping Editor, מזינים ערך דומה לערך הבא בשדה Input Value ובוחרים באפשרות EntityId/ConnectorInputPayload כמשתנה מקומי.
```
 {
    "Customer_InternalId": "1714",
    "Payment": 9999.0
  } 
  
```
אם השילוב מצליח, לפרמטר התגובה connectorOutputPayload של המשימה CustomerPayment יש ערך שדומה לזה:
```
 {
    "InternalId": "1090749"
  } 
  
```

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

בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
בוחרים באפשרות PurchaseOrder_itemList מהרשימה Entity.
בוחרים את הפעולה Create ולוחצים על סיום.
בקטע Data Mapper (מיפוי נתונים) במשימה Data Mapping (מיפוי נתונים), לוחצים על Open Data Mapping Editor, מזינים ערך דומה לערך הבא בשדה Input Value ובוחרים באפשרות EntityId/ConnectorInputPayload כמשתנה מקומי.
```
 {
    "Entity_InternalId": "2041",
    "Location_InternalId": "6",
    "ItemList_Description": "Created on Jan 11",
    "ItemList_Item_InternalId": "979"
  } 
  
```
אם השילוב מצליח, לפרמטר התגובה connectorOutputPayload של המשימה PurchaseOrder_itemList יש ערך שדומה לזה:
```
 {
    "InternalId": "1093151",
    "ListId": "1"
  }  
  
```

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

בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
בוחרים באפשרות SalesOrder_itemList מהרשימה Entity.
בוחרים את הפעולה Create ולוחצים על סיום.
בקטע Data Mapper (מיפוי נתונים) במשימה Data Mapping (מיפוי נתונים), לוחצים על Open Data Mapping Editor, מזינים ערך דומה לערך הבא בשדה Input Value ובוחרים באפשרות EntityId/ConnectorInputPayload כמשתנה מקומי.
```
 {
    "Email": "222larabrown@gmail.com",
    "Entity_InternalId": "1709",
    "ItemList_Item_InternalId": "945",
    "ItemList_Amount": 1000.0
  }
  
```
אם השילוב מצליח, לפרמטר התגובה connectorOutputPayload של המשימה SalesOrder_itemList יש ערך שדומה לזה:
```
  {
    "InternalId": "1093351",
    "ListId": "1"
  }  
  
```

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

בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
בוחרים באפשרות 'ספק' מהרשימה Entity.
בוחרים את הפעולה Create ולוחצים על סיום.
בקטע Data Mapper (מיפוי נתונים) במשימה Data Mapping (מיפוי נתונים), לוחצים על Open Data Mapping Editor, מזינים ערך דומה לערך הבא בשדה Input Value ובוחרים באפשרות EntityId/ConnectorInputPayload כמשתנה מקומי.
```
 {
    "CompanyName": "Deloitte",
    "LegalName": "AU Vendor"
  } 
  
```
אם השילוב מצליח, לפרמטר התגובה connectorOutputPayload של המשימה Vendor יש ערך שדומה לזה:
```
 {
    "InternalId": "5067"
  }  
  
```

דוגמה – יצירה של רשומה מסוג VendorBill_itemList

בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
בוחרים באפשרות VendorBill_itemList מהרשימה Entity.
בוחרים את הפעולה Create ולוחצים על סיום.
בקטע Data Mapper (מיפוי נתונים) במשימה Data Mapping (מיפוי נתונים), לוחצים על Open Data Mapping Editor, מזינים ערך דומה לערך הבא בשדה Input Value ובוחרים באפשרות EntityId/ConnectorInputPayload כמשתנה מקומי.
```
 {
    "Entity_InternalId": "2041",
    "ItemList_Item_InternalId": "1374",
    "ItemList_Amount": 700.0
  } 
  
```
אם השילוב מצליח, לפרמטר התגובה connectorOutputPayload של המשימה VendorBill_itemList יש ערך שדומה לזה:
```
 {
    "InternalId": "5067"
  }  
  
```

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

בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
בוחרים באפשרות VendorCredit_itemList מהרשימה Entity.
בוחרים את הפעולה Create ולוחצים על סיום.
בקטע Data Mapper (מיפוי נתונים) במשימה Data Mapping (מיפוי נתונים), לוחצים על Open Data Mapping Editor, מזינים ערך דומה לערך הבא בשדה Input Value ובוחרים באפשרות EntityId/ConnectorInputPayload כמשתנה מקומי.
```
 {
    "Entity_InternalId": "2041",
    "Location_InternalId": "6",
    "ItemList_Item_InternalId": "992",
    "ItemList_Description": "Created on Jan 12"
  }
  
```
אם השילוב מצליח, לפרמטר התגובה connectorOutputPayload של המשימה VendorCredit_itemList יש ערך שדומה לזה:
```
 {
    "InternalId": "1093353",
    "ListId": "1"
  }  
  
```

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

בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
בוחרים באפשרות VendorPayment_applyList מהרשימה Entity.
בוחרים את הפעולה Create ולוחצים על סיום.
בקטע Data Mapper (מיפוי נתונים) במשימה Data Mapping (מיפוי נתונים), לוחצים על Open Data Mapping Editor, מזינים ערך דומה לערך הבא בשדה Input Value ובוחרים באפשרות EntityId/ConnectorInputPayload כמשתנה מקומי.
```
 {
    "ApplyList_Doc": 3339.0,
    "ApplyList_Apply": true,
    "Entity_InternalId": "1471"
  }
  
```
אם השילוב מצליח, לפרמטר התגובה connectorOutputPayload של המשימה VendorPayment_applyList יש ערך שדומה לזה:
```
 {
    "InternalId": "1093756",
    "ListId": "1"
  }   
  
```

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

בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
בוחרים באפשרות CreditMemo מהרשימה Entity.
בוחרים את הפעולה Create ולוחצים על סיום.

{
          "ItemListAggregate": " + "<ItemList>\n" +
                 "  <Row>\n" +
                 "    <ItemList_Item_InternalId>6</ItemList_Item_InternalId>\n" +
                 "    <ItemList_Line>2</ItemList_Line>\n" +
                 "    <ItemList_Amount>8800.0</ItemList_Amount>\n" +
                 "  </Row>\n" +
                 "  <Row>\n" +
                 "    <ItemList_Item_InternalId>6</ItemList_Item_InternalId>\n" +
                 "    <ItemList_Line>3</ItemList_Line>\n" +
                 "    <ItemList_Amount>9900.0</ItemList_Amount>\n" +
                 "  </Row>\n" +
                 "</ItemList>" + ",
          "Entity_InternalId": "11",
          "Email": "222larabrown@gmail.com"
      }

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

{
    "InternalId": "106"
  }

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

בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
בוחרים באפשרות 'חשבונית' מהרשימה Entity.
בוחרים את הפעולה Create ולוחצים על סיום.

{
          "ItemListAggregate": " + "<ItemList>\n" +
              "  <Row>\n" +
                  "    <ItemList_Item_InternalId>6</ItemList_Item_InternalId>\n" +
                  "    <ItemList_Line>1</ItemList_Line>\n" +
                  "    <ItemList_Amount>7998500.0</ItemList_Amount>\n" +
                  "  </Row>\n" +
                  "  <Row>\n" +
                  "    <ItemList_Item_InternalId>6</ItemList_Item_InternalId>\n" +
                  "    <ItemList_Line>2</ItemList_Line>\n" +
                  "    <ItemList_Amount>6500.0</ItemList_Amount>\n" +
                  "  </Row>\n" +
                  "</ItemList>" + ",
          "Memo": "May9"
      }

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

{
    "InternalId": "206"
  }

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

בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
בוחרים באפשרות ItemFulfillment מהרשימה Entity.
בוחרים את הפעולה Create ולוחצים על סיום.
בקטע Data Mapper (מיפוי נתונים) במשימה Data Mapping (מיפוי נתונים), לוחצים על Open Data Mapping Editor, מזינים ערך דומה לערך הבא בשדה Input Value ובוחרים באפשרות EntityId/ConnectorInputPayload כמשתנה מקומי.
```
{
    "CreatedFrom_InternalId": "411",
    "ShipStatus": "_picked"
  } 
  
```
אם השילוב מצליח, לפרמטר התגובה connectorOutputPayload של המשימה ItemFulfillment יש ערך שדומה לזה:
```
{
    "InternalId": "412"
  }
  
```

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

בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
בוחרים באפשרות JournalEntry מהרשימה Entity.
בוחרים את הפעולה Create ולוחצים על סיום.

{
          "Subsidiary_InternalId": "1",
          "Memo": "Journal Entry created on April 2",
          "LineListAggregate":" + "<LineList>\n" +
              "  <Row>\n" +
                  "    <LineList_Account_InternalId>1</LineList_Account_InternalId>\n" +
                  "    <LineList_Line>1</LineList_Line>\n" +
                  "    <LineList_credit>500.0</LineList_credit>\n" +
                  "  </Row>\n" +
                  "  <Row>\n" +
                  "    <LineList_Account_InternalId>1</LineList_Account_InternalId>\n" +
                  "    <LineList_Line>1</LineList_Line>\n" +
                  "    <LineList_debit>500.00</LineList_debit>\n" +
                  "  </Row>\n" +
                  "</LineList>" + "
      }

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

{
    "InternalId": "612"
  }

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

בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
בוחרים באפשרות PurchaseOrder מהרשימה Entity.
בוחרים את הפעולה Create ולוחצים על סיום.

{
          "Entity_InternalId": "2041",
          "Location_InternalId": "6",
          " + "<ItemList>\n" +
              "  <Row>\n" +
                  "    <ItemList_Item_InternalId>979</ItemList_Item_InternalId>\n" +
                  "    <ItemList_Line>2</ItemList_Line>\n" +
                  "    <ItemList_Amount>66500.0</ItemList_Amount>\n" +
                  "  </Row>\n" +
                  "  <Row>\n" +
                  "    <ItemList_Item_InternalId>979</ItemList_Item_InternalId>\n" +
                  "    <ItemList_Line>3</ItemList_Line>\n" +
                  "    <ItemList_Amount>16500.0</ItemList_Amount>\n" +
                  "  </Row>\n" +
                  "</ItemList>" + ",
          "Email": "222larabrown@gmail.com"
      }

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

{
    "InternalId": "1116228"
  }

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

בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
בוחרים באפשרות VendorBill מהרשימה Entity.
בוחרים את הפעולה Create ולוחצים על סיום.

  {"Entity_InternalId": "12",
  " + "<ItemList>\n" +
              "  <Row>\n" +
                      "    <ItemList_Item_InternalId>7</ItemList_Item_InternalId>\n" +
                      "    <ItemList_Line>1</ItemList_Line>\n" +
                      "    <ItemList_Amount>77700.0</ItemList_Amount>\n" + +
                      "  </Row>\n" +
                      "  <Row>\n" +
                      "    <ItemList_Item_InternalId>7</ItemList_Item_InternalId>\n" +
                      "    <ItemList_Line>2</ItemList_Line>\n" +
                      "    <ItemList_Amount>888888</ItemList_Amount>\n" + +
                      "  </Row>\n" +
                      "</ItemList>;" + "}

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

{
    "InternalId": "816"
  }

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

בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
בוחרים באפשרות VendorCredit מהרשימה Entity.
בוחרים את הפעולה Create ולוחצים על סיום.

{"Entity_InternalId": "12",
  " + "<ItemList>\n" +
              "  <Row>\n" +
                      "    <ItemList_Item_InternalId>7</ItemList_Item_InternalId>\n" +
                      "    <ItemList_Line>1</ItemList_Line>\n" +
                      "    <ItemList_Amount>77700.0</ItemList_Amount>\n" +
                      "  </Row>\n" +
                      "  <Row>\n" +
                      "    <ItemList_Item_InternalId>7</ItemList_Item_InternalId>\n" +
                      "    <ItemList_Line>2</ItemList_Line>\n" +
                      "    <ItemList_Amount>888888</ItemList_Amount>\n" +
                      "  </Row>\n" +
                      "</ItemList>;" + "}

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

{
    "InternalId": "818"
  }

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

בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
בוחרים באפשרות VendorPayment מהרשימה Entity.
בוחרים את הפעולה Create ולוחצים על סיום.
בקטע Data Mapper (מיפוי נתונים) במשימה Data Mapping (מיפוי נתונים), לוחצים על Open Data Mapping Editor, מזינים ערך דומה לערך הבא בשדה Input Value ובוחרים באפשרות EntityId/ConnectorInputPayload כמשתנה מקומי.
```
{
    "Entity_InternalId": "12",
    "ApplyList_Apply": true,
    "ApplyList_Doc": 714.0
  }       
  
```
אם השילוב מצליח, לפרמטר התגובה connectorOutputPayload של המשימה VendorPayment יש ערך שדומה לזה:
```
{
    "InternalId": "1025",
    "ListId": "1"
  } 
  
```

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

בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
בוחרים באפשרות TRANSFERORDER מהרשימה Entity.
בוחרים את הפעולה Create ולוחצים על סיום.

{
  "Location_InternalId": "1",
  "TransferLocation_InternalId": "3",
  "ItemListAggregate": 
   " + "<ItemList>\n" +
              "  <Row>\n" +
              "    <ItemList_Item_InternalId>8</ItemList_Item_InternalId>\n" +
              "    <ItemList_Line>1</ItemList_Line>\n" +
              "    <ItemList_Amount>77700.0</ItemList_Amount>\n" +
              "  </Row>\n" +
              "  <Row>\n" +
              "    <ItemList_Item_InternalId>8</ItemList_Item_InternalId>\n" +
              "    <ItemList_Line>2</ItemList_Line>\n" +
              "    <ItemList_Amount>888888</ItemList_Amount>\n" +
              "  </Row>\n" +
              "</ItemList>;"
  }

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

{
  "InternalId": "1337"
  }

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

בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
בוחרים באפשרות CashSale מהרשימה Entity.
בוחרים את הפעולה Create ולוחצים על סיום.

{
  "Entity_InternalId": "10",
  "Location_InternalId": "3",
  "ItemListAggregate": 
   "<ItemList>\n" +
              "  <Row>\n" +
              "    <ItemList_Item_InternalId>8</ItemList_Item_InternalId>\n" +
              "    <ItemList_Line>1</ItemList_Line>\n" +
              "    <ItemList_Amount>77700.0</ItemList_Amount>\n" +
              "  </Row>\n" +
              "  <Row>\n" +
              "    <ItemList_Item_InternalId>8</ItemList_Item_InternalId>\n" +
              "    <ItemList_Line>2</ItemList_Line>\n" +
              "    <ItemList_Amount>888888</ItemList_Amount>\n" +
              "  </Row>\n" +
              "</ItemList>;"
  }

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

{
  "InternalId": "1234"
  }

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

בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
בוחרים באפשרות PaycheckJournal מהרשימה Entity.
בוחרים את הפעולה Create ולוחצים על סיום.

{
  "Employee_InternalId": "8",
  "Account_InternalId": "314",
  "EarningListAggregate":  
   "<EarningList>\n" +
              "  <Row>\n" +
              "    <EarningList_PayrollItem_InternalId>2</EarningList_PayrollItem_InternalId>\n" +
              "    <EarningList_Amount>1998</EarningList_Amount>\n" +
              "  </Row>\n" +
              "</EarningList>;"
  }

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

{
  "InternalId": "1746"
  }

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

בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
בוחרים באפשרות InventoryAdjustment מהרשימה Entity.
בוחרים את הפעולה Create ולוחצים על סיום.

{
  "Account_InternalId": "1",
  "AdjLocation_InternalId": "1",
  "Location_InternalId": "3",
  "InventoryListAggregate": 
   "<InventoryList>\n" +
              "  <Row>\n" +
              "    <InventoryList_Item_InternalId>8</InventoryList_Item_InternalId>\n" +
              "    <InventoryList_Line>1</InventoryList_Line>\n" +
              "    <InventoryList_Location_InternalId>1</InventoryList_Location_InternalId>\n" +
              "    <InventoryList_AdjustQtyBy>100</InventoryList_AdjustQtyBy>\n" +
              "  </Row>\n" +
              "</InventoryList>;"
  }

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

{
  "InternalId": "1640"
  }

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

בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
בוחרים באפשרות CashRefund מהרשימה Entity.
בוחרים את הפעולה Create ולוחצים על סיום.

{
  "Entity_InternalId": "10",
  "Location_InternalId": "3",
  "ItemListAggregate": 
   "<ItemList>\n" +
              "  <Row>\n" +
              "    <ItemList_Item_InternalId>8</ItemList_Item_InternalId>\n" +
              "    <ItemList_Line>1</ItemList_Line>\n" +
              "    <ItemList_Amount>799.0</ItemList_Amount>\n" +
              "  </Row>\n" +
              "  <Row>\n" +
              "    <ItemList_Item_InternalId>8</ItemList_Item_InternalId>\n" +
              "    <ItemList_Line>2</ItemList_Line>\n" +
              "    <ItemList_Amount>666</ItemList_Amount>\n" +
              "  </Row>\n" +
              "</ItemList>;"
  }

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

{
  "InternalId": "1232"
  }

דוגמה – עדכון רשומה של CreditMemo

בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
בוחרים באפשרות CreditMemo מהרשימה Entity.
בוחרים את הפעולה Update ולוחצים על סיום.
בקטע Data Mapper (מיפוי נתונים) במשימה Data Mapping (מיפוי נתונים), לוחצים על Open Data Mapping Editor, מזינים ערך דומה לערך הבא בשדה Input Value ובוחרים באפשרות EntityId/ConnectorInputPayload/FilterClause כמשתנה מקומי.
```
{
    "Email2": "222larabrown@gmail.com"
  } 
  
```
מגדירים את מזהה הישות ב-Data Mapper לישות של CreditMemo. כדי להגדיר את מזהה הישות, לוחצים על Open Data Mapping Editor, מזינים ערך דומה לערך הבא בשדה Input Value ובוחרים באפשרות EntityId/ConnectorInputPayload/FilterClause כמשתנה מקומי.
לחלופין, במקום לציין את entityId, אפשר גם להגדיר את filterClause ל- 1090651.

הרצת הדוגמה הזו מחזירה תגובה שדומה לתגובה הבאה במשתנה הפלט connectorOutputPayload של משימת המחבר:
```
 {
    "InternalId": "1090651"
  } 
  
```

דוגמה – עדכון רשומת לקוח

בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
בוחרים באפשרות 'לקוח' מתוך הרשימה Entity.
בוחרים את הפעולה Update ולוחצים על סיום.
בקטע Data Mapper (מיפוי נתונים) במשימה Data Mapping (מיפוי נתונים), לוחצים על Open Data Mapping Editor, מזינים ערך דומה לערך הבא בשדה Input Value ובוחרים באפשרות EntityId/ConnectorInputPayload/FilterClause כמשתנה מקומי.
```
 {
    "Email": "222larabrown@gmail.com"
  } 
  
```
מגדירים את מזהה הישות ב-Data Mapper לישות של הלקוח. כדי להגדיר את מזהה הישות, לוחצים על Open Data Mapping Editor, מזינים ערך דומה לערך הבא בשדה Input Value ובוחרים באפשרות EntityId/ConnectorInputPayload/FilterClause כמשתנה מקומי.
לחלופין, במקום לציין את entityId, אפשר גם להגדיר את filterClause ל- 4767.

הרצת הדוגמה הזו מחזירה תגובה שדומה לתגובה הבאה במשתנה הפלט connectorOutputPayload של משימת המחבר:
```
 {
    "InternalId": "4767"
  } 
  
```

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

בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
בוחרים באפשרות 'חשבונית' מהרשימה Entity.
בוחרים את הפעולה Update ולוחצים על סיום.
בקטע Data Mapper (מיפוי נתונים) במשימה Data Mapping (מיפוי נתונים), לוחצים על Open Data Mapping Editor, מזינים ערך דומה לערך הבא בשדה Input Value ובוחרים באפשרות EntityId/ConnectorInputPayload/FilterClause כמשתנה מקומי.
```
  {
    "Email2": "222larabrown@gmail.com"
  } 
  
```
מגדירים את מזהה הישות ב-Data Mapper לישות של החשבונית. כדי להגדיר את מזהה הישות, לוחצים על Open Data Mapping Editor, מזינים ערך דומה לערך הבא בשדה Input Value ובוחרים באפשרות EntityId/ConnectorInputPayload/FilterClause כמשתנה מקומי.
לחלופין, במקום לציין את entityId, אפשר גם להגדיר את filterClause ל- 1083927.

הרצת הדוגמה הזו מחזירה תגובה שדומה לתגובה הבאה במשתנה הפלט connectorOutputPayload של משימת המחבר:
```
 {
    "InternalId": "1083927"
  } 
  
```

דוגמה – עדכון רשומה של CustomerPayment

בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
בוחרים באפשרות CustomerPayment מהרשימה Entity.
בוחרים את הפעולה Update ולוחצים על סיום.
בקטע Data Mapper (מיפוי נתונים) במשימה Data Mapping (מיפוי נתונים), לוחצים על Open Data Mapping Editor, מזינים ערך דומה לערך הבא בשדה Input Value ובוחרים באפשרות EntityId/ConnectorInputPayload/FilterClause כמשתנה מקומי.
```
 {
    "Customer_InternalId": "1714",
    "Payment": 7.77777777E8
  } 
  
```
מגדירים את מזהה הישות ב-Data Mapper לישות של CustomerPayment. כדי להגדיר את מזהה הישות, לוחצים על Open Data Mapping Editor, מזינים ערך דומה לערך הבא בשדה Input Value ובוחרים באפשרות EntityId/ConnectorInputPayload/FilterClause כמשתנה מקומי.
לחלופין, במקום לציין את entityId, אפשר גם להגדיר את filterClause ל- 1090749.

הרצת הדוגמה הזו מחזירה תגובה שדומה לתגובה הבאה במשתנה הפלט connectorOutputPayload של משימת המחבר:
```
 {
    "InternalId": "1090749"
  } 
  
```

דוגמה – עדכון של רשומה מסוג PurchaseOrder

בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
בוחרים באפשרות PurchaseOrder מהרשימה Entity.
בוחרים את הפעולה Update ולוחצים על סיום.
בקטע Data Mapper (מיפוי נתונים) במשימה Data Mapping (מיפוי נתונים), לוחצים על Open Data Mapping Editor, מזינים ערך דומה לערך הבא בשדה Input Value ובוחרים באפשרות EntityId/ConnectorInputPayload/FilterClause כמשתנה מקומי.
```
 {
    "Message": "Aspirin Updated"
  } 
  
```
מגדירים את מזהה הישות ב-Data Mapper לישות של PurchaseOrder. כדי להגדיר את מזהה הישות, לוחצים על Open Data Mapping Editor, מזינים ערך דומה לערך הבא בשדה Input Value ובוחרים באפשרות EntityId/ConnectorInputPayload/FilterClause כמשתנה מקומי.
לחלופין, במקום לציין את entityId, אפשר גם להגדיר את filterClause ל- 1000.

הרצת הדוגמה הזו מחזירה תגובה שדומה לתגובה הבאה במשתנה הפלט connectorOutputPayload של משימת המחבר:
```
 {
    "InternalId": "1000"
  } 
  
```

דוגמה – עדכון של רשומה מסוג SalesOrder

בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
בוחרים באפשרות PurchaseOrder מהרשימה Entity.
בוחרים את הפעולה Update ולוחצים על סיום.
בקטע Data Mapper (מיפוי נתונים) במשימה Data Mapping (מיפוי נתונים), לוחצים על Open Data Mapping Editor, מזינים ערך דומה לערך הבא בשדה Input Value ובוחרים באפשרות EntityId/ConnectorInputPayload/FilterClause כמשתנה מקומי.
```
 {
    "Email": "222larabrown@gmail.com",
    "Entity_InternalId": "1709",
    "Item_InternalId": "945"
  }
  
```
מגדירים את מזהה הישות ב-Data Mapper לישות של SalesOrder. כדי להגדיר את מזהה הישות, לוחצים על Open Data Mapping Editor, מזינים ערך דומה לערך הבא בשדה Input Value ובוחרים באפשרות EntityId/ConnectorInputPayload/FilterClause כמשתנה מקומי.
לחלופין, במקום לציין את entityId, אפשר גם להגדיר את filterClause ל- 1086949.

הרצת הדוגמה הזו מחזירה תגובה שדומה לתגובה הבאה במשתנה הפלט connectorOutputPayload של משימת המחבר:
```
 {
    "InternalId": "1086949"
  } 
  
```

דוגמה – עדכון רשומה של ספק

בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
בוחרים באפשרות 'ספק' מהרשימה Entity.
בוחרים את הפעולה Update ולוחצים על סיום.
בקטע Data Mapper (מיפוי נתונים) במשימה Data Mapping (מיפוי נתונים), לוחצים על Open Data Mapping Editor, מזינים ערך דומה לערך הבא בשדה Input Value ובוחרים באפשרות EntityId/ConnectorInputPayload/FilterClause כמשתנה מקומי.
```
 {
    "CompanyName": "Deloitte_Updated"
  } 
  
```
מגדירים את מזהה הישות בכלי למיפוי נתונים לישות של הספק. כדי להגדיר את מזהה הישות, לוחצים על Open Data Mapping Editor, מזינים ערך דומה לערך הבא בשדה Input Value ובוחרים באפשרות EntityId/ConnectorInputPayload/FilterClause כמשתנה מקומי.
לחלופין, במקום לציין את entityId, אפשר גם להגדיר את filterClause ל- 4567.

הרצת הדוגמה הזו מחזירה תגובה שדומה לתגובה הבאה במשתנה הפלט connectorOutputPayload של משימת המחבר:
```
 {
    "InternalId": "4567"
  } 
  
```

דוגמה – עדכון רשומה של VendorBill

בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
בוחרים באפשרות VendorBill מהרשימה Entity.
בוחרים את הפעולה Update ולוחצים על סיום.
בקטע Data Mapper (מיפוי נתונים) במשימה Data Mapping (מיפוי נתונים), לוחצים על Open Data Mapping Editor, מזינים ערך דומה לערך הבא בשדה Input Value ובוחרים באפשרות EntityId/ConnectorInputPayload/FilterClause כמשתנה מקומי.
```
  {
    "Memo": "Memo_Jan 11"
  } 
  
```
מגדירים את מזהה הישות ב-Data Mapper לישות של VendorBill. כדי להגדיר את מזהה הישות, לוחצים על Open Data Mapping Editor, מזינים ערך דומה לערך הבא בשדה Input Value ובוחרים באפשרות EntityId/ConnectorInputPayload/FilterClause כמשתנה מקומי.
לחלופין, במקום לציין את entityId, אפשר גם להגדיר את filterClause ל- 3339.

הרצת הדוגמה הזו מחזירה תגובה שדומה לתגובה הבאה במשתנה הפלט connectorOutputPayload של משימת המחבר:
```
 {
    "InternalId": "3339"
  } 
  
```

דוגמה – עדכון רשומה של VendorCredit

בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
בוחרים באפשרות VendorCredit מהרשימה Entity.
בוחרים את הפעולה Update ולוחצים על סיום.
בקטע Data Mapper (מיפוי נתונים) במשימה Data Mapping (מיפוי נתונים), לוחצים על Open Data Mapping Editor, מזינים ערך דומה לערך הבא בשדה Input Value ובוחרים באפשרות EntityId/ConnectorInputPayload/FilterClause כמשתנה מקומי.
```
 {
    "Memo": "16253"
  } 
  
```
מגדירים את מזהה הישות ב-Data Mapper לישות של VendorCredit. כדי להגדיר את מזהה הישות, לוחצים על Open Data Mapping Editor, מזינים ערך דומה לערך הבא בשדה Input Value ובוחרים באפשרות EntityId/ConnectorInputPayload/FilterClause כמשתנה מקומי.
לחלופין, במקום לציין את entityId, אפשר גם להגדיר את filterClause ל- 1091549.

הרצת הדוגמה הזו מחזירה תגובה שדומה לתגובה הבאה במשתנה הפלט connectorOutputPayload של משימת המחבר:
```
 {
    "InternalId": "1091549"
  } 
  
```

דוגמה – עדכון רשומה של VendorPayment

בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
בוחרים באפשרות VendorPayment מהרשימה Entity.
בוחרים את הפעולה Update ולוחצים על סיום.
בקטע Data Mapper (מיפוי נתונים) במשימה Data Mapping (מיפוי נתונים), לוחצים על Open Data Mapping Editor, מזינים ערך דומה לערך הבא בשדה Input Value ובוחרים באפשרות EntityId/ConnectorInputPayload/FilterClause כמשתנה מקומי.
```
  {
    "Memo": "Jan8"
  } 
  
```
מגדירים את מזהה הישות ב-Data Mapper לישות של VendorPayment. כדי להגדיר את מזהה הישות, לוחצים על Open Data Mapping Editor, מזינים ערך דומה לערך הבא בשדה Input Value ובוחרים באפשרות EntityId/ConnectorInputPayload/FilterClause כמשתנה מקומי.
לחלופין, במקום לציין את entityId, אפשר גם להגדיר את filterClause ל- 1082627.

הרצת הדוגמה הזו מחזירה תגובה שדומה לתגובה הבאה במשתנה הפלט connectorOutputPayload של משימת המחבר:
```
 {
    "InternalId": "1082627"
  } 
  
```

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

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

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

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

כשיוצרים את החיבור הזה באמצעות Terraform, צריך להגדיר את המשתנים הבאים בקובץ ההגדרות של Terraform:

שם הפרמטר	סוג נתונים	חובה	תיאור
account_id	מחרוזת	נכון	החשבון של החברה שאליו משויך שם המשתמש ב-NetSuite.
aggregate_column_mode	מחרוזת	לא נכון	מציין איך לטפל בעמודות מצטברות.
application_id	מחרוזת	לא נכון	החל מגרסה 2020.1, בקשות אל NetSuite מחייבות מזהה אפליקציה.
custom_field_permissions	מחרוזת	לא נכון	רשימה מופרדת בפסיקים של הרשאות לשדות בהתאמה אישית. האפשרות הזו מאפשרת שליטה רבה יותר מאשר IncludeCustomFieldColumns .
include_child_tables	בוליאני	לא נכון	ערך בוליאני שמציין אם להציג טבלאות צאצא.
include_custom_field_columns	בוליאני	לא נכון	ערך בוליאני שמציין אם רוצים לכלול עמודות של שדות מותאמים אישית.
include_custom_list_tables	בוליאני	לא נכון	ערך בוליאני שמציין אם רוצים להשתמש בטבלאות שמבוססות על רשימות בהתאמה אישית.
include_custom_record_tables	בוליאני	לא נכון	ערך בוליאני שמציין אם רוצים להשתמש בטבלאות שמבוססות על סוגי רשומות מותאמים אישית.
include_reference_columns	מחרוזת	לא נכון	רשימה מופרדת בפסיקים שמייצגת את העמודות שייכללו באחזור נתונים משדה שמייצג הפניה לרשומה.
maximum_concurrent_sessions	מספר שלם	לא נכון	המספר המקסימלי של סשנים בו-זמניים שזמינים לשימוש בחיבור.
net_suite_date_format	מחרוזת	לא נכון	פורמט התאריך המועדף שמוגדר בממשק המשתמש של NetSuite.
net_suite_long_date_format	מחרוזת	לא נכון	פורמט התאריך הארוך המועדף שמוגדר בממשק המשתמש של NetSuite.
netsuite_metadata_folder	מחרוזת	לא נכון	נתיב לספרייה שממנה יורדו קובצי מטא-נתונים מ-NetSuite. כדאי להגדיר את האפשרות הזו כדי לשפר את הביצועים.
report_doubles_as_decimal	בוליאני	לא נכון	מציין אם צריך לדווח על מספרים כפולים כמספרים עשרוניים.
request_memorized_transactions	בוליאני	לא נכון	ערך בוליאני שמציין אם רוצים לבקש עסקאות שנשמרו כשמאחזרים עסקאות מ-NetSuite.
role_id	מחרוזת	לא נכון	‫RoleID הוא ה-InternalID של התפקיד שישמש לכניסה ל-NetSuite. כדי להשתמש בתפקיד ברירת המחדל של המשתמש, משאירים את השדה ריק.
סכימה	מחרוזת	נכון	סוג הסכימה לשימוש.
use_async_services	בוליאני	לא נכון	ערך בוליאני שמציין אם רוצים להשתמש בשירותים אסינכרוניים כשמוסיפים, מעדכנים ומוחקים.
use_internal_names_for_customizations	בוליאני	לא נכון	ערך בוליאני שמציין אם רוצים להשתמש בשמות פנימיים להתאמות אישיות.
use_upserts	בוליאני	לא נכון	ערך בוליאני שמציין אם רוצים לבצע פעולת upsert כשמשתמשים בפעולת insert.
user_timezone_offset	מחרוזת	לא נכון	ההפרש בין אזור הזמן של המשתמש לבין UTC, כפי שמוגדר בהעדפות NetSuite בקטע Home (דף הבית) --> Preferences (העדפות) --> Time Zone (אזור זמן). לדוגמה: EST.
row_scan_depth	מחרוזת	לא נכון	מספר השורות שייסרקו כדי לקבוע באופן דינמי את העמודות של הטבלה.
דרגת מלל	מחרוזת	לא נכון	רמת המלל של החיבור, משתנה מ-1 עד 5. רמת הפירוט הגבוהה יותר תתעד את כל פרטי התקשורת (בקשה,תגובה ואישורי SSL).
proxy_enabled	בוליאני	לא נכון	מסמנים את תיבת הסימון הזו כדי להגדיר שרת Proxy לחיבור.
proxy_auth_scheme	ENUM	לא נכון	סוג האימות שבו יש להשתמש כדי לבצע אימות לשרת ה-proxy‏ ProxyServer. הערכים הנתמכים הם: BASIC, ‏ DIGEST, ‏ NONE
proxy_user	מחרוזת	לא נכון	שם משתמש שישמש לאימות בשרת ה-proxy ‏ProxyServer.
proxy_password	SECRET	לא נכון	סיסמה שתשמש לאימות בשרת ה-proxy‏ ProxyServer.
proxy_ssltype	ENUM	לא נכון	סוג ה-SSL שבו צריך להשתמש כשמתחברים לשרת ה-proxy של ProxyServer. הערכים הנתמכים הם: AUTO, ‏ ALWAYS, ‏ NEVER, ‏ TUNNEL

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

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

NetSuite

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

הגדרת המחבר

הגדרת אימות

שלבים נוספים אחרי יצירת החיבור

אישור מחדש של קוד הרשאה

הגדרת NetSuite

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

שימוש בחיבור NetSuite בשילוב

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

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

דוגמה – קבלת רשומה של CreditMemo

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

דוגמה – יצירה של רשומה מסוג ReturnAuthorization

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

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

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

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

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

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

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

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

דוגמה – יצירה של רשומה מסוג VendorBill_itemList

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

דוגמה – עדכון רשומה של CreditMemo

דוגמה – עדכון רשומת לקוח

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

דוגמה – עדכון רשומה של CustomerPayment

דוגמה – עדכון של רשומה מסוג PurchaseOrder

דוגמה – עדכון של רשומה מסוג SalesOrder

דוגמה – עדכון רשומה של ספק

דוגמה – עדכון רשומה של VendorBill

דוגמה – עדכון רשומה של VendorCredit

דוגמה – עדכון רשומה של VendorPayment

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

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

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