/// <summary>
///
/// Method to start the dispatch process for one or several documents.
/// All files on each document will be included, and it will be
/// dispatched to all recipients.
///
/// If any of the documents fail, the operation will continue with the
/// next document in the list. A list of result objects will be returned. NB:
/// The result only indicates if the dispatch process was started
/// successfully. To see if the dispatch was completed successfully – check
/// status in 360°.
///
/// </summary>
/// <param name='operations'>
/// The operations group for this extension method.
/// </param>
/// <param name='dispatchDocumentsArgs'>
/// (See model for parameter info)
/// </param>
public static DispatchDocumentsOKResponse DispatchDocuments(this IDocumentService operations, DispatchDocumentsArgs dispatchDocumentsArgs = default(DispatchDocumentsArgs))
{
return(Task.Factory.StartNew(s => ((IDocumentService)s).DispatchDocumentsAsync(dispatchDocumentsArgs), operations, CancellationToken.None, TaskCreationOptions.None, TaskScheduler.Default).Unwrap().GetAwaiter().GetResult());
}
/// <summary>
///
/// Method to start the dispatch process for one or several documents.
/// All files on each document will be included, and it will be
/// dispatched to all recipients.
///
/// If any of the documents fail, the operation will continue with the
/// next document in the list. A list of result objects will be returned. NB:
/// The result only indicates if the dispatch process was started
/// successfully. To see if the dispatch was completed successfully – check
/// status in 360°.
///
/// </summary>
/// <param name='operations'>
/// The operations group for this extension method.
/// </param>
/// <param name='dispatchDocumentsArgs'>
/// (See model for parameter info)
/// </param>
/// <param name='cancellationToken'>
/// The cancellation token.
/// </param>
public static async Task <DispatchDocumentsOKResponse> DispatchDocumentsAsync(this IDocumentService operations, DispatchDocumentsArgs dispatchDocumentsArgs = default(DispatchDocumentsArgs), CancellationToken cancellationToken = default(CancellationToken))
{
using (var _result = await operations.DispatchDocumentsWithHttpMessagesAsync(dispatchDocumentsArgs, null, cancellationToken).ConfigureAwait(false))
{
return(_result.Body);
}
}
/// <summary>
///
/// Method to start the dispatch process for one or several documents.
/// All files on each document will be included, and it will be
/// dispatched to all recipients.
///
/// If any of the documents fail, the operation will continue with the
/// next document in the list. A list of result objects will be returned. NB:
/// The result only indicates if the dispatch process was started
/// successfully. To see if the dispatch was completed successfully – check
/// status in 360°.
///
/// </summary>
/// <param name='dispatchDocumentsArgs'>
/// (See model for parameter info)
/// </param>
/// <param name='customHeaders'>
/// Headers that will be added to request.
/// </param>
/// <param name='cancellationToken'>
/// The cancellation token.
/// </param>
/// <return>
/// A response object containing the response body and response headers.
/// </return>
public async Task <HttpOperationResponse <DispatchDocumentsOKResponse> > DispatchDocumentsWithHttpMessagesAsync(DispatchDocumentsArgs dispatchDocumentsArgs = default(DispatchDocumentsArgs), Dictionary <string, List <string> > customHeaders = null, CancellationToken cancellationToken = default(CancellationToken))
{
// Tracing
bool _shouldTrace = ServiceClientTracing.IsEnabled;
string _invocationId = null;
if (_shouldTrace)
{
_invocationId = ServiceClientTracing.NextInvocationId.ToString();
Dictionary <string, object> tracingParameters = new Dictionary <string, object>();
tracingParameters.Add("dispatchDocumentsArgs", dispatchDocumentsArgs);
tracingParameters.Add("cancellationToken", cancellationToken);
ServiceClientTracing.Enter(_invocationId, this, "DispatchDocuments", tracingParameters);
}
// Construct URL
var _baseUrl = this.BaseUri.AbsoluteUri;
var _url = new Uri(new Uri(_baseUrl + (_baseUrl.EndsWith("/") ? "" : "/")), "DispatchDocuments").ToString();
// Create HTTP transport objects
HttpRequestMessage _httpRequest = new HttpRequestMessage();
HttpResponseMessage _httpResponse = null;
_httpRequest.Method = new HttpMethod("POST");
_httpRequest.RequestUri = new Uri(_url);
// Set Headers
if (customHeaders != null)
{
foreach (var _header in customHeaders)
{
if (_httpRequest.Headers.Contains(_header.Key))
{
_httpRequest.Headers.Remove(_header.Key);
}
_httpRequest.Headers.TryAddWithoutValidation(_header.Key, _header.Value);
}
}
// Serialize Request
string _requestContent = null;
if (dispatchDocumentsArgs != null)
{
_requestContent = SafeJsonConvert.SerializeObject(dispatchDocumentsArgs, this.SerializationSettings);
_httpRequest.Content = new StringContent(_requestContent, Encoding.UTF8);
_httpRequest.Content.Headers.ContentType = MediaTypeHeaderValue.Parse("application/json; charset=utf-8");
}
// Set Credentials
if (this.Credentials != null)
{
cancellationToken.ThrowIfCancellationRequested();
await this.Credentials.ProcessHttpRequestAsync(_httpRequest, cancellationToken).ConfigureAwait(false);
}
// Send Request
if (_shouldTrace)
{
ServiceClientTracing.SendRequest(_invocationId, _httpRequest);
}
cancellationToken.ThrowIfCancellationRequested();
_httpResponse = await this.HttpClient.SendAsync(_httpRequest, cancellationToken).ConfigureAwait(false);
if (_shouldTrace)
{
ServiceClientTracing.ReceiveResponse(_invocationId, _httpResponse);
}
HttpStatusCode _statusCode = _httpResponse.StatusCode;
cancellationToken.ThrowIfCancellationRequested();
string _responseContent = null;
if ((int)_statusCode != 200)
{
var ex = new HttpOperationException(string.Format("Operation returned an invalid status code '{0}'", _statusCode));
_responseContent = await _httpResponse.Content.ReadAsStringAsync().ConfigureAwait(false);
ex.Request = new HttpRequestMessageWrapper(_httpRequest, _requestContent);
ex.Response = new HttpResponseMessageWrapper(_httpResponse, _responseContent);
if (_shouldTrace)
{
ServiceClientTracing.Error(_invocationId, ex);
}
_httpRequest.Dispose();
if (_httpResponse != null)
{
_httpResponse.Dispose();
}
throw ex;
}
// Create Result
var _result = new HttpOperationResponse <DispatchDocumentsOKResponse>();
_result.Request = _httpRequest;
_result.Response = _httpResponse;
// Deserialize Response
if ((int)_statusCode == 200)
{
_responseContent = await _httpResponse.Content.ReadAsStringAsync().ConfigureAwait(false);
try
{
_result.Body = SafeJsonConvert.DeserializeObject <DispatchDocumentsOKResponse>(_responseContent, this.DeserializationSettings);
}
catch (JsonException ex)
{
_httpRequest.Dispose();
if (_httpResponse != null)
{
_httpResponse.Dispose();
}
throw new SerializationException("Unable to deserialize the response.", _responseContent, ex);
}
}
if (_shouldTrace)
{
ServiceClientTracing.Exit(_invocationId, _result);
}
return(_result);
}
