API 'externa a TP.NET' para la subida del DeCA
Se puede usar una API externa, proporcionada/programada por terceros ajenos al desarrollador de TP.NET, para la subida automática del DeCA al realizar una pesada, ya que una de las nuevas opciones para la gestión del DeCA permite precisamente esta opción.
A continuación se muestra un esquema básico de ambos métodos, basado en una aplicación ASP.NET Core Web API .NET 9:
Un tercero, el equipo IT del cliente o una empresa ajena a DAII puede desarrollar una API propia que disponga de esos 2 métodos (subir y borrar) y que serán los que se comuniquen con la 'nube del cliente'.
En TP.NET se usa un objeto de tipo HttpClient, tanto para la subida como para el borrado:
Subida [HttpPost]
- Se lee el pdf y se añade como un StreamContent a un objeto de tipo MultipartFormDataContent mediante una instrucción de tipo: content.Add(fileContent,"file", filaName); donde el objeto fileContent tiene una cabecera de tipo "application/pdf".
- Se espera una respuesta mediante: response = Await _httpClient.PostAsync(_url, content);
- Si response.IsSuccessStatusCode es verdadero se considerará que la llamada ha sido correcta.
A grandes rasgos, esto es lo que hace TP.NET para 'subir' el fichero mediante la API 'externa':
Borrado [HttpDelete]
El proceso de borrado puede configurarse para que se realice un borrado del fichero antes de volver a subir el PDF, sobre todo cuando se hacen modificaciones en la pesada desde la ventana de gestión del parte de pesadas.
Si tu API no requiere de este paso, se deberá indicar que no es necesario realizar un borrado previo en los parámetros de configuración de TP.NET
- Se construye la url como: _url = _urlEndPointDelete?filename=_nombreUnicoPdf, donde nombreUnicoPdf se recupera de la información del registro de pesadas.
- Se espera una respuesta mediante: response = Await _httpClient.DeleteAsync(_url);
- Si response.IsSuccessStatusCode es verdadero se considerará que la llamada ha sido correcta.
A grandes rasgos, esto es lo que hace TP.NET para 'borrar' el fichero mediante la API 'externa':
El parámetro interno de tipo booleano CustomAPI_DeleteError_ByPass permitirá indicar a TP.NET que intente llamar al método de subida, incluso si el método de borrado ha dado error. El valor por defecto es abortar la subida si en el borrado ocurrió algún error.
Por último indicar que tanto para la subida como para el borrado, el parámetro interno SSL_TLS_version define el valor del protocolo seguro usado. El valor por defecto es Tls12 que representa que se use la versión 1.2 del protocolo TLS.
En los ficheros de registro de la carpeta Logs dentro de DAIIData se puede obtener información adicional en caso de error o depuración.
