Invocación de API de servicios y estándar mediante programación

Puede revisar el código de ejemplo para invocar servicios y las API estándar de forma programática y revisar los protocolos.

La aplicación proporciona código de ejemplo que muestra cómo se pueden invocar mediante programación las API estándar y los servicios de la aplicación. Consulte los archivos de ejemplo en el directorio <runtime_sandbox>/xapidocs/code_examples/ .

Nota: Utilice el método executeFlow( ) de la interfaz YIFApi para ejecutar un servicio definido en el marco de definición de servicios.

Las transacciones de API y de servicio que son salientes de la aplicación se pueden configurar a través del Creador de servicios, tal como se describe en Conceptos de modelado de organización y participantes.

Las transacciones de API y de servicio que son de entrada para la aplicación se pueden invocar a través de los protocolos siguientes:
  • EJB
  • HTTP y HTTPS
  • LOCAL
  • Servicios web
  • COM+

EJB

Utilice EJB para ejecución del lado del servidor del código. Llamada Java™ . Todos los métodos de la aplicación toman un YFSEnvironment y un documento, y devuelven un documento. Dado que los EJB están diseñados para llamarse de forma remota, cada uno de estos documentos se serializa en un extremo y se deserializa en el otro. No obstante, la aplicación utiliza un EJB, donde cada API tiene dos parámetros string y devuelve un string. De esta forma, obliga a cualquier implementación de documento a serializar y deserializar una interfaz estándar bien definida.

Por ejemplo, se crea un nuevo EJB con firmas de método como:
String createOrder(String env, String inputXML) throws YFSException, RemoteException;

donde env es un XML que debe ser una entrada válida a la variable createEnvironment. El valor de devolución es un XML de salida.

Al llamar a una API utilizando YIFClientFactory.getInstance().getApi(“EJB”) la llamada se efectúa utilizando este EJB basado en String. Con este tipo de llamada, puede pasar un YFSEnvironment y un documento, y obtener un documento de retorno. El código de aplicación realiza la conversión de forma transparente.

Nota: El EJB basado en DOM está en desuso. Por consiguiente, para avanzar necesita utilizar el EJB basado en String para ejecución del lado del servidor.

HTTP

Utilice HTTP para ejecución de código del lado del servidor. Llamada Java.

LOCAL

Utilice Local para ejecución de código del lado del cliente. Llamada COM o Java.

Servicios Web

Utilice Servicios web para código de ejecución del lado del cliente. Llamada COM o Java.

COM+

Utilice COM para ejecución de código VB o C++ del lado del cliente. Llamada COM o Java.

Utilizar COM requiere configurar el servidor y los clientes de ejecución.

Nota: Las excepciones encontradas al realizar llamadas de API síncronas a través de los protocolos de transporte EJB, COM o HTTP no se ponen en cola para su reprocesamiento.