機械翻訳について
  1. Oracle Fusion Cloud ProcurementのREST API
  2. タスク
  3. パンチアウト接続

リダイレクトURLを1つ取得

get

/fscmRestApi/resources/11.13.18.05/punchoutConnections/{punchoutConnectionsUniqID}

リクエスト

パス・パラメータ
  • これは、パンチアウト接続リソースに対してコンポジット・キー(CatalogIdおよびPunchoutItemId)を構成する属性のハッシュ・キーで、パンチアウト接続のインスタンスを一意に識別するために使用されます。 クライアントはハッシュ・キー値を生成しないでください。 かわりに、クライアントは、パンチアウト接続の特定のインスタンスにナビゲートするために、主キー値に対するフィルタを使用してパンチアウト接続コレクション・リソースを問い合せる必要があります。

    次に例を示します: punchoutConnections?q=CatalogId=<value1>;PunchoutItemId=<value2>
問合せパラメータ
  • このパラメータは、レスポンスの生成後に設定およびロールバックされるフィールドである依存関係を指定します。 通常、これらは属性変更の影響をプレビューするために使用されます。 このパラメータで指定されたフィールドは、常に問題のリソース・インスタンスで設定されます。 子リソース・コレクションがリクエストされ、パラメータが設定されると、リソース・コレクション・ペイロードを生成する前に、親リソース・インスタンスにフィールドが設定されます。 この問合せパラメータの値は、依存性フィールドのセットです。 例: dependency=ProductId=2

    フォーマット: <attr1>=<val1>,<attr2>=<value2>
  • このパラメータを指定すると、指定した子がリソース・ペイロードに含まれます(リンクのみでなく)。 この問合せパラメータの値は"all"または""です。 カンマをセパレータとして使用して、複数の子を指定できます。 例: ?expand=Employees,Localizations. ネストされた子は、"Child.NestedChild"の書式に従って指定することもできます(例): ?expand=Employees.Managers). ネストされた子が指定されている場合(例): Employees.Managers)。欠落している子は暗黙的に処理されます。 たとえば、"?expand=Employees.Managers"は"?expand=Employees、Employees.Managers"と同じです(これにより、従業員とマネージャが展開されます)。
  • このパラメータは、リソース・フィールドをフィルタします。 指定されたフィールドのみが返されます。つまり、フィールドが指定されていない場合、フィールドは返されません(リンクのみを取得する場合に便利です)。 間接子リソースが指定されている場合(例): Employees.Managers)。欠落している子は暗黙的に処理されます。 たとえば、"?fields=Employees.Managers:Empname"は"?fields=;Employees:;Employees.Managers:Empname" (これはマネージャの"Empname"フィールドのみを返す)と同じです。この問合せパラメータの値は、リソース・フィールドのリストです。 属性は直接にすることができます(例): 従業員または間接(例): Employees.Managers) child. 拡張問合せパラメータと組み合せることはできません。 両方を指定した場合、フィールドのみが考慮されます。

    フォーマット : ?fields=Attribute1,Attribute2

    子リソースのフィールドの書式 : ?fields=Accessor1:Attribute1,Attribute2
  • このパラメータは、単一のリソースまたはリソース・コレクションへのアクセス中に特定のリンクのみを表示するために使用できます。 パラメータ値書式は、次のカンマ区切りリストです : <link_relation>

    例:
    self,canonical
  • データのみを含めるために(リンク・セクションなしなど)、リソース品目ペイロードがフィルタ処理されます。
ヘッダー・パラメータ
  • REST APIがランタイム・カスタマイズをサポートしている場合、サービスのシェイプはランタイム中に変更される可能性があります。 RESTクライアントは、これらの変更から自身を分離したり、このヘッダーを指定して最新バージョンのAPIと対話することを選択できます。 たとえば: Metadata-Context:sandbox="TrackEmployeeFeature".
  • RESTクライアントとサービスの間のプロトコル・バージョン。 クライアントがリクエストでこのヘッダーを指定しない場合、サーバーはAPIのデフォルト・バージョンを選択します。

この操作にはリクエスト本文がありません。

トップに戻る

レスポンス

サポートされているメディア・タイプ

デフォルトのレスポンス

次の表では、このタスクに対するデフォルトのレスポンスについて説明します。
ヘッダー
  • REST APIがランタイム・カスタマイズをサポートしている場合、サービスのシェイプはランタイム中に変更される可能性があります。 RESTクライアントは、これらの変更から自身を分離したり、このヘッダーを指定して最新バージョンのAPIと対話することを選択できます。 たとえば: Metadata-Context:sandbox="TrackEmployeeFeature".
  • RESTクライアントとサービスの間のプロトコル・バージョン。 クライアントがリクエストでこのヘッダーを指定しない場合、サーバーはAPIのデフォルト・バージョンを選択します。
本文 ()
ルート・スキーマ : punchoutConnections-item-response
タイプ: object
ソースを表示
  • 読取り専用: true
    パンチアウト・カタログを一意に識別する値。
  • 読取り専用: true
    最大長: 30
    パンチアウト・カタログの名前。
  • Links
  • 読取り専用: true
    パンチアウト品目を一意に識別する値。
  • リダイレクト用のURL (Uniform Resource Locator)。 アプリケーションがサプライヤ・サイトとの接続を作成すると、接続が検証され、成功すると、サプライヤはURLを返します。 アプリケーションはこのURLを使用してパンチアウトに進むことができます。
トップに戻る

例

この例では、1つのリダイレクションURLを取得する方法について説明します。

cURLコマンドの例

次のcURLコマンドを使用して、RESTリソースに対するリクエストを送信します:

curl -u username:password "https://servername/fscmRestApi/resources/version/punchoutConnections?q=CatalogId;PunchoutItemId"

たとえば、次のコマンドは、カタログ識別子が300100123528563のリダイレクションURLを取得します:

curl -u username:password "https://servername/fscmRestApi/resources/version/punchoutConnections?q=CatalogId=300100123528563;PunchoutItemId=null"

レスポンス本文の例

JSON形式のレスポンス本文の例を次に示します。

{
  "items": [
    {
      "CatalogId": 300100123528563,
      "CatalogName": "REST_PUNCHOUT",
      "PunchoutItemId": null,
      "PunchoutRedirectionURL": "https://servername/fscmRestApi/resources/version/Punchout/responseservlet?sessionId=fGZjh5QpwxKZcQ3h4ZcFBb3vBQYnh0hvfBPh6Wkh3x5ntCVSc8gM!1453074687!1513685214486",
      "links": [
        {
          "rel": "self",
          "href": "https://servername/fscmRestApi/resources/version/punchoutConnections/00020000000EACED00057708000110F081428D73FFFFFFFF",
          "name": "punchoutConnections",
          "kind": "item"
        },
        {
          "rel": "canonical",
          "href": "https://servername/fscmRestApi/resources/version/punchoutConnections/00020000000EACED00057708000110F081428D73FFFFFFFF",
          "name": "punchoutConnections",
          "kind": "item"
        }
      ]
    }
  ],
  "count": 1,
  "hasMore": false,
  "limit": 25,
  "offset": 0,
  "links": [
    {
      "rel": "self",
      "href": "https://servername/fscmRestApi/resources/version/punchoutConnections",
      "name": "punchoutConnections",
      "kind": "collection"
    }
  ]
}
「トップに戻る」