SOAPメソッドを使用したアラートの設定
ウェブフック は、プロセスで何かが起きたときにユーザー、他のアプリケーション、またはITシステムに通知する仕組みです。データをアップロードした後、一部のタイムラインが設定された条件を満たしている場合、アプリケーションは対応する通知を送信します。
SOAPメソッドを使用してウェブフックを作成すると、プログラムでアラートが発生するたびにWebサービスに情報が送信されます。
始める前に
Timelineには、Webサービスを記述する事前に定義されたWSDLドキュメントが必要です。これには、利用可能なアクション、使用されたプロトコル、情報が送信された場所などが含まれます。WSDLドキュメントを含む有効なURLを取得するには、SOAPサービスサポートチームにお問い合わせください。
重要。
- Timelineは、ウェブフックの設定中に指定した静的操作入力を含むリクエストを送信します。Webサービスは、一致したタイムラインID、イベント属性、またはプログラムからのその他のデータなど、他の情報を受信しません。
- TimelineはWSDL 1.1のみに対応しています。
- Webサービスは、メッセージの送受信にSOAPプロトコルを使用する必要があります。
ウェブフックの作成方法
をクリックしてアラート編集ウィンドウを開きます。
重要。ウェブフックを作成する前に、アラートを追加して設定する必要があります。手順については、「アラートの作成と実行方法」を参照してください。- ウェブフックセクションで
をクリックします。 - SOAPメソッドを選択します。
- URL WSDLを入力します。
WSDLドキュメントのホスト先となる有効なURLを指定します。WSDLは、WebサービスのXML定義です。URL WSDLは、Webサービス構造を読み取ることができるドキュメントをホストしています。例：
https://website.com/webservice/soap?wsdl - WSDLを取得をクリックします。
TimelineはWSDLドキュメントを解析し、Webサービスで利用可能なサービス、ポート、操作を取得します。 - 目的のWebサービスで認証が必要な場合は、HTTPベーシック認証を選択します。ユーザー名とパスワードを対応するフィールドに入力します。
- ウェブフック名を入力します。アラート編集ウィンドウで、作成したウェブフック一覧で識別する際に役立ちます。
- プログラムがWebサービスに送信するXMLファイルのパラメータと入力を設定します。
| パラメータ | 説明と設定 |
|---|---|
| サービス |
Webベースのプロトコルで使用可能な機能のセット。 必要なポートと操作を提供するサービスを選択します。 |
| ポート |
Webサービスへの接続ポイント。 SOAPプロトコルを使用するポートを選択します。 |
| 操作 |
WSDLドキュメントで定義されている、Webサービスで使用可能なアクションのリスト。TimelineがWebサービスに送信する操作入力を入力する必要があります。以下の手順に従います：
|
- テストをクリックして、ウェブフックが正しく設定されていることを確認します。
TimelineがSOAPエンドポイントにリクエストを送信します。Timeline側で正常に実行されると、プログラムはポップアップメッセージでStatus: 200を表示します。 - 保存をクリックします。
次回のアラート実行後に、Timelineは指定された操作入力を含むリクエストをWebサービスに送信します。
使用例
Timelineは、発生したアラートについてWebサービスに通知することができます。これにより、必要があれば直ちに行動を起こすことができます。さらに、Timelineでデータを分析することができます。
たとえば、システムが特定の期間にプロセスの手順を実行しなければならないとします。Timelineのアラートを使って、システムの違反をWebサービスに知らせることができます。これを行うには、必要な手順の実行に時間がかかりすぎている場合にWebサービスに通知する期限に基づいてアラートを設定します。
9/5/2024 4:23:55 PM