Gmail
מחבר Gmail מאפשר לבצע פעולות קריאה ומחיקה ב-Gmail.
גרסאות נתמכות
המחבר הזה תומך ב-Gmail REST APIs.
לפני שמתחילים
לפני שמשתמשים במחבר Gmail, צריך לבצע את המשימות הבאות:
- בפרויקט שלכם ב-Google Cloud:
- נותנים למשתמש שמגדיר את המחבר את תפקיד ה-IAM roles/connectors.admin.
- מקצים לחשבון השירות שרוצים להשתמש בו עבור המחבר את תפקידי ה-IAM הבאים:
roles/secretmanager.viewerroles/secretmanager.secretAccessor
חשבון שירות הוא סוג מיוחד של חשבון Google שמייצג משתמש לא אנושי, שצריך לאמת ולאשר כדי לתת לו גישה לנתונים ב-Google APIs. אם אין לכם חשבון שירות, אתם צריכים ליצור חשבון שירות. מידע נוסף זמין במאמר בנושא יצירת חשבון שירות.
- מפעילים את השירותים הבאים:
-
secretmanager.googleapis.com(Secret Manager API) -
connectors.googleapis.com(Connectors API)
במאמר הפעלת שירותים מוסבר איך להפעיל שירותים.
-
אם השירותים או ההרשאות האלה לא הופעלו בפרויקט שלכם בעבר, תתבקשו להפעיל אותם כשאתם מגדירים את המחבר.
הגדרת המחבר
החיבור ספציפי למקור נתונים. אם יש לכם הרבה מקורות נתונים, תצטרכו ליצור חיבור נפרד לכל אחד מהם. כדי ליצור קישור:
- במסוף Cloud, עוברים לדף Integration Connectors > Connections ובוחרים או יוצרים פרויקט בענן.
- לוחצים על + יצירת חיבור חדש כדי לפתוח את הדף יצירת חיבור.
- בקטע מיקום, מבצעים את הפעולות הבאות:
- אזור: בוחרים מיקום מהרשימה הנפתחת.
רשימה של כל האזורים הנתמכים מופיעה במאמר מיקומים.
- לוחצים על הבא.
- אזור: בוחרים מיקום מהרשימה הנפתחת.
- בקטע פרטי החיבור, ממלאים את הפרטים הבאים:
- מחבר: בוחרים באפשרות Gmail מתוך רשימת המחברים הזמינים.
- גרסת המחבר: בוחרים את גרסת המחבר מתוך רשימת הגרסאות הזמינות.
- בשדה Connection Name, מזינים שם למופע החיבור. שם החיבור יכול להכיל אותיות קטנות, מספרים או מקפים. השם צריך להתחיל באות ולהסתיים באות או במספר, והוא לא יכול להכיל יותר מ-49 תווים.
- תיאור: מזינים תיאור למופע החיבור.
- אופציונלי: מפעילים את Cloud logging ובוחרים רמת יומן. כברירת מחדל, רמת היומן מוגדרת כ-
Error. - חשבון שירות: בוחרים חשבון שירות שיש לו את התפקידים הנדרשים.
- אופציונלי: מגדירים את ההגדרות של צומת החיבור:
- מספר מינימלי של צמתים: מזינים את המספר המינימלי של צמתי חיבור.
- מספר הצמתים המקסימלי: מזינים את מספר צמתי החיבור המקסימלי.
צומת הוא יחידה (או עותק) של חיבור שמבצעת עיבוד של עסקאות. כדי לעבד יותר טרנזקציות לחיבור מסוים, צריך יותר צמתים, ולהפך – כדי לעבד פחות טרנזקציות, צריך פחות צמתים. כדי להבין איך הצמתים משפיעים על התמחור של המחבר, אפשר לעיין במאמר בנושא תמחור של צמתי חיבור. אם לא מזינים ערכים, כברירת מחדל, מספר הצמתים המינימלי מוגדר כ-2 (לזמינות טובה יותר) ומספר הצמתים המקסימלי מוגדר כ-50.
- + הוספת תווית: לוחצים על האפשרות הזו כדי להוסיף תווית לחיבור בצורה של צמד מפתח/ערך.
- לוחצים על הבא.
-
בקטע אימות, מזינים את פרטי האימות.
- בוחרים סוג אימות ומזינים את הפרטים הרלוונטיים.
החיבור ל-Gmail תומך בסוגי האימות הבאים:
- אימות באמצעות חשבון שירות
- OAuth 2.0 – JWT Bearer
- OAuth 2.0 – קוד הרשאה
כדי להבין איך להגדיר את סוגי האימות האלה, אפשר לעיין במאמר בנושא הגדרת אימות.
- לוחצים על הבא.
- בוחרים סוג אימות ומזינים את הפרטים הרלוונטיים.
- בדיקה: בודקים את פרטי החיבור והאימות.
- לוחצים על יצירה.
הגדרת אימות
מזינים את הפרטים בהתאם לאימות שבו רוצים להשתמש.
- אימות חשבון שירות: לא נדרש לבצע הגדרה נוספת לסוג האימות הזה. חשבון השירות שבחרתם בקטע פרטי החיבור ישמש לאימות.
-
OAuth 2.0 - JWT Bearer
- אישור JWT: בוחרים את האישור שבו רוצים להשתמש לאימות JWT.
- גרסת הסוד: מזינים את גרסת הסוד של אישור ה-JWT.
- נושא ה-JWT: מזינים את נושא ה-JWT.
- הפעלת ביטול של אימות: מפעילים כדי לבטל את האימות.
-
OAuth 2.0 – קוד הרשאה
- מזהה לקוח: מזינים את מזהה הלקוח שבו רוצים להשתמש לאימות OAuth.
- היקפים: מזינים רשימה של היקפים רצויים.
- סוד הלקוח: סוד הלקוח שמשמש לאימות OAuth.
- Secret version (גרסת הסוד): מזינים את גרסת הסוד של סוד הלקוח.
- הפעלת ביטול של אימות: מפעילים כדי לבטל את האימות.
דוגמאות להגדרת חיבור
בקטע הזה מפורטים ערכים לדוגמה לשדות השונים שאתם מגדירים כשאתם יוצרים את החיבור.
סוג החיבור OAuth 2.0 – JWT bearer
| שם השדה | פרטים |
|---|---|
| מיקום | asia-east1 |
| מחבר | Gmail |
| גרסת המחבר | 1 |
| שם החיבור | gmail-jwt-conn |
| הפעלת Cloud Logging | TRUE |
| חשבון השירות | my-service-account@my-project.iam.gserviceaccount.com |
| מספר הצמתים המינימלי | 2 |
| מספר הצמתים המקסימלי | 50 |
| אימות | OAuth 2.0 – JWT Bearer |
| JWT Cert | אישור JWT |
| גרסה של סוד | 1 |
OAuth 2.0 – סוג החיבור של קוד הרשאה
| שם השדה | פרטים |
|---|---|
| מיקום | us-central1 |
| מחבר | Gmail |
| גרסת המחבר | 1 |
| שם החיבור | gmail-auth-conn |
| הפעלת Cloud Logging | כן |
| חשבון השירות | my-service-account@my-project.iam.gserviceaccount.com |
| מספר הצמתים המינימלי | 2 |
| מספר הצמתים המקסימלי | 50 |
| אימות | OAuth 2.0 – קוד הרשאה |
| מזהה לקוח | 60875425788659-mt0cm1tguyiagvst468fvaw7.apps.googleusercontent.com |
| היקפים | https://mail.google.com/ |
| סוד לקוח | ygdruoX-Rtyah9gzkdZc-7CB0Eng9hyaufD0VD |
| גרסה של סוד | 1 |
מגבלות המערכת
מחבר Gmail יכול לעבד עד טרנזקציה אחת בשנייה, לכל צומת, ומגביל את מספר הטרנזקציות מעבר למגבלה הזו. כברירת מחדל, Integration Connectors מקצה 2 צמתים (לזמינות טובה יותר) לחיבור.
מידע על המגבלות שחלות על Integration Connectors זמין במאמר מגבלות.
שימוש בחיבור ל-Gmail בשילוב
אחרי שיוצרים את החיבור, הוא זמין גם ב-Apigee Integration וגם ב-Application Integration. אפשר להשתמש בחיבור באינטגרציה באמצעות המשימה Connectors.
- כדי להבין איך ליצור ולהשתמש במשימת מחברים ב-Apigee Integration, אפשר לעיין במאמר משימת מחברים.
- כדי להבין איך ליצור ולהשתמש במשימת מחברים ב-Application Integration, אפשר לעיין במאמר בנושא משימת מחברים.
פעולות
בקטע הזה מוסבר איך לבצע חלק מהפעולות במחבר הזה.
פעולת SendMailMessages
הפעולה הזו שולחת הודעה ב-Gmail.
פרמטרים של קלט לפעולה SendMailMessages
| שם הפרמטר | סוג נתונים | חובה | תיאור |
|---|---|---|---|
| אל | String | כן | כתובת האימייל של הנמען הראשי. אם יש כמה נמענים, צריך להשתמש ברשימה מופרדת בפסיקים. |
| AttachmentHasBytes | String | לא | מגדירים את הערך true אם תוכן הקובץ המצורף מסופק ב-AttachmentContentBytes (בקידוד Base64), או false אם התוכן מסופק כמחרוזת ב-AttachmentContent. ברירת המחדל היא False. |
| AttachmentFileName | String | לא | השם של הקובץ לצירוף. הפרמטר הזה משמש כשהערך של AttachmentHasBytes הוא false או כשהוא לא מסופק. |
| נושא | String | כן | שורת הנושא של האימייל. |
| AttachmentContent | String | לא | תוכן המחרוזת של הקובץ לצירוף. הפרמטר הזה משמש כשהערך של AttachmentHasBytes הוא false או לא מוגדר. |
| עותק מוסתר | String | לא | כתובת האימייל של הנמען שהועתק לעותק מוסתר. אם יש כמה נמענים, צריך להשתמש ברשימה מופרדת בפסיקים. |
| AttachmentContentBytes | String | לא | תוכן הקובץ לצירוף בבייטים בקידוד Base64. הפרמטר הזה נמצא בשימוש כשהערך של AttachmentHasBytes הוא True. |
| CC | String | לא | כתובת האימייל של הנמען שקיבל עותק. אם יש כמה נמענים, צריך להשתמש ברשימה מופרדת בפסיקים. |
| תוכן | String | כן | התוכן העיקרי של הודעת האימייל. |
| AttachmentPath | String | לא | רשימה מופרדת בפסיקים של נתיבי קבצים מקומיים לצירוף לאימייל. |
דוגמה להגדרת הפעולה SendMailMessages מופיעה במאמר דוגמאות.
הפעולה DownloadAttachment
הפעולה הזו מורידה קובץ מצורף מ-Gmail.
פרמטרים של קלט לפעולה DownloadAttachment
| שם הפרמטר | סוג נתונים | חובה | תיאור |
|---|---|---|---|
| MessageId | String | כן | המזהה של האימייל. |
| DownloadLocation | String | לא | המיקום שבו הקובץ המצורף יישמר. |
| FileStream | String | לא | מופע של זרם פלט שבו נכתבים נתונים של קובץ. |
| AttachmentId | String | לא | המזהה של הקובץ המצורף. חובה לציין את הערך הזה אם מציינים את FileStream. |
דוגמה להגדרת הפעולה DownloadAttachment מופיעה במאמר דוגמאות.
דוגמאות לפעולות
בקטע הזה מוסבר איך לבצע חלק מהפעולות במחבר הזה.
דוגמה – שליחת הודעה ב-Gmail
- בתיבת הדו-שיח
Configure connector task, לוחצים עלActions. - בוחרים את הפעולה
SendMailMessagesולוחצים על סיום. - בקטע Task Input (קלט המשימה) של המשימה Connectors (מחברים), לוחצים על
connectorInputPayloadומזינים ערך דומה לערך הבא בשדהDefault Value:{ "To": "testbristleconeemail@gmail.com", "Subject": "Data MapperCheck", "Content": "Gmail", }
אם הפעולה מצליחה, פרמטר התגובה connectorOutputPayload של משימת המחבר יקבל ערך שדומה לזה:
[{
"Id": "199334f660ff462a"
}]
דוגמה – שליחת הודעה ב-Gmail עם קובץ מצורף מסוג JPG
- בתיבת הדו-שיח
Configure connector task, לוחצים עלActions. - בוחרים את הפעולה
SendMailMessagesולוחצים על סיום. - בקטע Task Input (קלט המשימה) של המשימה Connectors (מחברים), לוחצים על
connectorInputPayloadומזינים ערך דומה לערך הבא בשדהDefault Value:{ "To": "testbristleconeemail@gmail.com", "Subject": "Data Mapper Email Sep10 JPG", "Content": "Gmail", "AttachmentFileName": "TestSep10.jpg", "AttachmentContentBytes": "/9j/4AAQSkZJRgABAQEBLAEsAAD/2wBDAAIBAQEBAQIBAQECAgICAgQDAgICAgUEBAMEBgUGBgYFBgYGBwkIBgcJBwYGCAsICQoKCgoKBggLDAsKDAkKCgr/2wBDAQICAgICAgUDAwUKBwYHCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgr/wAARCANUBdwDAREAAhEBAxEB/8QAHgABAAAGAwEAAAAAAAAAAAAAAAEDBAcICQIFBgr/xABsEAABAwMCBAMFBQQHAwUJACMBAgMEAAURBgcIEiExCRNBChQiUWEVIzJxgUJSkaEWFzNicrHBJEPRNFOCkqIYJTlEY4O14fDxJmRzdXZ3k7PCNTY4haOytLYZN1RVV8NIVmV0eJSWpNLT4v/EAB0BAQABBAMBAAAAAAAAAAAAAAAHAQQFBgIDCAn/xABXEQABAwURKIlESiJREoiURKIlESiJREoiURKIlESiJREoiURKIlESiJREoiURKIlESiJREoiURKIlESiJREoiURKIlESiJREoiURKIlESiJREoiURKIlESiJREoiURKIlESiJREoiURKIlESiJREoiURKIlESiJREoiURKIlESiJREoiURKIlESiJREoiURKIlESiJREoiURKIlESiJREoiURKIlESiJREoiURKIlESiJREoiURKIlESiJREoiURKIlESiJREoiURKIlESiJREoiURKIlESiJREoiURKIlESiJREoiURKIlESiJREoiURKIlESiJREoiURKIlESiJREoiURKIlESiJREoiURKIlESiJREoiURKIlESiJREoiURKIlESiJREoiURKIlESiJREoiURKIlESiJREoiURKIlESiJREoiURKIlESiJREoiURKIlESiJREoiURKIlESiJREoiURKIlESiJREoiURKIlESiJREoiURKIlESiJREoiURKIlESiJREoiURKIlESiJREoiURKIlESiJREoiURKIlESiJREoiURKIlESiJREoiURKIlESiJREoiURKIlESiJREoiURKIlESiJREoiURKIlESiJREoiURKIlESiJREoiURKIlESiJREoiURKIlESiJREoiURKIlESiJREoiURKIlESiJREoiURKIlESiJREoiURKIlESiJREoiURKIlESiJREoiURKIlESiJREoiURKIlESiJREoiURKIlESiJREoiURKIlESiJREoiURKIlESiJREoiURKIlESiJREoiURKIlESiJREoiURKIlESiJREoiURKIlESiJREoiURKIlESiJREoiURKIlESiJREoiURKIlESiJREoiURKIlESiJREoiURKIlESiJREoiURKIlESiJREoiURKIlESiJREoiURKIlESiJREoiURKIlESiJREoiURKIlESiJREoiURKIlESiJREoiURKIlESiJREoiURKIlESiJREoiURKIlESiJREoiURKIlESiJREoiURKIlESiJREoiURKIlESiJREoiURKIlESiJREoiURKIlESiJREoiURKIlESiJREoiURKIlESiJREoiURKIlESiJREoiURKIlESiJREoiURKIlESiJREoiURKIlESiJREoiURKIlESiJREoiURKIlESiJREoiURKIlESiJREoiURKIlESiJREoiURKIlESiJREoiURKIlESiJREoiURKIlESiJREoiURKIlESiJREoiURKIlESiJREoiURKIlESiJREoiURKIv/Z", "AttachmentHasBytes": true }
אם הפעולה מצליחה, פרמטר התגובה connectorOutputPayload של משימת המחבר יקבל ערך שדומה לזה:
[{
"Id": "199334f660ff462a"
}]
דוגמה – שליחת הודעה ב-Gmail עם קובץ PDF מצורף
- בתיבת הדו-שיח
Configure connector task, לוחצים עלActions. - בוחרים את הפעולה
SendMailMessagesולוחצים על סיום. - בקטע Task Input (קלט המשימה) של המשימה Connectors (מחברים), לוחצים על
connectorInputPayloadומזינים ערך דומה לערך הבא בשדהDefault Value:{ "To": "testbristleconeemail@gmail.com", "Subject": "Data Mapper Email Sep10", "Content": "Gmail", "AttachmentFileName": "TestSep10.pdf", "AttachmentContent": "JVBERi0xLjQKJcOkw7zDtsOfCjIgMCBvYmoKPDwvTGVuZ3RoIDMgMCBSL0ZpbHRlci9GbGF0ZURlY29kZT4+CnN0cmVhbQp4nD2OywoCMQxF9/mKu3YRk7bptDAIDuh+oOAP+AAXgrOZ37etjmSTe3ISIljpDYGwwrKxRwrKGcsNlx1e31mt5UFTIYucMFiqcrlif1ZobP0do6g48eIPKE+ydk6aM0roJG/RegwcNhDr5tChd+z+miTJnWqoT/3oUabOToVmmvEBy5IoCgplbmRzdHJlYW0KZW5kb2JqCgozIDAgb2JqCjEzNAplbmRvYmoKCjUgMCBvYmoKPDwvTGVuZ3RoIDYgMCBSL0ZpbHRlci9GbGF0ZURlY29kZS9MZW5ndGgxIDIzMTY0Pj4Kc3RyZWFtCnic7Xx5fFvVlf+59z0tdrzIu7xFz1G8Kl7i2HEWE8vxQlI3iRM71A6ksSwrsYptKZYUE9omYStgloZhaSlMMbTsbSPLAZwEGgNlusxQ0mHa0k4Z8muhlJb8ynQoZVpi/b736nkjgWlnfn/8Pp9fpNx3zz33bPecc899T4oVHA55KIEOkUJO96DLvyQxM5WI/omIpbr3BbU/3J61FPBpItOa3f49g1948t/vI4rLIzL8dM/A/t3vn77ZSpT0LlH8e/0eV98jn3k0mSj7bchY2Q/EpdNXm4hyIIOW9g8Gr+gyrq3EeAPGVQM+t+uw5VrQ51yBcc6g6wr/DywvGAHegbE25Br0bFR/ezPGR4kq6/y+QPCnVBYl2ijka/5hjz95S8kmok8kEFl8wDG8xQtjZhRjrqgGo8kcF7+I/r98GY5TnmwPU55aRIhb9PWZNu2Nvi7mRM9/C2flx5r+itA36KeshGk0wf5MWfQ+y2bLaSOp9CdkyxE6S3dSOnXSXSyVllImbaeNTAWNg25m90T3Rd+ii+jv6IHoU+zq6GOY/yL9A70PC/5NZVRHm0G/nTz0lvIGdUe/Qma6nhbRWtrGMslFP8H7j7DhdrqDvs0+F30fWtPpasirp0ZqjD4b/YDK6Gb1sOGVuCfoNjrBjFF31EuLaQmNckf0J9HXqIi66Wv0DdjkYFPqBiqgy+k6+jLLVv4B0J30dZpmCXy", "AttachmentHasBytes": true }
אם הפעולה מצליחה, פרמטר התגובה connectorOutputPayload של משימת המחבר יקבל ערך שדומה לזה:
[{
"Id": "1993341d558d7b07"
}]
דוגמה – שליחת הודעה ב-Gmail עם קובץ TXT מצורף
- בתיבת הדו-שיח
Configure connector task, לוחצים עלActions. - בוחרים את הפעולה
SendMailMessagesולוחצים על סיום. - בקטע Task Input (קלט המשימה) של המשימה Connectors (מחברים), לוחצים על
connectorInputPayloadומזינים ערך דומה לערך הבא בשדהDefault Value:{ "To": "testbristleconeemail@gmail.com", "Subject": "Data Mapper Email Sep10", "Content": "Gmail", "AttachmentFileName": "TestSep10.txt", "AttachmentContent": "TestingwithAttachment", "AttachmentHasBytes": true }
אם הפעולה מצליחה, פרמטר התגובה connectorOutputPayload של משימת המחבר יקבל ערך שדומה לזה:
[{
"Id": "1993341d558d7b07"
}]
דוגמה – הורדת קובץ מצורף מ-Gmail
- בתיבת הדו-שיח
Configure connector task, לוחצים עלActions. - בוחרים את הפעולה
DownloadAttachmentולוחצים על סיום. - בקטע Task Input (קלט המשימה) של המשימה Connectors (מחברים), לוחצים על
connectorInputPayloadומזינים ערך דומה לערך הבא בשדהDefault Value:{ "MessageId": "198acdcde5c09ce5" }
אם הפעולה מצליחה, פרמטר התגובה connectorOutputPayload של משימת המחבר יקבל ערך שדומה לזה:
[{
"Success": "true",
"MessageId": "198acdcde5c09ce5",
"AttachmentId": "1",
"Size": "58005",
"Data": "JVBERi0xLjQKJdPr6eEKMSAwIG9iago8PC9UaXRsZSAoYWJvdXQ6YmxhbmspCi9DcmVhdG9yIChNb3ppbGxhLzUuMCBcKFgxMTsgTGludXggeDg2XzY0XCkgQXBwbGVXZWJLaXQvNTM3LjM2IFwoS0hUTUwsIGxpa2UgR2Vja29cKSBIZWFkbGVzc0Nocm9tZS8xMzguMC4wLjAgU2FmYXJpLzUzNy4zNikKL1Byb2R1Y2VyIChTa2lhL1BERiBtMTM4KQovQ3JlYXRpb25EYXRlIChEOjIwMjUwODE1MDgwMDE2KzAwJzAwJykKL01vZERhdGUgKEQ6MjAyNTA4MTUwODAwMTYrMDAnMDAnKT4-CmVuZG9iagozIDAgb2JqCjw8L2NhIDEKL0JNIC9Ob3JtYWw-PgplbmRvYmo",
"Filename": "My_Store_404672162.pdf",
"@isoutervalue": null
}]
דוגמאות לפעולות על ישויות
בקטע הזה מוסבר איך לבצע חלק מהפעולות על ישויות במחבר הזה.
דוגמה – רשימה של כל ההודעות ב-Gmail
- בתיבת הדו-שיח
Configure connector task, לוחצים עלEntities. - בוחרים באפשרות
MessagesמהרשימהEntity. - בוחרים את הפעולה
Listולוחצים על סיום. - בקטע Task Input במשימה Connectors, אפשר להגדיר את filterClause בהתאם לדרישות הלקוח.
חובה להשתמש במירכאות בודדות (') כדי להקיף את הערך של filterClause. אפשר להשתמש ב-filterClause כדי לסנן רשומות על סמך העמודות.
דוגמה – קבלת פרטים של הודעה ב-Gmail מתיבת הדואר הנכנס
- בתיבת הדו-שיח
Configure connector task, לוחצים עלEntities. - בוחרים באפשרות
InboxמהרשימהEntity. - בוחרים את הפעולה
Getולוחצים על סיום. - מגדירים את entityId ל-
1, שהוא המפתח שיועבר. כדי להגדיר את entityId, בקטע Data Mapper (מיפוי נתונים) של Data Mapping (מיפוי נתונים), לוחצים על Open Data Mapping Editor (פתיחת כלי מיפוי הנתונים), מזינים1בשדה Input Value (ערך קלט) ובוחרים את entityId כמשתנה מקומי.
הערך של entityId צריך להיות מועבר ישירות, למשל "1". כאן, "1" הוא הערך הייחודי של המפתח הראשי שמועבר.
במקרים מסוימים, העברה של entityId יחיד עלולה לגרום לשגיאה כי לישות יש שני מפתחות מורכבים. במקרים כאלה, אפשר להשתמש ב-filterClause ולהעביר את הערך, כמו id='1'.
דוגמה – מחיקת הודעה ב-Gmail
- בתיבת הדו-שיח
Configure connector task, לוחצים עלEntities. - בוחרים באפשרות
MessagesמהרשימהEntity. - בוחרים את הפעולה
Deleteולוחצים על סיום. - מגדירים את entityId ל-
1, שהוא המפתח שיועבר. - כדי להגדיר את entityId, בקטע מיפוי נתונים של מיפוי הנתונים, לוחצים על פתיחת הכלי לעריכת מיפוי נתונים, מזינים
1בשדה ערך קלט ובוחרים באפשרות entityId כמשתנה מקומי.אם לישות יש שני מפתחות עסקיים מורכבים או שני מפתחות ראשיים במקום לציין את entityId, אפשר גם להגדיר את filterClause לערך
id='1'.