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

Уникальный идентификатор внутри выполнения для этого шага.

Возвращает INVALID_ARGUMENT, если это поле установлено или перезаписано вызывающей стороной.

• В ответ: всегда устанавливаю
• В запросе на создание/обновление: никогда не устанавливать

object ( Timestamp )

Время создания шага.

• В ответ: всегда устанавливаю
• В запросе на создание/обновление: никогда не устанавливать

object ( Timestamp )

Время, когда статус шага был установлен как завершенный.

Это значение будет установлено автоматически при переходе состояния в ЗАВЕРШЕНО.

• В ответ: устанавливается, если состояние выполнения ЗАВЕРШЕНО.
• В запросе на создание/обновление: никогда не устанавливать

string

Короткое удобочитаемое имя для отображения в пользовательском интерфейсе. Максимум 100 символов. Например: Чистая сборка

PRECONDITION_FAILED будет возвращен при создании нового шага, если его имя и размерность совпадают с существующим шагом. Если два шага представляют собой похожее действие, но имеют разные значения измерения, они должны иметь одно и то же имя. Например, если один и тот же набор тестов выполняется на двух разных платформах, два шага должны иметь одно и то же имя.

• В ответ: всегда устанавливаю
• В запросе на создание: всегда устанавливается
• В запросе на обновление: никогда не устанавливать

string

Описание этого инструмента. Например: mvn clean package -DskipTests=true.

• В ответ: присутствует, если установлено запросом на создание/обновление.
• В запросе на создание/обновление: необязательно.

enum ( State )

Исходное состояние — IN_PROGRESS. Единственные допустимые переходы состояний: * IN_PROGRESS -> COMPLETE.

PRECONDITION_FAILED будет возвращен, если запрошен недопустимый переход.

Допустимо создание шага с состоянием COMPLETE. Состояние может быть установлено в COMPLETE только один раз. PRECONDITION_FAILED будет возвращен, если состояние установлено на COMPLETE несколько раз.

• В ответ: всегда устанавливаю
• В запросе на создание/обновление: необязательно.

object ( Outcome )

Классификация результата, например, УСПЕХ или НЕУДАЧА.

• В ответ: присутствует, если установлено запросом на создание/обновление.
• В запросе на создание/обновление: необязательно.

boolean

Являются ли какие-либо выходные данные этого шага изображениями, миниатюры которых можно получить с помощью Thumbnails.list.

• В ответ: всегда устанавливаю
• В запросе на создание/обновление: никогда не устанавливать

map (key: string, value: string)

Произвольные пары ключ/значение, предоставленные пользователем, связанные с шагом.

Пользователи несут ответственность за управление пространством имен ключей, чтобы ключи случайно не конфликтовали.

INVALID_ARGUMENT будет возвращен, если количество меток превышает 100 или если длина любого из ключей или значений превышает 100 символов.

• В ответ: всегда устанавливаю
• В запросе на создание: необязательно
• В запросе на обновление: необязательно; любая новая пара ключ/значение будет добавлена ​​на карту, и любое новое значение для существующего ключа обновит значение этого ключа.

Объект, содержащий список пар "key": value . Пример: { "name": "wrench", "mass": "1.3kg", "count": "3" } .

map (key: string, value: string)

Если выполнение, содержащее этот шаг, имеет какой-либо набор Dimension_definition, то это поле позволяет дочернему элементу указывать значения измерений.

Ключи должны точно соответствовать измерению_определения выполнения.

Например, если выполнение имеет dimension_definition = ['attempt', 'device'] , тогда шаг должен определить значения для этих измерений, например. dimensionValue = ['attempt': '1', 'device': 'Nexus 6']

Если шаг не участвует в одном измерении матрицы, значением этого измерения должна быть пустая строка. Например, если один из тестов выполняется бегуном, который не поддерживает повторные попытки, шаг может иметь dimensionValue = ['attempt': '', 'device': 'Nexus 6']

Если шаг не участвует ни в одном измерении матрицы, то параметр DimensionValue может остаться неустановленным.

PRECONDITION_FAILED будет возвращен, если какой-либо из ключей не существует в измерении_определения выполнения.

PRECONDITION_FAILED будет возвращен, если другой шаг в этом выполнении уже имеет то же имя и значение измерения, но отличается в других полях данных, например, поле шага отличается.

PRECONDITION_FAILED будет возвращено, если установлено измерение ValueValue и при выполнении имеется измерение_определение, которое не указано в качестве одного из ключей.

• В ответ: присутствует, если установлено при создании
• В запросе на создание: необязательно
• В запросе на обновление: никогда не устанавливать

Объект, содержащий список пар "key": value . Пример: { "name": "wrench", "mass": "1.3kg", "count": "3" } .

object ( Duration )

Сколько времени потребовалось для выполнения этого шага.

Если этот параметр не установлен, устанавливается разница между временем создания и временем завершения, когда шаг установлен в состояние ЗАВЕРШЕНО. В некоторых случаях уместно установить это значение отдельно: например, если шаг создан, но операция, которую он представляет, ставится в очередь на несколько минут перед выполнением, было бы целесообразно не включать время, проведенное в очереди, в его runDuration.

PRECONDITION_FAILED будет возвращен, если вы попытаетесь установить runDuration для шага, для которого это поле уже установлено.

• В ответ: присутствует, если было установлено ранее; всегда присутствует на шаге COMPLETE
• В запросе на создание: необязательно
• В запросе на обновление: необязательно

object ( Duration )

Сколько ресурсов устройства используется для выполнения теста.

Это использование устройства, используемое для выставления счетов, которое отличается от runDuration, например, при сбое инфраструктуры не будет взиматься плата за использование устройства.

PRECONDITION_FAILED будет возвращен, если вы попытаетесь установить device_usage на шаге, для которого это поле уже установлено.

• В ответ: присутствует, если было установлено ранее.
• В запросе на создание: необязательно
• В запросе на обновление: необязательно

object ( MultiStep )

Подробности, когда несколько шагов выполняются с той же конфигурацией, что и группа. Эти данные можно использовать для определения того, к какой группе относится этот шаг. Он также определяет «первичный шаг» группы, который индексирует всех членов группы.

• В ответ: присутствует, если было установлено ранее.
• В запросе на создание: необязательно, установите, если этот шаг был выполнен более одного раза.
• В запросе на обновление: необязательно

object ( TestExecutionStep )

Выполнение тестового запуска.

object ( ToolExecutionStep )

Запуск инструмента (используется для шагов, которые мы явно не поддерживаем).

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

object ( TestSuiteOverview )

Список содержимого обзора набора тестов. Это может быть проанализировано сервером из журнала xUnit XML или загружено непосредственно пользователем. Эти ссылки следует вызывать только тогда, когда наборы тестов полностью проанализированы или загружены.

Максимально допустимое количество обзоров наборов тестов на шаг — 1000.

• В ответ: всегда устанавливаю
• В запросе на создание: необязательно
• В запросе на обновление: никогда (вместо этого используйте собственный методPublishXunitXmlFiles)

object ( ToolExecution )

Представляет выполнение средства запуска тестов.

Код завершения этого инструмента будет использоваться для определения того, пройден ли тест.

• В ответ: всегда устанавливаю
• В запросе на создание/обновление: необязательно.

object ( TestIssue )

Проблемы, обнаруженные во время выполнения теста.

Например, если тестируемое мобильное приложение вышло из строя во время теста, здесь можно записать сообщение об ошибке и содержимое трассировки стека, чтобы облегчить отладку.

• В ответ: присутствует, если установлено при создании или обновлении.
• В запросе на создание/обновление: необязательно.

object ( TestTiming )

Распределение времени выполнения теста.

• В ответ: присутствует, если установлено при создании или обновлении.
• В запросе на создание/обновление: необязательно.

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

string

Полная токенизированная командная строка, включая имя программы (эквивалент argv в программе C).

• В ответ: присутствует, если установлено запросом на создание.
• В запросе на создание: необязательно
• В запросе на обновление: никогда не устанавливать

object ( FileReference )

Ссылки на любые текстовые журналы отображают выполнение инструмента.

Это поле можно задать до выхода из инструмента, чтобы иметь доступ к просмотру журналов в реальном времени во время работы инструмента.

Максимально допустимое количество журналов инструментов на шаг — 1000.

• В ответ: присутствует, если установлено запросом на создание/обновление.
• В запросе на создание: необязательно
• В запросе на обновление: необязательно, любое предоставленное значение будет добавлено к существующему списку.

object ( ToolExitCode )

Код завершения выполнения инструмента. Это поле будет установлено после выхода из инструмента.

• В ответ: присутствует, если установлено запросом на создание/обновление.
• В запросе на создание: необязательно
• В запросе на обновление: необязательно, будет возвращена ошибка FAILED_PRECONDITION, если код выхода уже установлен.

object ( ToolOutputReference )

Ссылки на непрозрачные файлы любого формата, выдаваемые при выполнении инструмента.

Максимально допустимое количество выходов инструмента за шаг — 1000.

• В ответ: присутствует, если установлено запросом на создание/обновление.
• В запросе на создание: необязательно
• В запросе на обновление: необязательно, любое предоставленное значение будет добавлено к существующему списку.

{
  "number": integer
}

integer

Код завершения выполнения инструмента. Значение 0 означает, что выполнение прошло успешно.

• В ответ: всегда устанавливаю
• В запросе на создание/обновление: всегда устанавливается

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

string

Краткое, понятное человеку сообщение с описанием проблемы. Необходимый.

object ( StackTrace )

Устарело в пользу полей трассировки стека внутри определенных предупреждений.

object ( Any )

Предупреждающее сообщение с дополнительной информацией о проблеме. Всегда должно быть сообщение от com.google.devtools.toolresults.v1.warnings.

enum ( Severity )

Серьезность проблемы. Необходимый.

enum ( Type )

Тип проблемы. Необходимый.

enum ( Category )

Категория вопроса. Необходимый.

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

string

URL-адрес/имя ресурса, которое однозначно идентифицирует тип сериализованного сообщения буфера протокола. Эта строка должна содержать хотя бы один символ «/». Последний сегмент пути URL-адреса должен представлять полное имя типа (как в path/google.protobuf.Duration ). Имя должно быть в канонической форме (например, «.» в начале не допускается).

На практике команды обычно предварительно компилируют в двоичный файл все типы, которые, по их ожиданиям, будут использоваться в контексте Any. Однако для URL-адресов, использующих схему http , https или отсутствие схемы, можно дополнительно настроить сервер типов, который сопоставляет URL-адреса типов с определениями сообщений следующим образом:

• Если схема не указана, предполагается https .
• HTTP GET для URL-адреса должен возвращать значение google.protobuf.Type в двоичном формате или выдавать ошибку.
• Приложениям разрешено кэшировать результаты поиска на основе URL-адреса или предварительно скомпилировать их в двоичный файл, чтобы избежать какого-либо поиска. Следовательно, при изменении типов необходимо сохранять двоичную совместимость. (Используйте имена версионных типов для управления критическими изменениями.)

Примечание. Эта функция в настоящее время недоступна в официальной версии protobuf и не используется для URL-адресов типов, начинающихся с type.googleapis.com.

Схемы, отличные от http , https (или пустой схемы), могут использоваться с семантикой, специфичной для реализации.

string ( bytes format)

Должен быть допустимым сериализованным буфером протокола указанного выше типа.

Строка в кодировке Base64.

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

object ( Duration )

Сколько времени потребовалось для запуска процесса тестирования.

• В ответ: присутствует, если было установлено ранее.
• В запросе на создание/обновление: необязательно.

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

object ( ToolExecution )

Инструментальное исполнение.

• В ответ: присутствует, если установлено запросом на создание/обновление.
• В запросе на создание/обновление: необязательно.

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

string

Идентификатор основного (исходного) шага, который может быть этим шагом.

integer

Уникальный int, присвоенный каждому шагу. Диапазон значений от 0 (включительно) до общего количества шагов (не включая). Первый шаг — 0.

object ( PrimaryStep )

Присутствует, если это основной (исходный) шаг.

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

enum ( OutcomeSummary )

Статус сводного теста нескольких шагов, которые выполнялись с той же конфигурацией, что и группа.

object ( IndividualOutcome )

Идентификатор шага и результат каждого отдельного шага.

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

string

enum ( OutcomeSummary )

integer

Уникальный int, присвоенный каждому шагу. Диапазон значений от 0 (включительно) до общего количества шагов (не включая). Первый шаг — 0.

object ( Duration )

Сколько времени потребовалось для выполнения этого шага.