execute (MSBuild)

Runs MSBuild operations on an MSBuild project file and deliver artifacts. 

Environment/Instance Properties

Property NameProperty CodeRequiredDescription
MSBuild HomeFDMSB_MSBUILD_HOMEYes

Path where the .NET framework is installed. Value should be up to but not including the bin folder. (e.g. C:\installs\microsoft\Microsoft Visual Studio\2019\Community\MSBuild\Current)

This folder should have a bin folder with the MSBuild executable (MSBuild.exe).

Note: You can use Community or Professional version of Microsoft Visual Studio.

Project Properties

Property NameProperty CodeRequiredDescription








Inputs

Input NameInput CodeRequiredDescription
Project Source FolderFDMSB_INP_PROJECT_SOURCE_FOLDERNo

Path to the project which contains one of the supported MSBuild project files. If a relative path is given, a path inside of the FD_TEMP_DIR will be assumed.

If value is not provided for this input, FD_TEMP_DIR will be assumed.

Project File NameFDMSB_INP_PROJECT_FILE_NAMENo

MSBuild project file name. The file will be searched in the project source folder if provided, otherwise in the exported source folder in the temp directory will be used.

If value is not provided for this input, plugin will look for project files with extensions csproj, vbproj, vcxproj, dbproj, fsproj, pyproj, rbproj, wixproj, vdproj, isproj, pssproj, modelproj, sln and first matching project file will be used.

Command Line ArgumentsFDMSB_INP_CMD_LINE_ARGSNoThe MSBuild.exe arguments or properties, formatted as key=value. Provide one pair per line.
Pass Arguments as PropertiesFDMSB_INP_PASS_ARGS_AS_PROPERTIES

No

If yes, will prefix /p: before the arguments.
Save ArtifactsFDMSB_INP_SAVE_ARTIFACTSNoDefaults to true. If checked, plugin will save artifacts from this folder in to execution artifacts directory.
Artifacts SubfolderFDMSB_INP_ARTIFACTS_SUBFOLDERNo

Specify Subfolder under Project Location where artifacts are generated by MSBuild. Defaults to bin.

Plugin will save artifacts from this folder in to execution artifacts directory if Save Artifacts is checked.

The OutDir property offered by MSBuild is used to move the artifacts generated to the user-defined directory.

Outputs

Output NameDescription




Artifacts 

This operation produces artifacts if the Save Artifacts input is checked. Otherwise, you may wish to use the file or shell plugin to move the correct files to the artifacts folder later in the workflow. If you check Save Artifacts, then indicate proper Artifacts Subfolder as well.

Endpoint Selection 

This operation delegates endpoint selection to the workflow developer. The workflow editor will default the selection to "All", which selects all available endpoints associated with the environment instance. Selecting a specific resource will result in selection of endpoints associated with the environment instance which have that resource defined.

Endpoint Execution

This operation delegates endpoint execution to the workflow developer. The workflow editor will default to "Any", which will execute on any one of the selected endpoints, which will be randomly picked from selected endpoints or a specific endpoint where the previous step may have executed. Changing this value to "All" will result in execution on all selected endpoints.

The following macros are not currently supported in the footer:
  • style