שילוב AppSheet עם Google SecOps

במאמר הזה מוסבר איך לשלב את AppSheet עם Google Security Operations ‏ (Google SecOps).

תרחישים לדוגמה

ביצוע פעולות CRUD.

פרמטרים של שילוב

משתמשים בפרמטרים הבאים כדי להגדיר את השילוב:

שם הפרמטר	סוג	ערך ברירת המחדל	חובה	תיאור
ספריית הבסיס של ה-API	String	https://api.appsheet.com	כן	הבסיס של ה-API במופע AppSheet.
מזהה אפליקציה	String	לא רלוונטי	כן	המזהה של אפליקציית AppSheet.
טוקן גישה	סיסמה	לא רלוונטי	כן	טוקן הגישה של אפליקציית AppSheet.
אימות SSL	תיבת סימון	סימן אישור	כן	אם האפשרות הזו נבחרה, האינטגרציה מאמתת את אישור ה-SSL כשהיא מתחברת לשרת AppSheet.

הוראות להגדרת שילוב ב-Google SecOps מופיעות במאמר הגדרת שילובים.

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

פעולות

מידע נוסף על פעולות זמין במאמרים איך מגיבים לפעולות שממתינות לאישור ב-Your Workdesk ואיך מבצעים פעולה ידנית.

הוספת רשומה

מוסיפים רשומה לטבלה ב-AppSheet.

פרמטרים

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

הפעלה ב-

הפעולה הזו לא מופעלת על ישויות.

תוצאות הפעולה

תוצאת סקריפט

שם התוצאה של הסקריפט	אפשרויות ערך	דוגמה
is_success	נכון/לא נכון	is_success=False

Case wall

סוג התוצאות	תיאור	סוג
הודעת פלט*	הפעולה לא אמורה להיכשל או לעצור את ההרצה של חוברת ההדרכה: אם הנתונים זמינים (is_success = true): "Successfully added new record in table "{table}" in AppSheet. הפעולה צריכה להיכשל ולהפסיק את ההרצה של מדריך ההפעלה: אם מדווחת שגיאה קריטית, כמו פרטי כניסה שגויים, אין חיבור לשרת או שגיאה אחרת: "Error executing action "Add Record". הסיבה: {0}''.format(error.Stacktrace) אם אין נתונים בתגובה: "שגיאה בהפעלת הפעולה 'הוספת רשומה'. הסיבה: מטען ייעודי (payload) לא תקין סופק. צריך לבדוק את האיות של שם הטבלה ואת המבנה של אובייקט ה-JSON של הרשומה'. אם התגובה היא 'הודעה': 'שגיאה בהפעלת הפעולה 'הוספת רשומה'. הסיבה: {0}''.format(Message) אובייקט JSON לא תקין: שגיאה בהפעלת הפעולה 'הוספת רשומה'. הסיבה: סופק אובייקט JSON לא תקין. צריך לבדוק את המבנה.	כללי

מחיקת רשומה

מחיקת רשומה בטבלה ב-AppSheet.

פרמטרים

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

הפעלה ב-

הפעולה הזו לא מופעלת על ישויות.

תוצאות הפעולה

תוצאת סקריפט

שם התוצאה של הסקריפט	אפשרויות ערך	דוגמה
is_success	נכון/לא נכון	is_success=False

Case wall

סוג התוצאות	תיאור	סוג
הודעת פלט*	הפעולה לא אמורה להיכשל או לעצור את ההרצה של חוברת ההדרכה: אם הנתונים זמינים (is_success = true): "Successfully deleted record in table "{table}" in AppSheet. אם קוד הסטטוס הוא 200, אבל rowNumber הוא null‏ (is_success=true): הרשומה שסופקה לא קיימת בטבלה {table} ב-AppSheet. הפעולה צריכה להיכשל ולהפסיק את ההרצה של מדריך ההפעלה: אם מדווחת שגיאה קריטית, כמו פרטי כניסה שגויים, אין חיבור לשרת או שגיאה אחרת: "שגיאה בהפעלת הפעולה 'מחיקת רשומה'. הסיבה: {0}''.format(error.Stacktrace) אם אין נתונים בתגובה: "שגיאה בהפעלת הפעולה 'מחיקת רשומה'. הסיבה: מטען ייעודי (payload) לא תקין סופק. צריך לבדוק את האיות של שם הטבלה ואת המבנה של אובייקט ה-JSON של הרשומה'. אם התגובה היא Message: "Error executing action "Delete Record". Reason: {0}''.format(Message) שגיאה בהפעלת הפעולה 'מחיקת רשומה'. הסיבה: סופק אובייקט JSON לא תקין. צריך לבדוק את המבנה.	כללי

הצגת רשימה של טבלאות

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

פרמטרים

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

הפעלה ב-

הפעולה הזו לא מופעלת על ישויות.

תוצאות הפעולה

תוצאת סקריפט

שם התוצאה של הסקריפט	אפשרויות ערך	דוגמה
is_success	נכון/לא נכון	is_success=False

תוצאה בפורמט JSON

{
    "Tables": [
        {
            "name": "Hash identificiation",
            "id": "Hash identificiation"
        }
    ]
}

Case wall

סוג התוצאות	תיאור	סוג
הודעת פלט*	הפעולה לא אמורה להיכשל או לעצור את ההרצה של חוברת ההדרכה: אם נמצאו תוצאות (is_success = true): 'נמצאו טבלאות בהתאם לקריטריונים שצוינו ב-AppSheet. אם לא נמצאו תוצאות (is_success = true): 'לא נמצאו טבלאות לקריטריונים שצוינו ב-AppSheet. הפעולה צריכה להיכשל ולהפסיק את ההרצה של מדריך ההפעלה: אם מדווחת שגיאה קריטית, כמו פרטי כניסה שגויים, אין חיבור לשרת או שגיאה אחרת: "Error executing action "List Tables". הסיבה: {0}''.format(error.Stacktrace)	כללי
Case Wall Table	שם: שולחנות זמינים עמודות: מזהה שם	כללי

פינג

בודקים את הקישוריות ל-AppSheet.

פרמטרים

אין.

הפעלה ב-

הפעולה הזו לא מופעלת על ישויות.

תוצאות הפעולה

תוצאת סקריפט

שם התוצאה של הסקריפט	אפשרויות ערך	דוגמה
is_success	נכון/לא נכון	is_success=False

Case wall

סוג התוצאות	תיאור	סוג
הודעת פלט*	הפעולה לא אמורה להיכשל או לעצור את ההרצה של חוברת ההדרכה: אם הפעולה תצליח: "החיבור לשרת AppSheet בוצע בהצלחה עם פרמטרי החיבור שסופקו!" הפעולה צריכה להיכשל ולהפסיק את ההרצה של מדריך ההפעלה: אם הפעולה לא מצליחה: 'החיבור לשרת AppSheet נכשל! השגיאה היא {0}'.format(exception.stacktrace)	כללי

חיפוש מסמכים

חיפוש רשומות בטבלה ב-AppSheet.

פרמטרים

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

הפעלה ב-

הפעולה הזו לא מופעלת על ישויות.

תוצאות הפעולה

תוצאת סקריפט

שם התוצאה של הסקריפט	אפשרויות ערך	דוגמה
is_success	נכון/לא נכון	is_success=False

Case wall

סוג התוצאות	תיאור	סוג
הודעת פלט*	הפעולה לא אמורה להיכשל או לעצור את ההרצה של חוברת ההדרכה: אם הנתונים זמינים (is_success = true): "הנתונים אוחזרו בהצלחה על סמך הקריטריונים שסופקו מהטבלה {table} ב-AppSheet. אם אין נתונים זמינים (is_success=false): לא נמצאו רשומות על סמך הקריטריונים שצוינו בטבלה {table} ב-AppSheet. הפעולה צריכה להיכשל ולהפסיק את ההרצה של מדריך ההפעלה: אם מדווחת שגיאה קריטית, כמו פרטי כניסה שגויים, אין חיבור לשרת או שגיאה אחרת: "שגיאה בהפעלת הפעולה 'חיפוש רשומות'. הסיבה: {0}''.format(error.Stacktrace) אם התגובה היא Message: 'Error executing action "Search Records". Reason: {0}''.format(Message)	כללי
Case Wall Table	שם: רשומות	כללי

עדכון רשומה

עדכון רשומה בטבלה ב-AppSheet.

פרמטרים

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

הפעלה ב-

הפעולה הזו לא מופעלת על ישויות.

תוצאות הפעולה

תוצאת סקריפט

שם התוצאה של הסקריפט	אפשרויות ערך	דוגמה
is_success	נכון/לא נכון	is_success=False

Case wall

סוג התוצאות	תיאור	סוג
הודעת פלט*	הפעולה לא אמורה להיכשל או לעצור את ההרצה של חוברת ההדרכה: אם הנתונים זמינים (is_success = true): 'העדכון של הרשומה בטבלה {table} ב-AppSheet בוצע בהצלחה'. הפעולה צריכה להיכשל ולהפסיק את ההרצה של מדריך ההפעלה: אם מדובר בשגיאה קריטית, כמו פרטי כניסה שגויים, אין חיבור לשרת, או שגיאה אחרת: "שגיאה בהפעלת הפעולה 'עדכון רשומה'. הסיבה: {0}''.format(error.Stacktrace) אם אין נתונים בתגובה: "שגיאה בהפעלת הפעולה 'עדכון רשומה'. הסיבה: מטען ייעודי (payload) לא תקין סופק. צריך לבדוק את האיות של שם הטבלה ואת המבנה של אובייקט ה-JSON של הרשומה'. אם התגובה כוללת את ההודעה: "Error executing action "Update Record". הסיבה: {0}''.format(Message) שגיאה בהפעלת הפעולה 'עדכון רשומה'. הסיבה: סופק אובייקט JSON לא תקין. צריך לבדוק את המבנה.	כללי

הבעיה עדיין לא נפתרה? קבלת תשובות מחברי הקהילה וממומחי Google SecOps.