Catatan
Akses ke halaman ini memerlukan otorisasi. Anda dapat mencoba masuk atau mengubah direktori.
Akses ke halaman ini memerlukan otorisasi. Anda dapat mencoba mengubah direktori.
Sebagai pengembang, baca dokumentasi referensi ini untuk menggunakan msdyn_ForecastApi tindakan kustom guna mengambil dan memperbarui data perkiraan. Anda juga dapat menggunakan tindakan ini untuk menyimpan data perkiraan dari waktu ke waktu, sebagai rekam jepret. Anda kemudian dapat menggunakan rekam jepret untuk membandingkan data perkiraan dari waktu ke waktu. Gunakan kode sampel API perkiraan untuk memulai tindakan msdyn_ForecastApi kustom.
Parameter-parameternya
| Nama Parameter | Diperlukan | Description |
|---|---|---|
WebApiName |
Yes | Berisi nama API yang akan dieksekusi. |
RequestJson |
Yes | Berisi parameter dan argumen untuk panggilan API. |
Daftar API
Diberikan di bawah ini adalah kumpulan API yang dapat Anda panggil menggunakan msdyn_ForecastApi tindakan kustom.
GET_ForecastConfigurations
Mengembalikan daftar semua konfigurasi perkiraan yang dikonfigurasi.
Example
POST [Organization URI]/api/data/v9.1/msdyn_ForecastApi/ HTTP/1.1
Content-Type: application/json
{
"WebApiName": "GET_ForecastConfigurations",
"RequestJson": "{}"
}
| Pengaturan | Tipe | Description |
|---|---|---|
WebApiName |
String | Nama API |
RequestJson |
String | Objek JSON berseri |
Jawaban
{
"@odata.context": "[Organization URI]/api/data/v9.1/$metadata#Microsoft.Dynamics.CRM.msdyn_ForecastApiResponse",
"response": [
{
"Columns": [
{
"ForecastConfigurationColumnId": "0ad51075-912b-4e00-a7a1-91170e437d27",
...
"ForecastConfigurationId": "27bd2c40-f868-ea11-a811-000d3a37bb2c",
...
},
{
"ForecastConfigurationColumnId": "c3ef8024-6517-4168-adc7-bb5b520554a0",
...
"ForecastConfigurationId": "27bd2c40-f868-ea11-a812-125d3a37bb2d",
...
}],
"PermissionRoles": null,
"AdditionalFilters": "<fetch version=\"1.0\" mapping=\"logical\"><entity name=\"opportunity\"><\/entity><\/fetch>",
"IsSnapshotScheduled": false,
"SnapshotSchedule": null,
"SnapshotTimeZone": null,
"PublishedDateTime": "0001-01-01T00:00:00",
"DefaultViewIdForUnderlyingRecords": "bf649add-6c30-ea11-a813-000d3a5475f7"
}
]
}
Mengembalikan nilai
Daftar Konfigurasi Perkiraan.
GET_ForecastConfigurationsByName
Mengembalikan semua konfigurasi perkiraan yang memiliki nama yang disediakan sebagai bagian dari payload permintaan.
Example
POST [Organization URI]/api/data/v9.1/msdyn_ForecastApi HTTP/1.1
Content-Type: application/json
{
"WebApiName": "GET_ForecastConfigurationsByName",
"RequestJson": "{\"Name\":\"api_test1\"}"
}
| Pengaturan | Tipe | Description |
|---|---|---|
WebApiName |
String | Nama API |
RequestJson |
Objek JSON | Terdiri dari Name: nama konfigurasi prakiraan |
Jawaban
{
"@odata.context": "[Organization URI]/api/data/v9.1/$metadata#Microsoft.Dynamics.CRM.msdyn_ForecastApiResponse",
"response": [
{
"Columns": [
{
"Name": "api_test1",
...
"ForecastConfigurationId": "bcf37937-487e-ea11-a811-000d3a37bb2c",
...
}
],
"PermissionRoles": null,
"AdditionalFilters": "<fetch version=\"1.0\" mapping=\"logical\"><entity name=\"opportunity\"><\/entity><\/fetch>",
"IsSnapshotScheduled": false,
"SnapshotSchedule": null,
"SnapshotTimeZone": null,
"PublishedDateTime": "0001-01-01T00:00:00",
"DefaultViewIdForUnderlyingRecords": "bf649add-6c30-ea11-a813-000d3a5475f7"
}
]
}
Mengembalikan nilai
Daftar Konfigurasi Perkiraan.
GET_ForecastPeriodsByForecastConfigurationId
Mengembalikan semua periode perkiraan untuk Id konfigurasi perkiraan aktif, yang disediakan sebagai bagian dari payload permintaan.
Example
POST [Organization URI]/api/data/v9.1/msdyn_ForecastApi HTTP/1.1
Content-Type: application/json
{
"WebApiName": "GET_ForecastPeriodsByForecastConfigurationId",
"RequestJson": "{
\"ForecastConfigurationId\":\"04323a04-da7f-ea11-a811-000d3a37bb2c\"
}"
}
| Pengaturan | Tipe | Description |
|---|---|---|
WebApiName |
String | Nama API |
RequestJson |
Objek JSON | Berisi ForecastConfigurationId: Id Konfigurasi Prakiraan |
Jawaban
{
"@odata.context": "[Organization URI]/api/data/v9.1/$metadata#Microsoft.Dynamics.CRM.msdyn_ForecastApiResponse",
"response": [
{
"Id": "8b8cadd8-ede3-4b21-97cf-93efc0337089",
"ForecastConfigurationId": "04323a04-da7f-ea11-a811-000d3a37bb2c",
"RecurrenceIndex": 0,
"ValidFrom": "2020-04-01T00:00:00Z",
"ValidTo": "2020-06-30T23:59:59Z",
"Name": "FY2020 Q2",
"RecomputeStatus": 10,
"LastRecomputedOn": "2020-05-25T08:04:24.817Z",
"RecomputationStartTime": "2020-06-05T05:04:30.904Z",
"RecomputeStatusChangedOn": "2020-06-05T06:04:00.363Z",
"FailureInfo": "Microsoft.Azure.WebJobs.FunctionFailedException: The activity function 'CreateUpdateForecastHierarchy' failed: \"An item with the same key has already been added. Key: aaaaaaaa-0b0b-1c1c-2d2d-333333333333\". See the function execution logs for additional details. ---> System.ArgumentException: An item with the same key has already been added. Key: aaaaaaaa-0b0b-1c1c-2d2d-333333333333\r\n at System.Collections.Generic.Dictionary`2.TryInsert(TKey key, TValue value, InsertionBehavior behavior)\r\n at Microsoft.Dynamics.Forecasting.RecomputeEngine.HierarchyManager.<>c__DisplayClass23_0.<GetForecastInstancesByHierarchyEntityId>b__0(ForecastInstance forecastInstance) in C:\\src\\cloud_IDEs\\ide5\\Azure\\RecomputeEngine\\HierarchyManager\\HierarchyManager.cs:line 727\r\n at System.Collections.Generic.List`1.ForEach(Action`1 action)\r\n at Microsoft.Dynamics.Forecasting.RecomputeEngine.HierarchyManager.GetForecastInstancesByHierarchyEntityId(ForecastConfiguration forecastConfiguration, Guid forecastRecurrenceId) in C:\\src\\cloud_IDEs\\ide5\\Azure\\RecomputeEngine\\HierarchyManager\\HierarchyManager.cs:line 727\r\n at Microsoft.Dynamics.Forecasting.RecomputeEngine.HierarchyManager.CreateOrUpdateForecastDataWithLatestHierarchy(ForecastConfiguration forecastConfiguration, Guid forecastRecurrenceId, Dictionary`2 latestHierarchyEntityList) in C:\\src\\cloud_IDEs\\ide5\\Azure\\RecomputeEngine\\HierarchyManager\\HierarchyManager.cs:line 602\r\n at Microsoft.Dynamics.Forecasting.RecomputeEngine.HierarchyManager.<>c__DisplayClass16_0.<CreateOrUpdateForecastHierarchy>b__0() in C:\\src\\cloud_IDEs\\ide5\\Azure\\RecomputeEngine\\HierarchyManager\\HierarchyManager.cs:line 283\r\n at System.Threading.Tasks.Task.InnerInvoke()\r\n at System.Threading.Tasks.Task.<>c.<.cctor>b__275_1(Object obj)\r\n at System.Threading.ExecutionContext.RunInternal(ExecutionContext executionContext, ContextCallback callback, Object state)\r\n--- End of stack trace from previous location where exception was thrown ---\r\n at System.Threading.ExecutionContext.RunInternal(ExecutionContext executionContext, ContextCallback callback, Object state)\r\n at System.Threading.Tasks.Task.ExecuteWithThreadLocal(Task& currentTaskSlot)\r\n--- End of stack trace from previous location where exception was thrown ---\r\n at Microsoft.Dynamics.Forecasting.RecomputeEngine.HierarchyManager.CreateOrUpdateForecastHierarchy(ForecastConfiguration forecastConfiguration, Guid forecastRecurrenceId, Dictionary`2 latestHierarchyEntityList) in C:\\src\\cloud_IDEs\\ide5\\Azure\\RecomputeEngine\\HierarchyManager\\HierarchyManager.cs:line 255\r\n at Microsoft.Dynamics.Forecasting.RecomputeEngine.HierarchyManager.CreateOrUpdateForecastHierarchy(Guid orgId, Guid forecastConfigurationId, Guid forecastRecurrenceId, Dictionary`2 latestHierarchyEntityList) in C:\\src\\cloud_IDEs\\ide5\\Azure\\RecomputeEngine\\HierarchyManager\\HierarchyManager.cs:line 167\r\n at Microsoft.Dynamics.Forecasting.AzureFunctions.CreateUpdateForecastHierarchy.Run(CreateUpdateForecastHierarchyInput input) in C:\\src\\cloud_IDEs\\ide5\\Azure\\AzureFunctions\\Recompute\\ActivityFunctions\\CreateUpdateForecastHierarchy.cs:line 43\r\n at Microsoft.Azure.WebJobs.Host.Executors.VoidTaskMethodInvoker`2.InvokeAsync(TReflected instance, Object[] arguments) in C:\\projects\\azure-webjobs-sdk-rqm4t\\src\\Microsoft.Azure.WebJobs.Host\\Executors\\VoidTaskMethodInvoker.cs:line 20\r\n at Microsoft.Azure.WebJobs.Host.Executors.FunctionInvoker`2.InvokeAsync(Object instance, Object[] arguments) in C:\\projects\\azure-webjobs-sdk-rqm4t\\src\\Microsoft.Azure.WebJobs.Host\\Executors\\FunctionInvoker.cs:line 52\r\n at Microsoft.Azure.WebJobs.Host.Executors.FunctionExecutor.InvokeAsync(IFunctionInvoker invoker, ParameterHelper parameterHelper, CancellationTokenSource timeoutTokenSource, CancellationTokenSource functionCancellationTokenSource, Boolean throwOnTimeout, TimeSpan timerInterval, IFunctionInstance instance) in C:\\projects\\azure-webjobs-sdk-rqm4t\\src\\Microsoft.Azure.WebJobs.Host\\Executors\\FunctionExecutor.cs:line 585\r\n at Microsoft.Azure.WebJobs.Host.Executors.FunctionExecutor.ExecuteWithWatchersAsync(IFunctionInstanceEx instance, ParameterHelper parameterHelper, ILogger logger, CancellationTokenSource functionCancellationTokenSource) in C:\\projects\\azure-webjobs-sdk-rqm4t\\src\\Microsoft.Azure.WebJobs.Host\\Executors\\FunctionExecutor.cs:line 532\r\n at Microsoft.Azure.WebJobs.Host.Executors.FunctionExecutor.ExecuteWithLoggingAsync(IFunctionInstanceEx instance, ParameterHelper parameterHelper, IFunctionOutputDefinition outputDefinition, ILogger logger, CancellationTokenSource functionCancellationTokenSource) in C:\\projects\\azure-webjobs-sdk-rqm4t\\src\\Microsoft.Azure.WebJobs.Host\\Executors\\FunctionExecutor.cs:line 468\r\n at Microsoft.Azure.WebJobs.Host.Executors.FunctionExecutor.ExecuteWithLoggingAsync(IFunctionInstanceEx instance, FunctionStartedMessage message, FunctionInstanceLogEntry instanceLogEntry, ParameterHelper parameterHelper, ILogger logger, CancellationToken cancellationToken) in C:\\projects\\azure-webjobs-sdk-rqm4t\\src\\Microsoft.Azure.WebJobs.Host\\Executors\\FunctionExecutor.cs:line 278\r\n --- End of inner exception stack trace ---\r\n at Microsoft.Azure.WebJobs.DurableOrchestrationContext.CallDurableTaskFunctionAsync[TResult](String functionName, FunctionType functionType, String instanceId, RetryOptions retryOptions, Object input) in E:\\functions\\azure-functions-durable-extension\\src\\WebJobs.Extensions.DurableTask\\DurableOrchestrationContext.cs:line 498\r\n at Microsoft.Dynamics.Forecasting.AzureFunctions.OrchestratorFunctionBase.ExecuteActivityAsync(DurableOrchestrationContext context, String functionName, Object input, Dictionary`2 telemetryProps) in C:\\src\\cloud_IDEs\\ide5\\Azure\\AzureFunctions\\OrchestratorFunctionBase.cs:line 252\r\n at Microsoft.Dynamics.Forecasting.AzureFunctions.RecomputeOrchestrator.ExecuteRecomputeOrchestration(DurableOrchestrationContext context, RecomputeOrchestratorInput recomputeInput, String correlationId, Dictionary`2 telemetryProps) in C:\\src\\cloud_IDEs\\ide5\\Azure\\AzureFunctions\\Recompute\\RecomputeOrchestrator.cs:line 169",
"RecurrenceState": 0,
"UpdatedAttribteList": null
}
]
}
Mengembalikan nilai
Daftar Periode Perkiraan.
GET_ForecastInstances
Mengembalikan daftar instans perkiraan yang merupakan rekaman entitas baris tunggal.
Nota
Periode perkiraan dapat memiliki banyak contoh perkiraan. Jauh lebih banyak daripada yang ingin Anda tarik dalam satu permintaan. Titik akhir API default menyediakan jumlah item terbatas per permintaan.
Catatan: Kueri besar dapat merusak performa, sehingga jumlah hasil per halaman dibatasi pada 4000 rekaman. Jika Anda ingin mengambil lebih dari 4000 rekaman, misalnya untuk membuat daftar sisi klien dari semua instans perkiraan yang tersedia, Anda dapat membuat beberapa permintaan API dan menggabungkan hasilnya dalam aplikasi Anda.
Example
POST [Organization URI]/api/data/v9.1/msdyn_ForecastApi HTTP/1.1
Content-Type: application/json
{
"WebApiName": "GET_ForecastInstances",
"RequestJson": "{\"ForecastPeriodId\":\"a0a0a0a0-bbbb-cccc-dddd-e1e1e1e1e1e1\",\"ForecastConfigurationId\":\"b1b1b1b1-cccc-dddd-eeee-f2f2f2f2f2f2\",\"PageInfo\":{\"SortingAttribute\":\"HierarchyEntityRecord.RecordId\",\"SortingOrder\":\"DESC\",\"PageSize\":1,\"PageNo\":5},\"GetParticipatingRecordsFetchXml\":false,\"ParticipatingRecordsViewId\":\"c2c2c2c2-dddd-eeee-ffff-a3a3a3a3a3a3"}"
}
| Pengaturan | Tipe | Description |
|---|---|---|
WebApiName |
String | Nama API |
RequestJson |
Objek JSON | Terdiri dariForecastPeriodId: Pengidentifikasi unik periode perkiraanForecastConfigurationId: Pengidentifikasi unik konfigurasi perkiraanSortingAttribute: Atribut berdasarkan yang ingin Anda lakukan Penyortiran di halaman halamanSortingOrder: ASC untuk urutan menaik DSC untuk urutan menurunPageSize: Jumlah catatan yang ingin Anda ambil dalam satu halamanPageNo: Catatan halaman mana yang ingin Anda ambil.GetParticipatingRecordsFetchXml: Bendera yang menunjukkan apakah pengambilan XML rekaman yang berpartisipasi diperlukan dalam respons.ParticipatingRecordsViewId: Ini diperlukan ketika GetParticipatingRecordsFetchXml benar. Ini adalah ID kueri (tampilan) yang disimpan yang digunakan untuk XML pengambilan rekaman yang berpartisipasi dihasilkan. |
Diberikan di bawah ini adalah contoh JSON untuk RequestJson objek.
{
"WebApiName": "GET_ForecastInstances",
"RequestJson": "{\"ForecastPeriodId\":\"{{frid}}\",\"ForecastConfigurationId\":\"{{fcid}}\",\"PageInfo\":{\"SortingAttribute\":\"HierarchyEntityRecord.RecordId\",\"SortingOrder\":\"ASC\",\"PageSize\":1,\"PageNo\":5},\"GetParticipatingRecordsFetchXml\":false,\"ParticipatingRecordsViewId\":\"bf649add-6c30-ea11-a813-000d3a5475f7\"}"
}
Jawaban
{
"@odata.context": "[Organization URI]/api/data/v9.1/$metadata#Microsoft.Dynamics.CRM.msdyn_ForecastApiResponse",
"response": {
"ForecastInstances": [
"ForecastInstanceId": "95d2305a-a0be-4b34-84ac-b10e67b0771a",
"ForecastConfigurationId": "04323a04-da7f-ea11-a811-000d3a37bb2c",
...],
"HasMorePages": false,
"ParticipatingRecordsFetchXml": "",
"Code": 200,
"Message": "OK"
}
}
Mengembalikan nilai
Daftar Instans Perkiraan.
Update_SimpleColumnByEntityId
Memperbarui nilai kolom tertentu menggunakan nilai parameter yang diteruskan.
Nota
Sejumlah besar permintaan pembaruan dalam satu panggilan API dapat merusak performa, sehingga pembaruan per permintaan dibatasi hingga 50.
Example
POST [Organization URI]/api/data/v9.1/msdyn_ForecastApi HTTP/1.1
content-type: application/json
{
"WebApiName": "Update_ SimpleColumnByEntityId",
"RequestJson": "
{
\"ForecastConfigurationId\":\"0461fb6b-8d85-ea11-a811-000d3a37bb2c\",
\"ForecastRecurranceId\":\"f8b1122c-b913-4e88-9727-368b6134be3e\",
\"SimpleColumnUpdateRequests\":[{
\" HierarchyEntityRecordId\":\"d8680b00-fd31-46c2-8136-7c4df19cf2a8\",
\"ForecastConfigurationColumnId\":\"65ec7bd1-2de6-49fa-b259-ba74bc721c78\",
\"ForecastConfigurationColumnValue\":0.0,
\"IsRolledUpColumnUpdate\":false},{
\" HierarchyEntityRecordId\":\"11141300-131b-493a-9857-22bd8689b775\",
\"ForecastConfigurationColumnId\":\"65ec7bd1-2de6-49fa-b259-ba74bc721c78\",
\"ForecastConfigurationColumnValue\":0.0,
\"IsRolledUpColumnUpdate\":false}]}"
}
| Pengaturan | Nama | Description |
|---|---|---|
| WebApiName | String | Nama API |
| ForecastConfigurationId | GUID | ID Konfigurasi Perkiraan |
| ForecastRecurranceId | GUID | Id Perkiraan Pengulangan atau Id Periode Perkiraan Daftar SimpleColumnUpdateRequests adalah array |
| HierarkiEntitasRecordId | GUID | EntityRecordId |
| ForecastConfigurationColumnId | GUID | ID Kolom Konfigurasi Perkiraan |
| ForecastConfigurationColumnValue | Tipe Data ForecastConfigurationColumn | Nilai yang perlu diperbarui ke |
| IsRolledUpColumnUpdate(opsional) | Boolean |
True Jika nilai diperbarui untuk kolom yang digabungkan, False jika nilainya adalah Perbarui untuk kolom agregat |
Jawaban
{
"@odata.context": "[Organization URI]/api/data/v9.1/$metadata#Microsoft.Dynamics.CRM.msdyn_ForecastApiResponse",
"response": [
{
"Message": "Update Successful",
"StatusCode": 0,
"HierarchyEntityRecordId": "d8680b00-fd31-46c2-8136-7c4df19cf2a8",
"ForecastConfigurationColumnId": "65ec7bd1-2de6-49fa-b259-ba74bc721c78"
},
{
"Message": "Update Successful",
"StatusCode": 0,
"HierarchyEntityRecordId": "11141300-131b-493a-9857-22bd8689b775",
"ForecastConfigurationColumnId": "65ec7bd1-2de6-49fa-b259-ba74bc721c78"
}
]
}
Mengembalikan nilai
Daftar UpdateSimpleColumnByEntityResponse catatan yang terdiri dari HierarchyEntityRecordId, ForecastConfigurationColumnId, , Message. StatusCode
Update_SimpleColumnByFIId
Memperbarui nilai kolom tertentu dengan mengatur nilai parameter yang dilewati.
Nota
Sejumlah besar permintaan pembaruan dalam satu panggilan API dapat merusak performa, sehingga pembaruan per permintaan dibatasi hingga 50.
Example
POST [Organization URI]/api/data/v9.1/msdyn_ForecastApi HTTP/1.1
content-type: application/json
{
"WebApiName": "Update_SimpleColumnByFIId",
"RequestJson": "
{
\"ForecastConfigurationId\":\"0461fb6b-8d85-ea11-a811-000d3a37bb2c\",
\"ForecastRecurranceId\":\"f8b1122c-b913-4e88-9727-368b6134be3e\",
\"SimpleColumnUpdateRequests\":[
{
\"ForecastInstanceId\":\"d8680b00-fd31-46c2-8136-7c4df19cf2a8\",
\"ForecastConfigurationColumnId\":\"65ec7bd1-2de6-49fa-b259-ba74bc721c78\",
\"ForecastConfigurationColumnValue\":0.0,
\"IsRolledUpColumnUpdate\":false},
{
\"ForecastInstanceId\":\"11141300-131b-493a-9857-22bd8689b775\",
\"ForecastConfigurationColumnId\":\"65ec7bd1-2de6-49fa-b259-ba74bc721c78\",
\"ForecastConfigurationColumnValue\":0.0,
\"IsRolledUpColumnUpdate\":false}]}"
}
| Pengaturan | Tipe | Description |
|---|---|---|
| WebApiName | String | Nama API |
| ForecastConfigurationId | GUID | ID Konfigurasi Perkiraan |
| ForecastRecurranceId | Panduan | Id Perkiraan Pengulangan atau Id Periode Perkiraan |
| SimpleColumnUpdateRequests | Array | Termasuk yang berikut ini |
| ForecastInstanceId | GUID | ID Instans Perkiraan |
| ForecastConfigurationColumnId | GUID | ID Kolom Konfigurasi Perkiraan |
| ForecastConfigurationColumnValue | Tipe Data ForecastConfigurationColumn | Nilai yang perlu diperbarui ke |
| IsRolledUpColumnUpdate(opsional) | Boolean |
True Jika nilai diperbarui untuk kolom yang digabungkan, false jika nilainya adalah Perbarui untuk kolom agregat |
Jawaban
{
"@odata.context": "[Organization URI]/api/data/v9.1/$metadata#Microsoft.Dynamics.CRM.msdyn_ForecastApiResponse",
"response": [
{
"Message": "Update Successful",
"StatusCode": 0,
"ForecastInstanceId": "d8680b00-fd31-46c2-8136-7c4df19cf2a8",
"ForecastConfigurationColumnId": "65ec7bd1-2de6-49fa-b259-ba74bc721c78"
},
{
"Message": "Update Successful",
"StatusCode": 0,
"ForecastInstanceId": "11141300-131b-493a-9857-22bd8689b775",
"ForecastConfigurationColumnId": "65ec7bd1-2de6-49fa-b259-ba74bc721c78"
}
]
}
Mengembalikan nilai
Daftar UpdateSimpleColumnByEntityResponse catatan yang terdiri dari ForecastInstanceId, ForecastConfigurationColumnId, , Message. StatusCode
GET_ParticipatingRecordsFetchxml
Mengembalikan XML pengambilan untuk mengambil rekaman yang mendasarinya dalam perkiraan.
Example
POST /api/GET_ParticipatingRecordsFetchxml HTTP/1.1
Host: your-api-endpoint.com
Content-Type: application/json
{
"ForecastConfigurationId": "a01f86da-1b45-ef11-bfe2-6045bd066f80",
"ForecastPeriodId": "a51f86da-1b45-ef11-bfe2-6045bd066f80",
"HierarchyRecordId": "697adf08-df43-ef11-bfe2-6045bd07ea28",
"ForecastInstanceId": "69169046-520b-4040-abfa-2981a2f0aee3",
"ForecastConfigurationColumnId": "f06490f5-6c27-453c-b06c-0194819202a4",
"RecordViewId": "bf649add-6c30-ea11-a813-000d3a5475f7",
"IsRolledUpNodeRequested": "true"
}
| Pengaturan | Tipe | Description |
|---|---|---|
| ForecastConfigurationId | GUID | ID konfigurasi perkiraan |
| ForecastPeriodId | GUID | ID Periode Perkiraan |
| HierarkiRecordId | GUID | ID rekaman di Dataverse yang rekaman yang mendasarinya harus diambil. Misalnya, ID pengguna sistem dalam kasus Prakiraan Bagan Organisasi, atau ID wilayah dalam kasus Prakiraan Wilayah. |
| ForecastInstanceId | GUID | ID instans perkiraan |
| ForecastConfigurationColumnId | GUID | ID kolom perkiraan yang perlu diambil. Misalnya, jika Anda hanya ingin mengambil rekaman yang berpartisipasi untuk kolom Kasus Terbaik dari perkiraan Anda, masukkan ID kolom Kasus Terbaik . Anda hanya dapat memasukkan satu ID kolom untuk setiap permintaan. Untuk mengambil lebih banyak kolom, Anda harus mengirim permintaan untuk setiap kolom. Lewati parameter ini jika Anda ingin mengambil XML untuk semua kolom perkiraan. Anda bisa mendapatkan ID kolom dari definisi Konfigurasi Perkiraan . |
| RekamViewId | GUID | ID tampilan rekaman dari rekaman yang mendasarinya. Pelajari selengkapnya tentang mendapatkan ID tampilan di savedquery EntityType |
| IsRolledUpNodeRequested | Boolean | Menentukan apakah akan mengembalikan nilai untuk simpul yang digulung (grup) atau simpul individu. Jika diatur ke true, semua rekaman di bawah simpul grup akan dikembalikan. Jika diatur ke false, hanya catatan individu yang dikembalikan. |
Jawaban
{
"@odata.context": "https://orgname.dynamics.com/api/data/v9.0/$metadata#Microsoft.Dynamics.CRM.msdyn_ForecastApiResponse",
"response": "<fetch version=\"1.0\" mapping=\"logical\" distinct=\"true\"><entity name=\"opportunity\"><filter type=\"and\"><condition attribute=\"estimatedclosedate\" operator=\"between\"><value>2024-07-01T00:00:00.0000000Z</value><value>2024-09-30T23:59:59.0000000Z</value></condition><condition attribute=\"msdyn_forecastcategory\" operator=\"eq\" value=\"100000001\" /></filter><link-entity name=\"systemuser\" from=\"systemuserid\" to=\"ownerid\" link-type=\"inner\"><attribute name=\"systemuserid\" /><filter type=\"and\"><condition attribute=\"systemuserid\" operator=\"eq-or-under\" value=\"697adf08-df43-ef11-bfe2-6045bd07ea28\" /></filter></link-entity><attribute name=\"name\" /><attribute name=\"statuscode\" /><attribute name=\"statecode\" /><attribute name=\"customerid\" /><attribute name=\"ownerid\" /><attribute name=\"msdyn_forecastcategory\" /><attribute name=\"estimatedvalue\" /><attribute name=\"estimatedclosedate\" /><attribute name=\"actualvalue\" /><attribute name=\"actualclosedate\" /><attribute name=\"opportunityid\" /><order attribute=\"name\" descending=\"false\" /></entity></fetch>"
}
Mengembalikan nilai
Kueri XML pengambilan yang mengembalikan rekaman yang mendasarinya dalam perkiraan.