Skip to content

forcedotcom/sf-skills / plugins/builder/integration/skills/integration-connectivity-generate

integration-connectivity-generate

Verified

Salesforce integration architecture and runtime plumbing with 120-point scoring. Use this skill to set up Named Credentials, External Credentials, External Services, REST/SOAP callout patterns, Platform Events, and Change Data Capture. TRIGGER when: user sets up Named Credentials, External Services, REST/SOAP callouts, Platform Events, CDC, or touches .namedCredential-meta.xml files. DO NOT TRIGGER when: Connected App/OAuth config (use integration-connectivity-connected-app-configure), Apex-only logic (use platform-apex-generate), data import/export (use platform-data-manage), or CDC channel-membership metadata such as PlatformEventChannel, PlatformEventChannelMember, or EnrichedField (use integration-eventing-cdc-configure).

FileKindSize
README.mdmarkdown3.5 KB
SKILL.mdskill md8.8 KB
assets/callouts/callout-retry-handler.clsother6.0 KB
assets/callouts/http-response-handler.clsother8.5 KB
assets/callouts/rest-queueable-callout.clsother8.8 KB
assets/callouts/rest-sync-callout.clsother7.4 KB
assets/cdc/cdc-handler.clsother8.4 KB
assets/cdc/cdc-subscriber-trigger.triggerother5.3 KB
assets/endpoint-security/example.cspTrustedSite-meta.xmlconfig1.8 KB
assets/endpoint-security/example.remoteSite-meta.xmlconfig1.3 KB
assets/external-credentials/jwt-external-credential.externalCredential-meta.xmlconfig3.2 KB
assets/external-credentials/oauth-external-credential.externalCredential-meta.xmlconfig3.0 KB
assets/external-services/external-service-operations.mdmarkdown5.5 KB
assets/external-services/openapi-registration.externalServiceRegistration-meta.xmlconfig4.8 KB
assets/named-credentials/certificate-auth.namedCredential-meta.xmlconfig2.2 KB
assets/named-credentials/custom-auth.namedCredential-meta.xmlconfig2.2 KB
assets/named-credentials/oauth-client-credentials.namedCredential-meta.xmlconfig1.8 KB
assets/named-credentials/oauth-jwt-bearer.namedCredential-meta.xmlconfig2.2 KB
assets/platform-events/event-publisher.clsother6.4 KB
assets/platform-events/event-subscriber-action.clsother9.5 KB
assets/platform-events/event-subscriber-trigger.triggerother3.9 KB
assets/platform-events/platform-event-definition.object-meta.xmlconfig3.7 KB
assets/soap/soap-callout-service.clsother6.4 KB
assets/soap/wsdl2apex-guide.mdmarkdown6.2 KB
references/callout-patterns.mdmarkdown21.8 KB
references/cdc-guide.mdmarkdown8.2 KB
references/cli-reference.mdmarkdown2.9 KB
references/event-driven-architecture-guide.mdmarkdown10.1 KB
references/event-patterns.mdmarkdown27.2 KB
references/external-services-guide.mdmarkdown8.4 KB
references/messaging-api-v2.mdmarkdown17.9 KB
references/named-credentials-automation.mdmarkdown6.2 KB
references/named-credentials-guide.mdmarkdown7.1 KB
references/platform-events-guide.mdmarkdown6.6 KB
references/rest-callout-patterns.mdmarkdown8.8 KB
references/scoring-rubric.mdmarkdown2.4 KB
references/security-best-practices.mdmarkdown5.9 KB
scripts/README.mdmarkdown2.9 KB
scripts/configure-named-credential.shexecutablescript9.2 KB
scripts/set-api-credential.shexecutablescript4.9 KB
scripts/suggest_credential_setup.pyscript9.3 KB
scripts/templates/setup-credentials-with-csp.shexecutablescript5.9 KB
scripts/validate_integration.pyscript13.4 KB

assets/cdc/cdc-handler.cls

View on GitHub
/**
 * @description Change Data Capture (CDC) Handler for {{ObjectName}}
 *
 * Use Case: Business logic for processing CDC events
 * - Sync changes to external systems
 * - Maintain audit logs
 * - Trigger downstream processes
 *
 * This class is called by the {{ObjectName}}CDCSubscriber trigger
 * and contains all business logic for CDC event processing.
 *
 * @author {{Author}}
 * @date {{Date}}
 */
public with sharing class {{ObjectName}}CDCHandler {

    // Fields to watch for sync (ignore changes to other fields)
    private static final Set<String> SYNC_FIELDS = new Set<String>{
        'Name',
        'Status__c',
        'Amount__c'
        // Add fields that should trigger sync
    };

    /**
     * @description Handle CREATE change events
     * @param event The CDC event
     * @param header The change event header
     */
    public static void handleCreate({{ObjectName}}ChangeEvent event, EventBus.ChangeEventHeader header) {
        List<String> recordIds = header.getRecordIds();
        Datetime commitTime = header.getCommitTimestamp();

        System.debug(LoggingLevel.DEBUG,
            'CDC CREATE - Records: ' + recordIds + ' at ' + commitTime);

        // Build payload from event field values
        Map<String, Object> payload = buildPayloadFromEvent(event);
        payload.put('recordIds', recordIds);
        payload.put('operation', 'CREATE');
        payload.put('timestamp', commitTime);

        // Queue sync to external system
        System.enqueueJob(new ExternalSyncQueueable(payload));
    }

    /**
     * @description Handle UPDATE change events
     * @param event The CDC event
     * @param header The change event header
     * @param changedFields List of changed field API names
     */
    public static void handleUpdate(
        {{ObjectName}}ChangeEvent event,
        EventBus.ChangeEventHeader header,
        List<String> changedFields
    ) {
        List<String> recordIds = header.getRecordIds();

        // Check if any sync-relevant fields changed
        Boolean relevantChange = false;
        List<String> relevantFields = new List<String>();

        for (String field : changedFields) {
            if (SYNC_FIELDS.contains(field)) {
                relevantChange = true;
                relevantFields.add(field);
            }
        }

        if (!relevantChange) {
            System.debug(LoggingLevel.DEBUG,
                'CDC UPDATE - Ignoring (no sync fields changed): ' + changedFields);
            return;
        }

        System.debug(LoggingLevel.DEBUG,
            'CDC UPDATE - Records: ' + recordIds +
            ', Relevant changed fields: ' + relevantFields);

        // Build payload with changed values
        Map<String, Object> payload = buildPayloadFromEvent(event);
        payload.put('recordIds', recordIds);
        payload.put('operation', 'UPDATE');
        payload.put('changedFields', relevantFields);
        payload.put('timestamp', header.getCommitTimestamp());

        // Queue sync to external system
        System.enqueueJob(new ExternalSyncQueueable(payload));
    }

    /**
     * @description Handle DELETE change events
     * @param recordIds Deleted record IDs
     * @param header The change event header
     */
    public static void handleDelete(List<String> recordIds, EventBus.ChangeEventHeader header) {
        System.debug(LoggingLevel.DEBUG,
            'CDC DELETE - Records: ' + recordIds);

        Map<String, Object> payload = new Map<String, Object>{
            'recordIds' => recordIds,
            'operation' => 'DELETE',
            'timestamp' => header.getCommitTimestamp()
        };

        // Queue delete sync to external system
        System.enqueueJob(new ExternalSyncQueueable(payload));
    }

    /**
     * @description Handle UNDELETE change events
     * @param event The CDC event
     * @param header The change event header
     */
    public static void handleUndelete({{ObjectName}}ChangeEvent event, EventBus.ChangeEventHeader header) {
        // Treat undelete like create - sync full record
        handleCreate(event, header);
    }

    /**
     * @description Handle GAP events (missed events)
     * @param recordIds Affected record IDs
     * @param gapType Type of gap event
     */
    public static void handleGap(List<String> recordIds, String gapType) {
        System.debug(LoggingLevel.WARN,
            'CDC GAP - Type: ' + gapType + ', Records: ' + recordIds);

        // Query current state of records and sync
        // This ensures we have accurate data despite missed events
        /*
        List<{{ObjectName}}> records = [
            SELECT Id, Name, Status__c, Amount__c
            FROM {{ObjectName}}
            WHERE Id IN :recordIds
            WITH USER_MODE
        ];

        for ({{ObjectName}} record : records) {
            Map<String, Object> payload = new Map<String, Object>{
                'recordIds' => new List<String>{record.Id},
                'operation' => 'SYNC', // Full sync due to gap
                'data' => record
            };
            System.enqueueJob(new ExternalSyncQueueable(payload));
        }
        */
    }

    /**
     * @description Handle GAP_OVERFLOW (too many changes)
     * @param entityName The object API name
     */
    public static void handleOverflow(String entityName) {
        System.debug(LoggingLevel.ERROR,
            'CDC OVERFLOW for ' + entityName + ' - Full sync required!');

        // Create alert/task for admin attention
        /*
        Task alertTask = new Task(
            Subject = 'CDC Overflow - Full Sync Required for ' + entityName,
            Description = 'Change Data Capture experienced overflow. ' +
                         'Some events were missed. Full sync is required.',
            Priority = 'High',
            Status = 'Open',
            ActivityDate = Date.today()
        );
        insert alertTask;
        */

        // Consider triggering a batch job for full sync
        // Database.executeBatch(new FullSyncBatch(entityName));
    }

    /**
     * @description Build payload map from CDC event field values
     * @param event The CDC event
     * @return Map of field values
     */
    private static Map<String, Object> buildPayloadFromEvent({{ObjectName}}ChangeEvent event) {
        Map<String, Object> payload = new Map<String, Object>();

        // Map event fields to payload
        // Only non-null values are changed fields
        payload.put('Name', event.Name);
        // payload.put('Status__c', event.Status__c);
        // payload.put('Amount__c', event.Amount__c);
        // Add more fields as needed

        // Remove null values (unchanged fields)
        Set<String> keysToRemove = new Set<String>();
        for (String key : payload.keySet()) {
            if (payload.get(key) == null) {
                keysToRemove.add(key);
            }
        }
        for (String key : keysToRemove) {
            payload.remove(key);
        }

        return payload;
    }

    /**
     * @description Queueable job for syncing to external system
     */
    public class ExternalSyncQueueable implements Queueable, Database.AllowsCallouts {
        private Map<String, Object> payload;

        public ExternalSyncQueueable(Map<String, Object> payload) {
            this.payload = payload;
        }

        public void execute(QueueableContext context) {
            try {
                // Call external system with payload
                // Example: Use Named Credential + REST callout
                /*
                HttpRequest req = new HttpRequest();
                req.setEndpoint('callout:ExternalSystem/sync');
                req.setMethod('POST');
                req.setHeader('Content-Type', 'application/json');
                req.setBody(JSON.serialize(payload));

                Http http = new Http();
                HttpResponse res = http.send(req);

                if (res.getStatusCode() >= 200 && res.getStatusCode() < 300) {
                    System.debug('Sync successful');
                } else {
                    System.debug('Sync failed: ' + res.getStatusCode());
                }
                */

                System.debug(LoggingLevel.DEBUG,
                    'External sync payload: ' + JSON.serialize(payload));

            } catch (Exception e) {
                System.debug(LoggingLevel.ERROR,
                    'External sync failed: ' + e.getMessage());
                // Consider: Create error log, retry logic, DLQ
            }
        }
    }
}
reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis.Stars: 471kUpdated Claude CodeCodexVerifiedInstall
diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness.Stars: 322kUpdated Claude CodeCodexVerifiedInstall
dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependenciesStars: 322kUpdated Claude CodeCodexVerifiedInstall
executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is availableStars: 322kUpdated Claude CodeCodexVerifiedInstall