Business Services

Import WSDL of WiFIS

• The Business Services of WiFIS Easy Connect must meet the WSDL defined in the implementation guide.
• They have been generated with SOAP wizard of Ensemble, to have the interface specified by WiFIS.
• After generating Business Services with the wizard, the following changes were made:

  • Change the superclass to WIFIS.BS.V1Service. This class has the implementation generic for all Business Services of WiFIS.

  • The implementation of each Web Service method calls a generic method of super class using as parameter the name of the workflow and the operation performed:

    quit ..Forward(any,"Cites",$$$CurrentMethod)

Common implementation for Web Services

WIFIS.BS.V1Service class is the super class of all WiFIS Business Services and contains the common implementation for all of them.

Getting the WSDL

• Because of details of chosen implementation, the WSDL returned by Ensemble for this Web Service could not meet the exact format of WSDL WiFIS, and this could cause problems if a client requests the WSDL with http://<URL>?WSDL.
• For this reason there is a possibility of using the parameter WSDLFile. This parameter has the path of a WSDL file which is returned to the request http://<URL>?WSDL (if it is empty, it will be returned the WSDL using the Ensemble standard mechanism).

Optional validation of XML schema

• The SOAP definition of WiFIS especifies the message body as XML.Any to allow any HL7 without having to change the SOAP interface. This also allows sending any XML not meeting HL7 without rejection from Web service.
• To facilitate testing and debugging it is possible to specify a filename for XML Schema (parameter XMLSchemaFile)
  • This parameter indicates the path of a schema file XML that Web service uses to validate the format of the message (when the parameter ValidateSchema is activated).

---

Importació WSDL de WiFIS

• Els Business Services de WiFIS Easy Connect han de complir amb la WSDL definida en la guia de implementació de WiFIS.
• S'han generat amb l'assistent de SOAP de Ensemble, perquè tinguin l'interfície especificada per WiFIS.
• Després de generar els Business Services amb l'assistent, s'han fet els següents canvis:

  • Canviar la super classe a WIFIS.BS.V1Service. Aquesta classe conté la implementació genèrica a tots els Business Services de WiFIS.

  • La implementació de cada mètode del servei web crida a un mètode genèric de la super classe utilitzant com paràmetres el nom del circuit i de la operació a realitzar:

    quit ..Forward(any,"Cites",$$$CurrentMethod)

Implementació comú als Serveis Web

La classe WIFIS.BS.V1Service és la super classe de tots els Business Services WiFIS i conté la implementació comú per tots ells.

Recuperació del WSDL

• A causa de detalls de la implementació escollida, la WSDL retornada per Ensemble per a aquest servei web no compleix sempre el format exacte de WSDL WiFIS, i això pot ocasionar problemes si un client sol·licita la WSDL amb http://<URL>?WSDL.
• Per aquest motiu existeix la possibilitat d'informar el paràmetre WSDLFile. Aquest paràmetre indica la ruta d'un fitxer WSDL que es retorna a la petició http://<URL>?WSDL (en cas de no estar informat, es retorna la WSDL pel mecanisme estàndard de Ensemble).

Validació opcional de l'esquema XML

• La definició SOAP de WiFIS defineix el cos del missatge com un XML.Any per permetre qualsevol tipus de HL7 sense haver de canviar la interfície SOAP. Això permet també enviar qualsevol XML que no compleixi amb HL7 sense que ho rebutgi el servei web.
• Per facilitar les proves i la depuració existeix la possibilitat d'especificar un nom de fitxer d'esquema XML (paràmetre XMLSchemaFile)
  • Aquest paràmetre indica la ruta d'un fitxer d'esquema XML que el servei web uitlitza per validar el format del missatge (quan el paràmetre ValidateSchema está activat).