/// <summary>
/// Attaches a file to an issue on the server.
/// </summary>
/// <remarks>Uses the REST API <a href="https://www.jetbrains.com/help/youtrack/standalone/Attach-File-to-an-Issue.html">Attach File to an Issue</a>.</remarks>
/// <param name="issueId">Id of the issue to attach the file to.</param>
/// <param name="attachmentName">Filename for the attachment.</param>
/// <param name="attachmentStream">The <see cref="T:System.IO.Stream"/> to attach.</param>
/// <param name="group">Attachment visibility group.</param>
/// <param name="author">Creator of the attachment. Note to define author the 'Low-Level Administration' permission is required.</param>
/// <exception cref="T:System.ArgumentNullException">When the <paramref name="issueId"/>, <paramref name="attachmentName"/> or <paramref name="attachmentStream"/> is null or empty.</exception>
/// <exception cref="T:System.Net.HttpRequestException">When the call to the remote YouTrack server instance failed.</exception>
public async Task AttachFileToIssue(string issueId, IAttachFileQueryBuilder builder, Stream attachmentStream)
{
if (string.IsNullOrEmpty(issueId))
{
throw new ArgumentNullException(nameof(issueId));
}
if (attachmentStream == null)
{
throw new ArgumentNullException(nameof(attachmentStream));
}
var url = IssuesUrls.AttachFileToIssue(issueId);
var request = new YouTrackRestRequest(url, Method.POST);
if (builder != null)
{
foreach (var param in builder.GetQueryParameters())
{
request.AddQueryParameter(param.Key, param.Value);
}
}
request.AddHeader("Content-Type", "multipart/form-data");
var streamContent = new StreamContent(attachmentStream);
streamContent.Headers.ContentDisposition = new ContentDispositionHeaderValue("form-data")
{
FileName = builder.GetAttachmentName(),
Name = builder.GetAttachmentName()
};
var content = new MultipartFormDataContent
{
streamContent
};
request.AddParameter("application/json; charset=utf-8", request.JsonSerializer.Serialize(content),
ParameterType.RequestBody);
var response = await RestClient.ExecuteTaskAsync(request);
//var response = await client.PostAsync($"rest/issue/{issueId}/attachment?{query}", content);
if (response.StatusCode == HttpStatusCode.BadRequest)
{
//TODO THE
// Try reading the error message
//var responseJson = JObject.Parse(await response.Content.ReadAsStringAsync());
//if (responseJson["value"] != null)
//{
// throw new YouTrackErrorException(responseJson["value"].Value<string>());
//}
//else
//{
// throw new YouTrackErrorException(Strings.Exception_UnknownError);
//}
}
}
/// <summary>
/// Updates an issue on the server in a specific project.
/// </summary>
/// <remarks>Uses the REST API <a href="https://www.jetbrains.com/help/youtrack/standalone/Update-an-Issue.html">Update an Issue</a>.</remarks>
/// <param name="issueId">Id of the issue to update.</param>
/// <param name="summary">Updated summary of the issue.</param>
/// <param name="description">Updated description of the issue.</param>
/// <exception cref="T:System.ArgumentNullException">When the <paramref name="issueId"/> is null or empty.</exception>
/// <exception cref="T:YouTrackErrorException">When the call to the remote YouTrack server instance failed and YouTrack reported an error message.</exception>
/// <exception cref="T:System.Net.HttpRequestException">When the call to the remote YouTrack server instance failed.</exception>
public async Task UpdateIssue(string issueId, string summary = null, string description = null)
{
if (string.IsNullOrEmpty(issueId))
{
throw new ArgumentNullException(nameof(issueId));
}
if (summary == null && description == null)
{
return;
}
var url = IssuesUrls.UpdateIssue(issueId);
var request = new YouTrackRestRequest(url, Method.POST);
if (!string.IsNullOrEmpty(summary))
{
request.AddQueryParameter("summary", WebUtility.UrlEncode(summary));
}
if (!string.IsNullOrEmpty(description))
{
request.AddQueryParameter("description", WebUtility.UrlEncode(description));
}
request.AddHeader("Content-Type", "multipart/form-data");
var response = await RestClient.ExecuteTaskAsync(request);
}
/// <summary>
/// Applies a command to a specific issue on the server.
/// </summary>
/// <remarks>Uses the REST API <a href="https://www.jetbrains.com/help/youtrack/standalone/Apply-Command-to-an-Issue.html">Apply Command to an Issue</a>.</remarks>
/// <param name="issueId">Id of the issue to apply the command to.</param>
/// <param name="command">The command to apply. A command might contain a string of attributes and their values - you can change multiple fields with one complex command.</param>
/// <param name="comment">A comment to add to an issue.</param>
/// <param name="disableNotifications">When <value>true</value>, no notifications about changes made with the specified command will be sent. Defaults to <value>false</value>.</param>
/// <param name="runAs">Login name for a user on whose behalf the command should be applied.</param>
/// <exception cref="T:System.ArgumentNullException">When the <paramref name="issueId"/> or <paramref name="command"/> is null or empty.</exception>
/// <exception cref="T:YouTrackErrorException">When the call to the remote YouTrack server instance failed and YouTrack reported an error message.</exception>
/// <exception cref="T:System.Net.HttpRequestException">When the call to the remote YouTrack server instance failed.</exception>
public async Task ApplyCommand(string issueId, string command, string comment = null,
bool disableNotifications = false, string runAs = null)
{
if (string.IsNullOrEmpty(issueId))
{
throw new ArgumentNullException(nameof(issueId));
}
if (string.IsNullOrEmpty(command))
{
throw new ArgumentNullException(nameof(command));
}
var url = IssuesUrls.ApplyCommand(issueId);
var request = new YouTrackRestRequest(url, Method.POST);
request.AddQueryParameter("command", WebUtility.UrlEncode(command));
if (!string.IsNullOrEmpty(comment))
{
request.AddQueryParameter("comment", WebUtility.UrlEncode(comment));
}
if (disableNotifications)
{
request.AddQueryParameter("disableNotifications", WebUtility.UrlEncode("true"));
}
if (!string.IsNullOrEmpty(runAs))
{
request.AddQueryParameter("runAs", WebUtility.UrlEncode(runAs));
}
request.AddHeader("Content-Type", "multipart/form-data");
var response = await RestClient.ExecuteTaskAsync(request);
if (response.StatusCode == HttpStatusCode.BadRequest)
{
//TODO THE implement that.
// Try reading the error message
//var responseJson = response.
//if (responseJson["value"] != null)
//{
// throw new YouTrackErrorException(responseJson["value"].Value<string>());
//}
//else
//{
// throw new YouTrackErrorException(Strings.Exception_UnknownError);
//}
}
}
/// <summary>
/// Creates an issue on the server in a specific project.
/// </summary>
/// <remarks>Uses the REST API <a href="https://www.jetbrains.com/help/youtrack/standalone/Create-New-Issue.html">Create New Issue</a>.</remarks>
/// <param name="projectId">Id of the project to create an issue in.</param>
/// <param name="issue">The <see cref="Issue" /> to create. At the minimum needs the Summary field populated.</param>
/// <returns>The newly created <see cref="Issue" />'s id on the server.</returns>
/// <exception cref="T:System.ArgumentNullException">When the <paramref name="projectId"/> is null or empty.</exception>
/// <exception cref="T:YouTrackErrorException">When the call to the remote YouTrack server instance failed and YouTrack reported an error message.</exception>
/// <exception cref="T:System.Net.HttpRequestException">When the call to the remote YouTrack server instance failed.</exception>
public async Task <string> CreateIssue(string projectId, Issue issue)
{
if (string.IsNullOrEmpty(projectId))
{
throw new ArgumentNullException(nameof(projectId));
}
//TODO THE queryBuilder ?
var url = IssuesUrls.CreateIssue();
var request = new YouTrackRestRequest(url, Method.PUT);
request.AddQueryParameter("project", projectId);
if (!string.IsNullOrEmpty(issue.Summary))
{
request.AddQueryParameter("summary", WebUtility.UrlEncode(issue.Summary));
}
if (!string.IsNullOrEmpty(issue.Description))
{
request.AddQueryParameter("description", WebUtility.UrlEncode(issue.Summary));
}
request.AddHeader("Content-Type", "multipart/form-data");
var response = await RestClient.ExecuteTaskAsync(request);
// Extract issue id from Location header response
var marker = "rest/issue/";
var locationHeader =
response.Headers.FirstOrDefault(h => h.Name.Equals("Location", StringComparison.OrdinalIgnoreCase));
var issueId =
locationHeader.Value.ToString().Substring(
locationHeader.Value.ToString().IndexOf(marker, StringComparison.OrdinalIgnoreCase) +
marker.Length);
// For every custom field, apply a command
var customFields = issue.Fields
.Where(field => !ReservedFields.Contains(field.Name.ToLower()))
.ToDictionary(field => field.Name, field => field.Value);
foreach (var customField in customFields)
{
if (!(customField.Value is string) && customField.Value is System.Collections.IEnumerable enumerable)
{
await ApplyCommand(issueId, $"{customField.Key} {string.Join(" ", enumerable.OfType<string>())}",
string.Empty);
}
else if (customField.Value is DateTime dateTime)
{
await ApplyCommand(issueId, $"{customField.Key} {dateTime:s}", string.Empty);
}
else if (customField.Value is DateTimeOffset dateTimeOffset)
{
await ApplyCommand(issueId, $"{customField.Key} {dateTimeOffset:s}", string.Empty);
}
else
{
await ApplyCommand(issueId, $"{customField.Key} {customField.Value}", string.Empty);
}
}
// Add comments?
foreach (var issueComment in issue.Comments)
{
await ApplyCommand(issueId, "comment", issueComment.Text, runAs : issueComment.Author);
}
// Add tags?
foreach (var issueTag in issue.Tags)
{
await ApplyCommand(issueId, $"tag {issueTag.Value}");
}
return(issueId);
}