Team Foundation Service OData API

Essa semana estava em um cliente apresentando o TFS 2012, e um dos questionamentos levantados foi como ter acesso as informações do TFS?

Nesse caso temos 2 opções, a primeira pelo TFS SDK,  já descrito aqui como usa-lo Automatizando a criação de Work Items e outra é TFS OData que foi lançado ano passado que são serviços disponibilizados via REST onde podemos ter acesso a WorkItems, Builds, Team Projects, Branchs, etc.

Esse post tem a finalidade de descrever como realizar a instalação e configuração do TFS OData

O que é OData?

Open Data Protocol (OData) é um protocolo para acessar informações via Web construído sobre o protocolo AtomPub e JSON. Um pedido de OData usa o modelo REST para todas as solicitações. Cada comando REST é um POST, GET, PUT ou DELETE pedido http (mapeamento estanho CRUD), onde as especificidades do comando estão na url.

Instalando o TFS OData

Para realizar a instalação temos que baixar o código fonte do nesse link OData Service for Team Foundation Server v2

tfs_odata_imagem1

  • ODataForTFS.V2.3.0.exe – Código fonte contendo o TFS OData para instalação
  • TFSConnectBeta.exe – Exemplo de como usar o TFS OData
  • TFSDashboardBeta.exe – Exemplo de como usar o TFS OData

Execute o arquivo ODataForTFS.V2.3.0.exe para descompactar os arquivos em um diretório, e depois abra a solution ODataTFS.sln

tfs_odata_imagem3

Agora devemos criar um novo website no IIS para publicar o nosso serviço

tfs_odata_imagem2

Vamos publicar nosso serviço no IIS através do Visual Studio selecionando o projeto ODataTFS.Web e selecionar a opção Publish, configure as opções do servidor onde será publicado e clique em Publish

tfs_odata_imagem4

O resultado deverá ser conforme a figura abaixo!

tfs_odata_imagem5

Configurando o TFS OData

Depois de instalado temos que realizar algumas configurações no arquivo web.config, a primeira é o endereço do TFS que se encontra na chave ODataTFS.TfsServer conforme a imagem abaixo:

tfs_odata_imagem6

Caso em seu ambiente você não esteja usando HTTPS, temos que alterar o modo de autenticação nos bindings

De: <security mode=”Transport”></security>

Para: <security mode=”None”></security>

tfs_odata_imagem7

Agora acesse o website que foi configurado no IIS e veja o resultado

tfs_odata_imagem8

Nos próximos posts veremos como usar o TFS OData

Qualquer dúvida, opinião, reclamação mande seu comentário!

Um Abraço!

Sobre Leandro Prado

Leandro Silveira Prado é Premier Field Engineer na Microsoft especializado em Application Lifecycle Management.