作業確認を1つ取得
get
/fscmRestApi/resources/11.13.18.05/workConfirmations/{workConfirmationsUniqID}
リクエスト
パス・パラメータ
- workConfirmationsUniqID(required): string
これは、作業確認リソースのコンポジット・キーを構成し、作業確認のインスタンスを一意に識別するために使用される属性のハッシュ・キーです。 クライアントはハッシュ・キー値を生成しないでください。 かわりに、クライアントは作業確認の特定のインスタンスに移動してハッシュ・キーを取得するために、作業確認コレクション・リソースを問い合せる必要があります。
問合せパラメータ
- 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
データのみを含めるために(リンク・セクションなしなど)、リソース品目ペイロードがフィルタ処理されます。
ヘッダー・パラメータ
- Effective-Of:
このヘッダーは文字列値を受け入れます。 この文字列は、セミコロンで区切られた
= 有効日範囲操作の実行に使用されます。 受け入れられるパラメータは、RangeMode、RangeSpan、RangeStartDate、RangeEndDate、RangeStartSequenceおよびRangeEndSequenceです。 パラメータ値は常に文字列です。 RangeModeに指定できる値は、SET_LOGICAL_START、SET_LOGICAL_END、END_DATE、SET_EFFECTIVE_START、SET_EFFECTIVE_END、REPLACE_CORRECTION、REPLACE_UPDATE、RECONCILE_CORRECTION、CORRECTION、RECONCILE_UPDATE、UPDATE、ZAPおよびDELETE_CHANGESです。 RangeSpanに指定できる値は、PHYSICAL_ROW_END_DATEおよびLOGICAL_ROW_END_DATEです。 RangeStartDateおよびRangeEndDateの値は、yyyy-MM-dd形式の日付の文字列表現である必要があります。 RangeStartSequenceおよびRangeEndSequenceの値は、解析時に正の整数が生成されるように文字列である必要があります。のリストです。 - 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のデフォルト・バージョンを選択します。
ルート・スキーマ : workConfirmations-item-response
タイプ:
ソースを表示
object-
attachments: array Attachments
タイトル:
Attachments添付リソースは、作業確認の添付を管理します。 -
BalanceToFinish: number
読取り専用:
true購買オーダーの作業を完了するための待ち状態の金額です。 -
Buyer: string
タイトル:
Name読取り専用:true最大長:240購買オーダーの管理を担当する個人。 -
BuyerId: integer (int64)
読取り専用:
true購買オーダーのバイヤーを一意に識別する値。 -
Comments: string
最大長:
240作業確認に入力されたコメント。 -
ContractAmountToDate: number
読取り専用:
true購買オーダーのオーダー金額。 -
CreatedBy: string
読取り専用:
true最大長:64作業確認を作成したユーザー。 -
CreationDate: string (date-time)
読取り専用:
trueサプライヤまたはアプリケーションが作業確認を作成した日時。 -
Currency: string
タイトル:
Currency Name読取り専用:true最大長:80購買オーダーの通貨。 -
CurrencyCode: string
読取り専用:
true最大長:15購買オーダーの通貨を識別する略称です。 -
CurrentPaymentDue: number
読取り専用:
trueパフォーマンスの期間に支払う必要がある金額。 -
documentActions: array Document Actions
タイトル:
Document Actions文書処理リソースは、作業確認に対して実行された処理のリストを取得します。 -
ImportSource: string
最大長:
25作業確認のインポート元のソース・アプリケーションを示す値です。 -
LastUpdateDate: string (date-time)
読取り専用:
trueサプライヤまたはアプリケーションが作業確認を最後に更新した日時。 -
LastUpdatedBy: string
読取り専用:
true最大長:64作業確認を最後に更新したユーザー。 -
lines: array Lines
タイトル:
Lines明細リソースは、パフォーマンス期間中に完了した作業の合計進捗率、数量または金額などの作業確認詳細を管理します。 -
links: array Links
タイトル:
Linksリソース・インスタンスに関連付けられたリンク関係。 -
OrderNumber: string
タイトル:
Order最大長:30販売先法的エンティティの購買オーダーを一意に識別する番号です。 -
PeriodEndDate: string (date)
作業確認がアクティブでなくなったパフォーマンス期間。
-
PeriodStartDate: string (date)
作業確認がアクティブになるパフォーマンス期間。
-
PODescription: string
タイトル:
Description読取り専用:true最大長:240購買オーダーの摘要。 -
POHeaderId: integer (int64)
購買オーダーを一意に識別する値。
-
PreviouslyApprovedAmount: number
読取り専用:
true現在のパフォーマンス期間より前の購買オーダーの承認済作業確認金額合計。 -
ProjectedRetainageThisPeriod: number
読取り専用:
true購買オーダーでパフォーマンス期間中に源泉徴収可能な留保金額の見積。 -
SoldToLegalEntity: string
タイトル:
Legal Entity Name最大長:240購買オーダーの購買を財務的に担当する法的エンティティです。 -
SoldToLegalEntityId: integer (int64)
購買オーダーの購買を財務的に担当する法的エンティティを一意に識別する値。
-
Status: string
タイトル:
Meaning読取り専用:true最大長:80作業確認のステータス。 -
StatusCode: string
読取り専用:
true最大長:25作業確認ステータスを識別する略称です。 -
Supplier: string
読取り専用:
true最大長:360購買オーダーのサプライヤの名前。 -
SupplierId: integer (int64)
読取り専用:
true購買オーダーのサプライヤを一意に識別する値。 -
SupplierSite: string
タイトル:
Site読取り専用:true最大長:240サプライヤが購買オーダーの履行に使用する事業所。 -
SupplierSiteId: integer (int64)
読取り専用:
true購買オーダーのサプライヤ・サイトを一意に識別する値。 -
TotalCompletedThisPeriod: number
読取り専用:
trueパフォーマンスの期間の購買オーダーにおける完了作業の合計金額。 -
TotalCompletedToDate: number
読取り専用:
true購買オーダーにおける完了作業の合計金額。 -
WorkConfirmationId: integer (int64)
読取り専用:
true作業確認を一意に識別する値。 -
WorkConfirmationNumber: string
読取り専用:
true最大長:30販売先法的エンティティの作業確認を一意に識別する番号です。 -
WorkConfirmationRequestDate: string (date-time)
作業確認がリクエストされた日付。
-
WorkConfirmationSequenceNumber: integer (int64)
読取り専用:
true購買オーダーの作業確認の順序を一意に識別する番号です。
ネストされたスキーマ : 明細
タイプ:
arrayタイトル:
Lines明細リソースは、パフォーマンス期間中に完了した作業の合計進捗率、数量または金額などの作業確認詳細を管理します。
ソースを表示
ネストされたスキーマ : workConfirmations-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: string (byte)
タイトル:
File Contents添付のコンテンツ。 -
FileName: string
タイトル:
File Name最大長:2048添付のファイル名。 -
FileUrl: string
タイトル:
File UrlファイルのURI。 -
FileWebImage: string (byte)
タイトル:
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最大長:4000webページ・タイプの添付の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.
ネストされたスキーマ : workConfirmations-documentActions-item-response
タイプ:
ソースを表示
object-
Action: string
タイトル:
Meaning読取り専用:true最大長:80作業確認で実行された処理の名前。 -
ActionCode: string
最大長:
25作業確認で実行される処理の名前を識別する略称です。 有効な値は、送信、承認、否認および取下げです。 -
ActionDate: string (date-time)
ユーザーがアクションを実行した日時。
-
CreatedBy: string
読取り専用:
true最大長:64作業確認時に処理を実行したユーザー。 -
CreationDate: string (date-time)
読取り専用:
trueユーザーが作業確認に対して処理を実行した日時。 -
LastUpdateDate: string (date-time)
読取り専用:
trueユーザーが作業確認の処理を最近実行した日時。 -
LastUpdatedBy: string
読取り専用:
true最大長:64作業確認の処理を最後に実行したユーザー。 -
links: array Links
タイトル:
Linksリソース・インスタンスに関連付けられたリンク関係。 -
Note: string
最大長:
255ユーザーが処理の実行中に入力したことに注意してください。 -
ObjectId: integer (int64)
作業確認を一意に識別する値。
-
PerformedByUserName: string
最大長:
255処理を実行した個人。 -
PerformerId: integer
処理を実行した個人を一意に識別する値。
-
SequenceNumber: integer
作業確認で実行される承認処理の順序を一意に識別する番号です。
ネストされたスキーマ : workConfirmations-lines-item-response
タイプ:
ソースを表示
object-
Amount: number
期間または実績の分割払いスケジュールで完了した作業の金額。
-
BalanceToFinish: number
読取り専用:
true分割払いスケジュールでの作業を完了するための待ち状態の金額。 -
CreatedBy: string
読取り専用:
true最大長:64作業確認明細を作成したユーザー。 -
CreationDate: string (date-time)
読取り専用:
trueサプライヤまたはアプリケーションが作業確認明細を作成した日時。 -
LastUpdateDate: string (date-time)
読取り専用:
trueサプライヤまたはアプリケーションが作業確認明細を最後に更新した日時。 -
LastUpdatedBy: string
読取り専用:
true最大長:64作業確認明細を最後に更新したユーザー。 -
links: array Links
タイトル:
Linksリソース・インスタンスに関連付けられたリンク関係。 -
MaximumRetainageAmount: number
タイトル:
Maximum Retainage Amount読取り専用:true購買オーダー明細で源泉徴収可能な最大留保金額です。 -
POLineId: integer (int64)
購買オーダー明細を一意に識別する値。
-
POLineLocationId: integer (int64)
購買オーダー・スケジュールを一意に識別する値。
-
POLineNumber: number
タイトル:
Line購買オーダー明細を一意に識別する番号です。 -
POScheduleDescription: string
タイトル:
Description読取り専用:true最大長:240分割払いスケジュールに関連付けられた作業の摘要。 -
POScheduleNumber: number
タイトル:
Schedule購買オーダー明細の購買オーダー・スケジュールを一意に識別する番号です。 -
PreviouslyApprovedAmount: number
読取り専用:
true現在のパフォーマンス期間前の分割払いスケジュールの承認済作業確認合計金額。 -
Price: number
タイトル:
Price読取り専用:true購買オーダー・スケジュールの価格です。 -
ProjectedRetainageThisPeriod: number
読取り専用:
trueパフォーマンス期間の分割払いスケジュールで源泉徴収できる留保金額の見積。 -
Quantity: number
期間または実績の分割払いスケジュールで完了した作業の数量。
-
RetainageRate: number
タイトル:
Retainage Rate読取り専用:true留保金として源泉徴収できる請求書値のパーセントです。 -
ScheduledQuantity: number
タイトル:
Quantity読取り専用:true分割払い予定の予定数量。 -
ScheduledValue: number
読取り専用:
true分割払いスケジュールのオーダー金額。 -
ScheduleType: string
タイトル:
Meaning読取り専用:true最大長:80分割払いスケジュールのタイプです。 -
ScheduleTypeCode: string
読取り専用:
true最大長:30分割払いスケジュール・タイプを識別する略称です。 有効な値は、レートと総額です。 -
TotalCompleted: number
読取り専用:
true分割払いスケジュールで完了した作業の合計金額。 -
TotalProgressPercent: number
分割払いスケジュールで完了した作業のパーセントを示す値です。
-
TotalProjectedRetainageToDate: number
読取り専用:
true分割払いスケジュールで源泉徴収できる留保金額の見積。 -
UOM: string
タイトル:
UOM Name読取り専用:true最大長:25購買オーダー・スケジュールでオーダーされた数量の単位です。 -
UOMCode: string
読取り専用:
true最大長:3購買オーダー・スケジュールの単位を識別する略称です。 -
WorkConfirmationId: integer (int64)
読取り専用:
true作業確認を一意に識別する値。 -
WorkConfirmationLineId: integer (int64)
読取り専用:
true作業確認明細を一意に識別する値。 -
WorkConfirmationNumber: string
読取り専用:
true最大長:30販売先法的エンティティの作業確認を一意に識別する番号です。
リンク
- 添付
-
操作: /fscmRestApi/resources/11.13.18.05/workConfirmations/{workConfirmationsUniqID}/child/attachmentsパラメータ:
- workConfirmationsUniqID:
$request.path.workConfirmationsUniqID
添付リソースは、作業確認の添付を管理します。 - workConfirmationsUniqID:
- 取消
-
パラメータ:
- workConfirmationsUniqID:
$request.path.workConfirmationsUniqID
承認待ちステータスから作業確認を取り消します。 取り消されると、作業確認に対してこれ以上の処理は実行できません。 - workConfirmationsUniqID:
- documentActions
-
操作: /fscmRestApi/resources/11.13.18.05/workConfirmations/{workConfirmationsUniqID}/child/documentActionsパラメータ:
- workConfirmationsUniqID:
$request.path.workConfirmationsUniqID
文書処理リソースは、作業確認に対して実行された処理のリストを取得します。 - workConfirmationsUniqID:
- 行
-
パラメータ:
- workConfirmationsUniqID:
$request.path.workConfirmationsUniqID
明細リソースは、パフォーマンス期間中に完了した作業の合計進捗率、数量または金額などの作業確認詳細を管理します。 - workConfirmationsUniqID:
- 飲む
-
パラメータ:
- workConfirmationsUniqID:
$request.path.workConfirmationsUniqID
承認のために作業確認文書を送信します。 作業確認は、RESTリソースまたはユーザー・インタフェースを使用して作成できます。 - workConfirmationsUniqID:
- 取下げ
-
パラメータ:
- workConfirmationsUniqID:
$request.path.workConfirmationsUniqID
承認待ちの作業確認を取り下げます。 - workConfirmationsUniqID:
例
この例では、1つの作業確認を取得する方法を説明します。 この例では、作業確認の一意識別子を使用して1つの作業確認が取得されます。
cURLコマンドの例
この例では、作業確認の一意の識別子を使用して1つの作業確認が取得されます。
次のcURLコマンドを使用して、RESTリソースに対するリクエストを送信します:
curl -u username:password "https://servername/fscmRestApi/resources/version/workConfirmations/WorkConfirmationId"
たとえば:
curl -u username:password "https://servername/fscmRestApi/resources/version/workConfirmations/300100549276467"
レスポンス本文の例
次の例には、レスポンス本文の内容がJSON形式で含まれます:
{
"WorkConfirmationId": 300100549276467,
"WorkConfirmationNumber": "1005070-1",
"POHeaderId": 300100549056643,
"OrderNumber": "1005070",
"SoldToLegalEntityId": 204,
"SoldToLegalEntity": "Vision Operations",
"PeriodStartDate": "2021-12-01",
"PeriodEndDate": "2021-12-31",
"WorkConfirmationRequestDate": "2022-01-03T00:00:00+00:00",
"Comments": null,
"StatusCode": "PENDING APPROVAL",
"Status": "Pending Approval",
"WorkConfirmationSequenceNumber": 1,
"CreationDate": "2022-01-10T15:24:01+00:00",
"CreatedBy": "CVSUPPA05",
"LastUpdateDate": "2022-01-10T15:55:54+00:00",
"LastUpdatedBy": "CVSUPPA05",
"PODescription": "Contract for renovation of parking lot",
"SupplierId": 1717,
"Supplier": "CV_SuppA05",
"SupplierSiteId": 4060,
"SupplierSite": "CVSuppA05Site01",
"CurrencyCode": "USD",
"Currency": "US Dollar",
"ImportSource": null,
"PreviouslyApprovedAmount": 0,
"ContractAmountToDate": 250000,
"TotalCompletedThisPeriod": 7000,
"TotalCompletedToDate": 7000,
"ProjectedRetainageThisPeriod": 700,
"CurrentPaymentDue": 6300,
"BalanceToFinish": 243000,
"BuyerId": 100010026863799,
"Buyer": "Norden,Loraine",
"links": [
{
"rel": "self",
"href": "https://servername/fscmRestApi/resources/version/workConfirmations/300100549276467",
"name": "workConfirmations",
"kind": "item",
"properties": {
"changeIndicator": "ACED0005737200136A6176612E7574696C2E41727261794C6973747881D21D99C7619D03000149000473697A65787000000001770400000001737200116A6176612E6C616E672E496E746567657212E2A0A4F781873802000149000576616C7565787200106A6176612E6C616E672E4E756D62657286AC951D0B94E08B02000078700000000878"
}
},
{
"rel": "canonical",
"href": "https://servername/fscmRestApi/resources/version/workConfirmations/300100549276467",
"name": "workConfirmations",
"kind": "item"
},
{
"rel": "child",
"href": "https://servername/fscmRestApi/resources/version/workConfirmations/300100549276467/child/attachments",
"name": "attachments",
"kind": "collection"
},
{
"rel": "child",
"href": "https://servername/fscmRestApi/resources/version/workConfirmations/300100549276467/child/documentActions",
"name": "documentActions",
"kind": "collection"
},
{
"rel": "child",
"href": "https://servername/fscmRestApi/resources/version/workConfirmations/300100549276467/child/lines",
"name": "lines",
"kind": "collection"
},
{
"rel": "action",
"href": "https://servername/fscmRestApi/resources/version/workConfirmations/300100549276467/action/withdraw",
"name": "withdraw",
"kind": "other"
},
{
"rel": "action",
"href": "https://servername/fscmRestApi/resources/version/workConfirmations/300100549276467/action/cancel",
"name": "cancel",
"kind": "other"
},
{
"rel": "action",
"href": "https://servername/fscmRestApi/resources/version/workConfirmations/300100549276467/action/submit",
"name": "submit",
"kind": "other"
}
]
}