שילוב של AppSheet עם Google SecOps
במאמר הזה מוסבר איך לשלב את AppSheet עם Google Security Operations (Google SecOps).
תרחישים לדוגמה
לבצע פעולות CRUD.
פרמטרים של שילוב
כדי להגדיר את השילוב, משתמשים בפרמטרים הבאים:
| שם הפרמטר | סוג | ערך ברירת המחדל | חובה | תיאור |
|---|---|---|---|---|
| הרמה הבסיסית (root) של ה-API | String | https://api.appsheet.com | כן | שורש ה-API של המכונה של AppSheet. |
| מזהה אפליקציה | String | לא רלוונטי | כן | המזהה של אפליקציית AppSheet. |
| טוקן גישה | סיסמה | לא רלוונטי | כן | טוקן גישה של אפליקציית AppSheet. |
| אימות SSL | תיבת סימון | סימן אישור | כן | אם האפשרות הזו נבחרת, השילוב מאמת את אישור ה-SSL כשמתחברים לשרת AppSheet. |
איך מגדירים שילובים ב-Google SecOps
אם צריך, אפשר לבצע שינויים בשלב מאוחר יותר. אחרי שמגדירים מופע של אינטגרציה, אפשר להשתמש בו בפלייבוקים. במאמר תמיכה במספר מופעים מוסבר איך להגדיר מספר מופעים ולתמוך בהם.
פעולות
מידע נוסף על פעולות זמין במאמרים מענה לפעולות בהמתנה משולחן העבודה והפעלה ידנית של פעולה בבקשת התמיכה.
הוספת רשומה
הוספת רשומה לטבלה ב-AppSheet.
פרמטרים
| שם הפרמטר | סוג | ערך ברירת המחדל | חובה | תיאור |
|---|---|---|---|---|
| שם טבלה | String | לא רלוונטי | כן | מציינים את שם הטבלה שאליה רוצים להוסיף רשומה חדשה. |
| אובייקט JSON של רשומה | JSON | כן | מציינים את אובייקט ה-JSON של הרשומה שצריך להוסיף. |
הפעלה ב-
הפעולה הזו לא פועלת על ישויות.
תוצאות הפעולה
תוצאת הסקריפט
| שם תוצאת הסקריפט | אפשרויות לערכים | דוגמה |
|---|---|---|
| is_success | נכון/לא נכון | is_success=False |
קיר נרתיק הטעינה
| סוג התוצאות | תיאור | סוג |
|---|---|---|
| הודעת פלט* | הפעולה לא אמורה להיכשל או להפסיק את ההפעלה של הפלייבוק: אם הנתונים זמינים (is_success = true): "נוספה רשומה חדשה בטבלה "{table}" ב-AppSheet. הפעולה אמורה להיכשל ולעצור את ההפעלה של הפלייבוק: אם מדווחת שגיאה חמורה, כמו פרטי כניסה שגויים, אין חיבור לשרת או שגיאה אחרת: "שגיאה בביצוע הפעולה 'הוספת רשומה'. הסיבה: {0}''.format(error.Stacktrace) אם אין נתונים בתגובה: "Error executing action "Add Record". הסיבה: המטען הייעודי (payload) שסופק לא תקין. צריך לבדוק את האיות של שם הטבלה ואת המבנה של אובייקט ה-JSON של הרשומה.' אם מופיעה ההודעה הבאה בתגובה: "Error executing action "Add Record". הסיבה: {0}''.format(Message) אובייקט JSON לא תקין: שגיאה בביצוע הפעולה "הוספת רשומה". הסיבה: אובייקט ה-JSON שסופק לא תקין. צריך לבדוק את המבנה. |
כללי |
מחיקת הרשומה
מחיקת רשומה בטבלה ב-AppSheet.
פרמטרים
| שם הפרמטר | סוג | ערך ברירת המחדל | חובה | תיאור |
|---|---|---|---|---|
| שם טבלה | String | לא רלוונטי | כן | מציינים את שם הטבלה שבה רוצים למחוק רשומה. |
| אובייקט JSON של רשומה | JSON | כן | מציינים את אובייקט ה-JSON של הרשומה שרוצים למחוק. צריך לספק רק את מפתח המזהה הייחודי של הרשומה. |
הפעלה ב-
הפעולה הזו לא פועלת על ישויות.
תוצאות הפעולה
תוצאת הסקריפט
| שם תוצאת הסקריפט | אפשרויות לערכים | דוגמה |
|---|---|---|
| is_success | נכון/לא נכון | is_success=False |
קיר נרתיק הטעינה
| סוג התוצאות | תיאור | סוג |
|---|---|---|
| הודעת פלט* | הפעולה לא אמורה להיכשל או להפסיק את ההפעלה של הפלייבוק: אם הנתונים זמינים (is_success = true): "הרשומה נמחקה בהצלחה בטבלה "{table}" ב-AppSheet. אם קוד הסטטוס הוא 200, אבל הערך של rowNumber הוא null (is_success=true): הרשומה שצוינה לא קיימת בטבלה "{table}" ב-AppSheet. הפעולה אמורה להיכשל ולעצור את ההפעלה של הפלייבוק: אם מדווחת שגיאה חמורה, כמו פרטי כניסה שגויים, אין חיבור לשרת או שגיאה אחרת: "שגיאה בביצוע הפעולה 'מחיקת רשומה'. הסיבה: {0}''.format(error.Stacktrace) אם אין נתונים בתגובה: "Error executing action "Delete Record". הסיבה: המטען הייעודי (payload) שסופק לא תקין. צריך לבדוק את האיות של שם הטבלה ואת המבנה של אובייקט ה-JSON של הרשומה.' אם מופיעה ההודעה הבאה בתגובה: "Error executing action "Delete Record". הסיבה: {0}''.format(Message) הייתה שגיאה בביצוע הפעולה "מחיקת רשומה". הסיבה: אובייקט ה-JSON שסופק לא תקין. צריך לבדוק את המבנה. |
כללי |
הצגת רשימת הטבלאות
הצגת רשימה של הטבלאות הזמינות באפליקציה ב-AppSheet.
פרמטרים
| שם הפרמטר | סוג | ערך ברירת המחדל | חובה | תיאור |
|---|---|---|---|---|
| לוגיקת הסינון | DDL | שווה ערכים אפשריים:
|
לא | מציינים את לוגיקת הסינון שרוצים להחיל. |
| ערך המסנן | String | לא רלוונטי | לא | מציינים באיזה ערך להשתמש במסנן. אם בוחרים באפשרות "שווה", הפעולה תנסה למצוא את ההתאמה המדויקת בין הפריטים. אם בוחרים באפשרות "מכיל", הפעולה תנסה למצוא פריטים שמכילים את מחרוזת המשנה הזו. אם לא מציינים ערך בפרמטר הזה, המסנן לא יופעל. |
| מספר הטבלאות המקסימלי להחזרה | מספר שלם | 50 | לא | מציינים כמה טבלאות רוצים להחזיר. ברירת המחדל: 50. |
הפעלה ב-
הפעולה הזו לא פועלת על ישויות.
תוצאות הפעולה
תוצאת הסקריפט
| שם תוצאת הסקריפט | אפשרויות לערכים | דוגמה |
|---|---|---|
| is_success | נכון/לא נכון | is_success=False |
תוצאת JSON
{
"Tables": [
{
"name": "Hash identificiation",
"id": "Hash identificiation"
}
]
}
קיר נרתיק הטעינה
| סוג התוצאות | תיאור | סוג |
|---|---|---|
| הודעת פלט* | הפעולה לא אמורה להיכשל או להפסיק את ההפעלה של הפלייבוק: אם נמצאו תוצאות (is_success = true): "נמצאו טבלאות ב-AppSheet שתואמות לקריטריונים שצוינו. אם לא נמצאו תוצאות (is_success = true): "לא נמצאו טבלאות שתואמות לקריטריונים שצוינו ב-AppSheet. הפעולה אמורה להיכשל ולעצור את ההפעלה של הפלייבוק: אם מדווחת שגיאה חמורה, כמו פרטי כניסה שגויים, אין חיבור לשרת או שגיאה אחרת: "שגיאה בביצוע הפעולה 'רשימת טבלאות'. הסיבה: {0}''.format(error.Stacktrace) |
כללי |
| שולחן קיר עם ויטרינה | שם: שולחנות פנויים עמודות:
|
כללי |
פינג
בודקים את הקישוריות ל-AppSheet.
פרמטרים
אין.
הפעלה ב-
הפעולה הזו לא פועלת על ישויות.
תוצאות הפעולה
תוצאת הסקריפט
| שם תוצאת הסקריפט | אפשרויות לערכים | דוגמה |
|---|---|---|
| is_success | נכון/לא נכון | is_success=False |
קיר נרתיק הטעינה
| סוג התוצאות | תיאור | סוג |
|---|---|---|
| הודעת פלט* | הפעולה לא אמורה להיכשל או להפסיק את ההפעלה של הפלייבוק: אם החיבור הצליח: "החיבור לשרת AppSheet בוצע בהצלחה באמצעות פרמטרי החיבור שסופקו". הפעולה אמורה להיכשל ולעצור את ההפעלה של הפלייבוק: אם החיבור נכשל: "החיבור לשרת AppSheet נכשל. השגיאה היא {0}".format(exception.stacktrace) |
כללי |
חיפוש רשומות
חיפוש רשומות בטבלה ב-AppSheet.
פרמטרים
| שם הפרמטר | סוג | ערך ברירת המחדל | חובה | תיאור |
|---|---|---|---|---|
| שם טבלה | String | לא רלוונטי | כן | מציינים את שם הטבלה שרוצים לאחזר את הפרטים שלה. |
| שאילתת בורר | String | לא רלוונטי | לא | מציינים את שאילתת הבורר, שתשמש להגבלת התוצאות. אם לא תציינו ערך, הפעולה תחזיר את כל הרשומות. |
הפעלה ב-
הפעולה הזו לא פועלת על ישויות.
תוצאות הפעולה
תוצאת הסקריפט
| שם תוצאת הסקריפט | אפשרויות לערכים | דוגמה |
|---|---|---|
| is_success | נכון/לא נכון | is_success=False |
קיר נרתיק הטעינה
| סוג התוצאות | תיאור | סוג |
|---|---|---|
| הודעת פלט* | הפעולה לא אמורה להיכשל או להפסיק את ההפעלה של הפלייבוק: אם הנתונים זמינים (is_success = true): "Successfully retrieved records based on the provided criteria from table "{table}" in AppSheet. אם אין נתונים זמינים (is_success=false): לא נמצאו רשומות על סמך הקריטריונים שצוינו בטבלה "{table}" ב-AppSheet. הפעולה אמורה להיכשל ולעצור את ההפעלה של הפלייבוק: אם מדווחת שגיאה חמורה, כמו פרטי כניסה שגויים, אין חיבור לשרת או שגיאה אחרת: "שגיאה בביצוע הפעולה 'חיפוש רשומות'. הסיבה: {0}''.format(error.Stacktrace) אם מופיעה ההודעה הבאה בתגובה: "Error executing action "Search Records". הסיבה: {0}''.format(Message) |
כללי |
| שולחן קיר עם ויטרינה | שם: רשומות | כללי |
עדכון הרשומה
עדכון רשומה בטבלה ב-AppSheet.
פרמטרים
| שם הפרמטר | סוג | ערך ברירת המחדל | חובה | תיאור |
|---|---|---|---|---|
| שם טבלה | String | לא רלוונטי | כן | מציינים את שם הטבלה שבה רוצים לעדכן רשומה. |
| אובייקט JSON של רשומה | JSON | כן | מציינים את אובייקט ה-JSON של הרשומה שצריך לעדכן. אתם צריכים לספק את מפתח המזהה הייחודי ואת השדות שאתם רוצים לעדכן. |
הפעלה ב-
הפעולה הזו לא פועלת על ישויות.
תוצאות הפעולה
תוצאת הסקריפט
| שם תוצאת הסקריפט | אפשרויות לערכים | דוגמה |
|---|---|---|
| is_success | נכון/לא נכון | is_success=False |
קיר נרתיק הטעינה
| סוג התוצאות | תיאור | סוג |
|---|---|---|
| הודעת פלט* | הפעולה לא אמורה להיכשל או להפסיק את ההפעלה של הפלייבוק: אם הנתונים זמינים (is_success = true):"הרשומה עודכנה בהצלחה בטבלה "{table}" ב-AppSheet. הפעולה אמורה להיכשל ולעצור את ההפעלה של הפלייבוק: אם יש שגיאה חמורה, כמו פרטי כניסה שגויים, אין חיבור לשרת, אחר: "שגיאה בביצוע הפעולה 'עדכון רשומה'. הסיבה: {0}''.format(error.Stacktrace) אם אין נתונים בתגובה: "Error executing action "Update Record". הסיבה: המטען הייעודי (payload) שסופק לא תקין. צריך לבדוק את האיות של שם הטבלה ואת המבנה של אובייקט ה-JSON של הרשומה.' אם מופיעה ההודעה הבאה בתגובה: "Error executing action "Update Record". הסיבה: {0}''.format(Message) הייתה שגיאה בביצוע הפעולה "עדכון רשומה". הסיבה: אובייקט ה-JSON שסופק לא תקין. צריך לבדוק את המבנה. |
כללי |
הבעיה עדיין לא נפתרה? קבלת תשובות מחברי הקהילה וממומחי Google SecOps.