TeamCity 3.0 Help

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):

    <style type="text/css"> @import" <path_to_server>/css/status/externalStatus.css"; </style>
  • Insert this code sample where you want to display the build configuration's status:

    <script type="text/javascript" src="<path_to_server>/externalStatus.html?js=1"> </script>
  • 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.

Last modified: 20 April 2023