Excel Online

אפשר להשתמש במחבר Excel Online כדי לבצע פעולות ב-Excel Online.

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

מגדירים את פרויקט Google Cloud, יוצרים את אפליקציית OAuth ומעניקים את ההרשאות הנדרשות.

הגדרת הפרויקט בענן ב-Google Cloud

לפני שמשתמשים במחבר של Excel Online, צריך לבצע את המשימות הבאות בפרויקט ב-Google Cloud:

• מוודאים שהגדרתם חיבור לרשת. מידע על תבניות רשת זמין במאמר קישוריות לרשת.
• מפעילים את השירותים הבאים:
  • ‫secretmanager.googleapis.com (Secret Manager API)
  • ‫connectors.googleapis.com (Connectors API)

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

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

יצירת אפליקציית OAuth בהתאמה אישית – Azure AD

1. מתחברים ל-Azure Portal.
2. בחלונית הניווט הימנית, בוחרים באפשרות Azure Active Directory ואז באפשרות applicationRegistrations.
3. לוחצים על New registration (הרשמה חדשה).
4. מזינים שם לאפליקציה.
5. בוחרים את הגדרת הדייר הרצויה: דייר יחיד או כמה דיירים, ושימוש ציבורי או פרטי.
• אם בוחרים באפשרות ברירת המחדל, 'חשבונות רק בספרייה הארגונית הזו', צריך להגדיר את מאפיין החיבור AzureTenant למזהה של Azure AD Tenant כשמקימים חיבור עם CData JDBC Driver ל-Microsoft Excel Online. אחרת, ניסיון האימות ייכשל עם שגיאה.
• אם האפליקציה מיועדת לשימוש פרטי בלבד, צריך לציין 'חשבונות בספרייה הארגונית הזו בלבד'.
• אם אתם רוצים להפיץ את האפליקציה, אתם צריכים לבחור באחת מהאפשרויות של ריבוי דיירים.
6. מגדירים את כתובת ה-URL להפניה אוטומטית ל-http://localhost:33333 (ברירת המחדל של הדרייבר) או מציינים יציאה אחרת ומגדירים את CallbackURL לכתובת ה-URL המדויקת לתשובה שהגדרתם.
7. לוחצים על Register (רישום) כדי לרשום את האפליקציה החדשה. מוצג מסך לניהול אפליקציות. חשוב לזכור את הערך של מזהה האפליקציה (לקוח) בתור OAuthClientId ואת הערך של מזהה הספרייה (דייר) בתור AzureTenant.
8. עוברים אל Certificates & Secrets (אישורים וסודות) ומגדירים את סוג האימות של האפליקציה. יש שני סוגים של אימות: אישור (מומלץ) או סוד לקוח.
• לאימות באמצעות אישור: ב-Certificates & Secrets, בוחרים באפשרות Upload certificate (העלאת אישור) ומעלים את האישור מהמחשב המקומי.
• כדי ליצור סוד לקוח חדש: ב-Certificates & Secrets, בוחרים באפשרות New Client Secret לאפליקציה ומציינים את משך הזמן שלה. אחרי שמירת הסוד של הלקוח, Microsoft Excel Online מציג את ערך המפתח. חשוב להעתיק את הערך הזה כי הוא מוצג רק פעם אחת. הערך הזה הופך ל-OAuthClientSecret.
9. בוחרים באפשרות 'הרשאות API' > 'הוספה' > 'הרשאות שהוקצו'.
10. מוסיפים את הרשאות האפליקציה הבאות: Sites.Read.All,‏ Files.Read,‏ Files.Read.All,‏ Files.Read.Selected,‏ Files.ReadWrite,‏ Files.ReadWrite.All,‏ Files.ReadWrite.AppFolder,‏ Files.ReadWrite.Selected ו-offline_access.
11. שומרים את השינויים.
12. אם ציינתם שימוש בהרשאות שדורשות הסכמת אדמין (כמו הרשאות לאפליקציה), אתם יכולים להעניק אותן מהדייר הנוכחי בדף 'הרשאות API'.

יצירת אפליקציית OAuth בהתאמה אישית – חשבון שירות ב-Azure

1. משתמשים בסרגל החיפוש כדי לחפש את שירות המינויים.
2. פותחים את דף המינויים.
3. בוחרים את המינוי שאליו רוצים להקצות את האפליקציה.
4. פותחים את הכלי 'בקרת גישה (IAM)'.
5. בוחרים באפשרות 'הוספה' > 'הוספת הקצאת תפקיד'. נפתח הדף 'הוספת הקצאת תפקיד' ב-Microsoft Excel Online.
6. מקצים לאפליקציה המותאמת אישית ב-Azure AD את התפקיד 'בעלים'.

הקצאת תפקיד לאפליקציה

1. כדי לגשת למשאבים במינוי, צריך להקצות תפקיד לאפליקציה.
2. פותחים את הדף 'מינויים' על ידי חיפוש שירות המינויים בסרגל החיפוש ובחירה בו.
3. בוחרים את המינוי שאליו רוצים להקצות את האפליקציה.
4. פותחים את בקרת הגישה (IAM) ובוחרים באפשרות 'הוספה' > 'הוספת הקצאת תפקיד' כדי לפתוח את הדף 'הוספת הקצאת תפקיד'.
5. בוחרים באפשרות 'בעלים' בתור התפקיד להקצאה לאפליקציית Azure AD שיצרתם.

מתן הסכמה של אדמין

1. כניסה ל-Azure Portal
2. עוברים אל App Registrations (רישום אפליקציות) ומחפשים את אפליקציית ה-OAuth המותאמת אישית שיצרתם.
3. בקטע API Permissions (הרשאות API), לוחצים על Grant Consent (מתן הסכמה).

מתן הרשאות לפרטי כניסה של לקוח

1. כניסה ל-Azure Portal
2. עוברים אל 'רישום אפליקציות'.
3. מאתרים את האפליקציה שיצרתם ופותחים את API Permissions (הרשאות API).
4. בוחרים את ההרשאות של Microsoft Graph. יש שני סוגים שונים של הרשאות: הרשאות שהוקצו והרשאות לאפליקציה.
5. בקטע Application Permissions (הרשאות לאפליקציה), בוחרים את ההרשאות שנדרשות לשילוב.

הגדרת המחבר

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

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

   כניסה לדף Connections

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

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

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

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

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

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

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

   הערה: אפשר להתאים אישית את הערכים של צומת החיבור רק אם אתם לקוחות עם תשלום לפי שימוש.
   8. דייר Azure: הדייר של Microsoft Online שמשמש לגישה לנתונים. אם לא מציינים דייר, המערכת משתמשת בדייר ברירת המחדל.
   9. ‫Drive: המזהה של ה-Drive. אתם יכולים להשתמש בתצוגות Drives ו-SharePointSites כדי לראות את כל האתרים והכוננים שיש לכם גישה אליהם.
   10. כתובת URL של Sharepoint: כתובת ה-URL הבסיסית של שרת Sharepoint.
   11. הצגת מסמכים משותפים: האם להציג מסמכים משותפים.
   12. חוברת עבודה: השם או המזהה של חוברת העבודה.
   13. כותרת: מציין אם שמות העמודות צריכים להיות מזוהים מהשורה הראשונה.
   14. טבלה: מגביל את החיבור לטבלה שמכילה טווח של תאים בגיליון עבודה. ‫Format: [{Workbook Name}_{Worksheet Name}!{Range}]
   15. אופציונלי: לוחצים על + הוספת תווית כדי להוסיף תווית לקישור בצורה של צמד מפתח/ערך.
   16. לוחצים על הבא.
5. 1. בקטע אימות, מזינים את פרטי האימות. כדי להבין איך להגדיר את פרטי האימות האלה, אפשר לעיין במאמר הגדרת אימות.
   2. לוחצים על הבא.
6. בדיקה: בודקים את פרטי החיבור והאימות.
7. לוחצים על יצירה.

הגדרת אימות

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

• Client ID: מזהה הלקוח שמשמש לבקשת אסימוני גישה.
• היקף: רשימה מופרדת בפסיקים של ההיקפים הרצויים.
• סוד לקוח: סוד הלקוח שמשמש לבקשת טוקנים של גישה.
• כתובת URL לאישור: כתובת ה-URL לאישור שנוצרת כשיוצרים לקוח OAuth. מזינים את כתובת ה-URL בפורמט הבא: https://login.microsoftonline.com/AZURE_TENANT/oauth2/v2.0/authorize?prompt=consent

‫Excel Online – סוג החיבור לאינטרנט

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

שם השדה	פרטים
מיקום	us-central1
מחבר	Excelonline
גרסת המחבר	1
שם החיבור	excelonline-gcp
חשבון השירות	SERVICE_ACCOUNT_NAME@serviceaccount
דייר Azure	9b******-****-****-****-*********12
Drive	b!p_648NCXwk6hJ1pfyn0SeFaithFnRM1JmYNur9asmHAs2k8qe5UsR5a1cX6luuD0
כתובת URL של SharePoint	https://*****.sharepoint.com/
הצגת מסמכים משותפים	נכון
מספר הצמתים המינימלי	2
מספר הצמתים המקסימלי	50
מזהה לקוח	e89*****-****-****-****-*********b6
היקפים	https://graph.microsoft.com/.default
סוד לקוח	CLIENT_SECRET
גרסה של סוד	1
כתובת אתר להרשאה	https://login.microsoftonline.com/AZURE_TENANT/oauth2/v2.0/authorize?prompt=consent

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

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

1. בדף החיבורים, מאתרים את החיבור החדש.

   שימו לב שהסטטוס של המחבר החדש יהיה נדרשת הרשאה.

2. לוחצים על דרושה הרשאה.

   יוצג לוח עריכת הרשאה.

3. מעתיקים את הערך של Redirect URI (ה-URI של ההפניה האוטומטית) לאפליקציה החיצונית.
4. מאמתים את פרטי ההרשאה.
5. לוחצים על Authorize.

   אם ההרשאה מתבצעת בהצלחה, סטטוס החיבור יהיה פעיל בדף החיבורים.

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

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

1. לוחצים על החיבור הרצוי בדף החיבורים.

   ייפתח הדף עם פרטי החיבור.

2. לוחצים על עריכה כדי לערוך את פרטי החיבור.
3. בודקים את הפרטים של OAuth 2.0 – קוד הרשאה בקטע אימות.

   אם צריך, מבצעים את השינויים הנדרשים.

4. לוחצים על Save. הלחיצה תעביר אתכם לדף פרטי החיבור.
5. בקטע אימות, לוחצים על עריכת הרשאה. מוצגת החלונית Authorize (אישור).
6. לוחצים על Authorize.

   אם ההרשאה מתבצעת בהצלחה, סטטוס החיבור יהיה פעיל בדף החיבורים.

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

הגודל המקסימלי של קובץ Excel שהמחבר של Excel Online יכול לעבד הוא 25MB.

מחבר Excel Online יכול לעבד 3 טרנזקציות בשנייה, לכל צומת, ומגביל טרנזקציות מעבר למגבלה הזו. כברירת מחדל, Integration Connectors מקצה 2 צמתים (לזמינות טובה יותר) לחיבור.

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

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

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

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

שימוש בחיבור ל-Excel Online בשילוב

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

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

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

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

הערה: אפשר לראות את הישויות, הפעולות והפעולות של מחבר במשימת המחברים.

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

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

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

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

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

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

פעולות

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

הערה: התוצאות של כל הפעולות יהיו זמינות כתשובת JSON בפרמטר התשובה connectorOutputPayload של המשימה Connectors אחרי שתפעילו את השילוב.

הוספת פעולה של גיליון עבודה

הוספת גיליון עבודה לחוברת עבודה קיימת ב-Excel Online.

פרמטרים של קלט של פעולת AddWorksheet (הוספת גיליון עבודה)

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

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

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

דוגמאות

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

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

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

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

בדוגמה הזו מוסיפים גיליון עבודה לחוברת עבודה קיימת ב-Excel Online.

1. בתיבת הדו-שיח Configure connector task, לוחצים על Actions.
2. בוחרים את הפעולה AddWorksheet ולוחצים על סיום.
3. בקטע מיפוי נתונים Open Data Mapping Editor ואז מזינים ערך דומה לערך הבא בשדה Input:

   {   
   "WorkbookId": "01M7ENMYA2QJVY77NPOFD3WQIJ6PNNX5VL",
   "Title": "Worksheet_SP1"
   }

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

[{
  "Success": "true",
  "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#workbookWorksheet",
  "@odata.type": "#microsoft.graph.workbookWorksheet",
  "@odata.id": "/drives('b%21p_648NCXwk6hJ1pfyn0SeFaithFnRM1JmYNur9asmHAs2k8qe5UsR5a1cX6luuD0')/items('01M7ENMYA2QJVY77NPOFD3WQIJ6PNNX5VL')/workbook/worksheets(%27%7BD9372F53-CB1B-4082-9E13-02E65C2FC233%7D%27)",
  "id": "{D9372F53-CB1B-4082-9E13-02E65C2FC233}",
  "name": "Worksheet_SP1",
  "position": "1",
  "visibility": "Visible"
}]

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

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

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

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

דוגמה – רשימה של כל המסמכים המשותפים

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

דוגמה – הצגת כל חוברות העבודה

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

דוגמה – קבלת כוננים

1. בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
ect Drives מהרשימה Entity.
2. בוחרים את הפעולה Get ולוחצים על סיום.
3. מגדירים את מזהה הישות ל-Get single Drives. כדי להגדיר את מזהה הישות, בקטע מיפוי נתונים של מיפוי הנתונים, לוחצים על פתיחת כלי מיפוי הנתונים, מזינים b!ZETdEU1T_UOBEzbgDmsvcubxvUaXbcJNrrNPM4LqokkwLC3zCRPiQLi2PBfCs9-v בשדה ערך קלט ובוחרים באפשרות EntityId כמשתנה מקומי.

דוגמה – קבלת SharedDocument

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

דוגמה – קבלת חוברות עבודה

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

דוגמה – מחיקת נתונים מ-Book

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

דוגמה – יצירת נוסחה ל-Formulae_Sheet_List

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

    {
     "Excel_Sheet": "Old_Excel",
     "B": "=SUM(C8:D8)",
     "C": "6",
     "D": "6"
     }
     
   Running this example, returns a response similar to the following in the Connector
     task's connectorOutputPayload output variable:
     
   {
     "Id": 8.0
     } 
     

Example - Create With_Headers

1. In the Configure connector task dialog, click Entities.
2. Select Book 4567_Book4567_Sheet1 from the Entity list.
3. Select the Create operation, and then click Done.
4. In the Data mapper section of the Task click OpenDataMapping editor and then enter a value similar to the following in the field:

    {
       "Name": "workbooknew",
       "Type": "newly created",
       "Sl no": 5.0
     }
     
   Running this example, returns a response similar to the following in the Connector
     task's connectorOutputPayload output variable:
     
   {
     "Id": 6.0
     }
     

Example - Create Without_Headers

1. In the Configure connector task dialog, click Entities.
2. Select Book 4567_Book4567_Sheet1 from the Entity list.
3. Select the Create operation, and then click Done.
4. In the Data mapper section of the Task click OpenDataMapping editor and then enter a value similar to the following in the field:

     {
       "A": "6",
       "B": "Halo",
       "C": "Stardust"
     } 
     
   Running this example, returns a response similar to the following in the Connector
     task's connectorOutputPayload output variable:
     
   {
     "Id": 7.0
     } 
     

Example - Update an Formula for Formulae_Sheet_List

1. In the Configure connector task dialog, click Entities.
2. Select Formulae_Sheet_List from the Entity list.
3. Select the Update operation, and then click Done.
4. Set the entity ID to Update a Formulae_Sheet_List. To set the entity ID, in the Data mapper section of the Tasks, click entityId and then enter 8.0 in the given field.
5. In the Data mapper section of the Task click OpenDataMapping editor and then enter a value similar to the following in the field:

    
     {
     "B": "=MAX(C8:D8)",
     "C": "7",
     "D": "10"
     } 
     

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

 
  {   
  "Id": 8.0
  }
  

דוגמה – עדכון ללא כותרת

1. בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
2. בוחרים באפשרות Book 4567_Book4567_Sheet1 מהרשימה Entity.
3. בוחרים את הפעולה Update ולוחצים על סיום.
4. מגדירים את מזהה הישות לערך Update a Book 4567_Book4567_Sheet1. כדי להגדיר את מזהה הישות, בקטע מיפוי נתונים שבמשימות, לוחצים על entityId ואז מזינים 7.0 בשדה שמופיע.
5. בקטע מיפוי נתונים של המשימה, לוחצים על OpenDataMapping עורך ואז מזינים ערך דומה לערך הבא ב-field:

    
      {
       "B": "cosmically",
       "C": "interlinked"
     }  
     

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

 
  {   
  "Id": 7.0
  }
  

דוגמה – Update_With_Header

1. בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
li>בוחרים באפשרות Book 4567_Book4567_Sheet1 מהרשימה Entity.
2. בוחרים את הפעולה Update ולוחצים על סיום.
3. מגדירים את מזהה הישות לערך Update a Book 4567_Book4567_Sheet1. כדי להגדיר את מזהה הישות, בקטע מיפוי נתונים של משימות, לוחצים על entityId ומזינים 6.0 בשדה הנתון.
4. בקטע מיפוי נתונים של המשימה, לוחצים על OpenDataMapping עורך ואז מזינים ערך דומה לערך הבא ב-field:

    
      {
       "Name": "updated",
       "Type": "newupdate"
     }
     

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

 
  {   
  "Id": 6.0
  }
  

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

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

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

• איך משעים ומחדשים חיבור
• איך עוקבים אחרי השימוש בכלי לחיבור נתונים
• איך צופים ביומני המחברים