機械翻訳について

予算に関連付けられたMDFリクエストを取得

get

/crmRestApi/resources/11.13.18.05/mdfBudgets/{BudgetCode}/child/FundRequest/{FundRequestCode}

リクエスト

パス・パラメータ
問合せパラメータ
  • このパラメータは、レスポンスの生成後に設定およびロールバックされるフィールドである依存関係を指定します。 通常、これらは属性変更の影響をプレビューするために使用されます。 このパラメータで指定されたフィールドは、常に問題のリソース・インスタンスで設定されます。 子リソース・コレクションがリクエストされ、パラメータが設定されると、リソース・コレクション・ペイロードを生成する前にフィールドが親リソース・インスタンスに設定されます。 この問合せパラメータの値は、依存性フィールドのセットです。 例: 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のデフォルト・バージョンを選択します。
本文( )
ルート・スキーマ : mdfBudgets-FundRequest-item-response
タイプ: object
ソースを表示
  • タイトル: End Date
    資金リクエスト活動が完了した日付。
  • タイトル: Start Date
    資金リクエスト活動が開始された日付。
  • タイトル: Request Age
    読取り専用: true
    MDFリクエストが作成されてからの日数。
  • タイトル: Approver Comments
    資金リクエストの承認アクション中に入力されたコメント。
  • タイトル: Status
    MDF請求で実行できる承認処理を示すコード。 受け入れられる値は、承認、拒否、戻る、取下げ、終了およびHtOutcmeReturnReturnActionです。
  • タイトル: Approved Amount
    デフォルト値: 0
    MDFリクエストに対して承認された金額。
  • タイトル: Approved Percent
    デフォルト値: 100
    資金リクエスト合計の承認済み金額の割合。
  • タイトル: Approved By
    最大長: 64
    MDFリクエストを承認したユーザー。
  • タイトル: Approved by ID
    マーケティングMDFリクエストを承認したユーザーの一意の識別子。
  • タイトル: Approved Date
    MDFリクエストが承認された日付。
  • タイトル: Available Amount
    読取り専用: true
    デフォルト値: 0
    承認済みマーケティングMDFリクエスト合計と承認済み請求額合計との差異で、新規請求に使用できます。
  • タイトル: Budget Exchange Rate
    デフォルト値: 0
    資金リクエストに関連付けられているMDF予算の為替レート。
  • タイトル: Budget Code
    読取り専用: true
    最大長: 100
    マーケティング予算の公開一意識別子。
  • タイトル: Budget Currency
    読取り専用: true
    最大長: 30
    資金リクエストに関連付けられたMDF予算に使用される通貨。
  • タイトル: Budget End Date
    読取り専用: true
    資金リクエストに関連付けられたMDF予算の終了日。
  • タイトル: Budget ID
    マーケティングMDFリクエストに関連付けられた親予算。
  • タイトル: Budget
    資金リクエストに関連付けられているMDF予算の名前。
  • タイトル: Budget Start Date
    読取り専用: true
    資金リクエストに関連付けられたMDF予算の開始日。
  • タイトル: Can Approve
    読取り専用: true
    ユーザーがリクエストを承認できるかどうかを示します。
  • タイトル: Can Reject
    読取り専用: true
    ユーザーがリクエストを否認できるかどうかを示します。
  • タイトル: Can Return
    読取り専用: true
    ユーザーがリクエストを返せるかどうかを示します。
  • タイトル: Can Submit
    読取り専用: true
    ユーザーがリクエストを送信できるかどうかを示します。
  • タイトル: Can Terminate
    読取り専用: true
    ユーザーがリクエストを終了できるかどうかを示します。
  • タイトル: Can Withdraw
    読取り専用: true
    ユーザーがリクエストを取り下げることができるかどうかを示します。
  • タイトル: Channel Manager
    読取り専用: true
    最大長: 450
    資金リクエストのチャネル・マネージャであるユーザー。
  • タイトル: Channel Manager ID
    読取り専用: true
    資金リクエストのチャネル・マネージャであるリソースの一意の識別子。
  • タイトル: Comments
    最大長: 1000
    マーケティングMDFリクエストの追加コメント。
  • タイトル: Conversion Currency Code
    読取り専用: true
    最大長: 30
    リクエストでの変換に使用される通貨コード。
  • タイトル: Conversion Rate Type
    読取り専用: true
    最大長: 30
    MDF資金リクエストの通貨換算レート・タイプ。 有効な値のリストは、参照ZCA_COMMON_RATE_TYPEで定義されます。 「設定およびメンテナンス」作業領域の通貨プロファイル・オプションの管理タスクを使用して、プロファイル・オプションをレビューおよび更新します。
  • タイトル: Conversion Exchange Rate
    読取り専用: true
    企業通貨に対するリクエストの通貨換算レート。
  • タイトル: Created By
    読取り専用: true
    最大長: 64
    マーケティングMDFリクエストを作成したユーザー。
  • タイトル: Created By
    読取り専用: true
    資金リクエストの作成者の名前。
  • タイトル: Creation Date
    読取り専用: true
    MDFリクエストが作成された日付。
  • タイトル: Currency
    最大長: 30
    MDFリクエストの通貨コード。 有効な値のリストは、参照ZCA_COMMON_CORPORATE_CURRENCYで定義されます。 「設定およびメンテナンス」作業領域の通貨プロファイル・オプションの管理タスクを使用して、プロファイル・オプションをレビューおよび更新します。
  • タイトル: Currency Conversion Date
    読取り専用: true
    企業通貨に対するリクエストの通貨換算レートの日付。
  • タイトル: Delete Indicator
    読取り専用: true
    リクエストを削除できるかどうかを示します。 ユーザーがリクエストを削除するアクセス権を持っている場合、デフォルト値はtrue、それ以外の場合はfalseです。
  • タイトル: Description
    最大長: 4000
    マーケティングMDFリクエストの説明。
  • タイトル: Code
    最大長: 100
    マーケティングMDFリクエストの一意の代替識別子。
  • タイトル: Fund Request ID
    MDFリクエストの一意の識別子。
  • タイトル: Name
    最大長: 250
    MDFリクエストの表示名。
  • タイトル: Status
    最大長: 30
    デフォルト値: DRAFT
    マーケティングMDFリクエストのステータス・コード。
  • タイトル: Type
    最大長: 30
    資金リクエストのタイプ。
  • タイトル: Justification
    最大長: 1000
    資金リクエストの理由。
  • タイトル: Last Update Date
    読取り専用: true
    資金リクエストが最後に更新された日付。
  • タイトル: Last Updated By
    読取り専用: true
    最大長: 64
    マーケティングMDFリクエストを最後に更新したユーザー。
  • タイトル: Last Update Login
    読取り専用: true
    最大長: 32
    資金リクエストを最後に更新したユーザーのログイン。
  • Links
  • タイトル: Email
    読取り専用: true
    最大長: 320
    資金リクエストの所有者の電子メール・アドレス。
  • タイトル: Phone
    読取り専用: true
    資金リクエストの所有者の書式設定された電話番号。
  • タイトル: Owner ID
    マーケティング予算を管理する内部リソースです。
  • タイトル: Owner
    最大長: 360
    資金リクエストの所有者。
  • タイトル: Owner Party Number
    読取り専用: true
    最大長: 30
    リソースのパブリック一意識別子。
  • タイトル: Partner Company Number
    最大長: 30
    パートナの公開一意識別子。
  • タイトル: Partner Country
    読取り専用: true
    最大長: 2
    資金リクエストに関連付けられているパートナの国。
  • タイトル: Partner ID
    マーケティングMDFリクエストに関連付けられたパートナ取引先の一意の識別子。
  • タイトル: Partner
    最大長: 360
    マーケティングMDFリクエストに関連付けられたパートナ取引先識別子名。
  • タイトル: Partner
    読取り専用: true
    最大長: 360
    資金リクエストに関連付けられているパートナの名前。
  • タイトル: Record Set
    読取り専用: true
    フィルタ基準に基づいてMDFリクエストを検索します。
  • タイトル: Rejected By
    最大長: 64
    マーケティングMDFリクエストを却下したユーザー。
  • タイトル: Rejected by ID
    MDFリクエストを却下したユーザーの一意の識別子。
  • タイトル: Rejected Date
    マーケティングMDFリクエストが拒否された日付。
  • タイトル: Reject Reason
    資金リクエストを却下する理由コード。
  • タイトル: Requested Amount
    MDFリクエストに対して送信された金額。 金額は、MDF請求に関連付けられている通貨コードで表示されます。
  • タイトル: Status
    MDFリクエストのステータス。
  • タイトル: Return Reason
    資金リクエストを送信者に返却する理由コード。
  • タイトル: Claim Deadline
    読取り専用: true
    関連する請求を発行する必要がある日付。
  • タイトル: Request Deadline
    資金リクエストを送信する必要がある期限の日付。
  • タイトル: Submitted By
    最大長: 64
    マーケティングMDFリクエストを送信したユーザー。
  • タイトル: Submitted by ID
    リクエストを送信したユーザーの一意の識別子。
  • タイトル: Submitted Date
    マーケティングMDFリクエストが送信された日付。
  • タイトル: Approved Claim Amount
    読取り専用: true
    デフォルト値: 0
    マーケティングMDFリクエストに対するすべての承認済み請求の合計金額。
  • タイトル: Update Indicator
    読取り専用: true
    リクエストを更新できるかどうかを示します。 ユーザーがリクエストを更新するためのアクセス権を持っている場合、デフォルト値はtrue、それ以外の場合はfalseです。
トップに戻る

例:

次の例は、cURLを使用してRESTリソースに対する取得リクエストを発行することによって、予算に関連付けられたmdfリクエストを取得する方法を示しています。

cURLコマンド

curl -u <username:password> \ -X https://servername.fa.us2.oraclecloud.com/fscmRestApi/resources/11.13.18.05/mdfBudgets/{BudgetCode}/child/FundRequest/{FundRequestCode}

レスポンス本文の例

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

 {
            "RecordSet": null,
            "FundRequestId": 300100543257820,
            "FundRequestName": "RequestApp_0b602762412",
            "CurrencyCode": "USD",
            "RequestedAmount": 100000,
            "ApprovedAmount": 100000,
            "CreationDate": "2021-06-17T04:06:25+00:00",
            "RequestStatusMeaning": "Approved",
            "Age": 123,
            "ApprovedBy": "Account_MgrENT1 CAM",
            "ApprovedDate": "2021-06-17",
            "BudgetName": "BudgetActive_64d02762383",
            "Description": null,
            "FundRequestCode": "RequestApp_0b602762412",
            "LastUpdatedBy": "Channel_OPS_Mgr_ENT1 COM",
            "LastUpdateDate": "2021-06-17T04:06:51.202+00:00",
            "PartnerName": "Stryker Corp.",
            "RejectedBy": null,
            "RejectedDate": null,
            "SubmittedDate": null,
            "CreatedBy": "CHANNEL_OPERATIONS_MANAGER",
            "LastUpdateLogin": "C4774F721408A0D0E0533DFDF40A851E",
            "BudgetId": 300100543257793,
            "FundRequestStatusCode": "APPROVED",
            "PartnerId": 100000016934002,
            "SubmittedBy": null,
            "TotalApprovedClaimAmount": 100,
            "AvailableFundRequestAmount": 99900,
            "SubmitFundReqBy": "2021-06-24",
            "Comments": null,
            "CreatedBy_FN": "Channel_OPS_Mgr_ENT1 COM",
            "ConversionRateType": "Corporate",
            "ConversionCurrencyCode": "USD",
            "BgtExchangeRate": 1,
            "ApprovedAmountPercent": 100,
            "FundRequestType": null,
            "Justification": null,
            "OwnerId": 100010038017885,
            "ActivityEndDate": null,
            "ChannelManager": "Account_MgrENT1 CAM",
            "ActivityStartDate": null,
            "OwnerName": "Channel_OPS_Mgr_ENT1 COM",
            "ChannelManagerId": 100010038017873,
            "PartnerPartyUniqueName": "Stryker Corp.",
            "PartnerCountry": "US",
            "OwnerEmailAddress": "sendmail-test-discard@oracle.com",
            "ApprovedById": 100010038017873,
            "CurrencyConversionDate": "2021-06-17",
            "RejectedById": null,
            "SubmittedById": null,
            "CanSubmit": "false",
            "CanTerminate": "true",
            "OwnerFormattedPhoneNumber": "+1 (650) 633-8437",
            "CanApprove": "false",
            "CanReject": "false",
            "CanReturn": "false",
            "CanWithdraw": "false",
            "ReturnReasonCode": null,
            "RejectReasonCode": null,
            "ApprovalActionComments": null,
            "ConvExchangeRate": 1,
            "UpdateFlag": false,
            "DeleteFlag": false,
            "ApprovalTaskStatusCode": null,
            "OwnerPartyNumber": "100010038017885",
            "PartnerCompanyNumber": "100001",
            "SubmitClaimsBy": "2021-06-24",
            "BudgetCurrency": "USD",
            "BudgetStartDate": "2021-06-17",
            "BudgetEndDate": null,
            "BudgetCode": "BudgetActive_64d02762383",
            "links": [
                {
                    "rel": "self",
                    "href": "https://servername.fa.us2.oraclecloud.com/crmRestApi/resources/11.13.18.05/mdfBudgets/BudgetActive_64d02762383/child/FundRequest/RequestApp_0b602762412",
                    "name": "FundRequest",
                    "kind": "item",
                    "properties": {
                        "changeIndicator": "ACED0005737200136A6176612E7574696C2E41727261794C6973747881D21D99C7619D03000149000473697A65787000000001770400000001737200116A6176612E6C616E672E496E746567657212E2A0A4F781873802000149000576616C7565787200106A6176612E6C616E672E4E756D62657286AC951D0B94E08B02000078700000000278"
                    }
                },
                {
                    "rel": "canonical",
                    "href": "https://servername.fa.us2.oraclecloud.com/crmRestApi/resources/11.13.18.05/mdfBudgets/BudgetActive_64d02762383/child/FundRequest/RequestApp_0b602762412",
                    "name": "FundRequest",
                    "kind": "item"
                },
                {
                    "rel": "parent",
                    "href": "https://servername.fa.us2.oraclecloud.com/crmRestApi/resources/11.13.18.05/mdfBudgets/BudgetActive_64d02762383",
                    "name": "mdfBudgets",
                    "kind": "item"
                },
                {
                    "rel": "lov",
                    "href": "https://servername.fa.us2.oraclecloud.com/crmRestApi/resources/11.13.18.05/mdfBudgets/BudgetActive_64d02762383/child/FundRequest/RequestApp_0b602762412/lov/FundRequestTypeLOVVA",
                    "name": "FundRequestTypeLOVVA",
                    "kind": "collection"
                },
                {
                    "rel": "lov",
                    "href": "https://servername.fa.us2.oraclecloud.com/crmRestApi/resources/11.13.18.05/mdfBudgets/BudgetActive_64d02762383/child/FundRequest/RequestApp_0b602762412/lov/ReturnReasonCodeVA",
                    "name": "ReturnReasonCodeVA",
                    "kind": "collection"
                },
                {
                    "rel": "lov",
                    "href": "https://servername.fa.us2.oraclecloud.com/crmRestApi/resources/11.13.18.05/mdfBudgets/BudgetActive_64d02762383/child/FundRequest/RequestApp_0b602762412/lov/RequestStatusLOVVA",
                    "name": "RequestStatusLOVVA",
                    "kind": "collection"
                },
                {
                    "rel": "lov",
                    "href": "https://servername.fa.us2.oraclecloud.com/crmRestApi/resources/11.13.18.05/mdfBudgets/BudgetActive_64d02762383/child/FundRequest/RequestApp_0b602762412/lov/FundRequestPartnerPartySearchVA",
                    "name": "FundRequestPartnerPartySearchVA",
                    "kind": "collection"
                },
                {
                    "rel": "lov",
                    "href": "https://servername.fa.us2.oraclecloud.com/crmRestApi/resources/11.13.18.05/mdfBudgets/BudgetActive_64d02762383/child/FundRequest/RequestApp_0b602762412/lov/ResourceVOVA",
                    "name": "ResourceVOVA",
                    "kind": "collection"
                },
                {
                    "rel": "lov",
                    "href": "https://servername.fa.us2.oraclecloud.com/crmRestApi/resources/11.13.18.05/mdfBudgets/BudgetActive_64d02762383/child/FundRequest/RequestApp_0b602762412/lov/CurrencyPVA",
                    "name": "CurrencyPVA",
                    "kind": "collection"
                },
                {
                    "rel": "lov",
                    "href": "https://servername.fa.us2.oraclecloud.com/crmRestApi/resources/11.13.18.05/mdfBudgets/BudgetActive_64d02762383/child/FundRequest/RequestApp_0b602762412/lov/RejectReasonCodeVA",
                    "name": "RejectReasonCodeVA",
                    "kind": "collection"
                },
                {
                    "rel": "lov",
                    "href": "https://servername.fa.us2.oraclecloud.com/crmRestApi/resources/11.13.18.05/mdfBudgets/BudgetActive_64d02762383/child/FundRequest/RequestApp_0b602762412/lov/BudgetLOVVA",
                    "name": "BudgetLOVVA",
                    "kind": "collection"
                },
                {
                    "rel": "lov",
                    "href": "https://servername.fa.us2.oraclecloud.com/crmRestApi/resources/11.13.18.05/mdfBudgets/BudgetActive_64d02762383/child/FundRequest/RequestApp_0b602762412/lov/RecordSetVA",
                    "name": "RecordSetVA",
                    "kind": "collection"
                }
            ]
 }
「トップに戻る」