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/soap/soap-callout-service.cls

View on GitHub
/**
 * @description SOAP Web Service Callout Service
 *
 * Use Case: Integrations with SOAP/XML-based web services
 * - Legacy enterprise systems
 * - Government APIs
 * - Financial services (often SOAP-based)
 *
 * Prerequisites:
 * 1. Generate Apex from WSDL (Setup → Apex Classes → Generate from WSDL)
 * 2. Configure Named Credential or Remote Site Setting for endpoint
 *
 * This template wraps WSDL-generated stub classes with:
 * - Error handling
 * - Timeout configuration
 * - Logging
 *
 * @author {{Author}}
 * @date {{Date}}
 */
public with sharing class {{ServiceName}}SoapService {

    // Named Credential for SOAP endpoint (recommended over Remote Site Setting)
    private static final String NAMED_CREDENTIAL = 'callout:{{NamedCredentialName}}';

    // Timeout in milliseconds (max 120000)
    private static final Integer TIMEOUT_MS = 120000;

    /**
     * @description Call SOAP operation with request object
     *
     * Replace {{WsdlStubClass}} with your WSDL-generated class name
     * Replace {{PortType}} with the port/binding type from WSDL
     * Replace {{OperationName}} with the SOAP operation to call
     *
     * @param request Request object (WSDL-generated type)
     * @return Response object (WSDL-generated type)
     * @throws SoapCalloutException on errors
     */
    public static {{ResponseType}} callService({{RequestType}} request) {
        try {
            // Instantiate the WSDL-generated stub
            {{WsdlStubClass}}.{{PortType}} stub = new {{WsdlStubClass}}.{{PortType}}();

            // Configure endpoint
            // Option 1: Use Named Credential (recommended)
            stub.endpoint_x = NAMED_CREDENTIAL;

            // Option 2: Direct endpoint (requires Remote Site Setting)
            // stub.endpoint_x = '{{SoapEndpoint}}';

            // Set timeout
            stub.timeout_x = TIMEOUT_MS;

            // Set custom SOAP headers if needed
            // stub.inputHttpHeaders_x = new Map<String, String>{
            //     'X-Custom-Header' => 'value'
            // };

            // Make the SOAP call
            {{ResponseType}} response = stub.{{OperationName}}(request);

            // Log success
            System.debug(LoggingLevel.DEBUG, 'SOAP call successful: {{OperationName}}');

            return response;

        } catch (CalloutException e) {
            // Network/timeout error
            System.debug(LoggingLevel.ERROR, 'SOAP CalloutException: ' + e.getMessage());
            throw new SoapCalloutException('Connection error: ' + e.getMessage(), e);

        } catch (Exception e) {
            // SOAP fault or other error
            System.debug(LoggingLevel.ERROR, 'SOAP Error: ' + e.getMessage());
            System.debug(LoggingLevel.ERROR, 'Stack: ' + e.getStackTraceString());
            throw new SoapCalloutException('SOAP service error: ' + e.getMessage(), e);
        }
    }

    /**
     * @description Async SOAP call via Queueable
     *              Use this when calling from DML context (triggers)
     * @param request Request object
     * @param callbackId Optional ID for tracking the async job
     */
    public static void callServiceAsync({{RequestType}} request, Id callbackId) {
        System.enqueueJob(new SoapCalloutQueueable(request, callbackId));
    }

    /**
     * @description Queueable implementation for async SOAP calls
     */
    public class SoapCalloutQueueable implements Queueable, Database.AllowsCallouts {
        private {{RequestType}} request;
        private Id callbackId;

        public SoapCalloutQueueable({{RequestType}} request, Id callbackId) {
            this.request = request;
            this.callbackId = callbackId;
        }

        public void execute(QueueableContext context) {
            try {
                {{ResponseType}} response = callService(request);

                // Process response and update Salesforce record if needed
                if (callbackId != null) {
                    processCallback(response, callbackId);
                }

            } catch (Exception e) {
                System.debug(LoggingLevel.ERROR, 'Async SOAP call failed: ' + e.getMessage());
                // Consider: create error log, send notification
            }
        }
    }

    /**
     * @description Process async callback result
     * @param response SOAP response
     * @param callbackId Record ID to update with result
     */
    private static void processCallback({{ResponseType}} response, Id callbackId) {
        // TODO: Implement callback processing
        // Example: Update a record with the response data
        /*
        SObject record = callbackId.getSObjectType().newSObject(callbackId);
        record.put('Integration_Status__c', 'Complete');
        record.put('Integration_Response__c', JSON.serialize(response));
        update record;
        */
    }

    /**
     * @description Custom exception for SOAP callout errors
     */
    public class SoapCalloutException extends Exception {}
}

/*
 * ============================================================================
 * WSDL2APEX GENERATION GUIDE
 * ============================================================================
 *
 * Step 1: Obtain WSDL
 * -------------------
 * Get the WSDL file from the external system. It should be an XML file
 * defining the service, operations, and data types.
 *
 * Step 2: Generate Apex Classes
 * -----------------------------
 * 1. Go to Setup → Apex Classes
 * 2. Click "Generate from WSDL"
 * 3. Upload the WSDL file
 * 4. Choose a namespace (or accept default)
 * 5. Click "Generate Apex code"
 *
 * Step 3: Review Generated Classes
 * --------------------------------
 * Salesforce generates:
 * - Stub class ({{WsdlStubClass}}) with methods for each operation
 * - Request/Response wrapper classes
 * - Data type classes matching WSDL schema
 *
 * Step 4: Configure Access
 * ------------------------
 * Option A: Named Credential (Recommended)
 * - Create Named Credential with SOAP endpoint
 * - Set stub.endpoint_x = 'callout:NamedCredentialName'
 *
 * Option B: Remote Site Setting
 * - Create Remote Site Setting with SOAP endpoint domain
 * - Set stub.endpoint_x to full URL
 *
 * Step 5: Test the Integration
 * ----------------------------
 * Execute anonymous Apex:
 *
 * {{RequestType}} req = new {{RequestType}}();
 * req.field1 = 'value';
 * {{ResponseType}} resp = {{ServiceName}}SoapService.callService(req);
 * System.debug(resp);
 *
 * ============================================================================
 */
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: 472kUpdated 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