Skip to main content
ExLibris

Knowledge Assistant

BETA
  • Subscribe by RSS
  • Back
    Alma

     

    Ex Libris Knowledge Center
    1. Search site
      Go back to previous article
      1. Sign in
        • Sign in
        • Forgot password
    1. Home
    2. Alma
    3. Product Documentation
    4. 日本語
    5. 外部システムとの連携
    6. リソース管理
    7. Webhook

    Webhook

    1. Last updated
    2. Save as PDF
    3. Share
      1. Share
      2. Tweet
      3. Share
    1.  Webhook 統合プロファイルの構成
    Translatable
    webhook定義プロファイルを設定するには、次の役職が必要です。
    • 統括システム管理者
    Webhookは、通常何らかのイベントによってトリガーされるユーザー定義のHTTPコールバックであり、そのイベントの結果またはステータスに関する情報が含まれます。
    次のいずれかが発生すると、Almaはwebhookを送信できます:
    • ジョブの実行が完了した(Alma UIまたはAPIを使用)。
    • ユーザーがアップデートされた。
    • 次の通知のいずれかが送信されます:
      • リクエストキャンセルレター (全文)
      • 取寄せアクティビティレター
      • 貸出ステータス通知
      • 取り置きレター
    • 保留、予約、移動、デジタル化、またはワークオーダーのリクエストが作成され、クローズされ、または取置き棚に置かれました。
    • 貸出が作成、返却、または紛失したと通知されました。
    •  書誌レコードが変更されました。
    • 物理的なアイテムが変更されました。
    • 連続した 注文明細からのアイテムを受信しました。
    Webhookをトリガーするイベントの完全なリストについては、開発者ネットワークの「サポートされているイベント」を参照してください。
    webhookをアクティブにするには、Almaにwebhook統合プロファイルが設定されている必要があります(以下を参照)。
     通知を使用するWebhookの場合、統合プロファイル作成の一部として、 [レターアクティビティ]コードテーブルで目的のWebhookをアクティブ化します。ただし、統合プロファイルが作成されたら、 追加のWebhookをアクティブ化または非アクティブ化するために、 レターアクティビティコードテーブルを開く必要はありません。これは、 レター構成テーブル
    で簡単に行うことができます。 レターアクティビティページのレター借用アクティビティオプション。

    これらのWebhookの詳細については、https://developers.exlibrisgroup.com/alma/apis/xsd/rest_webhook_notifications.xsdを参照してください。

     Webhook 統合プロファイルの構成

     Webhookタイプの統合プロファイルを構成するには、次のようにします。
    1. 統合プロファイルリストページ(設定メニュー > 一般 > 外部システム > 統合プロファイル)で、統合プロファイルを追加を選択します。統合プロファイルウィザードの最初のページが開きます。
    2. 統合タイプのドロップダウンリストから、Webhookを選択し、プロファイルのコードと名前を入力します。
    3. 次へを選択します。ウィザードの2ページ目が開きます。
      統合プロファイルページでジョブ完了チェックボックスが有効になりました。
      Webhook 設定
    4. 有効化を選択して、Webhook統合プロファイルをアクティブにします。プロファイルがアクティブになるまで、ステータスは有効化待ち になります。
    5. リスナーURLをWebhookリスナーURLに、シークレットコードをシークレットに入力します。ここで入力される値については、Webhookで技術情報テーブルを参照してください。
    6. メッセージタイプがXMLまたはJSONのいずれかを選択します。
    7. 購読で:
      • ジョブの実行が完了したら、ジョブ完了を選択して、Webhookを送信 します(Alma UIまたはAPIを使用して)。
      • 上記の通知のいずれかが送信されたときにWebhookを送信するには、[通知]を選択します。
        [通知タイプの設定]を選択して レターアクティビティコードテーブルを開き、 一番下までスクロールしてこれらの通知のWebhookを有効にします。以前にアクティブ化されたWebhook(ここまたは「レター構成」テーブルのいずれか)は、アクティブ化されたものとして表示されます。ここでアクティブ化したWebhookは、[レター構成]テーブルでアクティブ化されたものとして表示されます。 目的の通知をアクティブにしたときに [保存]を選択して、統合プロファイルに戻ります。 
        レターアクティビティのマッピングテーブル。
      • ユーザー情報がアップデートされたときにwebhookを送信するには、 ユーザーを選択します。これには、ユーザージョブによって行われた変更を含む、履歴が登録されているすべてのユーザー変更が含まれます。APIを使用してユーザーを変更しても、webhookは送信されないことにご注意ください。ユーザーグループボックスで、webhookの送信を発生させるユーザーグループを選択します。ユーザーグループが指定されていない場合、すべてのユーザーグループに対してwebhookが送信されます。
      • 保留、予約、移動、デジタル化、またはワークオーダーのリクエストが作成された、閉じられた、または取置き棚に置かれたときに、 リクエストを選択してwebhookを送信します。
      • ローンの作成、返却、または紛失の申告がされたときに、ローンを選択してwebhookを送信します。
      • 書誌レコードが変更されたときに、[書誌レコード]を選択してwebhookを送信します。
      • 冊子アイテムが変更されたときに、冊子アイテムを選択してwebhookを送信します。
      • 受信 - 継続的な注文明細 を選択して、継続的な注文明細を受信したときに Webhook を送信します。
    8. [保存]を選択します。設定したプロファイルが、統合プロファイルリストに表示されます。
    • 統合プロファイルを定義したら、統合プロファイルアクションのリストからログの表示を選択できます。このオプションを使用すると、webhookイベントのログを表示できます。次に、テーブルの URL およびペイロード要素を検索できます。  Webhook リクエストごとにリクエスト本文を表示できます (表示は 4000 文字を超えると切り詰められますが、完全なリクエスト本文がリスナーに送信されます)。
    • webhookの試行が失敗した場合、webhookプロファイルの連絡先情報タブで規定されているすべてのEメールアドレスにEメールが送信されます。
    • Premium Sandbox環境では、Webhook Listener URLが削除され、プロファイルが非アクティブに設定されます。これは、Sandbox環境で行われたWebhookアクションが、本番データと同じようにリスナーサーバーに着地するため、テストデータと本番データが混在してしまうためです。サンドボックス環境で統合プロファイルをアクティブ化したい場合は、上記の手順4と5の指示に従って続行します。
    View article in the Exlibris Knowledge Center
    1. Back to top
      • Almaリンクリゾルバrデータ統計をbXと共有する
      • Alma機関とSUDOCの統合
    • Was this article helpful?

    Recommended articles

    1. Article type
      Topic
      Content Type
      Documentation
      Language
      日本語
      Product
      Alma
    2. Tags
      This page has no tags.
    1. © Copyright 2025 Ex Libris Knowledge Center
    2. Powered by CXone Expert ®
    • Term of Use
    • Privacy Policy
    • Contact Us
    2025 Ex Libris. All rights reserved