WebService Plus Activity

Parent Previous Next

La actividad WebServicePlusActivity permite acceder a cualquier Web Service construido en cualquier plataforma y sus parámetros no necesariamente deben ser de tipo simple.

                               


Al hacer doble click sobre la actividad colocada en el diseñador de reacciones se accede a la primer pantalla del asistente de  configuración de actividades.



URL

Permite ingresar la ruta de acceso a la definición WSDL del Web Service. Al presionar  el botón “Go” se realiza la carga de dicha definición y se completa la lista "Web Service Methods" visualizando los métodos disponibles en el  Web Service seleccionado junto con sus parámetros. Cuando el usuario presiona el botón "Go" se genera en la carpeta WSProxies - ubicada dentro del directorio de instalación de BIZUIT Designer - un archivo cuyo nombre es el nombre de la reacción + el nombre de la actividad con la extensión “.dll” y otro con el mismo nombre y  la extensión “.config”. Estos archivos contienen el código y parametrización necesarios para invocar al WebService mediante un cliente WCF. Al momento de la publicación del evento estos archivos son automáticamente publicados conjuntamente con la reacción y colocados en el directorio WSProxies dentro de la carpeta de instalación de BIZUIT EventManager

Use generated WCF .config file

Esta opción nos permite utilizar la configuración de la llamada a dicho Web Service en un archivo de configuración individual generado por esta actividad o bien utilizar el archivo de configuración de BIZUIT Event Manager.

En caso de no seleccionar esta opción, se deberá colocar manualmente en el archivo web.config de BIZUIT EventManager la configuración del cliente WCF.

Ver http://msdn.microsoft.com/en-us/library/ms731745.aspx

Nota: En caso que el WebService requiera la utilización de certificados, y la opción "Use generated WCF .config file" NO se encuentre seleccionada, la configuracion de los mismos debe ser realizada en el web.config de BIZUIT EVentManager

Use Certificate

En caso que el WebService requiera la utilización de certificados, al seleccionar esta opción se permite ingresar la configuracion de los mismos.

Store Location

Especifica la ubicación del almacén de certificados X.509, pudiendo optar entre CurrentUser(Almacén de certificados X.509 utilizado por el usuario actual) y LocalMachine(Almacén de certificados X.509 asignado al equipo local)

Store Name

Especifica el nombre del almacén del certificado X.509 que se va a abrir, pudiendo optar entre:

  • AddressBook:El almacén del certificado X.509 para otros usuarios.
  • AuthRoot:El almacén del certificado X.509 para las entidades de certificación (CA) de otros fabricantes.
  • CertificateAuthority:El almacén del certificado X.509 para las entidades de certificación (CA) intermedias.
  • Disallowed:El almacén del certificado X.509 para los certificados revocados.
  • My: El almacén del certificado X.509 para los certificados personales.
  • Root:El almacén del certificado X.509 para las entidades de certificación (CA) raíz de confianza.
  • TrustedPeople:El almacén del certificado X.509 para las personas y los recursos de confianza directa.
  • TrustedPublisher:El almacén del certificado X.509 para emisores de confianza directa.

Find By

  • Especifica el tipo de valor buscado pudiendo optar entre:
  • FindByApplicationPolicy: La propiedad "Value" debe ser una cadena que represente el nombre descriptivo de la directiva de aplicación o el identificador de objeto (OID o Oid) del certificado. Por ejemplo, se puede utilizar "Sistema de archivos de cifrado" o "1.3.6.1.4.1.311.10.3.4". Cuando se vaya a adaptar una aplicación, se deberá utilizar el valor OID, puesto que el nombre descriptivo también se adapta.
  • FindByCertificatePolicy: La propiedad "Value" debe ser una cadena que represente el nombre descriptivo o el identificador de objeto (OID o Oid) de la directiva del certificado. El procedimiento recomendado es utilizar el OID como, por ejemplo, "1.3.6.1.4.1.311.10.3.4". Cuando se vaya a adaptar una aplicación, se deberá utilizar el OID, puesto que el nombre descriptivo también se adapta.
  • FindByExtension:        La propiedad "Value" deberá ser una cadena que describa la extensión que se va a buscar. El identificador de objeto (OID) se utiliza normalmente para indicar al método Find que busque todos los certificados que tengan una extensión que coincida con el valor de OID.
  • FindByIssuerDistinguishedName: La propiedad "Value" deberá ser una cadena que represente el nombre distintivo del emisor del certificado. Esta es una búsqueda más concreta que la proporcionada por el valor de enumeración FindByIssuerName. Cuando se utiliza el valor FindByIssuerDistinguishedName, el método Find realiza una comparación de cadenas de nombres distintivos, sin distinción de mayúsculas y minúsculas. La búsqueda por nombre de emisor proporciona resultados menos precisos.
  • FindByIssuerName: La propiedad "Value" deberá ser una cadena que represente el nombre del emisor del certificado. Esta es una búsqueda menos concreta que la proporcionada por el valor de enumeración FindByIssuerDistinguishedName. Cuando se utiliza el valor FindByIssuerName, el método Find realiza una comparación de cadenas, sin distinción de mayúsculas y minúsculas, con el valor proporcionado. Por ejemplo, si se pasa "MiEntidadEmisora" al método Find, se encontrarán todos los certificados cuyo nombre de emisor contenga esa cadena, sin que se tengan en cuenta otros valores del emisor.
  • FindByKeyUsage: La propiedad "Value" deberá ser una cadena que represente el uso de la clave o un entero que represente una máscara de bits que contenga todos los usos de clave solicitados. Para el valor de cadena sólo se puede especificar un uso de clave al mismo tiempo, pero se puede utilizar el método Find en una secuencia en cascada para obtener la intersección de los usos solicitados. Por ejemplo, el parámetro findValue se puede establecer en "KeyEncipherment" o en un entero (0x30 indica "KeyEncipherment" y "DataEncipherment"). También se pueden utilizar los valores de la enumeración X509KeyUsageFlags.
  • FindBySerialNumber: La propiedad "Value" debe ser una cadena que representa el número de serie del certificado como se muestra en el cuadro de diálogo de certificado, pero sin espacios, o que devuelve el método GetSerialNumberString .
  • FindBySubjectDistinguishedName: La propiedad "Value" deberá ser una cadena que represente el nombre distintivo del sujeto del certificado. Esta es una búsqueda más concreta que la proporcionada por el valor de enumeración FindBySubjectName. Cuando se utiliza el valor FindBySubjectDistinguishedName, el método Find realiza una comparación de cadenas de nombres distintivos, sin distinción de mayúsculas y minúsculas. La búsqueda por nombre de sujeto proporciona resultados menos precisos.
  • FindBySubjectKeyIdentifier: La propiedad "Value" deberá ser una cadena que represente el identificador de clave de sujeto en formato hexadecimal, como "F3E815D45E83B8477B9284113C64EF208E897112", tal y como se muestra en la interfaz de usuario (UI).
  • FindBySubjectName: La propiedad "Value" deberá ser una cadena que represente el nombre del sujeto del certificado. Esta es una búsqueda menos concreta que la proporcionada por el valor de enumeración FindBySubjectDistinguishedName. Cuando se utiliza el valor FindBySubjectName, el método Find realiza una comparación de cadenas, sin distinción de mayúsculas y minúsculas, con el valor proporcionado. Por ejemplo, si se pasa "MiCertificado" al método Find, se encontrarán todos los certificados cuyo nombre de sujeto contenga esa cadena, sin que se tengan en cuenta otros valores del sujeto. La búsqueda por nombre distintivo proporciona resultados más precisos.
  • FindByTemplateName: La propiedad "Value" deberá ser una cadena que represente el nombre de plantilla del certificado como, por ejemplo, "AutorizaciónCliente". Un nombre de plantilla es una extensión de la versión 3 de X509 que especifica los usos del certificado.
  • FindByThumbprint: La propiedad "Value" deberá ser una cadena que represente la huella digital del certificado.
  • FindByTimeExpired:La propiedad "Value" deberá ser un valor DateTime en hora local. Por ejemplo, puede encontrar todos los certificados que serán válidos hasta el fin del año eliminando los resultados de una operación Find para FindByTimeExpired del último día del año de los resultados de una operación Find para DateTime.Now.
  • FindByTimeNotYetValid:La propiedad "Value" deberá ser un valor DateTime en hora local. El valor no tiene que ser necesariamente futuro. Por ejemplo, puede utilizar FindByTimeNotYetValid para encontrar certificados que eran válidos en el año actual tomando la intersección de los resultados de una operación Find para FindByTimeNotYetValid durante el último día del año pasado con los resultados de una operación Find para FindByTimeValid de DateTime.Now.
  • FindByTimeValid: La propiedad "Value" deberá ser un valor DateTime en hora local. Puede utilizar DateTime.Now para buscar todos los certificados actualmente válidos.

Value

El valor a buscar según lo especificado en la propiedad "FindBy"



Use Authentication

En caso de requerir enviar credenciales de red para acceder al Web Service se debe tildar esta opción, lo que habilitara los campos “User” y “Password” en los cuales se deberá ingresar dichas credenciales.

User

Permite ingresar el usuario de la credencial de red requerida por el WebService.

Password

Permite ingresar la contraseña de la credencial de red requerida por el WebService.

Methods

Una vez cargado el Web Service, esta lista despliega los métodos disponibles que pueden ser llamados.

Parameters

Al seleccionar el método a ejecutar se visualizarán sus parámetros.

Call this Mehod Multiple Times

Permite configurar la llamada al método seleccionado se ejecutará más de una vez, en cuyo caso al momento de realizar el mapeo de datos de entrada en el paso 4 del asistente de configuración de actividades se añadirá un nodo repetitivo a la estructura de datos de entrada de la actividad que permitirá realizar el mapeo repetitivo necesario. Ver Mapeos.

Clear

Permite borrar la configuración realizada para ingresar una nueva configuración.



Anterior / Siguiente