Changes between Version 14 and Version 15 of actividades_2018_pruebas

Timestamp:

May 31, 2018, 8:31:49 AM (6 years ago)

Author:

pbuitrago

Comment:

--

actividades_2018_pruebas

@@ -22 +22 @@
 == Sección 1: Subir documento pdf ==
 
-En la primera sección se envía al sistema Murachí el archivo pdf que se va a firmar. Entonces para esta sección se requiere de un formulario que permita tomar del sistema de archivo documentos pdf y luego enviarlo con el método ''$.ajax usando el recurso /Murachi/0.1/archivos/'' '''Característica del formulario HTML''' 
+En la primera sección se envía al sistema Murachí el archivo pdf que se va a firmar. Entonces para esta sección se requiere de un formulario que permita tomar del sistema de archivo documentos pdf y luego enviarlo con el método ''$.ajax usando el recurso /Murachi/0.1/archivos/''
+
+'''Característica del formulario HTML''' 
 
 [[br]]
@@ -85 +87 @@
 [[BR]]
 
-Ahora vamos a necesitar una función en javascript que me permita usar la librería Forge para cargar y acceder al archivo .p12 o .pfx y obtener la información necesaria para realizar el proceso de firma electrónica.[[BR]]
+Ahora vamos a necesitar una función en ''javascript'' que me permita usar la librería ''Forge'' para cargar y acceder al archivo ''.p12'' o ''.pfx'' y obtener la información necesaria para realizar el proceso de firma electrónica.[[BR]]
 
 [[br]]
@@ -177 +179 @@
 [[BR]]
 
-Con esta función obtenemos la clave privada almacenada en la variable privateKey y el certificado almacenado en la variable certBytesHex. 
+Con esta función obtenemos la clave privada almacenada en la variable ''privateKey'' y el certificado almacenado en la variable ''certBytesHex''. 
 
 La clave privada es un conjunto de bytes que debemos convertir a string, para esto se tiene la siguiente función 
@@ -203 +205 @@
 }}}
 
-[[BR]]
+[[BR]
+
 '''Función SignFilePDF() Sección 1. Subir documento pdf'''
 
-En esta sección la función procesa los datos del formulario. Vamos a cargar el archivo .p12 o .pfx y usando la función getCertificate(e), y se obtiene el archivo pdf seleccionado en el formulario a través del método document.getElementById("file-sign") donde “file-sign” corresponde al id del elemento input de tipo “file” del formulario. Luego se almacena en un objeto de tipo FormData que permite el envío del archivo al servidor usando el método $.ajax
-Opciones de configuración de la petición $.ajax:
-ulr: Establece la URL en donde se realiza la petición, para esta sección es "https://murachi.cenditel.gob.ve/Murachi/0.1/archivos".
-type: Establece el tipo de petición, para esta actividad vamos a utilizar "POST". 
-dataType: Establece el formato de la respuesta que es permitido, si el servidor devuelve información con un formato diferente al especificado el código fallará. Para este proceso se establece “json”.
-data: Establece la información que se enviará al servidor. Para este proceso se envía el archivo almacenado en una variable de tipo FormaData. 
-contentType: Establece el tipo de codificación que se va a utilizar, para esta actividad es "application/json".
-processData: Establece si la información que se envía al servidor debe ser procesada a una cadena de caracteres. Para evitar esto se debe utilizar el valor “false”. En esta sección sólo se quiere enviar el archivo sin ser procesado.
-xhrFields y headers: ya indicado al principio de esta sección.
+En esta sección la función procesa los datos del formulario. Vamos a cargar el archivo ''.p12'' o ''.pfx'' y usando la función ''getCertificate(e)'', y se obtiene el archivo ''pdf'' seleccionado en el formulario a través del método ''document.getElementById("file-sign")'' donde ''“file-sign”'' corresponde al id del elemento input de tipo ''“file”'' del formulario. Luego se almacena en un objeto de tipo ''FormData'' que permite el envío del archivo al servidor usando el método ''$.ajax''
+
+'''Opciones de configuración de la petición $.ajax:'''
+'''ulr:''' Establece la URL en donde se realiza la petición, para esta sección es ''"https://murachi.cenditel.gob.ve/Murachi/0.1/archivos"''.
+'''type:''' Establece el tipo de petición, para esta actividad vamos a utilizar ''"POST"''. 
+'''dataType:''' Establece el formato de la respuesta que es permitido, si el servidor devuelve información con un formato diferente al especificado el código fallará. Para este proceso se establece “json”.
+'''data:''' Establece la información que se enviará al servidor. Para este proceso se envía el archivo almacenado en una variable de tipo ''FormaData''. 
+'''contentType:''' Establece el tipo de codificación que se va a utilizar, para esta actividad es ''"application/json"''.
+'''processData:''' Establece si la información que se envía al servidor debe ser procesada a una cadena de caracteres. Para evitar esto se debe utilizar el valor ''“false”''. En esta sección sólo se quiere enviar el archivo sin ser procesado.
+'''xhrFields:''' {withCredentials: true} esta característica puede usarse para establecer la propiedad de '''withCredentials'''. Si se establece ''TRUE'' permite que se pase los ''cookies'' al servidor y permitir solicitudes de dominios cruzados. 
+'''headers:''' {"Authorization":"Basic YWRtaW46YWRtaW4="} autenticación básica HTTP
 
 [[BR]]
@@ -268 +273 @@
 [[BR]]
 
-La repuesta de esta sección se procesa por el método .done a través del argumento response donde podemos acceder al valor del JSON con la función JSON.stringify.
+La repuesta de esta sección se procesa por el método ''.done'' a través del argumento response donde podemos acceder al valor del ''JSON'' con la función ''JSON.stringify''.
 
 [[BR]]
@@ -392 +397 @@
 
 En esta sección se va a calcular el valor del hash del documento que se envió en la sección 1, en tal sentido antes del cálculo del hash se debe enviar al servidor Murachí toda la información que se agregará al documento tales como el certificado del firmante como información adicional necesaria para la firma electrónica: 
-fileId: corresponde al identificador del archivo que se encuentra en el servidor y se desea firmar (identificador único del archivo pdf). 
-certificate: corresponde al certificado del firmante en formato hexadecimal. 
-reason: corresponde a la razón de la firma (cadena descriptiva del por qué de la firma). 
-location: corresponde a la ubicación donde se realiza la firma. 
-contact: corresponde a información de contacto del firmante. 
-signatureVisible: true para mostrar un indicador visible de firma en la primera página del documento pdf y false para no mostrar un indicador visible de firma en la primera página del documento pdf. 
-
-El certificado lo obtuvimos en la sección anterior, en la función getCertificate(). Luego enviarlo al sistema Murachí con el metodo $.ajax usando el recurso :Murachi/0.1/archivos/pdfs
+
+'''fileId:''' corresponde al identificador del archivo que se encuentra en el servidor y se desea firmar (identificador único del archivo pdf). 
+'''certificate:''' corresponde al certificado del firmante en formato hexadecimal. 
+'''reason:''' corresponde a la razón de la firma (cadena descriptiva del por qué de la firma). 
+'''location:''' corresponde a la ubicación donde se realiza la firma. 
+'''contact:''' corresponde a información de contacto del firmante. 
+'''signatureVisible:''' true para mostrar un indicador visible de firma en la primera página del documento pdf y false para no mostrar un indicador visible de firma en la primera página del documento pdf. 
+
+El certificado lo obtuvimos en la sección anterior, en la función ''getCertificate()''. Luego enviarlo al sistema Murachí con el metodo ''$.ajax'' usando el recurso '':Murachi/0.1/archivos/pdfs''
 
 
@@ -435 +441 @@
 
 
-Si la petición tiene éxito la repuesta de esta sección se procesa a través de la función success: donde se le pase tres parámetros, data: que corresponde al resultado de la petición formateado según el valor del parámetro dataType (respuesta del servidor), textStatus: que corresponde a una cadena que describe el estado y jpXHR: que es un objeto que permite ejecutar varias funciones. 
+Si la petición tiene éxito la repuesta de esta sección se procesa a través de la función ''success:'' donde se le pase tres parámetros, ''data:'' que corresponde al resultado de la petición formateado según el valor del parámetro ''dataType'' (respuesta del servidor), ''textStatus:'' que corresponde a una cadena que describe el estado y ''jpXHR:'' que es un objeto que permite ejecutar varias funciones. 
 
 [[br]]