機械翻訳について

すべてのビジネス計画の取得

get

/crmRestApi/resources/11.13.18.05/businessPlans

リクエスト

問合せパラメータ
  • このパラメータを指定すると、指定した子がリソース・ペイロードに含まれます(リンクのみでなく)。 この問合せパラメータの値は"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
  • コレクションを検索するための事前定義済ファインダとして使用されます。

    フォーマット : ?finder=<finderName>;<variableName>=<variableValue>,<variableName2>=<variableValue2>

    使用可能なファインダ名および対応するファインダ変数を次に示します:

    • AllBusinessPlansFinder : ユーザーがアクセス権を持つすべてのビジネス・プランを検索します。
      ファインダ変数:
      • MyBusinessPlansFinder : 主キー情報を持つビジネス・プラン所有者を検索します。
        ファインダ変数:
        • BusinessPlanOwnerId; string; ビジネス・プランの所有者の一意の識別子。
      • PrimaryKey : 主キー情報を持つビジネス・プランを検索します。
        ファインダ変数:
        • BusinessPlanId; integer;ビジネス・プランの一意の識別子。
    • このパラメータは、リソース・コレクション内で返されるリソースの数を制限します。 制限がリソース数を超えると、フレームワークは使用可能なリソースのみを返します。
    • このパラメータは、単一のリソースまたはリソース・コレクションへのアクセス中に特定のリンクのみを表示するために使用できます。 パラメータ値書式は、次のカンマ区切りリストです : <link_relation>

      例:
      self,canonical
    • リソース・コレクションの開始位置を定義するために使用します。 オフセットがリソース数を超えると、リソースは返されません。 デフォルト値は0です。
    • リソース・アイテム・ペイロードは、データのみを含めるようにフィルタされます(リンク・セクションなどは含まれません)。
    • このパラメータは、指定されたフィールドに基づいてリソース・コレクションを順序付けます。 パラメータ値は、属性名のカンマ区切りの文字列で、それぞれオプションでコロンと「asc」または「desc」が続きます。 昇順の場合は「asc」、降順の場合は「desc」を指定します。 デフォルト値は「asc」です。 たとえば、?orderBy=field1:asc,field2:descです
    • この問合せパラメータは、where句を定義します。 リソース・コレクションは、指定された式を使用して問い合せられます。 この問合せパラメータの値は、1つ以上の式です。 例 : ?q=部門番号>=10および<= 30;Loc!=NY

      フォーマット : ?q=expression1;expression2

      次の問合せ可能属性を使用して、q問合せパラメータを使用してこの収集リソースをフィルタできます:
      • BusinessPlanClassCode; string; ビジネス・プランのクラスを示すコード。 有効な値のリストは、参照BusinessPlanClassVAで定義されます。
      • BusinessPlanId; integer;ビジネス・プランの一意の識別子。
      • BusinessPlanNumber; string;ビジネス計画の代替キー識別子。
      • BusinessPlanOwnerNumber; string; BusinessPlanOwnerIdに対応する代替キー。
      • BusinessPlanTypeCode; string; ビジネス・プランのタイプを示すコード。 有効な値のリストは、参照BusinessPlanTypeVAで定義されます。
      • CreatedBy; string; レコードを作成したユーザー。
      • CreationDate; string;レコードが作成された日付。
      • CustomerId; integer;ビジネス・プラン・アカウントの一意の識別子。
      • CustomerNumber; string; CustomerIdに対応する代替キー。
      • CustomerPartyType; string; ビジネス・プランに関連付けられている顧客のパーティ・タイプ。 有効な値のリストは、参照CA_RECORD_TYPEで定義されます。 指定可能な値は、組織、グループまたは個人です。
      • 説明;文字列;ビジネス計画の説明。
      • LastUpdateDate; string; レコードが最後に更新された日付。
      • LastUpdatedBy; string; レコードを最後に更新したユーザー。
      • 名前、文字列、ビジネス計画の名前。
      • OrigCreationDate; string; ビジネス・プランが最初に作成された日付。
      • OwnerResourceName; string;ビジネス・プラン所有者の名前。
      • PartnerNumber; string; PartnerIdに対応する代替キー。
      • PartnerPartyDisplayName; string; ビジネス・プランのパートナの表示名。
      • PeriodEndDate;文字列;期間終了日
      • PeriodEndName; string; ビジネス・プラン期間の終了の内部名。
      • PeriodRangeDisplayName; string;ビジネス期間範囲の表示名。
      • PeriodStartDate;文字列;期間開始日
      • PeriodStartName; string; ビジネス・プラン期間の開始の内部名。
      • PeriodTypeCode; string; ビジネス・プランの期間を示すコード。 有効な値のリストは、参照SalesObjectiveGLPeriodTypeViewAccessorで定義されます。
      • SourceType; string; ビジネス・プランのアクティビティの取得に使用されるソース・タイプ。
      • StatusCode; string; ビジネス・プランのステータスを示すコード。 有効な値のリストは、参照BusinessPlanStatusVAで定義されます。
    • "?totalResults=true"の場合、リソース・コレクション表現には"推定行数"が含まれます。それ以外の場合、カウントは含まれません。 デフォルト値はfalseです。
    ヘッダー・パラメータ
    • REST APIがランタイム・カスタマイズをサポートしている場合、サービスのシェイプはランタイム中に変更される可能性があります。 RESTクライアントは、これらの変更から自身を分離したり、このヘッダーを指定して最新バージョンのAPIと対話することを選択できます。 次に例を示します : Metadata-Context:sandbox="TrackEmployeeFeature".
    • RESTクライアントとサービスの間のプロトコル・バージョン。 クライアントがリクエストでこのヘッダーを指定しない場合、サーバーはAPIのデフォルト・バージョンを選択します。

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

    トップに戻る

    応答

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

    デフォルトのレスポンス

    次の表では、このタスクに対するデフォルトのレスポンスについて説明します。
    ヘッダー
    • REST APIがランタイム・カスタマイズをサポートしている場合、サービスのシェイプはランタイム中に変更される可能性があります。 RESTクライアントは、これらの変更から自身を分離したり、このヘッダーを指定して最新バージョンのAPIと対話することを選択できます。 次に例を示します : Metadata-Context:sandbox="TrackEmployeeFeature".
    • RESTクライアントとサービスの間のプロトコル・バージョン。 クライアントがリクエストでこのヘッダーを指定しない場合、サーバーはAPIのデフォルト・バージョンを選択します。
    本文( )
    ルート・スキーマ : businessPlans
    タイプ: object
    ソースを表示
    ネストされたスキーマ : アイテム
    タイプ: array
    タイトル: Items
    コレクション内のアイテム。
    ソースを表示
    ネストされたスキーマ : businessPlans-item-response
    タイプ: object
    ソースを表示
    • タイトル: Class
      最大長: 20
      デフォルト値: PARTNER
      ビジネス・プランのクラスを示すコード。 有効な値のリストは、参照BusinessPlanClassVAで定義されます。
    • タイトル: Business Plan ID
      ビジネス・プランの一意の識別子。
    • タイトル: Number
      最大長: 64
      ビジネス・プランの代替キー識別子。
    • タイトル: Owner ID
      ビジネス・プラン所有者の一意の識別子。
    • タイトル: Owner Number
      読取り専用: true
      最大長: 30
      BusinessPlanOwnerIdに対応する代替キー。
    • Business Plan Resources
      タイトル: Business Plan Resources
      ビジネス・プラン・リソースは、ビジネス・プランに関連付けられているチーム・メンバーを表示、作成、更新および削除するために使用されます。
    • タイトル: Type
      最大長: 30
      ビジネス・プランのタイプを示すコード。 有効な値のリストは、参照BusinessPlanTypeVAで定義されます。
    • タイトル: Created By
      読取り専用: true
      最大長: 64
      レコードを作成したユーザー。
    • タイトル: Creation Date
      読取り専用: true
      レコードが作成された日付。
    • タイトル: Customer ID
      ビジネス・プラン・アカウントの一意の識別子。
    • タイトル: Customer Number
      読取り専用: true
      最大長: 30
      CustomerIdに対応する代替キー。
    • タイトル: Customer Type
      読取り専用: true
      最大長: 30
      ビジネス・プランに関連付けられている顧客のパーティ・タイプ。 有効な値のリストは、参照CA_RECORD_TYPEで定義されます。 指定可能な値は、組織、グループまたは個人です。
    • 読取り専用: true
      ビジネス・プランを削除できるかどうかを示します。
    • タイトル: Description
      最大長: 3000
      ビジネス・プランの摘要。
    • タイトル: Last Updated Date
      読取り専用: true
      レコードが最後に更新された日付。
    • タイトル: Last Updated By
      読取り専用: true
      最大長: 64
      レコードを最後に更新したユーザー。
    • タイトル: Last Update Login
      読取り専用: true
      最大長: 32
      レコードを最後に更新したユーザーのログイン。
    • Links
    • タイトル: Name
      最大長: 275
      ビジネス計画の名前。
    • Notes
      タイトル: Notes
      ノート・リソースは、ビジネス・プランに関連付けられたノートの表示、作成、更新および削除に使用されます。 ノートは、ビジネス・プランに関連するコメント、情報またはインストラクションを取得します。
    • タイトル: Original Creation Date
      ビジネス計画が最初に作成された日付。
    • タイトル: Owner
      最大長: 360
      ビジネス計画所有者の名前。
    • タイトル: Partner ID
      ビジネス・プラン・パートナの一意の識別子。
    • タイトル: Partner
      読取り専用: true
      最大長: 80
      ビジネス計画に関連付けられているパートナの名前。
    • タイトル: Partner Number
      最大長: 30
      PartnerIdに対応する代替キー。
    • タイトル: Partner
      最大長: 360
      ビジネス・プランのパートナの表示名。
    • タイトル: End Date
      読取り専用: true
      期間終了日
    • タイトル: Period End Name
      最大長: 30
      ビジネス・プラン期間の終了の表示名。
    • タイトル: Period End Internal Name
      最大長: 30
      ビジネス・プラン期間の終了の内部名。
    • タイトル: Period
      最大長: 80
      ビジネス期間範囲の表示名。
    • 最大長: 15
      ビジネス・プラン期間のカレンダの名前。
    • タイトル: Start Date
      読取り専用: true
      期間開始日
    • タイトル: Period Start Name
      最大長: 30
      ビジネス・プラン期間の開始の表示名。
    • タイトル: Period Start Internal Name
      最大長: 30
      ビジネス・プラン期間の開始の内部名。
    • タイトル: Period Type
      最大長: 30
      ビジネス・プランの期間を示すコード。 有効な値のリストは、参照SalesObjectiveGLPeriodTypeViewAccessorで定義されます。
    • 読取り専用: true
      ビジネス・プランのアクティビティの取得に使用されるソース・タイプ。
    • タイトル: Status
      最大長: 30
      ビジネス・プランのステータスを示すコード。 有効な値のリストは、参照BusinessPlanStatusVAで定義されます。
    • SWOTs
      タイトル: SWOTs
      SWOTsリソースは、ビジネス・プランの長所、短所、商談および脅威の表示、作成、更新および削除に使用されます。
    • 読取り専用: true
      ビジネス・プランを更新できるかどうかを示します。 デフォルト値はtrueです。
    ネストされたスキーマ : ビジネス・プランのリソース
    タイプ: array
    タイトル: Business Plan Resources
    ビジネス・プラン・リソースは、ビジネス・プランに関連付けられているチーム・メンバーを表示、作成、更新および削除するために使用されます。
    ソースを表示
    ネストされたスキーマ : ノート
    タイプ: array
    タイトル: Notes
    ノート・リソースは、ビジネス・プランに関連付けられたノートの表示、作成、更新および削除に使用されます。 ノートは、ビジネス・プランに関連するコメント、情報またはインストラクションを取得します。
    ソースを表示
    ネストされたスキーマ : SWOTs
    タイプ: array
    タイトル: SWOTs
    SWOTsリソースは、ビジネス・プランの長所、短所、商談および脅威の表示、作成、更新および削除に使用されます。
    ソースを表示
    ネストされたスキーマ : businessPlans-BusinessPlanResource-item-response
    タイプ: object
    ソースを表示
    • タイトル: Access
      最大長: 30
      チーム・メンバーのアクセス・レベルを示すコード。 有効な値のリストは、参照ORA_ZCA_BUS_PLAN_ACCESS_LEVELで定義されます。
    • タイトル: Business Plan ID
      ビジネス・プランの一意の識別子。
    • タイトル: Number
      最大長: 64
      親PUID。
    • タイトル: Business Plan Resource ID
      ビジネス・プラン・リソースの一意の識別子。
    • タイトル: Resource Number
      最大長: 230
      ビジネス・プラン・リソースの代替キー識別子。
    • タイトル: Created By
      読取り専用: true
      最大長: 64
      レコードを作成したユーザー。
    • タイトル: Creation Date
      読取り専用: true
      レコードが作成された日付。
    • 読取り専用: true
      ビジネス・プラン・チーム・メンバーのマネージャの一意の識別子。
    • タイトル: Email
      読取り専用: true
      最大長: 320
      ビジネス計画チーム・メンバーの電子メール・アドレス。
    • タイトル: Phone
      読取り専用: true
      ビジネス計画チーム・メンバーの電話番号。
    • タイトル: Last Updated Date
      読取り専用: true
      レコードが最後に更新された日付。
    • タイトル: Last Updated By
      読取り専用: true
      最大長: 64
      レコードを最後に更新したユーザー。
    • タイトル: Last Update Login
      読取り専用: true
      最大長: 32
      レコードを最後に更新したユーザーのログイン。
    • Links
    • タイトル: Manager
      読取り専用: true
      最大長: 360
      ビジネス計画チーム・メンバーのマネージャの名前。
    • タイトル: Function
      最大長: 30
      チーム・メンバーの機能を示すコード。 有効な値のリストは、参照MemberFunctionCodesVAで定義されます。
    • タイトル: Organization
      読取り専用: true
      最大長: 240
      ビジネス・プラン・チーム・メンバーの組織名。
    • タイトル: Owner Indicator
      読取り専用: true
      ビジネス計画チーム・メンバーがビジネス計画の所有者であるかどうかを示します。 値がTrueの場合、ビジネス計画チーム・メンバーもビジネス計画の所有者になります。 デフォルト値は「False」です。
    • タイトル: Resource ID
      リソースの一意の識別子。
    • 読取り専用: true
      最大長: 360
      チーム・メンバーの名前。
    • 読取り専用: true
      最大長: 30
      ResourceIdに対応する代替キー。
    • タイトル: Role
      読取り専用: true
      最大長: 60
      チーム・メンバーのロールの名前。
    ネストされたスキーマ : businessPlans-Note-item-response
    タイプ: object
    ソースを表示
    • タイトル: Contact Relationship ID
      リレーションの一意の識別子。この値は、ノートが担当者に関連付けられているときに移入されます。
    • タイトル: Corporate Currency Code
      最大長: 15
      担当者に関連付けられたノートの企業通貨コード。 受け入れられる値のリストは、参照ZCA_COMMON_CORPORATE_CURRENCYで定義されます。
    • タイトル: Created By
      読取り専用: true
      最大長: 64
      レコードを作成したユーザー。
    • タイトル: Creation Date
      読取り専用: true
      レコードが作成された日付。
    • タイトル: Creator Party ID
      ノート作成者のパーティの一意の識別子。
    • タイトル: Currency Conversion Rate Type
      最大長: 30
      ノートに関連付けられた通貨換算レート・タイプ。 受け入れられる値のリストは、参照ZCA_COMMON_RATE_TYPEで定義されます。
    • タイトル: Currency
      最大長: 15
      ノートに関連付けられた通貨コード。 受け入れられる値のリストは、参照RatedCurrenciesVAで定義されます。
    • タイトル: Delete Indicator
      読取り専用: true
      ビジネス・プラン・ノートを削除できるかどうかを示します。 デフォルト値はtrueです。
    • タイトル: Primary Email
      読取り専用: true
      最大長: 320
      ノートを作成したユーザーの電子メール・アドレス。
    • タイトル: Primary Address
      読取り専用: true
      ノートを作成したユーザーの住所。
    • タイトル: Primary Phone
      読取り専用: true
      ノートを作成したユーザーの電話番号。
    • タイトル: Last Update Date
      読取り専用: true
      レコードが最後に更新された日付。
    • タイトル: Last Updated By
      読取り専用: true
      最大長: 64
      レコードを最後に更新したユーザー。
    • タイトル: Last Update Login
      読取り専用: true
      最大長: 32
      レコードを最後に更新したユーザーのログイン。
    • Links
    • タイトル: Note ID
      読取り専用: true
      ビジネス・プランのノートの一意の識別子。
    • 最大長: 30
      ノートの代替一意識別子。 システム生成または外部システムからのユーザー・キー。
    • タイトル: Title
      最大長: 500
      ユーザーが入力したノートのタイトル。
    • タイトル: Note
      実際のノートのテキスト。
    • タイトル: Type
      最大長: 30
      これは、ノートを分類するためのノート・タイプ・コードです。 有効な値のリストは、参照NoteSourceTypeVAで定義されます。
    • タイトル: Parent Note ID
      親ノートの一意の識別子。
    • タイトル: Party ID
      読取り専用: true
      ノートが関連付けられている担当者の一意の識別子。 この場合、CreatorPartyIdと同じです。
    • タイトル: Author
      読取り専用: true
      最大長: 360
      ビジネス・プランに関連付けられているパーティの名前。
    • タイトル: Related Object Type
      最大長: 30
      OBJECTS Metadataで定義されたソース・オブジェクトを示すコード(アクティビティ、商談、販売ビジネス・プランなど)。
    • タイトル: Related Object
      最大長: 64
      OBJECTS Metadataで定義されたソース・オブジェクトの主キー識別子(アクティビティ、商談、販売ビジネス・プランなど)。
    • タイトル: Update Indicator
      読取り専用: true
      ビジネス・プラン・ノートを更新できるかどうかを示します。 デフォルト値はtrueです。
    • タイトル: Private
      最大長: 30
      デフォルト値: INTERNAL
      これは、ノートの表示レベルを指定するための属性です。 有効な値のリストは、参照NoteVisibilityLookupVAで定義されます。
    ネストされたスキーマ : businessPlans-Swot-item-response
    タイプ: object
    ソースを表示
    • タイトル: Business Plan ID
      ビジネス・プランの一意の識別子。
    • タイトル: Business Plan Number
      最大長: 64
      親PUID。
    • タイトル: Created By
      読取り専用: true
      最大長: 64
      レコードを作成したユーザー。
    • タイトル: Creation Date
      読取り専用: true
      レコードが作成された日付。
    • タイトル: Description
      最大長: 2000
      SWOTの摘要。
    • タイトル: Last Updated Date
      読取り専用: true
      レコードが最後に更新された日付。
    • タイトル: Last Updated By
      読取り専用: true
      最大長: 64
      レコードを最後に更新したユーザー。
    • タイトル: Last Update Login
      読取り専用: true
      最大長: 32
      レコードを最後に更新したユーザーのログイン。
    • Links
    • タイトル: SWOT ID
      ビジネス・プランSWOTの一意の識別子。
    • タイトル: Number
      最大長: 64
      ビジネス・プランSWOTの代替キー識別子。
    • タイトル: Type Code
      最大長: 30
      ビジネス・プランSWOTのタイプを示すコード。 有効な値のリストは、参照ORA_ZCA_BUS_PLAN_SWOTで定義されます。 指定可能な値は、Opportunity(商談)、Strength(強さ)、Threat(脅威)、Weakmess(弱い)です。
    トップに戻る

    例:

    次の例は、cURLを使用してRESTリソースに対するGETリクエストを発行することによって、すべてのビジネス・プランを取得する方法を示しています。

    cURLコマンド

    - curl -u <username:password> \ -X http://servername.fa.us2.oraclecloud.com/crmRestApi/resources/11.13.18.05/businessPlans/

    レスポンス本文の例

    次の例は、JSON形式のレスポンス本文のコンテンツを示しています。

    {
    "items": [
      {
    "BusinessPlanClassCode": "PARTNER",
    "BusinessPlanId": 300100089695451,
    "Name": "AUTOBPNAME_c7577740946",
    "BusinessPlanNumber": "CDRM_7008",
    "BusinessPlanOwnerId": 100010038017849,
    "BusinessPlanTypeCode": null,
    "CreatedBy": "CHANNEL_SALES_MGR",
    "CreationDate": "2016-06-03T11:15:48-07:00",
    "Description": null,
    "LastUpdateDate": "2016-06-03T11:15:51-07:00",
    "LastUpdateLogin": "3462E43397E9A13FE0532AB0F20AD2A5",
    "LastUpdatedBy": "CHANNEL_SALES_MGR",
    "PartnerId": 300100089683791,
    "PeriodTypeCode": "YEAR",
    "PeriodSetName": "Accounting12",
    "PeriodStartName": "01-15",
    "PeriodEndName": "12-15",
    "StatusCode": "ORA_DRAFT",
    "OwnerResourceName": "Channel_Sales_Mgr_ENT2 CSM",
    "PartnerName": "OrgName_13873809212",
    "PeriodStartDisplayName": "2015",
    "PeriodEndDisplayName": "2015",
    "PeriodRangeDisplayName": "2015",
    "OrigCreationDate": "2016-06-03T11:15:48-07:00",
    "PartnerPartyDisplayName": "OrgName_13873809212",
    "UpdateFlag": true,
    "DeleteFlag": true,
    "SourceType": "SALES_BUSINESS_PLAN",
    ...
    },
      {
    "BusinessPlanClassCode": "PARTNER",
    "BusinessPlanId": 300100089800166,
    "Name": "AUTOBPNAME_f2554956076",
    "BusinessPlanNumber": "CDRM_10008",
    "BusinessPlanOwnerId": 100010038017849,
    "BusinessPlanTypeCode": null,
    "CreatedBy": "CHANNEL_SALES_MGR",
    "CreationDate": "2016-06-05T12:29:22-07:00",
    "Description": null,
    "LastUpdateDate": "2016-06-05T12:29:25-07:00",
    "LastUpdateLogin": "348C468C90248AAFE0532AB0F20A7F7C",
    "LastUpdatedBy": "CHANNEL_SALES_MGR",
    "PartnerId": 300100089785026,
    "PeriodTypeCode": "YEAR",
    "PeriodSetName": "Accounting12",
    "PeriodStartName": "01-15",
    "PeriodEndName": "12-15",
    "StatusCode": "ORA_DRAFT",
    "OwnerResourceName": "Channel_Sales_Mgr_ENT2 CSM",
    "PartnerName": "RESTORG_57451230678",
    "PeriodStartDisplayName": "2015",
    "PeriodEndDisplayName": "2015",
    "PeriodRangeDisplayName": "2015",
    "OrigCreationDate": "2016-06-05T12:29:22-07:00",
    "PartnerPartyDisplayName": "RESTORG_57451230678",
    "UpdateFlag": true,
    "DeleteFlag": true,
    "SourceType": "SALES_BUSINESS_PLAN",
    ...
    },
    ...
    「トップに戻る」