Los servicios RESTful de Catalyst permiten acceder a los servicios de Catalyst Process Automation. Para detectar los recursos de interfaz de RESTful de Catalyst, empiece con la URL base de cualquier explorador y utilice solicitudes de HTTP GET para atravesar los hipervínculos.
La URL base de la interfaz RESTful de Catalyst es:
http://<nombre de host>:7000/node/rest/
La URL base muestra las URL de los módulos del contenedor de Catalyst. El contenedor de Catalyst aloja módulos para el agente de Catalyst y los servicios de Catalyst Process Automation.
El estado de los módulos se puede mostrar en:
http://<nombre de host>:7000/node/rest/broker/Entity
El módulo para los servicios de Catalyst Process Automation es CA:00074_CA:00074:01:
http://<nombrehost>:7000/node/rest/CA:00074_CA:00074:01/
Se accede a los descriptores del conector mediante la interfaz de metadatos del API de REST, que es:
http://<nombrehost>:7000/node/rest/CA:00074_CA:00074:01;metadata=descriptor
Por ejemplo:
<?xml version="1.0" encoding="UTF-8"?>
<conndesc:descriptor xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:conndesc="http://www.ca.com/connex/conndesc"
xsi:schemaLocation="http://www.ca.com/connex/conndesc conn_desc.xsd"
xmlns:usm="http://www.ca.com/usm"
xmlns:xi="http://www.w3.org/2001/XInclude"
xmlns:usm-core="http://ns.ca.com/2009/07/usm-core"
xmlns:pam-ops="http://ns.ca.com/2011/09/pam-ops"
xmlns:pam="http://www.ca.com/pam">
<ID>com.ca.c2o.mdr.UCFPAMConnector</ID>
<version>4.0</version>
<category>CA Process Automation</category>
<configurationDesc xsi:type="usm:KeywordValuePairs">
</configurationDesc>
<connectorProperties>
<property name = "BaseURI" value="http://pam-uri"/>
</connectorProperties>
<!-- ******************************* -->
<!-- Operaciones del proceso... -->
<!-- ******************************* -->
<!-- Iniciar un proceso -->
<customOp ID="Start" name="Start" synchronous="true">
<inputType xsi:type="pam-ops:StartRequest"/>
<resultType xsi:type="pam-ops:StartResponse"/>
</customOp>
…
Se accede al esquema para las operaciones del conector mediante la interfaz de metadatos del API de REST en:
http://<nombrehost>:7000/node/rest/CA:00074_CA:00074:01;metadata=schema
Cualquier utilidad de esquema de XML de terceros puede utilizar el esquema para crear parámetros de entrada de las operaciones.
Por ejemplo:
<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema"
targetNamespace="http://ns.ca.com/2011/09/pam-ops"
xmlns:pam-ops="http://ns.ca.com/2011/09/pam-ops"
xmlns:usm-meta="http://ns.ca.com/2009/07/usm-metadata"
xmlns:usm-meta2="http://ns.ca.com/2011/02/usm-metadata2"
xmlns:usm-core="http://ns.ca.com/2009/07/usm-core" >
<xs:import namespace="http://ns.ca.com/2009/07/usm-metadata" schemaLocation="usm-metadata-200907.xsd"/>
<xs:import namespace="http://ns.ca.com/2011/02/usm-metadata2" schemaLocation="usm-metadata2-201102.xsd"/>
<xs:import namespace="http://ns.ca.com/2009/07/usm-core" schemaLocation="usm-core-200907.xsd"/>
<xs:complexType name="StartRequest">
<xs:annotation>
<xs:documentation>Solicitud para iniciar una entidad identificada por su EntityID</xs:documentation>
</xs:annotation>
<xs:sequence>
<xs:element name="EntityID" type="usm-core:EntityID">
<xs:annotation>
<xs:documentation>Identificación de la entidad que debería iniciarse (definidas por los elementos MdrProduct-MdrProdInstance-MdrElementID).</xs:documentation>
</xs:annotation>
</xs:element>
<xs:element name="Arguments" type="pam-ops:ArgumentList" minOccurs="0" maxOccurs="1" />
</xs:sequence>
</xs:complexType>
<xs:element name="StartRequest" type="pam-ops:StartRequest">
<xs:annotation>
<xs:documentation>Solicitud para iniciar una entidad identificada por su EntityID</xs:documentation>
</xs:annotation>
</xs:element>
<xs:complexType name="StartResponse">
<xs:annotation>
<xs:documentation>Si se inicia correctamente, se devuelve una respuesta que contiene EntityID</xs:documentation>
</xs:annotation>
<xs:sequence>
<xs:element name="EntityID" type="usm-core:EntityID">
<xs:annotation>
<xs:documentation>Identificación de la entidad que se ha solicitado para iniciarse (definida por los elementos MdrProduct-MdrProdInstance-MdrElementID).</xs:documentation>
</xs:annotation>
</xs:element>
</xs:sequence>
</xs:complexType>
<xs:element name="StartResponse" type="pam-ops:StartResponse">
<xs:annotation>
<xs:documentation>Si se inicia correctamente, se devuelve una respuesta que contiene EntityID</xs:documentation>
</xs:annotation>
</xs:element>
…
Comenzando por la URL de la interfaz REST de Catalyst, se puede mostrar la URL de los servicios de Catalyst Process Automation. La URL de los servicios de Catalyst Process Automation contiene las URL de los tipos y las operaciones compatibles. Por ejemplo:
<?xml version="1.0" encoding="UTF-8"?>
<module xmlns="http://ns.ca.com/2010/11/coreapi">
<id>CA:00074_CA:00074:01</id>
<mdrProduct>CA:00074</mdrProduct>
<mdrProdInstance>CA:00074:01</mdrProdInstance>
<type>
<id>ITActivity</id>
<name>ITActivity</name>
<namespace>http://ns.ca.com/2009/07/usm-core</namespace>
<prefix/>
<link href="http://mulwi01-w500:7000/node/rest/CA:00074_CA:00074:01/ITActivity" rel="list"/>
<link href="http://mulwi01-w500:7000/node/rest/CA:00074_CA:00074:01/ITActivity;metadata" rel="metadata"/>
</type>
<type>
<id>ITActivityTemplate</id>
<name>ITActivityTemplate</name>
<namespace>http://ns.ca.com/2009/07/usm-core</namespace>
<prefix/>
<link href="http://mulwi01-w500:7000/node/rest/CA:00074_CA:00074:01/ITActivityTemplate" rel="list"/>
<link href="http://mulwi01-w500:7000/node/rest/CA:00074_CA:00074:01/ITActivityTemplate;metadata" rel="metadata"/>
</type>
<operation>
<id>Release</id>
<name>Release</name>
<synchronous>true</synchronous>
<link href="http://mulwi01-w500:7000/node/rest/CA:00074_CA:00074:01/_ops/Release" rel="self"/>
</operation>
|
Copyright © 2013 CA.
Todos los derechos reservados.
|
|