Önceki Başlık: Etkinlik AbonelikleriSonraki Başlık: Görüntüleme İşlemleri


Catalyst REST

Catalyst RESTful hizmetleri, Catalyst Process Automation Hizmetlerine erişmenize olanak sağlar. Catalyst RESTful arabirim kaynaklarını keşfetmek için, herhangi bir tarayıcıdan temel URL ile başlayın ve köprülerin çapraz geçişini yapmak için HTTP GET isteklerini kullanın.

Catalyst RESTful arabiriminin temel URL'si şudur:

http://<hostname>:7000/node/rest/

Temel URL, Catalyst kapsayıcı modüllerinin URL'lerini görüntüler. Catalyst kapsayıcısı, Catalyst aracısı ve Catalyst Process Automation Hizmetlerine yönelik modülleri barındırır.

Modüllerin durumu şu adreste görüntülenebilir:

http://<hostname>:7000/node/rest/broker/Entity

Catalyst Process Automation Hizmetlerine yönelik modül şudur: "CA:00074_CA:00074:01":

http://<hostname>:7000/node/rest/CA:00074_CA:00074:01/

Bağlayıcı tanımlarına şu REST API meta veri arabiriminden erişilir:

http://<hostname>:7000/node/rest/CA:00074_CA:00074:01;metadata=descriptor

Örneğin:

<?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>
  
  
  <!-- ******************************* -->
  <!-- Process operations...           -->
  <!-- ******************************* -->
  
  <!-- Start a Process -->
  <customOp ID="Start" name="Start" synchronous="true">
    <inputType xsi:type="pam-ops:StartRequest"/>
    <resultType xsi:type="pam-ops:StartResponse"/>
  </customOp>
  …

Bağlayıcı işlemlerine yönelik şemaya şu adresteki REST API meta veri arabiriminden erişilir:

http://<hostname>:7000/node/rest/CA:00074_CA:00074:01;metadata=schema

Herhangi bir üçüncü taraf XML şema yardımcı programı, şemayı işlemlerin girdi parametrelerini oluşturmak için kullanabilir.

Örneğin:

<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>Bir varlığı başlatmaya yönelik istek, EntityID öğesiyle tanımlanır</xs:documentation>
    </xs:annotation>
    <xs:sequence>
      <xs:element name="EntityID" type="usm-core:EntityID">
        <xs:annotation>
          <xs:documentation>Başlatılması gereken varlığa yönelik tanımlama (şu öğeler tarafından tanımlanır: 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>Bir varlığı başlatmaya yönelik istek, EntityID öğesiyle tanımlanır</xs:documentation>
    </xs:annotation>
  </xs:element>
  <xs:complexType name="StartResponse">
    <xs:annotation>
      <xs:documentation>Başarıyla başlatılırsa, EntityID öğesini içeren bir yanıt döndürülür</xs:documentation>
    </xs:annotation>
    <xs:sequence>
      <xs:element name="EntityID" type="usm-core:EntityID">
        <xs:annotation>
          <xs:documentation>Başlatılması istenen varlığa yönelik tanımlama (şu öğeler tarafından tanımlanır: 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>Başarıyla başlatılırsa, EntityID öğesini içeren bir yanıt döndürülür</xs:documentation>
    </xs:annotation>
  </xs:element>
…

Catalyst REST arabiriminin URL'sinden başlayarak, Catalyst Process Automation Hizmetleri URL'sini görüntüleyebilirsiniz. Catalyst Process Automation Hizmetleri URL'si, desteklenen tür ve işlemlerin URL'lerini içerir. Örneğin:

<?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>