Updates

Author: KumarVivek

powerapps-docs/developer/common-data-service/reference/entities/entitydatasource.md

@@ -0,0 +1,367 @@
+---
+title: "EntityDataSource table reference (Common Data Service)| MicrosoftDocs"
+description: "Includes schema information and supported messages for the EntityDataSource table."
+ms.date: 11/07/2020
+ms.service: "powerapps"
+ms.topic: "reference"
+ms.assetid: 3948cc48-07c8-7f60-0608-71c37158ad7c
+author: "KumarVivek"
+ms.author: "kvivek"
+search.audienceType: 
+  - developer
+search.app: 
+  - PowerApps
+
+---
+# EntityDataSource table reference
+
+Internal entity that stores data source information for all installed providers.
+
+
+## Messages
+
+|Message|Web API Operation|SDK Assembly|
+|-|-|-|
+|Create|POST [*org URI*]/api/data/v9.0/entitydatasources<br />See [Create](/powerapps/developer/common-data-service/webapi/create-entity-web-api)|<xref:Microsoft.Xrm.Sdk.Messages.CreateRequest> or <br /><xref:Microsoft.Xrm.Sdk.IOrganizationService.Create*>|
+|Delete|DELETE [*org URI*]/api/data/v9.0/entitydatasources(*entitydatasourceid*)<br />See [Delete](/powerapps/developer/common-data-service/webapi/update-delete-entities-using-web-api#basic-delete)|<xref:Microsoft.Xrm.Sdk.Messages.DeleteRequest> or <br /><xref:Microsoft.Xrm.Sdk.IOrganizationService.Delete*>|
+|Retrieve|GET [*org URI*]/api/data/v9.0/entitydatasources(*entitydatasourceid*)<br />See [Retrieve](/powerapps/developer/common-data-service/webapi/retrieve-entity-using-web-api)|<xref:Microsoft.Xrm.Sdk.Messages.RetrieveRequest> or <br /><xref:Microsoft.Xrm.Sdk.IOrganizationService.Retrieve*>|
+|RetrieveMultiple|GET [*org URI*]/api/data/v9.0/entitydatasources<br />See [Query Data](/powerapps/developer/common-data-service/webapi/query-data-web-api)|<xref:Microsoft.Xrm.Sdk.Messages.RetrieveMultipleRequest> or <br /><xref:Microsoft.Xrm.Sdk.IOrganizationService.RetrieveMultiple*>|
+|Update|PATCH [*org URI*]/api/data/v9.0/entitydatasources(*entitydatasourceid*)<br />See [Update](/powerapps/developer/common-data-service/webapi/update-delete-entities-using-web-api#basic-update)|<xref:Microsoft.Xrm.Sdk.Messages.UpdateRequest> or <br /><xref:Microsoft.Xrm.Sdk.IOrganizationService.Update*>|
+
+## Table Properties
+
+|Property|Value|
+|--------|-----|
+|CollectionSchemaName|EntityDataSources|
+|DisplayCollectionName|Virtual Entity Data Sources|
+|DisplayName|Virtual Entity Data Source|
+|EntitySetName|entitydatasources|
+|IsBPFEntity|False|
+|LogicalCollectionName|entitydatasources|
+|LogicalName|entitydatasource|
+|OwnershipType|OrganizationOwned|
+|PrimaryIdAttribute|entitydatasourceid|
+|PrimaryNameAttribute|name|
+|SchemaName|EntityDataSource|
+
+<a name="writable-attributes"></a>
+
+## Writable columns
+
+These Columns (attributes) return true for either **IsValidForCreate** or **IsValidForUpdate** (usually both). Listed by **SchemaName**.
+
+- [ConnectionDefinition](#BKMK_ConnectionDefinition)
+- [ConnectionDefinitionSecrets](#BKMK_ConnectionDefinitionSecrets)
+- [Description](#BKMK_Description)
+- [EntityDataProviderId](#BKMK_EntityDataProviderId)
+- [EntityDataSourceId](#BKMK_EntityDataSourceId)
+- [EntityName](#BKMK_EntityName)
+- [IntroducedVersion](#BKMK_IntroducedVersion)
+- [IsCustomizable](#BKMK_IsCustomizable)
+- [Name](#BKMK_Name)
+
+
+### <a name="BKMK_ConnectionDefinition"></a> ConnectionDefinition
+
+|Property|Value|
+|--------|-----|
+|Description|JSON data representing values from a data source entity as individual fields.|
+|DisplayName|Data Source Values|
+|FormatName|Text|
+|IsLocalizable|False|
+|IsValidForForm|False|
+|IsValidForRead|True|
+|LogicalName|connectiondefinition|
+|MaxLength|2000|
+|RequiredLevel|None|
+|Type|String|
+
+
+### <a name="BKMK_ConnectionDefinitionSecrets"></a> ConnectionDefinitionSecrets
+
+|Property|Value|
+|--------|-----|
+|Description|JSON data representing secrets in a data source entity as individual fields.|
+|DisplayName|Data Source Secrets|
+|FormatName|Text|
+|IsLocalizable|False|
+|IsValidForForm|False|
+|IsValidForRead|True|
+|LogicalName|connectiondefinitionsecrets|
+|MaxLength|2000|
+|RequiredLevel|None|
+|Type|String|
+
+
+### <a name="BKMK_Description"></a> Description
+
+|Property|Value|
+|--------|-----|
+|Description|Enter additional information to describe the environment this data source targets and the purpose of this system.|
+|DisplayName|Description|
+|FormatName|Text|
+|IsLocalizable|False|
+|IsValidForForm|True|
+|IsValidForRead|True|
+|LogicalName|description|
+|MaxLength|1000|
+|RequiredLevel|None|
+|Type|String|
+
+
+### <a name="BKMK_EntityDataProviderId"></a> EntityDataProviderId
+
+|Property|Value|
+|--------|-----|
+|Description|Choose the entity dataprovider for the entity datasource.|
+|DisplayName|Entity Provider|
+|IsValidForForm|False|
+|IsValidForRead|True|
+|LogicalName|entitydataproviderid|
+|RequiredLevel|None|
+|Targets|contact|
+|Type|Lookup|
+
+
+### <a name="BKMK_EntityDataSourceId"></a> EntityDataSourceId
+
+|Property|Value|
+|--------|-----|
+|Description|Unique identifier of the Data Source Id|
+|DisplayName|Data Source Id|
+|IsValidForForm|False|
+|IsValidForRead|True|
+|IsValidForUpdate|False|
+|LogicalName|entitydatasourceid|
+|RequiredLevel|SystemRequired|
+|Type|Uniqueidentifier|
+
+
+### <a name="BKMK_EntityName"></a> EntityName
+
+|Property|Value|
+|--------|-----|
+|Description|Entity Logical Name|
+|DisplayName|Entity Logical Name|
+|FormatName|Text|
+|IsLocalizable|False|
+|IsValidForForm|False|
+|IsValidForRead|True|
+|LogicalName|entityname|
+|MaxLength|100|
+|RequiredLevel|None|
+|Type|String|
+
+
+### <a name="BKMK_IntroducedVersion"></a> IntroducedVersion
+
+|Property|Value|
+|--------|-----|
+|Description|Version in which the form is introduced.|
+|DisplayName|Introduced Version|
+|FormatName|VersionNumber|
+|IsLocalizable|False|
+|IsValidForForm|False|
+|IsValidForRead|True|
+|IsValidForUpdate|False|
+|LogicalName|introducedversion|
+|MaxLength|48|
+|RequiredLevel|None|
+|Type|String|
+
+
+### <a name="BKMK_IsCustomizable"></a> IsCustomizable
+
+|Property|Value|
+|--------|-----|
+|Description|Information that specifies whether this component can be customized.|
+|DisplayName|Customizable|
+|IsValidForForm|False|
+|IsValidForRead|True|
+|LogicalName|iscustomizable|
+|RequiredLevel|SystemRequired|
+|Type|ManagedProperty|
+
+
+### <a name="BKMK_Name"></a> Name
+
+|Property|Value|
+|--------|-----|
+|Description|Name of this data source. This name appears in the data source drop-down when creating a new entity.|
+|DisplayName|Name|
+|FormatName|Text|
+|IsLocalizable|False|
+|IsValidForForm|True|
+|IsValidForRead|True|
+|LogicalName|name|
+|MaxLength|256|
+|RequiredLevel|None|
+|Type|String|
+
+<a name="read-only-attributes"></a>
+
+## Read-only columns
+
+These columns (attributes) return false for both **IsValidForCreate** or **IsValidForUpdate**. Listed by **SchemaName**.
+
+- [ComponentState](#BKMK_ComponentState)
+- [EntityDataProviderIdName](#BKMK_EntityDataProviderIdName)
+- [EntityDataSourceIdUnique](#BKMK_EntityDataSourceIdUnique)
+- [IsManaged](#BKMK_IsManaged)
+- [OrganizationId](#BKMK_OrganizationId)
+- [OverwriteTime](#BKMK_OverwriteTime)
+- [SolutionId](#BKMK_SolutionId)
+- [SupportingSolutionId](#BKMK_SupportingSolutionId)
+
+
+### <a name="BKMK_ComponentState"></a> ComponentState
+
+|Property|Value|
+|--------|-----|
+|Description|For internal use only.|
+|DisplayName|Component State|
+|IsValidForForm|False|
+|IsValidForRead|True|
+|LogicalName|componentstate|
+|RequiredLevel|SystemRequired|
+|Type|Picklist|
+
+#### ComponentState Options
+
+|Value|Label|
+|-----|-----|
+|0|Published|
+|1|Unpublished|
+|2|Deleted|
+|3|Deleted Unpublished|
+
+
+
+### <a name="BKMK_EntityDataProviderIdName"></a> EntityDataProviderIdName
+
+|Property|Value|
+|--------|-----|
+|Description||
+|DisplayName|Entity Provider Name|
+|FormatName|Text|
+|IsLocalizable|False|
+|IsValidForForm|False|
+|IsValidForRead|True|
+|LogicalName|entitydataprovideridname|
+|MaxLength|100|
+|RequiredLevel|None|
+|Type|String|
+
+
+### <a name="BKMK_EntityDataSourceIdUnique"></a> EntityDataSourceIdUnique
+
+|Property|Value|
+|--------|-----|
+|Description|For internal use only.|
+|DisplayName|Unique Id|
+|IsValidForForm|False|
+|IsValidForRead|True|
+|LogicalName|entitydatasourceidunique|
+|RequiredLevel|SystemRequired|
+|Type|Uniqueidentifier|
+
+
+### <a name="BKMK_IsManaged"></a> IsManaged
+
+|Property|Value|
+|--------|-----|
+|Description|Indicates whether the solution component is part of a managed solution.|
+|DisplayName|State|
+|IsValidForForm|False|
+|IsValidForRead|True|
+|LogicalName|ismanaged|
+|RequiredLevel|SystemRequired|
+|Type|Boolean|
+
+#### IsManaged Options
+
+|Value|Label|
+|-----|-----|
+|1|Managed|
+|0|Unmanaged|
+
+**DefaultValue**: False
+
+
+
+### <a name="BKMK_OrganizationId"></a> OrganizationId
+
+|Property|Value|
+|--------|-----|
+|Description|Unique identifier for the organization.|
+|DisplayName|Organization Id|
+|IsValidForForm|False|
+|IsValidForRead|True|
+|LogicalName|organizationid|
+|RequiredLevel|SystemRequired|
+|Type|Uniqueidentifier|
+
+
+### <a name="BKMK_OverwriteTime"></a> OverwriteTime
+
+|Property|Value|
+|--------|-----|
+|DateTimeBehavior|UserLocal|
+|Description|For internal use only.|
+|DisplayName|Record Overwrite Time|
+|Format|DateOnly|
+|IsValidForForm|False|
+|IsValidForRead|True|
+|LogicalName|overwritetime|
+|RequiredLevel|SystemRequired|
+|Type|DateTime|
+
+
+### <a name="BKMK_SolutionId"></a> SolutionId
+
+|Property|Value|
+|--------|-----|
+|Description|Unique identifier of the associated solution.|
+|DisplayName|Solution|
+|IsValidForForm|False|
+|IsValidForRead|True|
+|LogicalName|solutionid|
+|RequiredLevel|SystemRequired|
+|Type|Uniqueidentifier|
+
+
+### <a name="BKMK_SupportingSolutionId"></a> SupportingSolutionId
+
+|Property|Value|
+|--------|-----|
+|Description|For internal use only.|
+|DisplayName|Solution|
+|IsValidForForm|False|
+|IsValidForRead|False|
+|LogicalName|supportingsolutionid|
+|RequiredLevel|None|
+|Type|Uniqueidentifier|
+
+<a name="manytoone"></a>
+
+## Many-To-One Relationships
+
+Each Many-To-One relationship is defined by a corresponding One-To-Many relationship with the related entity. Listed by **SchemaName**.
+
+- [entitydataprovider_datasource](#BKMK_entitydataprovider_datasource)
+- organization_entitydatasource
+
+
+### <a name="BKMK_entitydataprovider_datasource"></a> entitydataprovider_datasource
+
+See entitydataprovider Entity entitydataprovider_datasource One-To-Many relationship.
+
+### <a name="BKMK_organization_entitydatasource"></a> organization_entitydatasource
+
+See organization Entity organization_entitydatasource One-To-Many relationship.
+
+### See also
+
+[About the Entity Reference](../about-entity-reference.md)<br />
+[Web API Reference](/dynamics365/customer-engagement/web-api/about)<br />
+<xref href="Microsoft.Dynamics.CRM.entitydatasource?text=entitydatasource EntityType" />