--- schema_version: "1" id: 4b25268e4d6b1f20f5b440bbe03c3f26679f93cdeec32f810c64f5e7bc126e10 title: DataConnector collection: legacydeveloper version: current locale: en-us portal_url: https://docs.salesforce.com/legacydeveloper/current/en-us/api_meta/meta_dataconnector.md canonical_url: https://developer.salesforce.com/docs/atlas.en-us.api_meta.meta/api_meta/meta_dataconnector.htm source_site: developer.salesforce.com content_type: documentation content_hash: 6fab73c1cdc94ec63341b4e0c7cbb157c4f415806cd6475e274bf73ad63914b9 description: Represents the white-labeled metadata configuration for an external connector in Data 360. --- # DataConnector Represents the white-labeled metadata configuration for an external connector in Data 360. ![Important](https://developer.salesforce.com/docs/atlas.en-us.api_meta.meta/api_meta/images/icon_note_important.png) #### Important Where possible, we changed noninclusive terms to align with our company value of Equality. We maintained certain terms to avoid any effect on customer implementations. ## Parent Type This type extends the [Metadata](https://developer.salesforce.com/docs/atlas.en-us.api_meta.meta/api_meta/metadata.htm "The base class for all metadata types. You can’t edit this object. A component is an instance of a metadata type.") metadata type and inherits its fullName field. ## File Suffix and Directory Location DataConnector components have the suffix .dataconnector and are stored in the dataconnectors folder. ## Version DataConnector components are available in API version 64.0 and later. ## Special Access Rules There are no additional access requirements that are specific to this type. ## Fields | Field Name | Description | | --- | --- | | attributes | Field Type [DataConnectorAttribute\[\]](#DataConnectorAttribute) Description A list of configurable attributes for the data connector. | | description | Field Type string Description Required. The description of the data connector. | | errors | Field Type [DataConnectorError\[\]](#DataConnectorError) Description A list of error messages or codes related to the connector’s behavior or configuration validation. | | features | Field Type DataConnectorFeature\[\] (enumeration of type string) Description A list of features supported by the data connector. Values are: Override | | icon | Field Type string Description A static resource in SVG format with dimensions of 100x100 pixels and a file size not exceeding 100 KB. | | licenseAgreement | Field Type string Description Text of the license agreement associated with the data connector. | | masterLabel | Field Type string Description Required. The display label of the connector used in user interface (UI). | | ownerLocation | Field Type string Description A description or URL that specifies where the connector is maintained or hosted. | | ownerLogo | Field Type string Description A static resource in SVG format with dimensions of 100x100 pixels and a file size not exceeding 100 KB. | | ownerName | Field Type string Description The name of the organization that owns the connector. | | parentConnector | Field Type string Description The API name of the connector. For example, AwsS3, SNOWFLAKE, ICEBERG, and so on. | | releaseLevel | Field Type DataConnectorReleaseLevel (enumeration of type string) Description Required. Indicates the connector’s lifecycle stage. Values are: - BETA - GA - IN\_DEV - PILOT | | supportEmail | Field Type string Description The support email address users can contact for help with the connector. | | supportMessage | Field Type string Description A support-related message or instruction displayed. | | supportPhone | Field Type string Description The support phone number users can call for help with the connector. | | translations | Field Type LocalizedValue\[\] Description A list of localized labels and descriptions to support multiple languages in the UI. | ## DataConnectorAttribute | Field Name | Description | | --- | --- | | capabilities | Field Type DataConnectorCapability\[\] (enumeration of type string) Description A list of supported capabilities for the data connector. Values are: - DataIn - DataInDelete - DataInHeader - DataInIncremental - DataInSelector - DataInStructured - DataInUnstructured - DataOut - Hidden - UniqueGroup - ZeroCopyIn | | command | Field Type string Description The command string executed during data operations, such as import or sync. | | commandAttributes | Field Type string Description A list of attributes passed with the command. | | dataType | Field Type DataConnectorDataType (enumeration of type string) Description Required. Specifies the type of data input expected. Values are: - CHECKBOX - COMBOBOX - DATE - DATETIME - EMAIL - IDP - NAMED\_CREDENTIAL - NUMBER - PASSWORD - PASSWORD\_FILE - PRIVATE\_NETWORK\_ROUTE - RADIO - RADIO\_BUTTONS - TEXT - TEXTAREA - TIME - TOGGLE | | defaultValue | Field Type string Description The default value assigned to the field if no user input is provided. | | editable | Field Type boolean Description Indicates whether the field value can be modified by the user. | | externalName | Field Type string Description Required. The unique name used to reference the connector externally, such as in API calls. | | masterLabel | Field Type string Description Required. The label used for display in the UI. | | max | Field Type string Description The maximum allowable value or length for the field. | | min | Field Type string Description The minimum allowable value or length for the field. | | options | Field Type [DataConnectorAttributeOpt\[\]](#DataConnectorAttributeOpt) Description A list of selectable options available for the field. | | order | Field Type int Description Required. The display order or evaluation order of the field. | | pattern | Field Type string Description The validation pattern used to ensure input follows a defined format. | | placeholder | Field Type string Description The placeholder text displayed in the input field when empty. | | readonly | Field Type boolean Description Indicates whether the field is read-only. | | required | Field Type boolean Description Indicates whether the field must have a value. | | secure | Field Type boolean Description Indicates whether the field contains sensitive data and should be masked. | | tooltip | Field Type string Description The tooltip text shown to users for additional guidance. | | translations | Field Type LocalizedValue\[\] Description A list of localized labels and descriptions for use in different languages. | | validationMessageError | Field Type string Description The error message shown when input validation fails for this field. | ## DataConnectorAttributeOpt | Field Name | Description | | --- | --- | | capabilities | Field Type DataConnectorCapability\[\] (enumeration of type string) Description A list of capabilities supported by the data connector. Values are: - DataIn - DataInDelete - DataInHeader - DataInIncremental - DataInSelector - DataInStructured - DataInUnstructured - DataOut - Hidden - UniqueGroup - ZeroCopyIn | | conditionAttributes | Field Type string Description A list of attributes used to define conditions in the connector configuration. | | externalName | Field Type string Description Required. The unique name used to reference the connector externally, such as in API calls. | | masterLabel | Field Type string Description Required. The display label for the connector used in the UI. | | order | Field Type int Description Required. The order or priority of the connector in processing context. | | translations | Field Type LocalizedValue\[\] Description A list of localized labels and descriptions for use in different languages. | ## DataConnectorError | Field Name | Description | | --- | --- | | externalName | Field Type string Description Required. The unique name used to reference the object externally, such as in API calls. Must be unique across the namespace. | | masterLabel | Field Type string Description Required. The label displayed in the UI. | | translations | Field Type LocalizedValue\[\] Description A list of localized labels and descriptions for use in different languages. | ## Declarative Metadata Sample Definition The following is an example of a DataConnector component. Iceberg Override Salesforce ICEBERG BETA Connect to Apache Iceberg tables Override Slack Salesforce Settle, USA Click download logs before reachout +15788467513 https://www.salesforce.com/company/legal IcebergOverride\_storageSourceType storageSourceType Storage Type COMBOBOX CATALOG\_PROVIDED DataIn Hidden 20 true true true The following is an example package.xml that references the previous definition. \* DataConnector \* StaticResource 64.0 ## Wildcard Support in the Manifest File This metadata type supports the wildcard character \* (asterisk) in the package.xml manifest file. For information about using the manifest file, see [Deploying and Retrieving Metadata with the Zip File](https://developer.salesforce.com/docs/atlas.en-us.api_meta.meta/api_meta/file_based_zip_file.htm "The deploy() and retrieve() calls are used to deploy and retrieve a .zip file. Within the .zip file is a project manifest (package.xml) that lists what to retrieve or deploy, and one or more XML components that are organized into folders.").