REST Resource: projects.histories.executions.steps

{
  "stepId": string,
  "creationTime": {
    object (Timestamp)
  },
  "completionTime": {
    object (Timestamp)
  },
  "name": string,
  "description": string,
  "state": enum (State),
  "outcome": {
    object (Outcome)
  },
  "hasImages": boolean,
  "labels": {
    string: string,
    ...
  },
  "dimensionValue": {
    string: string,
    ...
  },
  "runDuration": {
    object (Duration)
  },
  "deviceUsageDuration": {
    object (Duration)
  },
  "multiStep": {
    object (MultiStep)
  },

  // Union field step can be only one of the following:
  "testExecutionStep": {
    object (TestExecutionStep)
  },
  "toolExecutionStep": {
    object (ToolExecutionStep)
  }
  // End of list of possible types for union field step.
}

string

Pengidentifikasi unik dalam Eksekusi untuk Langkah ini.

Mengembalikan INVALID_ARGUMENT jika bidang ini disetel atau ditimpa oleh pemanggil.

• Sebagai tanggapan: selalu disetel
• Dalam permintaan buat/perbarui: tidak pernah disetel

object ( Timestamp )

Waktu ketika langkah itu dibuat.

• Sebagai tanggapan: selalu disetel
• Dalam permintaan buat/perbarui: tidak pernah disetel

object ( Timestamp )

Waktu ketika status langkah ditetapkan untuk selesai.

Nilai ini akan ditetapkan secara otomatis ketika status bertransisi ke COMPLETE.

• Sebagai tanggapan: atur jika status eksekusi SELESAI.
• Dalam permintaan buat/perbarui: tidak pernah disetel

string

Nama pendek yang dapat dibaca manusia untuk ditampilkan di UI. Maksimal 100 karakter. Misalnya: Bangunan bersih

PRECONDITION_FAILED akan dikembalikan saat membuat langkah baru jika nama dan DimensionValue-nya sama dengan langkah yang sudah ada. Jika dua langkah mewakili tindakan serupa, namun memiliki nilai dimensi berbeda, keduanya harus memiliki nama yang sama. Misalnya, jika rangkaian pengujian yang sama dijalankan pada dua platform berbeda, kedua langkah tersebut harus memiliki nama yang sama.

• Sebagai tanggapan: selalu disetel
• Dalam permintaan pembuatan: selalu disetel
• Dalam permintaan pembaruan: tidak pernah disetel

string

Deskripsi alat ini Misalnya: paket mvn clean -D skipTests=true

• Sebagai tanggapan: hadir jika diatur oleh permintaan buat/perbarui
• Dalam permintaan buat/perbarui: opsional

enum ( State )

Keadaan awal adalah IN_PROGRESS. Satu-satunya transisi status yang sah adalah * IN_PROGRESS -> COMPLETE

PRECONDITION_FAILED akan dikembalikan jika diminta transisi yang tidak valid.

Adalah valid untuk membuat Langkah dengan status disetel ke SELESAI. Status hanya dapat disetel ke COMPLETE satu kali. PRECONDITION_FAILED akan dikembalikan jika status disetel ke COMPLETE beberapa kali.

• Sebagai tanggapan: selalu disetel
• Dalam permintaan buat/perbarui: opsional

object ( Outcome )

Klasifikasi hasil, misalnya SUKSES atau KEGAGALAN

• Sebagai tanggapan: hadir jika diatur oleh permintaan buat/perbarui
• Dalam permintaan buat/perbarui: opsional

boolean

Apakah output dari langkah ini berupa gambar yang thumbnail-nya dapat diambil dengan thumbnails.list.

• Sebagai tanggapan: selalu disetel
• Dalam permintaan buat/perbarui: tidak pernah disetel

map (key: string, value: string)

Pasangan kunci/nilai yang disediakan pengguna secara sewenang-wenang dan terkait dengan langkah tersebut.

Pengguna bertanggung jawab untuk mengelola namespace kunci sedemikian rupa sehingga kunci tidak bertabrakan secara tidak sengaja.

INVALID_ARGUMENT akan dikembalikan jika jumlah label melebihi 100 atau jika panjang salah satu kunci atau nilai melebihi 100 karakter.

• Sebagai tanggapan: selalu disetel
• Dalam permintaan pembuatan: opsional
• Dalam permintaan pembaruan: opsional; setiap pasangan kunci/nilai baru akan ditambahkan ke peta, dan setiap nilai baru untuk kunci yang ada akan memperbarui nilai kunci tersebut

Sebuah objek yang berisi daftar "key": value . Contoh: { "name": "wrench", "mass": "1.3kg", "count": "3" } .

map (key: string, value: string)

Jika eksekusi yang berisi langkah ini memiliki kumpulan definisi_dimensi, maka bidang ini memungkinkan anak untuk menentukan nilai dimensi.

Kuncinya harus sama persis dengan dimensi_definisi eksekusi.

Misalnya, jika eksekusi memiliki dimension_definition = ['attempt', 'device'] maka suatu langkah harus menentukan nilai untuk dimensi tersebut, misalnya. dimensionValue = ['attempt': '1', 'device': 'Nexus 6']

Jika suatu langkah tidak berpartisipasi dalam satu dimensi matriks, nilai untuk dimensi tersebut harus berupa string kosong. Misalnya, jika salah satu pengujian dijalankan oleh pelari yang tidak mendukung percobaan ulang, langkah tersebut dapat memiliki dimensionValue = ['attempt': '', 'device': 'Nexus 6']

Jika langkah tersebut tidak berpartisipasi dalam dimensi matriks apa pun, maka DimensionValue mungkin tidak disetel.

PRECONDITION_FAILED akan dikembalikan jika salah satu kunci tidak ada dalam dimensi_definisi eksekusi.

PRECONDITION_FAILED akan dikembalikan jika langkah lain dalam eksekusi ini sudah memiliki nama dan DimensionValue yang sama, namun berbeda pada bidang data lainnya, misalnya bidang langkah berbeda.

PRECONDITION_FAILED akan dikembalikan jika DimensionValue disetel, dan ada Dimension_definition dalam eksekusi yang tidak ditentukan sebagai salah satu kunci.

• Sebagai tanggapan: hadir jika disetel oleh buat
• Dalam permintaan pembuatan: opsional
• Dalam permintaan pembaruan: tidak pernah disetel

Sebuah objek yang berisi daftar "key": value . Contoh: { "name": "wrench", "mass": "1.3kg", "count": "3" } .

object ( Duration )

Berapa lama waktu yang dibutuhkan untuk menjalankan langkah ini.

Jika tidak disetel, ini disetel ke selisih antara waktu pembuatan dan waktu penyelesaian saat langkah disetel ke status SELESAI. Dalam beberapa kasus, adalah tepat untuk menetapkan nilai ini secara terpisah: Misalnya, jika sebuah langkah dibuat, namun operasi yang diwakilinya diantrekan selama beberapa menit sebelum dieksekusi, akan lebih tepat untuk tidak menyertakan waktu yang dihabiskan dalam antrian dalam langkah tersebut. runDuration.

PRECONDITION_FAILED akan dikembalikan jika seseorang mencoba menyetel runDuration pada langkah yang bidang ini sudah disetel.

• Sebagai tanggapan: hadir jika ditetapkan sebelumnya; selalu hadir pada langkah LENGKAP
• Dalam permintaan pembuatan: opsional
• Dalam permintaan pembaruan: opsional

object ( Duration )

Berapa banyak sumber daya perangkat yang digunakan untuk melakukan pengujian.

Ini adalah penggunaan perangkat yang digunakan untuk tujuan penagihan, yang berbeda dengan runDuration, misalnya, kegagalan infrastruktur tidak akan dikenakan biaya untuk penggunaan perangkat.

PRECONDITION_FAILED akan dikembalikan jika seseorang mencoba menyetel penggunaan_perangkat pada langkah yang bidang ini sudah disetel.

• Sebagai tanggapan: hadir jika ditetapkan sebelumnya.
• Dalam permintaan pembuatan: opsional
• Dalam permintaan pembaruan: opsional

object ( MultiStep )

Detail saat beberapa langkah dijalankan dengan konfigurasi yang sama sebagai grup. Detail ini dapat digunakan untuk mengidentifikasi kelompok mana yang termasuk dalam langkah ini. Hal ini juga mengidentifikasi 'langkah utama' kelompok yang mengindeks semua anggota kelompok.

• Sebagai tanggapan: hadir jika ditetapkan sebelumnya.
• Dalam permintaan buat: opsional, atur jika langkah ini dilakukan lebih dari sekali.
• Dalam permintaan pembaruan: opsional

object ( TestExecutionStep )

Eksekusi pelari uji.

object ( ToolExecutionStep )

Eksekusi suatu alat (digunakan untuk langkah-langkah yang tidak kami dukung secara eksplisit).

{
  "testSuiteOverviews": [
    {
      object (TestSuiteOverview)
    }
  ],
  "toolExecution": {
    object (ToolExecution)
  },
  "testIssues": [
    {
      object (TestIssue)
    }
  ],
  "testTiming": {
    object (TestTiming)
  }
}

object ( TestSuiteOverview )

Daftar isi ikhtisar rangkaian pengujian. Ini dapat diuraikan dari log xUnit XML oleh server, atau diunggah langsung oleh pengguna. Referensi ini hanya boleh dipanggil ketika rangkaian pengujian telah diuraikan atau diunggah sepenuhnya.

Jumlah ikhtisar rangkaian pengujian maksimum yang diperbolehkan per langkah adalah 1000.

• Sebagai tanggapan: selalu disetel
• Dalam permintaan pembuatan: opsional
• Dalam permintaan pembaruan: tidak pernah (gunakan metode khusus publikasikanXunitXmlFiles sebagai gantinya)

object ( ToolExecution )

Mewakili eksekusi test runner.

Kode keluar dari alat ini akan digunakan untuk menentukan apakah tes tersebut lulus.

• Sebagai tanggapan: selalu disetel
• Dalam permintaan buat/perbarui: opsional

object ( TestIssue )

Masalah yang diamati selama pelaksanaan tes.

Misalnya, jika aplikasi seluler yang sedang diuji mengalami error selama pengujian, pesan kesalahan dan konten pelacakan tumpukan dapat dicatat di sini untuk membantu proses debug.

• Sebagai tanggapan: hadir jika diatur oleh buat atau perbarui
• Dalam permintaan buat/perbarui: opsional

object ( TestTiming )

Rincian waktu pelaksanaan tes.

• Sebagai tanggapan: hadir jika diatur oleh buat atau perbarui
• Dalam permintaan buat/perbarui: opsional

{
  "commandLineArguments": [
    string
  ],
  "toolLogs": [
    {
      object (FileReference)
    }
  ],
  "exitCode": {
    object (ToolExitCode)
  },
  "toolOutputs": [
    {
      object (ToolOutputReference)
    }
  ]
}

string

Baris perintah tokenisasi lengkap termasuk nama program (setara dengan argv dalam program C).

• Sebagai tanggapan: hadir jika diatur oleh permintaan pembuatan
• Dalam permintaan pembuatan: opsional
• Dalam permintaan pembaruan: tidak pernah disetel

object ( FileReference )

Referensi ke log teks biasa menampilkan eksekusi alat.

Bidang ini dapat disetel sebelum alat keluar agar dapat mengakses tampilan langsung log saat alat sedang berjalan.

Jumlah maksimum log alat yang diperbolehkan per langkah adalah 1000.

• Sebagai tanggapan: hadir jika diatur oleh permintaan buat/perbarui
• Dalam permintaan pembuatan: opsional
• Dalam permintaan pembaruan: opsional, nilai apa pun yang diberikan akan ditambahkan ke daftar yang ada

object ( ToolExitCode )

Kode keluar eksekusi alat. Bidang ini akan disetel setelah alat keluar.

• Sebagai tanggapan: hadir jika diatur oleh permintaan buat/perbarui
• Dalam permintaan pembuatan: opsional
• Dalam permintaan pembaruan: opsional, kesalahan FAILED_PRECONDITION akan dikembalikan jika kode keluar sudah disetel.

object ( ToolOutputReference )

Referensi ke file buram dalam format apa pun yang dihasilkan oleh eksekusi alat.

Jumlah maksimum keluaran alat per langkah yang diperbolehkan adalah 1000.

• Sebagai tanggapan: hadir jika diatur oleh permintaan buat/perbarui
• Dalam permintaan pembuatan: opsional
• Dalam permintaan pembaruan: opsional, nilai apa pun yang diberikan akan ditambahkan ke daftar yang ada

{
  "number": integer
}

integer

Kode keluar eksekusi alat. Nilai 0 berarti eksekusi berhasil.

• Sebagai tanggapan: selalu disetel
• Dalam permintaan buat/perbarui: selalu disetel

{
  "errorMessage": string,
  "stackTrace": {
    object (StackTrace)
  },
  "warning": {
    object (Any)
  },
  "severity": enum (Severity),
  "type": enum (Type),
  "category": enum (Category)
}

string

Pesan singkat yang dapat dibaca manusia yang menjelaskan masalah ini. Diperlukan.

object ( StackTrace )

Tidak digunakan lagi karena mendukung bidang pelacakan tumpukan di dalam peringatan tertentu.

object ( Any )

Pesan peringatan dengan rincian tambahan mengenai masalah ini. Harus selalu berupa pesan dari com.google.devtools.toolresults.v1.warnings

enum ( Severity )

Tingkat keparahan masalah. Diperlukan.

enum ( Type )

Jenis masalah. Diperlukan.

enum ( Category )

Kategori masalah. Diperlukan.

{
  "typeUrl": string,
  "value": string
}

string

Nama URL/sumber daya yang secara unik mengidentifikasi jenis pesan buffer protokol berseri. String ini harus berisi setidaknya satu karakter "/". Segmen terakhir jalur URL harus mewakili nama jenis yang sepenuhnya memenuhi syarat (seperti pada path/google.protobuf.Duration ). Nama harus dalam bentuk kanonik (misalnya, awalan "." tidak diterima).

Dalam praktiknya, tim biasanya melakukan prakompilasi ke dalam biner semua jenis yang mereka harapkan akan digunakan dalam konteks Any. Namun, untuk URL yang menggunakan skema http , https , atau tanpa skema, seseorang dapat secara opsional menyiapkan server tipe yang memetakan tipe URL ke definisi pesan sebagai berikut:

• Jika tidak ada skema yang disediakan, https diasumsikan.
• HTTP GET pada URL harus menghasilkan nilai google.protobuf.Type dalam format biner, atau menghasilkan kesalahan.
• Aplikasi diizinkan untuk menyimpan hasil pencarian dalam cache berdasarkan URL, atau mengkompilasinya terlebih dahulu ke dalam biner untuk menghindari pencarian apa pun. Oleh karena itu, kompatibilitas biner perlu dipertahankan pada perubahan tipe. (Gunakan nama tipe berversi untuk mengelola perubahan yang dapat menyebabkan gangguan.)

Catatan: fungsi ini saat ini tidak tersedia dalam rilis protobuf resmi, dan tidak digunakan untuk tipe URL yang dimulai dengan type.googleapis.com.

Skema selain http , https (atau skema kosong) dapat digunakan dengan implementasi semantik tertentu.

string ( bytes format)

Harus berupa buffering protokol serial yang valid dari jenis yang ditentukan di atas.

String yang dikodekan base64.

{
  "testProcessDuration": {
    object (Duration)
  }
}

object ( Duration )

Berapa lama waktu yang dibutuhkan untuk menjalankan proses pengujian.

• Sebagai tanggapan: hadir jika ditetapkan sebelumnya.
• Dalam permintaan buat/perbarui: opsional

{
  "toolExecution": {
    object (ToolExecution)
  }
}

object ( ToolExecution )

Eksekusi Alat.

• Sebagai tanggapan: hadir jika diatur oleh permintaan buat/perbarui
• Dalam permintaan buat/perbarui: opsional

{
  "primaryStepId": string,
  "multistepNumber": integer,
  "primaryStep": {
    object (PrimaryStep)
  }
}

string

Id Langkah dari langkah utama (asli), yang mungkin merupakan langkah ini.

integer

Int unik diberikan pada setiap langkah. Berkisar dari 0 (inklusif) hingga jumlah langkah (eksklusif). Langkah utama adalah 0.

object ( PrimaryStep )

Hadir jika ini merupakan langkah utama (asli).

{
  "rollUp": enum (OutcomeSummary),
  "individualOutcome": [
    {
      object (IndividualOutcome)
    }
  ]
}

enum ( OutcomeSummary )

Status pengujian rollup beberapa langkah yang dijalankan dengan konfigurasi yang sama sebagai grup.

object ( IndividualOutcome )

Id Langkah dan hasil dari setiap langkah individual.

{
  "stepId": string,
  "outcomeSummary": enum (OutcomeSummary),
  "multistepNumber": integer,
  "runDuration": {
    object (Duration)
  }
}

string

enum ( OutcomeSummary )

integer

Int unik diberikan pada setiap langkah. Berkisar dari 0 (inklusif) hingga jumlah langkah (eksklusif). Langkah utama adalah 0.

object ( Duration )

Berapa lama waktu yang dibutuhkan untuk menjalankan langkah ini.