- 印刷する
概要
XMLベースのAPIを使用するためのヒントとトリックのガイド
チューリップコネクターは、さまざまな種類の外部データソースとやり取りするために使用できます。この記事では、XMLを使用して情報を交換するHTTP APIに焦点を当てます。このカテゴリにはSOAPAPIも含まれます。
TulipでXMLデータを送信する
リクエストのボディにXMLコンテンツを送信するには、$value$
記法を使ってパラメータを挿入する必要があることを示します。
例えば、リクエストボディフィールドに次のように記述します:
<soapenv:Envelope
xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:mes="http://mes.myexample.com"
xmlns:get="http://getInfo.mes.myexample.com"
input1$
input2$
と入力し、input
1とinput2の
値をConnector Functionへの入力とすると、input
1とinput
2の値がリクエストボディに代入されたリクエストが作成されます。
これは以下のTulip Connector Functionインターフェースに示されています:
TulipでのXMLデータの解析
簡単なAPIの例
XML APIからのシンプルなレスポンスの例から始めましょう。
以下の例は、Tulip内の様々な情報にアクセスする方法を示しています。
のエクストラクタです:
/ブックストア/ブック[1]/タイトル
を返します:
<title lang="en">日常イタリア語</title>を返します。
glossary.JSON}}-queryが "0-indexed "であるのとは対照的に、XMLの配列は "1-indexed"、つまり最初の要素が "1 "の位置にあることに注意してください。
の抽出子:
/bookstore/book[1]/タイトル/テキスト()
を返します:
日常イタリア語
text()
関数は、選択されたノードに含まれるテキスト値を抽出するために使用されることに注意してください。
の抽出子:
/bookstore/book[@category="children"][1]/タイトル/テキスト()
が返します:
ハリー・ポッター
セレクタによって、ノードのプロパティ内を検索できるようになったことに注意してください。
これらの例は、以下に示すようにTulipで直接使用できます:
SOAP API の例
では、SOAP APIの典型的な機能である名前空間を使用した、より複雑なケースを見てみましょう。