REST Resource: projects.histories.executions.environments

משאב: איכות הסביבה

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

ייצוג JSON
{
  "projectId": string,
  "historyId": string,
  "executionId": string,
  "environmentId": string,
  "dimensionValue": {
    string: string,
    ...
  },
  "displayName": string,
  "creationTime": {
    object (Timestamp)
  },
  "completionTime": {
    object (Timestamp)
  },
  "shardSummaries": [
    {
      object (ShardSummary)
    }
  ],
  "environmentResult": {
    object (MergedResult)
  },
  "resultsStorage": {
    object (ResultsStorage)
  }
}
שדות
projectId

string

פלט בלבד. מזהה פרויקט.

historyId

string

פלט בלבד. מזהה היסטוריה.

executionId

string

פלט בלבד. מזהה ביצוע.

environmentId

string

פלט בלבד. מזהה סביבה.

dimensionValue

map (key: string, value: string)

ערכי מימד המתארים את הסביבה. ערכי מימד מורכבים תמיד מ"דגם", "גרסה", "מקומי" ו"כיוון".

  • בתגובה: תמיד מוגדר
  • בבקשת יצירה: הגדר תמיד
  • בבקשת עדכון: לעולם לא הוגדר

אובייקט המכיל רשימה של "key": value . דוגמה: { "name": "wrench", "mass": "1.3kg", "count": "3" } .

displayName

string

שם קצר הניתן לקריאה על ידי אדם לתצוגה בממשק המשתמש. מקסימום 100 תווים. לדוגמה: Nexus 5, API 27.

creationTime

object ( Timestamp )

פלט בלבד. הזמן שבו נוצרה הסביבה.

completionTime

object ( Timestamp )

פלט בלבד. הזמן שבו סטטוס הסביבה הוגדר להשלמת.

ערך זה יוגדר אוטומטית כאשר המצב יעבור ל-COMLETE.

shardSummaries[]

object ( ShardSummary )

פלט בלבד. סיכומים של רסיסים.

רק רסיס אחד יוצג אלא אם תכונת הרסיס מופעלת ב-TestExecutionService.

environmentResult

object ( MergedResult )

תוצאה ממוזגת של הסביבה.

resultsStorage

object ( ResultsStorage )

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

ShardSummary

סיכום תוצאות עבור רסיס בסביבה.

ייצוג JSON
{
  "runs": [
    {
      object (StepSummary)
    }
  ],
  "shardResult": {
    object (MergedResult)
  }
}
שדות
runs[]

object ( StepSummary )

סיכומי השלבים השייכים לרסיס.

כאשר flaky_test_attempts מופעלת מ-TestExecutionService, יותר מהרצה אחת (Step) יכולה להציג. והריצות ימוינו לפי multistepNumber.

shardResult

object ( MergedResult )

תוצאה ממוזגת של הרסיס.

סיכום צעדים

לסוג זה אין שדות.

סיכום קל משקל של שלב בתוך ביצוע זה.

תוצאה ממוזגת

תוצאת בדיקה ממוזגת לסביבה.

אם לסביבה יש רק שלב אחד (ללא שידורים חוזרים או רסיסים), אז התוצאה הממוזגת זהה לתוצאת השלב. אם לסביבה יש מספר רסיסים ו/או שידורים חוזרים, אז התוצאות של רסיסים ושידורים חוזרים השייכים לאותה סביבה מתמזגים לתוצאה של סביבה אחת.

ייצוג JSON
{
  "state": enum (State),
  "outcome": {
    object (Outcome)
  },
  "testSuiteOverviews": [
    {
      object (TestSuiteOverview)
    }
  ]
}
שדות
state

enum ( State )

מצב המשאב

outcome

object ( Outcome )

תוצאה של המשאב

testSuiteOverviews[]

object ( TestSuiteOverview )

התוצאה המשולבת והמגולגלת של כל חבילת בדיקה שהופעלה כחלק מסביבה זו.

שילוב: כאשר מקרי הבדיקה מחבילה מופעלים בשלבים שונים (ריסוק), התוצאות מתווספות בחזרה יחד בסקירה אחת. (לדוגמה, אם ל-shard1 יש 2 כשלים ול-shard2 יש כשל אחד מאשר ל-Shard Count = 3).

אוסף: כאשר מקרי בדיקה מאותה חבילה מופעלים מספר פעמים (רעוע), התוצאות משולבות (למשל, אם testcase1.run1 נכשל, testcase1.run2 עובר, וגם testcase2.run1 וגם testcase2.run2 נכשלים, אז הסקירה הכללית flakyCount = 1 ו- failureCount = 1).

אחסון תוצאות

האחסון לתוצאות הבדיקה.

ייצוג JSON
{
  "resultsStoragePath": {
    object (FileReference)
  },
  "xunitXmlFile": {
    object (FileReference)
  }
}
שדות
resultsStoragePath

object ( FileReference )

ספריית השורש לתוצאות הבדיקה.

xunitXmlFile

object ( FileReference )

הנתיב לקובץ Xunit XML.

שיטות

get

 מקבל סביבה.

list

 מפרט סביבות עבור ביצוע נתון.
,

משאב: איכות הסביבה

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

ייצוג JSON
{
  "projectId": string,
  "historyId": string,
  "executionId": string,
  "environmentId": string,
  "dimensionValue": {
    string: string,
    ...
  },
  "displayName": string,
  "creationTime": {
    object (Timestamp)
  },
  "completionTime": {
    object (Timestamp)
  },
  "shardSummaries": [
    {
      object (ShardSummary)
    }
  ],
  "environmentResult": {
    object (MergedResult)
  },
  "resultsStorage": {
    object (ResultsStorage)
  }
}
שדות
projectId

string

פלט בלבד. מזהה פרויקט.

historyId

string

פלט בלבד. מזהה היסטוריה.

executionId

string

פלט בלבד. מזהה ביצוע.

environmentId

string

פלט בלבד. מזהה סביבה.

dimensionValue

map (key: string, value: string)

ערכי מימד המתארים את הסביבה. ערכי מימד מורכבים תמיד מ"דגם", "גרסה", "מקומי" ו"כיוון".

  • בתגובה: תמיד מוגדר
  • בבקשת יצירה: הגדר תמיד
  • בבקשת עדכון: לעולם לא הוגדר

אובייקט המכיל רשימה של "key": value . דוגמה: { "name": "wrench", "mass": "1.3kg", "count": "3" } .

displayName

string

שם קצר הניתן לקריאה על ידי אדם לתצוגה בממשק המשתמש. מקסימום 100 תווים. לדוגמה: Nexus 5, API 27.

creationTime

object ( Timestamp )

פלט בלבד. הזמן שבו נוצרה הסביבה.

completionTime

object ( Timestamp )

פלט בלבד. הזמן שבו סטטוס הסביבה הוגדר להשלמת.

ערך זה יוגדר אוטומטית כאשר המצב יעבור ל-COMLETE.

shardSummaries[]

object ( ShardSummary )

פלט בלבד. סיכומים של רסיסים.

רק רסיס אחד יוצג אלא אם תכונת הרסיס מופעלת ב-TestExecutionService.

environmentResult

object ( MergedResult )

תוצאה ממוזגת של הסביבה.

resultsStorage

object ( ResultsStorage )

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

ShardSummary

סיכום תוצאות עבור רסיס בסביבה.

ייצוג JSON
{
  "runs": [
    {
      object (StepSummary)
    }
  ],
  "shardResult": {
    object (MergedResult)
  }
}
שדות
runs[]

object ( StepSummary )

סיכומי השלבים השייכים לרסיס.

כאשר flaky_test_attempts מופעלת מ-TestExecutionService, יותר מהרצה אחת (Step) יכולה להציג. והריצות ימוינו לפי multistepNumber.

shardResult

object ( MergedResult )

תוצאה ממוזגת של הרסיס.

סיכום צעדים

לסוג זה אין שדות.

סיכום קל משקל של שלב בתוך ביצוע זה.

תוצאה ממוזגת

תוצאת בדיקה ממוזגת לסביבה.

אם לסביבה יש רק שלב אחד (ללא שידורים חוזרים או רסיסים), אז התוצאה הממוזגת זהה לתוצאת השלב. אם לסביבה יש מספר רסיסים ו/או שידורים חוזרים, אז התוצאות של רסיסים ושידורים חוזרים השייכים לאותה סביבה מתמזגים לתוצאה של סביבה אחת.

ייצוג JSON
{
  "state": enum (State),
  "outcome": {
    object (Outcome)
  },
  "testSuiteOverviews": [
    {
      object (TestSuiteOverview)
    }
  ]
}
שדות
state

enum ( State )

מצב המשאב

outcome

object ( Outcome )

תוצאה של המשאב

testSuiteOverviews[]

object ( TestSuiteOverview )

התוצאה המשולבת והמגולגלת של כל חבילת בדיקה שהופעלה כחלק מסביבה זו.

שילוב: כאשר מקרי הבדיקה מחבילה מופעלים בשלבים שונים (ריסוק), התוצאות מתווספות בחזרה יחד בסקירה אחת. (לדוגמה, אם ל-shard1 יש 2 כשלים ול-shard2 יש כשל אחד מאשר ל-Shard Count = 3).

אוסף: כאשר מקרי בדיקה מאותה חבילה מופעלים מספר פעמים (רעוע), התוצאות משולבות (למשל, אם testcase1.run1 נכשל, testcase1.run2 עובר, וגם testcase2.run1 וגם testcase2.run2 נכשלים, אז הסקירה הכללית flakyCount = 1 ו- failureCount = 1).

אחסון תוצאות

האחסון לתוצאות הבדיקה.

ייצוג JSON
{
  "resultsStoragePath": {
    object (FileReference)
  },
  "xunitXmlFile": {
    object (FileReference)
  }
}
שדות
resultsStoragePath

object ( FileReference )

ספריית השורש לתוצאות הבדיקה.

xunitXmlFile

object ( FileReference )

הנתיב לקובץ Xunit XML.

שיטות

get

 מקבל סביבה.

list

 מפרט סביבות עבור ביצוע נתון.