TFS

Kovair DevOps TFS Integration Plugin

TFS
Listen to this article

TFS Plugin Details

Plugin Version: 1.0.1
Last Update on: December 20, 2019

Overview

Team Foundation Server (commonly abbreviated to TFS) is a Microsoft product that provides source code management (either with Team Foundation Version Control or Git), reporting, requirements management, project management (for both agile software development and waterfall teams), automated builds, lab management, testing and release management capabilities. It covers the entire application lifecycle, and enables DevOps capabilities. TFS can be used as a back-end to numerous integrated development environments (IDEs) but is tailored for Microsoft Visual Studio and Eclipse on all platforms.

TFS Information:

More information can be found at TFS.

Version Supported:

   This plugin was developed and tested against version present on TFS 2019

Plugin Operation:

  1. CheckOutCode

Input parameter(s):

ParameterIs MandatoryHelp Text
tf.exe Directory pathtrueInstalled TFS Path, Note: If this is invalid the file download will be stucked
Ex: C:\Program Files (x86)\Microsoft Visual Studio\2017\Community\Common7\IDE\CommonExtensions\Microsoft\TeamFoundation\Team Explorer\tf.exe
Mapped Workspace DirectorytrueMapped path with TFS. If no workspace is mapped with the given path the files won’t download
Ex : C:/Demo
AllfalseYou can use this option to restore an item that you have accidentally deleted from a server workspace. (This is the command-line ‘/all’ option
Overwritefalse

By default, the system does not retrieve an item if it is writable

that is, if its read-only attribute is cleared) on the client machine.

This option overrides the default behavior and overwrites a writable item,
unless the item is checked out. (This is the command-line ‘/overwrite’ option)

ForcefalseCombines /all and /overwrite. (This is the command-line ‘/force’ option)
RecursivefalseRecursively gets items in the specified directory and any subdirectories. (This is the command-line ‘/recursive’ option)

Output parameter(s):

ParameterHelp Text
FilePathFilepath where the files are been downloaded.
IsFilesPresentIs download Successfull.
TFSStatusFinal CheckOutCode job status.

Pass/Fail Condition:

StatusCondition
PassedAll Path should be valid.
Downloaded file should be physically present in the path provided in configuration
FailedOutputlog should contain ‘Unable to determine the workspace’.
  1. IsMappingExist

Input parameter(s):

ParameterIs MandatoryHelp Text
tf.exe Directory pathtrueInstalled TFS Path, Note: If this is invalid the file download will be stucked
Ex: C:\Program Files (x86)\Microsoft Visual Studio\2017\Community\Common7\IDE\CommonExtensions\Microsoft\TeamFoundation\Team Explorer\tf.exe
Mapped Workspace DirectorytrueMapped path with TFS. If no workspace is mapped with the given path the files won’t download
Workspace NametrueCheck the Workpspace whether path is mapped or notworkspace. (This is the command-line ‘/all’ option

Output parameter(s):

ParameterHelp Text
FilePathFilepath where the files are been downloaded.
WorkspaceNameName of the workspace
TFSStatusFinal IsMappingExist job status.

Pass/Fail Condition:

StatusCondition
PassedOutputlog should contain ‘Mapped Workspace Directory’.
FailedOutputlog should contain ‘does not exist’ or
‘Mapped Workspace Directory’ not found.
  1. CreateAndMapWorkspace

Input parameter(s):

ParameterIs MandatoryHelp Text
tf.exe Directory pathtrueInstalled TFS Path, Note: If this is invalid the file download will be stucked
Ex: C:\Program Files (x86)\Microsoft Visual Studio\2017\Community\Common7\IDE\CommonExtensions\Microsoft\TeamFoundation\Team Explorer\tf.exe
Mapped Workspace DirectorytrueMapped path with TFS. If no workspace is mapped with the given path the files won’t download
Root DirectorytrueCheck the Workpspace whether path is mapped or not. (This is the command-line ‘/all’ option
TFS URLtrueThe URL of Team Foundation Server i.e.http://<domain>:<port>/tfs
Source Control FoldertrueThe path that will be mapped with local folder
Workspace NametrueName of the Workspace

Output parameter(s):

ParameterHelp Text
FilePathFilepath where the files are been downloaded.
WorkspaceNameName of the workspace
TFSStatusFinal CreateAndMapWorkspace job status.

Pass/Fail Condition:

StatusCondition
PassedIf the outputlog is empty.
FailedOutputlog should contain ‘is already mapped in workspace’ or or ‘already exists on computer’
  1. DeleteWorkspace

Input parameter(s):

ParameterIs MandatoryHelp Text
tf.exe Directory pathtrueInstalled TFS Path, Note: If this is invalid the file download will be stucked
Ex: C:\Program Files (x86)\Microsoft Visual Studio\2017\Community\Common7\IDE\CommonExtensions\Microsoft\TeamFoundation\Team Explorer\tf.exe
Workspace NametrueName of the Workspace

Output parameter(s):

ParameterHelp Text
WorkspaceNameIs Delete Successfull.
TFSStatusFinal DeleteWorkspace job status.

Pass/Fail Condition:

StatusCondition
PassedIf the outputlog is empty.
FailedOutputlog should contain ‘does not exist.’

Disclaimers:

  1. Conflicts cannot be handle using this plugin.

Release Details:

TFS: 1.0.1
Initial version with basic functionalities

Contact us:

Yes, I accept the Privacy Statement and want to receive latest information from Kovair.
EnglishFrenchGermanItalianJapaneseSpanishChinese (Simplified)