› 統合 › Web サービス レファレンス › Web サービスの使用

Web サービスの使用

TotalAgility で Web サービス レファレンスを使用するには、TotalAgility サーバーに Microsoft .NET Framework をインストールします。

Web サービスにアクセスするには、次の手順を実行します。

  1. URL などの情報を一元的に保存し、Web サービスを容易に選択および編集できるようにするには、Web サービス参照を作成するします。
  2. インターネット Web サービスとやりとりするには、Web サービス アクティビティを作成するか、Web サービス アクションを追加します。パブリック クラスとパブリック メソッドを備えたすべての Web サービスは、Web サービス アクティビティから呼び出すことができます。各パブリック メソッドには、変数を割り当てる必要があるパラメータのリストがあります。

    SOAP UI を使用して WCF サービス メソッドをテストしており、サービス メソッドに戻り型として Object がある場合は、問題を回避するために、データ型に基づいてリクエストの XML を更新する必要があります。次の例では、文字列型が使用されています。

SOAP UI を使用して TotalAgility の SDK サービスを呼び出す

SOAP が Object データ型以外の値 (null を含む) を Object データ型のパラメータに送信した場合、.NET は変換を読み取ることができません。したがって、SOAP UI を使用して WCF サービス メソッドをテストしていて、サービス メソッドに戻り型として Object がある場合は、.NET が変換を読み取れるようにするために、データ型に基づいてリクエストの XML を変更する必要があります。

入力が「Object」データ型の場合のみ、XML を変更する必要があります。

CreateCase2() 用のサンプル XML では、Variable の Value プロパティは Object データ型です。変数値を文字列に変更します。

サービスへの入力として null 値を渡すには、XML を変更します。たとえば、開始日については次のように変更します。

<sdk:StartDate i:nil="true"></sdk:StartDate>

生成される XML は次のとおりです。

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"  xmlns:sdk="http://www.kofax.com/agility/services/sdk">
   <soapenv:Header/>
   <soapenv:Body>
     <sdk:CreateCase2>
         <!--Optional:-->
         <sdk:sessionId>CF804840115111D48C6100104B71BD07</sdk:sessionId>
         <!--Optional:-->
         <sdk:processIdentity>
            <sdk:Id>9CD1C8C5471F41C19C370E4BAD971F47</sdk:Id>
            <sdk:Version>176.000</sdk:Version>
            <sdk:Name>LAS_New_Request</sdk:Name>
         </sdk:processIdentity>
         <!--Optional:-->
         <sdk:caseReference>POC_123_201402001</sdk:caseReference>
         <!--Optional:-->
         <sdk:caseInitialization>
            <sdk:InputVariables>
               <!--Zero or more repetitions:-->
               <sdk:InputVariable>
                  <sdk:Id>MARKET</sdk:Id>
                  <sdk:Value>BIFA</sdk:Value>
               </sdk:InputVariable>
                <sdk:InputVariable>
                  <sdk:Id>POLICY_NUMBER</sdk:Id>
                  <sdk:Value>44/018/EUR/8508</sdk:Value>
               </sdk:InputVariable>
			 <sdk:InputVariable>
                  <sdk:Id>POLICY_TYPE</sdk:Id>
                  <sdk:Value>PCP_VIP</sdk:Value>
               </sdk:InputVariable>
			<sdk:InputVariable>
                  <sdk:Id>TRANSACTION_ID</sdk:Id>
                  <sdk:Value>55555555</sdk:Value>
               </sdk:InputVariable>
                <sdk:InputVariable>
                  <sdk:Id>TRANSACTION_TYPE</sdk:Id>
                  <sdk:Value>WITHDRAWAL</sdk:Value>
               </sdk:InputVariable>
			 <sdk:InputVariable>
                  <sdk:Id>INITIAL_CASE_TEAM</sdk:Id>
                  <sdk:Value>PCS - BFFM</sdk:Value>
               </sdk:InputVariable>
            </sdk:InputVariables>
            <sdk:StartDate>?</sdk:StartDate>
         </sdk:caseInitialization>
      </sdk:CreateCase2>
   </soapenv:Body>
</soapenv:Envelope>
  1. 次のように XML を変更します (コードの太字部分を参照)。 
    <soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:sdk="http://www.kofax.com/agility/services/sdk">
   <soapenv:Header/>
   <soapenv:Body>
     <sdk:CreateCase2>
        <!--Optional:-->
         <sdk:sessionId>CF804840115111D48C6100104B71BD07</sdk:sessionId>
         <!--Optional:-->
         <sdk:processIdentity>
            <sdk:Id>9CD1C8C5471F41C19C370E4BAD971F47</sdk:Id>
            <sdk:Version>176.000</sdk:Version>
            <sdk:Name>LAS_New_Request</sdk:Name>
         </sdk:processIdentity>
         <!--Optional:-->
         <sdk:caseReference>POC_123_201402007</sdk:caseReference>
         <!--Optional:-->
         <sdk:caseInitialization xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
            <sdk:InputVariables>
               <!--Zero or more repetitions:-->
               <sdk:InputVariable>
                  <sdk:Id>MARKET</sdk:Id>
                  <sdk:Value i:type="a:string" xmlns:a="http://www.w3.org/2001/XMLSchema">BIFA</sdk:Value>
               </sdk:InputVariable>                
            </sdk:InputVariables>
            <sdk:StartDate i:nil="true"></sdk:StartDate>
         </sdk:caseInitialization>
      </sdk:CreateCase2>
   </soapenv:Body>
</soapenv:Envelope>
  2. 次の応答が生成されます。この場合、次のようにケース ID が返されます (コードの太字部分を参照)。 
    <s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
   <s:Body>
      <CreateCase2Response xmlns="http://www.kofax.com/agility/services/sdk">
         <CreateCase2Result xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
            <Id>F04EBA61C1A64F47885A80A766CA3B59</Id>
         </CreateCase2Result>
      </CreateCase2Response>
   </s:Body>
</s:Envelope>