IntegArtifactDef

Represents a custom flow connector that you can use to extend flows to an external service.

Parent Type 

This type extends Metadata and inherits its fields.

File Suffix and Directory Location 

IntegArtifactDef components have the suffix .integArtifactDef and are stored in the integArtifactDefs folder.

Version 

Introduced in API version 66.0.

Special Access Rules 

Only users with the CustomConnectors permission can access this metadata type.

Fields 

description 

  • Type: string
  • Required: Yes
  • Description: Required. The detailed text description of the integration artifact’s overall purpose and functionality.

displayName 

  • Type: string
  • Required: Yes
  • Description: Required. The name of the integration artifact.

groupId 

  • Type: string
  • Required: Yes
  • Description: Required. The identifier that groups related integration artifacts.

iconName 

  • Type: string
  • Required: No
  • Description: The name of the icon for the integration artifact.

isGlobal 

  • Type: boolean
  • Required: No
  • Description: Indicates whether the integration artifact is global. A value of true indicates that the artifact is global. A value of false indicates that the artifact isn’t global.

Declarative Metadata Sample Definition 

This XML is an example of an IntegArtifactDef component.

1<?xml version="1.0" encoding="UTF-8"?>
2<IntegArtifactDef xmlns="http://soap.sforce.com/2006/04/metadata">
3    <description>Connects Salesforce Flow to MySystem</description>
4    <displayName>My Connector</displayName>
5    <groupId>com.example.myconnector</groupId>
6    <iconName>MyConnectorIcon</iconName>
7    <isGlobal>true</isGlobal>
8</IntegArtifactDef>

Don’t add a element to the metadata. Salesforce derives the connector’s developer name from the folder name under integArtifactDefs.

Note

This XML is an example package.xml file that references the previous definition.

1<?xml version="1.0" encoding="UTF-8"?>
2<Package xmlns="http://soap.sforce.com/2006/04/metadata">
3    <types>
4        <members>*</members>
5        <name>IntegArtifactDef</name>
6    </types>
7    <version>68.0</version>
8</Package>

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.