Enabling the Status Widget for Build Configurations

Skip to end of metadata
Go to start of metadata
You are viewing documentation of TeamCity 3.x, which is not the most recent released version of TeamCity. Please refer to the listing to choose another version.
Documentation Index

Enabling the Status Widget for Build Configurations

By enabling the status widget, it is possible for any external web page to retrieve the latest build status of one or more build configurations.

In addition to enabling this option when creating or editing the general settings of the build configuration, you need to include the following snippets of code in the web page source:

  • Add this code sample in the <head> section (or alternatively, add the withCss=true parameter to externalStatus.html):
  • Insert this code sample where you want to display the build configuration's status:
  • If you prefer to use plain HTML instead of javascript, omit the js=1 parameter
  • If you want to include default CSS styles without modifying the <head> section, add the withCss=true parameter 
  • To provide up-to-date status information on specific build configurations, use the following parameter in the URL as many times as needed:

    &buildTypeId=<buildConfigurationId>

  • It is also possible to show the status of all a project's build configurations by replacing "&buildTypeId=<buildConfigurationId>" with "&projectId=<projectId>". You can select a combination of these parameters to display the needed projects and build configurations on your web page.
  • You can also download and customize the externalStatus.css file (e.g. you can disable some columns by using display: none; See comments in externalStatus.css). But in this case, you must not include the withCss=true parameter, but provide the CSS styles explicitly, preferably in the <head> section, instead.

See also:

Labels:

build build Delete
status status Delete
widget widget Delete
external external Delete
web web Delete
Enter labels to add to this page:
Wait Image 
Looking for a label? Just start typing.