トラブルシューティング

トラブルシューティング

お知らせ:当社は、お客様により充実したサポート情報を迅速に提供するため、本ページのコンテンツは機械翻訳を用いて日本語に翻訳しています。正確かつ最新のサポート情報をご覧いただくには、本内容の英語版を参照してください。

1. 受信SOAPの作成不可

  1. 必須項目の不足:名前、URI、認証タイプが入力されていることを確認します。
  2. URIの重複:各要求に一意のURIを使用します。

2. 受信SOAP要求の受信不可

  1. エンドポイントURLの誤り:クライアントが正しいQntrlエンドポイントを呼び出していることを確認します。
  2. ファイアウォールの制限:ファイアウォールで受信要求を許可します。
  3. 認証の失敗:適切な認証情報が指定されていることを確認します。
 

3. SOAPメッセージの処理不具合

  1. XML形式の誤り:要求本文が整形式のXMLであり、標準のSOAP構造に従っていることを確認します。
  2. 必須パラメーターの不足:必須項目についてはAPIドキュメントを確認します。
  3. 要求メソッドの不一致
    1. WSDLの取得にはGET要求のみを使用します。
    2. SOAPメッセージの送信にはPOST要求を使用します。
  4. 本文形式が無効:要求本文には、raw形式の有効なSOAP XMLペイロードを含める必要があります。
 

4. 検証エラーによる要求の失敗

  1. 必須パラメーターの不足:すべての必須パラメーターが要求に含まれていることを確認します。
  2. パラメーター形式の誤り:データ型(例:数値、テキスト)と許可値に合わせます。
  3. 正規表現または長さの不一致:入力内容が定義済みのパターンまたは長さの制約を満たしていない可能性があります。
  4. WSDL準拠の有効化:要求内の操作名は、WSDLで定義されている名前と完全に一致している必要があります。一致していない場合、要求は拒否されます。

5. WSDL契約の読み込み不可

  1. 構文エラー:WSDL XML構造が有効で、正しく書式設定されていることを確認します。
  2. ネットワークの問題:外部からWSDLを取得する場合は、インターネット接続を確認します。
 

6. レート制限エラー

  1. 要求過多(429エラー):要求レートが定義済みの制限を超えています。
  2. 誤ったポリシーの関連付け:正しいレート制限ポリシーが選択されていることを確認します。
  3. Per-IPが想定どおりに機能しない:必要に応じてPer-IPオプションが有効になっているか確認します。

7. 関数エラーのデバッグ

  1. スクリプトログの確認:スクリプト実行時のエラーや問題がないかログを確認します。
 

8. 認証エラー

  1. 認証情報の誤り:指定された認証情報が想定される認証方式と一致していることを確認します。
  2. トークンの期限切れ:トークンベースの認証を使用している場合は、トークンを更新または再生成します。

ベストプラクティス  

  • 開発中は、Postman、CURL、またはQntrlの送信SOAP Webサービスを使用してエンドポイントをテストします。
  • 使用する認証方式がOAuthの場合は、正しいスコープが設定され、トークンが有効であることを確認します。
  • 公開前に、各エンドポイントを必ずテストします。
    • Related Articles

    • トラブルシューティング

      お知らせ:当社は、お客様により充実したサポート情報を迅速に提供するため、本ページのコンテンツは機械翻訳を用いて日本語に翻訳しています。正確かつ最新のサポート情報をご覧いただくには、本内容の英語版を参照してください。 1. APIを実行できない問題 すべての必須項目が正しく入力されていることを確認してください。対象には、URL、クエリーパラメーター、ヘッダー、およびリクエスト本文が含まれます。値が不足している、または正しくない場合、APIが正常に実行されないことがあります。 2. ...
    • 実装またはアクセスのトラブルシューティング

      お知らせ:当社は、お客様により充実したサポート情報を迅速に提供するため、本ページのコンテンツは機械翻訳を用いて日本語に翻訳しています。正確かつ最新のサポート情報をご覧いただくには、本内容の英語版を参照してください。 アクセス権限 実装アクセスまたはトラブルシューティングアクセスは、組織の所有者のみが付与できます。 お客さまの組織でのワークフローの作成や問題のトラブルシューティングを支援するため、当社のテクニカルサポートチームにお客さまのQntrlアカウントへの一時的なアクセス権限を付与できます。 ...
    • トラブルシューティング

      お知らせ:当社は、お客様により充実したサポート情報を迅速に提供するため、本ページのコンテンツは機械翻訳を用いて日本語に翻訳しています。正確かつ最新のサポート情報をご覧いただくには、本内容の英語版を参照してください。 1. WSDL URLの取得失敗 無効なWSDL URL:WSDL URLを確認し、アクセス可能であることを確認します。ブラウザーでURLをテストします。 認証が必要:認証が必要な場合は、正しい認証情報を指定します。 2. WSDL契約の変更不可 ...
    • トラブルシューティングに関するFAQ

      お知らせ:当社は、お客様により充実したサポート情報を迅速に提供するため、本ページのコンテンツは機械翻訳を用いて日本語に翻訳しています。正確かつ最新のサポート情報をご覧いただくには、本内容の英語版を参照してください。 1. QntrlでBridgeをインストールして使用するための前提条件 インストールには管理者権限が必要です。 Java Runtime Environment(JRE)が必要です。利用できない場合は、Bridge Agentに同梱されているJavaを使用できます。 2. Qntrl ...
    • データ変換ステータスのトラブルシューティングFAQ

      お知らせ:当社は、お客様により充実したサポート情報を迅速に提供するため、本ページのコンテンツは機械翻訳を用いて日本語に翻訳しています。正確かつ最新のサポート情報をご覧いただくには、本内容の英語版を参照してください。 1. 関数ステートではなくデータ変換ステートを使用するタイミング 必要なロジックをJSONata、JSLT、データセット操作などの組み込み機能で実現できる場合は、データ変換ステートを使用します。カスタムスクリプトを避けられ、保守性が向上し、サーキットをより整理された状態に保てます。 ...