/// <summary> /// Replaces a recipient in an envelope. /// </summary> /// <param name='operations'> /// The operations group for this extension method. /// </param> /// <param name='envelopeId'> /// The id of the envelope/bulk. /// </param> /// <param name='recipientId'> /// The id of an recipient in the bulk or envelope. /// </param> /// <param name='recipient'> /// The new recipient data. /// </param> /// <param name='cancellationToken'> /// The cancellation token. /// </param> public static async Task <object> ReplaceAsync(this IRecipient operations, string envelopeId, string recipientId, FlowApiSendEnvelopeRecipient recipient, CancellationToken cancellationToken = default(CancellationToken)) { using (var _result = await operations.ReplaceWithHttpMessagesAsync(envelopeId, recipientId, recipient, null, cancellationToken).ConfigureAwait(false)) { return(_result.Body); } }
/// <summary> /// Replaces a recipient in an envelope. /// </summary> /// <param name='envelopeId'> /// The id of the envelope/bulk. /// </param> /// <param name='recipientId'> /// The id of an recipient in the bulk or envelope. /// </param> /// <param name='recipient'> /// The new recipient data. /// </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 <object> > ReplaceWithHttpMessagesAsync(string envelopeId, string recipientId, FlowApiSendEnvelopeRecipient recipient, Dictionary <string, List <string> > customHeaders = null, CancellationToken cancellationToken = default(CancellationToken)) { if (envelopeId == null) { throw new ValidationException(ValidationRules.CannotBeNull, "envelopeId"); } if (recipientId == null) { throw new ValidationException(ValidationRules.CannotBeNull, "recipientId"); } if (recipient == null) { throw new ValidationException(ValidationRules.CannotBeNull, "recipient"); } if (recipient != null) { recipient.Validate(); } // Tracing bool _shouldTrace = ServiceClientTracing.IsEnabled; string _invocationId = null; if (_shouldTrace) { _invocationId = ServiceClientTracing.NextInvocationId.ToString(); Dictionary <string, object> tracingParameters = new Dictionary <string, object>(); tracingParameters.Add("envelopeId", envelopeId); tracingParameters.Add("recipientId", recipientId); tracingParameters.Add("recipient", recipient); tracingParameters.Add("cancellationToken", cancellationToken); ServiceClientTracing.Enter(_invocationId, this, "Replace", tracingParameters); } // Construct URL var _baseUrl = this.Client.BaseUri.AbsoluteUri; var _url = new Uri(new Uri(_baseUrl + (_baseUrl.EndsWith("/") ? "" : "/")), "v1.0/recipient/{recipientId}/fromEnvelope/{envelopeId}").ToString(); _url = _url.Replace("{envelopeId}", Uri.EscapeDataString(envelopeId)); _url = _url.Replace("{recipientId}", Uri.EscapeDataString(recipientId)); // Create HTTP transport objects HttpRequestMessage _httpRequest = new HttpRequestMessage(); HttpResponseMessage _httpResponse = null; _httpRequest.Method = new HttpMethod("PUT"); _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 (recipient != null) { _requestContent = SafeJsonConvert.SerializeObject(recipient, this.Client.SerializationSettings); _httpRequest.Content = new StringContent(_requestContent, Encoding.UTF8); _httpRequest.Content.Headers.ContentType = MediaTypeHeaderValue.Parse("application/json; charset=utf-8"); } // Set Credentials if (this.Client.Credentials != null) { cancellationToken.ThrowIfCancellationRequested(); await this.Client.Credentials.ProcessHttpRequestAsync(_httpRequest, cancellationToken).ConfigureAwait(false); } // Send Request if (_shouldTrace) { ServiceClientTracing.SendRequest(_invocationId, _httpRequest); } cancellationToken.ThrowIfCancellationRequested(); _httpResponse = await this.Client.HttpClient.SendAsync(_httpRequest, cancellationToken).ConfigureAwait(false); if (_shouldTrace) { ServiceClientTracing.ReceiveResponse(_invocationId, _httpResponse); } HttpStatusCode _statusCode = _httpResponse.StatusCode; cancellationToken.ThrowIfCancellationRequested(); string _responseContent = null; if ((int)_statusCode != 204 && (int)_statusCode != 400 && (int)_statusCode != 401 && (int)_statusCode != 404) { 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 <object>(); _result.Request = _httpRequest; _result.Response = _httpResponse; // Deserialize Response if ((int)_statusCode == 400) { _responseContent = await _httpResponse.Content.ReadAsStringAsync().ConfigureAwait(false); try { _result.Body = SafeJsonConvert.DeserializeObject <object>(_responseContent, this.Client.DeserializationSettings); } catch (JsonException ex) { _httpRequest.Dispose(); if (_httpResponse != null) { _httpResponse.Dispose(); } throw new SerializationException("Unable to deserialize the response.", _responseContent, ex); } } // Deserialize Response if ((int)_statusCode == 404) { _responseContent = await _httpResponse.Content.ReadAsStringAsync().ConfigureAwait(false); try { _result.Body = SafeJsonConvert.DeserializeObject <object>(_responseContent, this.Client.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); }
/// <summary> /// Replaces a recipient in an envelope. /// </summary> /// <param name='operations'> /// The operations group for this extension method. /// </param> /// <param name='envelopeId'> /// The id of the envelope/bulk. /// </param> /// <param name='recipientId'> /// The id of an recipient in the bulk or envelope. /// </param> /// <param name='recipient'> /// The new recipient data. /// </param> public static object Replace(this IRecipient operations, string envelopeId, string recipientId, FlowApiSendEnvelopeRecipient recipient) { return(Task.Factory.StartNew(s => ((IRecipient)s).ReplaceAsync(envelopeId, recipientId, recipient), operations, CancellationToken.None, TaskCreationOptions.None, TaskScheduler.Default).Unwrap().GetAwaiter().GetResult()); }