Not
Bu sayfaya erişim yetkilendirme gerektiriyor. Oturum açmayı veya dizinleri değiştirmeyi deneyebilirsiniz.
Bu sayfaya erişim yetkilendirme gerektiriyor. Dizinleri değiştirmeyi deneyebilirsiniz.
Bir geliştirici olarak, tahmin verilerini almak ve güncelleştirmek için özel eylemi kullanmak msdyn_ForecastApi üzere bu başvuru belgelerini okuyun. Bu eylemi, zaman zaman tahmin verilerini anlık görüntü olarak depolamak için de kullanabilirsiniz. Ardından, zaman içindeki tahmin verilerini karşılaştırmak için anlık görüntüyü kullanabilirsiniz. Özel eylemi kullanmaya başlamak için tahmin API'simsdyn_ForecastApi örnek kodunu kullanın.
Parametreler
| Parametre adı | Gerekli | Description |
|---|---|---|
WebApiName |
Yes | Yürütülecek API'nin adını içerir. |
RequestJson |
Yes | API çağrısı için parametreleri ve bağımsız değişkenleri içerir. |
API'lerin listesi
Aşağıda, özel eylemi kullanarak msdyn_ForecastApi çağırabileceğiniz API'ler kümesi verilmiştir.
GET_ForecastConfigurations
Yapılandırılan tüm tahmin yapılandırmalarının listesini döndürür.
Example
POST [Organization URI]/api/data/v9.1/msdyn_ForecastApi/ HTTP/1.1
Content-Type: application/json
{
"WebApiName": "GET_ForecastConfigurations",
"RequestJson": "{}"
}
| Parametre | Türü | Description |
|---|---|---|
WebApiName |
String | API'nin adı |
RequestJson |
String | Serileştirilmiş JSON nesnesi |
Yanıt
{
"@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"
}
]
}
Dönüş değeri
Tahmin yapılandırmalarının listesi.
GET_ForecastConfigurationsByName
İstek yükünün bir parçası olarak sağlanan ada sahip tüm tahmin yapılandırmalarını döndürür.
Example
POST [Organization URI]/api/data/v9.1/msdyn_ForecastApi HTTP/1.1
Content-Type: application/json
{
"WebApiName": "GET_ForecastConfigurationsByName",
"RequestJson": "{\"Name\":\"api_test1\"}"
}
| Parametre | Türü | Description |
|---|---|---|
WebApiName |
String | API'nin adı |
RequestJson |
JSON nesnesi | Şunlardan Nameoluşur: tahmin yapılandırmasının adı |
Yanıt
{
"@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"
}
]
}
Dönüş değeri
Tahmin yapılandırmalarının listesi.
GET_ForecastPeriodsByForecastConfigurationId
İstek yükünün bir parçası olarak sağlanan etkin tahmin yapılandırma kimliği için tüm tahmin dönemlerini döndürür.
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\"
}"
}
| Parametre | Türü | Description |
|---|---|---|
WebApiName |
String | API'nin adı |
RequestJson |
JSON Nesnesi | İçindekiler ForecastConfigurationId: Tahmin Yapılandırma Kimliği |
Yanıt
{
"@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
}
]
}
Dönüş değeri
Tahmin dönemlerinin listesi.
GET_ForecastInstances
Tek satırlı bir varlık kaydı olan tahmin örneklerinin listesini döndürür.
Uyarı
Tahmin dönemleri birçok tahmin örneğine sahip olabilir. Tek bir istekte indirmek isteyeceğinizden çok daha fazlası. API uç noktaları varsayılan olarak istek başına sınırlı sayıda öğe sağlar.
Not: Büyük sorgular performansa zarar verebilir, bu nedenle sayfa başına sonuç sayısı 4000 kayıtla sınırlıdır. 4000'den fazla kayıt almak istiyorsanız, örneğin mevcut tüm tahmin örneklerinin istemci tarafı bir listesini oluşturmak istiyorsanız, birden çok API isteğinde bulunabilir ve sonuçları uygulamanızda birleştirebilirsiniz.
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"}"
}
| Parametre | Türü | Description |
|---|---|---|
WebApiName |
String | API'nin adı |
RequestJson |
JSON nesnesi | OluşurForecastPeriodId: Tahmin döneminin benzersiz tanımlayıcısıForecastConfigurationId: Tahmin yapılandırmasının benzersiz tanımlayıcısıSortingAttribute: Sayfalamada Sıralama yapmak istediğiniz öznitelikSortingOrder: Artan düzen için ASC Azalan düzen için DSCPageSize: Tek bir sayfada almak istediğiniz kayıt sayısıPageNo: Hangi sayfa kayıtlarını getirmek istediğiniz.GetParticipatingRecordsFetchXml: Yanıtta katılımcı kayıtların XML'yi getirmesi gerekip gerekmediğini belirten bayrak.ParticipatingRecordsViewId: Doğru olduğunda GetParticipatingRecordsFetchXml bu gereklidir. Bu, katılımcı kayıt getirme XML'inin oluşturulduğu kaydedilmiş bir sorgu (görünüm) kimliğidir. |
Aşağıda nesne için RequestJson örnek JSON verilmiştir.
{
"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\"}"
}
Yanıt
{
"@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"
}
}
Dönüş değeri
Tahmin Örneklerinin Listesi.
Update_SimpleColumnByEntityId
İletilen parametrelerin değerlerini kullanarak belirli sütun değerlerini güncelleştirir.
Uyarı
Tek bir API çağrısında çok sayıda güncelleştirme isteği performansa zarar verebilir, bu nedenle istek başına güncelleştirme sayısı 50 ile sınırlıdır.
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}]}"
}
| Parametre | İsim | Description |
|---|---|---|
| WebApiAdı | String | API'nin adı |
| ForecastConfigurationId | GUID | Tahmin Yapılandırma Kimliği |
| ForecastRecurranceId | GUID | Forecast Recurrance Id (Tahmin Yinelenme Kimliği) veya Forecast Period Id (Tahmin Dönemi Kimliği) Bir liste bir dizidir SimpleColumnUpdateRequests |
| HierarchyEntityRecordId | GUID | EntityRecordId |
| ForecastConfigurationColumnId | GUID | Tahmin Yapılandırması Sütun Kimliği |
| ForecastConfigurationColumnValue | ForecastConfigurationColumn veri türü | Güncellenmesi gereken değer |
| IsRolledUpColumnUpdate(isteğe bağlı) | Boolean |
True Toplanan sütun için değer güncelleştirilmişse, False değer Toplama sütunu için güncelleştir ise |
Yanıt
{
"@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"
}
]
}
Dönüş değeri
, UpdateSimpleColumnByEntityResponse, , HierarchyEntityRecordIdForecastConfigurationColumnId'den MessageStatusCodeoluşan bir kayıt listesi.
Update_SimpleColumnByFIId
İletilen parametrelerin değerlerini ayarlayarak belirli sütun değerini güncelleştirir.
Uyarı
Tek bir API çağrısında çok sayıda güncelleştirme isteği performansa zarar verebilir, bu nedenle istek başına güncelleştirme sayısı 50 ile sınırlıdır.
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}]}"
}
| Parametre | Türü | Description |
|---|---|---|
| WebApiAdı | String | API'nin adı |
| ForecastConfigurationId | GUID | Tahmin Yapılandırma Kimliği |
| ForecastRecurranceId | Kılavuz | Tahmin Yineleme Kimliği veya Tahmin Dönemi Kimliği |
| SimpleColumnUpdateRequests | Array | Aşağıdakileri içerir |
| ForecastInstanceId (TahminInstanceId) | GUID | Tahmin örneği kimliği |
| ForecastConfigurationColumnId | GUID | Tahmin Yapılandırması Sütun Kimliği |
| ForecastConfigurationColumnValue | ForecastConfigurationColumn veri türü | Güncellenmesi gereken değer |
| IsRolledUpColumnUpdate(isteğe bağlı) | Boolean |
True Toplanan sütun için değer güncelleştirilmişse, false değer Toplama sütunu için güncelleştir ise |
Yanıt
{
"@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"
}
]
}
Dönüş değeri
, UpdateSimpleColumnByEntityResponse, , ForecastInstanceIdForecastConfigurationColumnId'den MessageStatusCodeoluşan bir kayıt listesi.
GET_ParticipatingRecordsFetchxml
Bir tahmindeki temel kayıtları almak için getirme XML'ini döndürür.
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"
}
| Parametre | Türü | Description |
|---|---|---|
| ForecastConfigurationId | GUID | Tahmin yapılandırma kimliği |
| ForecastPeriodId | GUID | Tahmin Dönemi Kimliği |
| HierarchyRecordId | GUID | Dataverse'te temel alınan kaydın alınması gereken kayıt kimliği. Örneğin, Organizasyon Şeması Tahmini durumunda sistem kullanıcı kimliği veya Bölge Tahmini durumunda bölge kimliği. |
| ForecastInstanceId (TahminInstanceId) | GUID | Tahmin örneği kimliği |
| ForecastConfigurationColumnId | GUID | Alınması gereken tahmin sütununun kimliği. Örneğin, tahmininizin En İyi Durum sütunu için yalnızca katılan kayıtları getirmek istediğinizde, En İyi Durum sütununun sütun kimliğini girin. Her istek için yalnızca bir sütun kimliği girebilirsiniz. Daha fazla sütun almak için her sütun için bir istek göndermeniz gerekir. Tahminin tüm sütunları için XML getirmek istiyorsanız bu parametreyi atlayın. Sütun kimliğini Tahmin Yapılandırması tanımından alabilirsiniz. |
| RecordViewId (KayıtGörüntüleme Kimliği) | GUID | Temel alınan kayıtların kayıt görünümü kimliği. savedquery EntityType'ta görünüm kimliğini alma hakkında daha fazla bilgi edinin |
| IsRolledUpNodeRequested | Boolean | Toplanan düğüm (grup) için mi yoksa tek bir düğüm için mi değerlerin döndürüleceğini belirtir. Doğru olarak ayarlanırsa, grup düğümü altındaki tüm kayıtlar döndürülür. false olarak ayarlanırsa, yalnızca kişinin kaydı döndürülür. |
Yanıt
{
"@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>"
}
Dönüş değeri
Bir tahmindeki temel kayıtları döndüren bir getirme XML sorgusu.