使用REST api创建新的团队项目

时间:2015-07-31 10:37:06

标签: rest tfs azure-devops

整个星期以来,我一直在反对这个问题。 使用REST api创建新的Team Project。 我看的每个地方,响应是一样的,它总是涉及使用命令行和xml。

但为什么?

在visual studio在线页面上可以找到:

https://www.visualstudio.com/en-us/integrate/api/tfs/projects

(特别关注标有“创建团队项目”的部分)

那么,如果不能使用它,为什么会存在呢? 或者我错过了什么?

如果有人知道使用这个的任何例子我会非常感激。

我一直在使用Microsoft.TeamFoundation.WorkItemTracking.Client命名空间等......并且乐意为项目创建新的工作项

我甚至设法使用API​​来下拉项目列表。 使用此示例中的代码(滚动到页面底部)

https://www.visualstudio.com/en-us/integrate/get-started/rest/basics

但我不能为我的生活发布一个新的团队项目。

此时我对任何建议持开放态度,我在这里创建了一个帐户,只是为了询问(我喜欢这个网站):(

根据要求,一些代码:

static async Task<string> PostProjectAsync(HttpClient _client, string _apiUrl, string _apiVersion)
    {
        var responseBody = string.Empty;

        HttpContent hc = new StringContent(@"
            {
                ""name"": ""Testprojectfromconsole"",
                ""description"": ""Posted from console application using the tfs API""
            }
            ");
        //TODO: make a class that matches the json layout that the api is expecting
        //then see if you have any better luck with that instead of this horrid horrid mess

        ProjectPost newproj = new ProjectPost();
        newproj.Name = @"Test Project -From console";
        newproj.Description = @"Hopefully this has been posted from the console app, delete it later on if need be.";
        newproj.Capabilities.VersionControl.SourceControlType = @"TFS"; //probably wrong
        newproj.Capabilities.ProcessTemplate.TemplateTypeId = @"default"; //also probably wrong

        string json = JsonConvert.SerializeObject(newproj);

        try
        {
            using (HttpResponseMessage response = _client.PostAsync(_apiUrl + _apiVersion, hc).Result)
            {
                response.EnsureSuccessStatusCode();
                responseBody = await response.Content.ReadAsStringAsync();
            }
        }
        catch (Exception ex)
        {
            Console.WriteLine(ex.ToString());
        }

        return responseBody;
    }

目前我正在将名为“hc”的HttpContent传递给postasync,但如果我将其切换为json对象,postasync将停止工作(因为它希望httpcontent不是json)

在调用此方法之前,客户端设置如下:

client.DefaultRequestHeaders.Accept.Add(
                new System.Net.Http.Headers.MediaTypeWithQualityHeaderValue("application/json"));



            //Set alternate credentials
            client.DefaultRequestHeaders.Authorization = new AuthenticationHeaderValue("Basic",
                Convert.ToBase64String(
                    System.Text.ASCIIEncoding.ASCII.GetBytes(
                        string.Format("{0}:{1}", ALTUSERNAME, ALTPASSWORD))));

            Console.WriteLine("<--------------Getting projects from tfs!-------------->");
            Console.WriteLine("<----------------Hold on to your butts!---------------->");

            responseBody = await GetAsync(client, BASEURL + "projects", APIVERS);

            Console.WriteLine(responseBody.ToString());

            Console.WriteLine("<----------------Making a new project!----------------->");
            Console.WriteLine("<----------------Hold on to your butts!---------------->");

            responseBody = await PostProjectAsync(client, BASEURL + "projects", APIVERS);

            Console.WriteLine(responseBody.ToString());

哦,网址是这样的:

static string PN1 = @"Test Project -From Web";
    static string PN2 = @"Another Test Project -From Web";
    static string COL = @"DefaultCollection";

    static string BASEURL = "https://{0}.visualstudio.com/DefaultCollection/_apis/";

    // Get the alternate credentials that you'll use to access the Visual Studio Online account.
    static string ALTUSERNAME = "myusername";
    static string ALTPASSWORD = "mypassword!";



    //Your visual studio account name
    static string ACCOUNT = "ourserver";

    //Api version query parameter
    static string APIVERS = "?api-version=1.0";

2 个答案:

答案 0 :(得分:1)

我不知道您是否仍然对此答案感兴趣(因为距今已有3年了),但问题不是您的代码:这是文档。

使用API​​创建项目时,文档中列出的字段不会告诉您所有必填字段。

如果您在Postman中尝试了该请求,以下是您会得到的信息:

  

消息:“提供给项目创建的项目信息无效。您必须仅提供所有这些属性/功能:名称,描述,可见性,功能,versioncontrol.sourceControlType,功能.processTemplate.templateTypeId。”

项目模板类型为id = 6b724908-ef14-45cf-84f8-768b5384da45

答案 1 :(得分:0)

这是我用过的代码。这是针对.net 3.5制作的,但我找到了.net 4.5.1的解决方案:

private const string PROJECT_TEMPLATE_AGILE = "adcc42ab-9882-485e-a3ed-7678f01f66bc";
private const string PROJECT_TEMPLATE_SCRUM = "6b724908-ef14-45cf-84f8-768b5384da45";
private const string PROJECT_TEMPLATE_CMMI = "27450541-8e31-4150-9947-dc59f998fc01";

VsoTeamProject project = new VsoTeamProject(
                        newFolderName,
                        comment,
                        new Capabilities(new VersionControl("Tfvc"), new ProcessTemplate(projectTemplateId)));

CreateTeamProject(project, "POST", false); // this calls PostResponse method

这是主要方法:

private void PostResponse(VsoTeamProject project, string method, bool useProjectName)
        {
            string projectState = "wellFormed";
            if(method.Equals("DELETE"))
            {
                projectState = "deleting";
            }

            var requestUriString = ConstructUrl(
                useProjectName ? project.TeamProjectId : string.Empty,
                string.Empty,
                new Dictionary<string, object>());
            var httpWebRequest = (HttpWebRequest)WebRequest.Create(requestUriString);
            httpWebRequest.ContentType = "application/json";
            httpWebRequest.Method = method;
            string autorization = TFSImplementor.LoginName + ":" + TFSImplementor.Password;
            byte[] binaryAuthorization = Encoding.UTF8.GetBytes(autorization);
            autorization = Convert.ToBase64String(binaryAuthorization);
            autorization = "Basic " + autorization;
            httpWebRequest.Headers.Add("AUTHORIZATION", autorization);

            if(method.Equals("POST"))
            {
                using(var streamWriter = new StreamWriter(httpWebRequest.GetRequestStream()))
                {
                    string json = JsonConvert.SerializeObject(project);

                    streamWriter.Write(json);
                }
            }

            try
            {
                var httpResponse = (HttpWebResponse)httpWebRequest.GetResponse();
                if(httpResponse.StatusCode == HttpStatusCode.Accepted)
                {
                    Task<WebResponse> responseTask = Task.Factory.FromAsync<WebResponse>(httpWebRequest.BeginGetResponse, httpWebRequest.EndGetResponse, null);
                    using(var responseStream = responseTask.Result.GetResponseStream())
                    {
                        var reader = new StreamReader(responseStream);
                        var t = reader.ReadToEnd();
                        ProjectStatus json = JsonConvert.DeserializeObject<ProjectStatus>(t);
                        if(json.status.Equals("queued"))
                        {
                            while(true)
                            {
                                if(CheckTeamProjectState(project.ProjectName, true, projectState))
                                {
                                    break;
                                }
                            }
                        }
                    }
                }
            }
            catch(WebException e)
            {
                using(WebResponse response = e.Response)
                {
                    using(Stream data = response.GetResponseStream())
                    {
                        using(var reader = new StreamReader(data))
                        {
                            string text = reader.ReadToEnd();
                            Logger.Error(text);
                            Logger.Exception(e);
                            if(method.Equals("DELETE"))
                            {
                                throw new Exception("Failed to delete project, check log for more details");
                            }

                            throw new Exception("Failed to create project, check log for more details");
                        }
                    }
                }
            }
        }

以下是您可以使用的类:

private class VsoTeamProject
{
    #region Fields

    private readonly string m_name;

    private readonly string m_comment;

    private readonly string m_teamProjectId;

    private readonly Capabilities m_capabilities;

    #endregion

    #region Constructors

    public VsoTeamProject(string teamProjectId, string name)
    {
        m_teamProjectId = teamProjectId;
        m_name = name;
    }

    public VsoTeamProject(string projectName, string description, Capabilities capabilities)
    {
        m_name = projectName;
        m_comment = description;
        m_capabilities = capabilities;
    }

    #endregion

    #region Properties

    [JsonProperty("name")]
    protected internal string ProjectName
    {
        get
        {
            return m_name;
        }
    }

    [JsonProperty("description")]
    protected internal string Description
    {
        get
        {
            return m_comment;
        }
    }

    protected internal string TeamProjectId
    {
        get
        {
            return m_teamProjectId;
        }
    }

    [JsonProperty("capabilities")]
    protected internal Capabilities Capabilities
    {
        get
        {
            return m_capabilities;
        }
    }

    #endregion
}

private class ProjectStatus
{
    public string id { get; set; }

    public string status { get; set; }

    public string url { get; set; }

    public string name { get; set; }

    public string state { get; set; }

    public string message { get; set; }
}

private class Capabilities
{
    public Capabilities(VersionControl versionControl, ProcessTemplate template)
    {
        VersionControl = versionControl;
        ProcessTemplate = template;
    }

    [JsonProperty("processTemplate")]
    public ProcessTemplate ProcessTemplate { get; private set; }

    [JsonProperty("versioncontrol")]
    public VersionControl VersionControl { get; private set; }
}

private class VersionControl
{
    public VersionControl(object type)
    {
        SourceControlType = type;
    }

    [JsonProperty("sourceControlType")]
    public object SourceControlType { get; private set; }
}

private class ProcessTemplate
{
    public ProcessTemplate(string templateTypeId)
    {
        TemplateTypeId = templateTypeId;
    }

    [JsonProperty("templateTypeId")]
    public string TemplateTypeId { get; private set; }
}

我有这个PostResponse方法也用于从VSO删除项目。它就像一个魅力。