שילוב של 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.