インバウンド・メッセージの取得
get
/crmRestApi/resources/11.13.18.05/inboundMessages/{InboundMessageId}
リクエスト
パス・パラメータ
- InboundMessageId(required): integer(int64)
インバウンド・メッセージの一意の識別子。
問合せパラメータ
- dependency: string
このパラメータは、レスポンスの生成後に設定およびロールバックされるフィールドである依存関係を指定します。 通常、これらは属性変更の影響をプレビューするために使用されます。 このパラメータで指定されたフィールドは、常に問題のリソース・インスタンスで設定されます。 子リソース・コレクションがリクエストされ、パラメータが設定されると、リソース・コレクション・ペイロードを生成する前にフィールドが親リソース・インスタンスに設定されます。 この問合せパラメータの値は、依存性フィールドのセットです。 例: dependency=ProductId=2
フォーマット: <attr1>=<val1>,<attr2>=<value2> - expand: string
このパラメータを指定すると、指定した子がリソース・ペイロードに含まれます(リンクのみでなく)。 この問合せパラメータの値は"all"または""です。 カンマをセパレータとして使用して、複数の子を指定できます。 例: ?expand=Employees,Localizations. ネストされた子は、"Child.NestedChild"の書式に従って指定することもできます(例): ?expand=Employees.Managers). ネストされた子が指定されている場合(例): Employees.Managers)。欠落している子は暗黙的に処理されます。 たとえば、"?expand=Employees.Managers"は"?expand=Employees,Employees.Managers"と同じです(これにより、従業員とマネージャが展開されます)。
- fields: string
このパラメータは、リソース・フィールドをフィルタします。 指定されたフィールドのみが返されます。つまり、フィールドが指定されていない場合、フィールドは返されません(リンクのみを取得する場合に便利です)。 間接子リソースが指定されている場合(例): Employees.Managers)。欠落している子は暗黙的に処理されます。 たとえば、"?fields=Employees.Managers:Empname"は"?fields=;Employees:;Employees.Managers:Empname" (これはマネージャの"Empname"フィールドのみを返す)と同じです。この問合せパラメータの値は、リソース・フィールドのリストです。 属性は直接にすることができます(例): 従業員または間接(例): Employees.Managers) child. 拡張問合せパラメータと組み合せることはできません。 両方を指定した場合、フィールドのみが考慮されます。
フォーマット : ?fields=Attribute1,Attribute2
子リソースのフィールドの書式 : ?fields=Accessor1:Attribute1,Attribute2 - links: string
このパラメータは、単一のリソースまたはリソース・コレクションへのアクセス中に特定のリンクのみを表示するために使用できます。 パラメータ値書式は、次のカンマ区切りリストです : <link_relation>
例:
self,canonical
- onlyData: boolean
リソース・アイテム・ペイロードは、データのみを含めるようにフィルタされます(リンク・セクションなどは含まれません)。
ヘッダー・パラメータ
- Metadata-Context:
REST APIがランタイム・カスタマイズをサポートしている場合、サービスのシェイプはランタイム中に変更される可能性があります。 RESTクライアントは、これらの変更から自身を分離したり、このヘッダーを指定して最新バージョンのAPIと対話することを選択できます。 次に例を示します : Metadata-Context:sandbox="TrackEmployeeFeature".
- REST-Framework-Version:
RESTクライアントとサービスの間のプロトコル・バージョン。 クライアントがリクエストでこのヘッダーを指定しない場合、サーバーはAPIのデフォルト・バージョンを選択します。
この操作にはリクエスト本文がありません。
トップに戻る応答
サポートされるメディア・タイプ
- application/json
デフォルトのレスポンス
次の表では、このタスクに対するデフォルトのレスポンスについて説明します。
ヘッダー
- Metadata-Context(required):
REST APIがランタイム・カスタマイズをサポートしている場合、サービスのシェイプはランタイム中に変更される可能性があります。 RESTクライアントは、これらの変更から自身を分離したり、このヘッダーを指定して最新バージョンのAPIと対話することを選択できます。 次に例を示します : Metadata-Context:sandbox="TrackEmployeeFeature".
- REST-Framework-Version(required):
RESTクライアントとサービスの間のプロトコル・バージョン。 クライアントがリクエストでこのヘッダーを指定しない場合、サーバーはAPIのデフォルト・バージョンを選択します。
ルート・スキーマ : inboundMessages-item-response
タイプ:
ソースを表示
object-
AcknowledgedDate: string (date-time)
タイトル:
Acknowledged Dateインバウンド・メッセージが確認された日付。 -
Attachments: array Attachments
タイトル:
Attachments添付リソースは、インバウンド・メッセージとともに添付として送信されるファイルのリストを作成、表示、更新および削除するために使用されます。 たとえば、エラー・メッセージのスクリーンショットを含むドキュメントです。 -
BatchId: integer (int64)
タイトル:
Batch IDインバウンド・メッセージが処理されるバッチの一意の識別子。 -
本文: 文字列(バイト)
タイトル:
Bodyインバウンド・メッセージのコンテンツ。 -
BUOrgId: integer (int64)
タイトル:
Business Unit ID読取り専用:trueインバウンドEメールに関連付けられたビジネス・ユニット名の一意のID。 -
ChannelId: integer (int64)
タイトル:
Channel IDインバウンド・メッセージに対するチャネルの一意の識別子。 -
ChannelTypeCdMeaning: string
タイトル:
Channel Type Value最大長:255インバウンドEメールのチャネル・タイプ参照コードに対応する表示値。 -
ConnectionTypeCd: string
タイトル:
Connection Type Code最大長:30デフォルト値:ORA_SVC_UMSインバウンド・メッセージの読取りに使用された接続タイプを示します。 -
ConnectionTypeCdMeaning: string
タイトル:
Connection Type Value最大長:255インバウンド・メッセージの接続タイプ参照コードに対応する表示値を示します。 -
ContentTypeCd: string
タイトル:
Content Type最大長:30インバウンド・メッセージのコンテンツ・タイプ。 -
ContentTypeCdMeaning: string
タイトル:
Content Type Value最大長:255インバウンドEメールのコンテンツ・タイプ参照コードに対応する表示値。 -
CreatedBy: string
タイトル:
Created By読取り専用:true最大長:64インバウンド・メッセージを作成したユーザー。 -
CreationDate: string (date-time)
タイトル:
Creation Date読取り専用:trueインバウンド・メッセージが作成された日付。 -
DeleteFlag: boolean
タイトル:
Can Delete読取り専用:trueインバウンド・メッセージを削除できるかどうかを示します。 -
FusionRecipient: string
タイトル:
Inbound Message Account最大長:320サービス・リクエストが転送される取引先。 -
InboundMessageId: integer (int64)
タイトル:
Inbound Message IDインバウンド・メッセージの一意の識別子。 -
InboundMsgParts: array Inbound Message Parts
タイトル:
Inbound Message Partsインバウンド・メッセージ・パート・リソースは、インバウンド・メッセージのコンポーネント・リスト(送信元、送信先、CC、重要度など)の作成、表示、更新および削除に使用されます。 -
LastUpdateDate: string (date-time)
タイトル:
Last Updated Date読取り専用:trueインバウンド・メッセージが最後に更新された日付。 -
LastUpdatedBy: string
タイトル:
Last Updated By読取り専用:true最大長:64インバウンド・メッセージを最後に更新したユーザー。 -
LastUpdateLogin: string
タイトル:
Last Update Login読取り専用:true最大長:32レコードを最後に更新したユーザーのログイン。 -
links: array Links
タイトル:
Linksリソース・インスタンスに関連付けられたリンク関係。 -
ObjectId: integer (int64)
タイトル:
Object IDインバウンド・メッセージに関連付けられたビジネス・オブジェクトの一意の識別子。 -
ObjectTypeCd: string
タイトル:
Object Type最大長:30インバウンド・メッセージに関連付けられたビジネス・オブジェクトのタイプ(SVC_SERVICE_REQUESTSなど)。 -
ObjectTypeCdMeaning: string
タイトル:
Object Type Value最大長:255インバウンドEメールのオブジェクト・タイプ参照コードに対応する表示値。 -
PlainTextBody: 文字列(バイト)
タイトル:
Plain Text Bodyインバウンド・メッセージのプレーン・テキスト・コンテンツ。 -
ReceivedChannelCd: string
タイトル:
Received Channel Code最大長:30インバウンド・メッセージのチャネル・タイプ。 たとえば、EメールやSMSです。 -
ReceivedDateTime: string (date-time)
タイトル:
Received Date TimeメールボックスがEメールを受信した日時を示します。 -
RetryCount: integer (int64)
タイトル:
Retry Countシステムがインバウンド・メッセージの処理を試行した回数。 -
Sender: string
タイトル:
Sender最大長:320インバウンド・メッセージの送信者。 -
SenderPartyId: integer (int64)
タイトル:
Sender Party IDメッセージを送信した個人のパーティ識別子。 -
SourceMessageId: string
タイトル:
Source Message ID最大長:2000ソース・システムのメッセージID。 -
StatusCd: string
タイトル:
Status Code最大長:30インバウンド・メッセージの現在のステータス。 たとえば、受信済、処理済、削除済などです。 -
StatusDetails: string
タイトル:
Status Details最大長:1000インバウンドEメール処理ステータスの詳細。 -
StatusTypeCdMeaning: string
タイトル:
Status Type Value最大長:255インバウンドEメールのステータス・タイプ参照コードに対応する表示値。 -
StripeCd: string
タイトル:
Stripe Code最大長:30インバウンド・メッセージのアプリケーション・コンテキスト。 -
StripeCdMeaning: string
タイトル:
Stripe Value最大長:255インバウンドEメールのストライプ・タイプ参照コードに対応する表示値。 -
StripeCode: string
タイトル:
Stripe Codeインバウンド・メッセージのアプリケーション・ストライプ。 -
Subject: string
タイトル:
Subject最大長:400インバウンド・メッセージの件名。 -
UpdateFlag: boolean
タイトル:
Can Update読取り専用:trueインバウンド・メッセージを更新できるかどうかを示します。
ネストされたスキーマ : 添付ファイル
タイプ:
arrayタイトル:
Attachments添付リソースは、インバウンド・メッセージとともに添付として送信されるファイルのリストを作成、表示、更新および削除するために使用されます。 たとえば、エラー・メッセージのスクリーンショットを含むドキュメントです。
ソースを表示
ネストされたスキーマ : インバウンド・メッセージ部品
タイプ:
arrayタイトル:
Inbound Message Partsインバウンド・メッセージ・パート・リソースは、インバウンド・メッセージのコンポーネント・リスト(送信元、送信先、CC、重要度など)の作成、表示、更新および削除に使用されます。
ソースを表示
ネストされたスキーマ : inboundMessages-Attachments-item-response
タイプ:
ソースを表示
object-
AsyncTrackerId: string
タイトル:
Asynchronous Upload Tracker Idファイルのアップロードを支援するために添付UIコンポーネントによって排他的に使用される属性。 -
AttachedDocumentId: integer (int64)
タイトル:
Attached Document Id添付文書の一意の識別子。 -
CategoryName: string
タイトル:
Category最大長:30添付のカテゴリ。 - ContentRepositoryFileShared: boolean
-
CreatedBy: string
タイトル:
Created By読取り専用:true最大長:255添付を作成したユーザー。 -
CreatedByUserName: string
タイトル:
Created By User Name読取り専用:trueレコードを作成したユーザーの名前。 -
CreationDate: string (date-time)
タイトル:
Creation Date読取り専用:true添付ファイルが作成された日付。 -
DatatypeCode: string
タイトル:
Type最大長:30デフォルト値:FILE添付のデータ型を示します。 -
Description: string
タイトル:
Description最大長:255添付の説明。 -
DmDocumentId: string
最大長:
255添付の作成元となる文書ID。 -
DmFolderPath: string
タイトル:
Dm Folder Path最大長:1000添付のフォルダ・パス。 -
DmVersionNumber: string
最大長:
255添付の作成元となる文書バージョン番号。 -
DownloadInfo: string
タイトル:
DownloadInfo添付ファイルをプログラムで取得するために使用される情報を含む文字列として表されるJSONオブジェクト。 -
ErrorStatusCode: string
タイトル:
Error Status Code添付のエラー・コード(ある場合)。 -
ErrorStatusMessage: string
タイトル:
Error Status Message添付のエラー・メッセージ(ある場合)。 -
ExpirationDate: string (date-time)
タイトル:
Expiration Date添付ファイルのコンテンツの有効期限。 -
FileContents: 文字列(バイト)
タイトル:
File Contents添付ファイルの内容。 -
FileName: string
タイトル:
File Name最大長:2048添付のファイル名。 -
FileUrl: string
タイトル:
File Url添付ファイルのURL。 -
FileWebImage: 文字列(バイト)
タイトル:
File Web Image読取り専用:trueソースが変換可能なイメージの場合、.png形式で表示されるファイルのbase64エンコード・イメージ。 -
LastUpdateDate: string (date-time)
タイトル:
Last Update Date読取り専用:true添付が最後に更新された日付。 -
LastUpdatedBy: string
タイトル:
Last Updated By読取り専用:true最大長:255添付を最後に更新したユーザー。 -
LastUpdatedByUserName: string
タイトル:
Last Updated By User読取り専用:trueレコードを最後に更新したユーザー。 -
links: array Links
タイトル:
Linksリソース・インスタンスに関連付けられたリンク関係。 -
Title: string
タイトル:
Title添付のタイトル。 -
UploadedFileContentType: string
タイトル:
Uploaded File Content Type添付のコンテンツ・タイプ。 -
UploadedFileLength: integer
タイトル:
File Size添付ファイルの長さ。 -
UploadedFileName: string
タイトル:
Uploaded File Name添付ファイルの名前。 -
UploadedText: string
タイトル:
Uploaded Text添付のテキスト。 -
Uri: string
タイトル:
Uri最大長:4000添付のURI。 -
Url: string
タイトル:
Url最大長:4000添付のURL。 -
UserName: string
タイトル:
User Name読取り専用:true最大長:255添付に関連付けられているユーザーのログイン。
ネストされたスキーマ : リンク
タイプ:
ソースを表示
object-
href: string
タイトル:
hyperlink reference関連リソースへのURI。 -
kind: string
タイトル:
kind許可された値:[ "collection", "item", "describe", "other" ]関連リソースの種類。 -
name: string
タイトル:
name関連リソースへのリンクの名前。 -
properties: object properties
-
rel: string
タイトル:
relation許可された値:[ "self", "lov", "parent", "canonical", "child", "enclosure", "action", "custom" ]リソース・インスタンスとの関係の名前。 例: self.
ネストされたスキーマ : properties
タイプ:
ソースを表示
object-
changeIndicator: string
リソース・インスタンスのインジケータまたはETag値を変更します。
ネストされたスキーマ : inboundMessages-InboundMsgParts-item-response
タイプ:
ソースを表示
object-
CreatedBy: string
タイトル:
Created By読取り専用:true最大長:64インバウンド・メッセージ・パートを作成したユーザー。 -
CreationDate: string (date-time)
タイトル:
Creation Date読取り専用:trueインバウンド・メッセージ・パートが作成された日付。 -
DeleteFlag: boolean
タイトル:
Can Delete読取り専用:trueインバウンド・メッセージ・パートを削除できるかどうかを示します。 -
InboundMessageId: integer (int64)
タイトル:
Inbound Message IDメッセージ・パートが関連付けられているインバウンド・メッセージの一意の識別子。 -
InboundMsgPartId: integer (int64)
タイトル:
Inbound Message Part IDメッセージ・パートの一意の識別子。 -
LastUpdateDate: string (date-time)
タイトル:
Last Updated Date読取り専用:trueインバウンド・メッセージ部分が最後に更新された日付。 -
LastUpdatedBy: string
タイトル:
Last Updated By読取り専用:true最大長:64インバウンド・メッセージ・パートを最後に更新したユーザー。 -
LastUpdateLogin: string
タイトル:
Last Update Login読取り専用:true最大長:32レコードを最後に更新したユーザーのログイン。 -
links: array Links
タイトル:
Linksリソース・インスタンスに関連付けられたリンク関係。 -
PartName: string
タイトル:
Part Name最大長:64インバウンド・メッセージ部分のヘッダー名。 -
PartTypeCd: string
タイトル:
Part Type Code最大長:30インバウンド・メッセージ部分のタイプ。 -
PartTypeCdMeaning: string
タイトル:
Part Type Value最大長:255インバウンド・メッセージの部品タイプ参照コードに対応する表示値。 -
PartValue: string
タイトル:
Part Value最大長:2000インバウンド・メッセージ部分の値。 -
UpdateFlag: boolean
タイトル:
Can Update読取り専用:trueインバウンド・メッセージ・パートを更新できるかどうかを示します。
リンク
- 添付
-
パラメータ:
- InboundMessageId:
$request.path.InboundMessageId
添付リソースは、インバウンド・メッセージとともに添付として送信されるファイルのリストを作成、表示、更新および削除するために使用されます。 たとえば、エラー・メッセージのスクリーンショットを含むドキュメントです。 - InboundMessageId:
- ChannelTypeCdLookup
-
パラメータ:
- ファインダ:
LookupTypeFinder%3BLookupType%3DORA_SVC_CHANNEL_TYPE_CD
LOVリンク関連では、次のプロパティが定義されます:- ソース属性: ReceivedChannelCd;ターゲット属性: LookupCode
- 表示属性: LookupCode
- ファインダ:
- ContentTypeCdLookup
-
パラメータ:
- ファインダ:
LookupTypeFinder%3BLookupType%3DORA_SVC_INBND_CONTENT_TYPE
LOVリンク関連では、次のプロパティが定義されます:- ソース属性: ContentTypeCd;ターゲット属性: LookupCode
- 表示属性: LookupCode
- ファインダ:
- InboundMsgParts
-
パラメータ:
- InboundMessageId:
$request.path.InboundMessageId
インバウンド・メッセージ・パート・リソースは、インバウンド・メッセージのコンポーネント・リスト(送信元、送信先、CC、重要度など)の作成、表示、更新および削除に使用されます。 - InboundMessageId:
- ObjectTypeCdLookup
-
パラメータ:
- ファインダ:
LookupTypeFinder%3BLookupType%3DORA_SVC_INBND_OBJECT_TYPE_CD
LOVリンク関連では、次のプロパティが定義されます:- ソース属性: ObjectTypeCd;ターゲット属性: LookupCode
- 表示属性: LookupCode
- ファインダ:
- StatusTypeCdLookup
-
パラメータ:
- ファインダ:
LookupTypeFinder%3BLookupType%3DORA_SVC_INBND_MSG_STATUS_TYPE
LOVリンク関連では、次のプロパティが定義されます:- ソース属性: StatusCd;ターゲット属性: LookupCode
- 表示属性: LookupCode
- ファインダ:
- StripeCodeLookup
-
パラメータ:
- ファインダ:
LookupTypeFinder%3BLookupType%3DORA_SVC_STRIPE_CD
LOVリンク関連では、次のプロパティが定義されます:- ソース属性: StripeCode;ターゲット属性: LookupCode
- 表示属性: LookupCode
- ファインダ:
例:
特定のインバウンド・メッセージの詳細を取得するには、次のURI構文でGETを使用します:
リクエストURIの例
次に、リクエストURLの例を示します。
https://servername.fa.us2.oraclecloud.com/crmRestApi/resources/11.13.18.05/inboundMessages/300100095233080
リクエスト・ヘッダーの例
次に、リクエスト・ヘッダーの例を示します。
GET /crmRestApi/resources/11.13.18.05/inboundMessages/300100095233080 HTTP/1.1 HOST: servername.fa.us2.oraclecloud.com authorization: Basic U0FMRVNfQURNSU46V2VsY29tZTE= content-type: application/vnd.oracle.adf.resourceitem+json
レスポンス・ヘッダーの例
次に、レスポンス・ヘッダーの例を示します。
HTTP/1.1 200: OK Date: Mon, 18 Jan 2017 09:15:04 GMT Server: Oracle-HTTP-Server-11g Content-Type: application/vnd.oracle.adf.resourceitem+json Content-Language: en
レスポンス本文の例
次に、JSON形式のレスポンス本文の例を示します。
Content type:
{
"InboundMessageId": 300100095233080,
"Sender": "abc@oracle.com",
"FusionRecipient": "recipient@servername.fa.us2.oraclecloud.com",
"Subject": "Testing REST API",
"ContentTypeCd": "ORA_SVC_TEXT_HTML",
"StatusCd": "ORA_SVC_PROCESSED",
"ReceivedChannelCd": "ORA_SVC_EMAIL",
"AcknowledgedDate": "2016-05-24T01:47:47-07:00",
"CreationDate": "2017-01-18T01:04:38-08:00",
"CreatedBy": "SALES_ADMIN",
"LastUpdateDate": "2017-01-18T01:04:38-08:00",
"LastUpdatedBy": "SALES_ADMIN",
"ChannelId": 2,
"ObjectId": 300100095233089,
"ObjectTypeCd": "SVC_SERVICE_REQUESTS",
"BatchId": 300100095233079,
"RetryCount": 0,
"StripeCode": "ORA_SVC_CRM",
"links": [
{
"rel": "self",
"href": "http://servername.fa.us2.oraclecloud.com/crmRestApi/resources/11.13.18.05/inboundMessages/300100095233080",
"name": "inboundMessages",
"kind": "item",
"properties": {
"changeIndicator": "ACED0005737200136A6176612E7574696C2E41727261794C6973747881D21D99C7619D03000149000473697A65787000000001770400000001737200116A6176612E6C616E672E496E746567657212E2A0A4F781873802000149000576616C7565787200106A6176612E6C616E672E4E756D62657286AC951D0B94E08B020000787200106A6176612E6C616E672E4F626A656374000000000000000000000078700000000178"
}
},
{
"rel": "canonical",
"href": "http://servername.fa.us2.oraclecloud.com/crmRestApi/resources/11.13.18.05/inboundMessages/300100095233080",
"name": "inboundMessages",
"kind": "item"
},
{
"rel": "child",
"href": "http://servername.fa.us2.oraclecloud.com/crmRestApi/resources/11.13.18.05/inboundMessages/300100095233080/child/InboundMsgParts",
"name": "InboundMsgParts",
"kind": "collection"
},
{
"rel": "child",
"href": "http://servername.fa.us2.oraclecloud.com/crmRestApi/resources/11.13.18.05/inboundMessages/300100095233080/child/Attachments",
"name": "Attachments",
"kind": "collection"
},
{
"rel": "enclosure",
"href": "http://servername.fa.us2.oraclecloud.com/crmRestApi/resources/11.13.18.05/inboundMessages/300100095233080/enclosure/Body",
"name": "Body",
"kind": "other"
},
{
"rel": "enclosure",
"href": "http://servername.fa.us2.oraclecloud.com/crmRestApi/resources/11.13.18.05/inboundMessages/300100095233080/enclosure/PlainTextBody",
"name": "PlainTextBody",
"kind": "other"
}
],
}