Skip to content

forcedotcom/sf-skills / plugins/builder/salesforce-development/skills/platform-data-manage

platform-data-manage

Verified

Salesforce data operations with 130-point scoring. Use to create, update, delete, bulk import/export, generate test data, and clean up org records via sf CLI and anonymous Apex. TRIGGER on creating test data, bulk import/export, sf data CLI commands, data-factory patterns for Apex tests, or seeding/cleaning org records. DO NOT TRIGGER for SOQL query writing only (use platform-soql-query), Apex test execution (use platform-apex-test-run), or metadata deployment (use platform-metadata-deploy).

FileKindSize
README.mdmarkdown4.5 KB
SKILL.mdskill md10.5 KB
assets/bulk/bulk-insert-10000.apexother12.3 KB
assets/bulk/bulk-insert-200.apexother12.4 KB
assets/bulk/bulk-insert-500.apexother13.1 KB
assets/bulk/bulk-upsert-external-id.apexother13.4 KB
assets/cleanup/delete-by-created-date.apexother15.9 KB
assets/cleanup/delete-by-name.apexother12.9 KB
assets/cleanup/delete-test-data.apexother16.6 KB
assets/cleanup/rollback-transaction.apexother12.4 KB
assets/csv/account-import.csvother1.8 KB
assets/csv/contact-import.csvother1.9 KB
assets/csv/custom-object-import.csvother1.1 KB
assets/csv/opportunity-import.csvother1.6 KB
assets/factories/account-factory.apexother5.6 KB
assets/factories/case-factory.apexother8.1 KB
assets/factories/contact-factory.apexother5.9 KB
assets/factories/custom-object-factory.apexother10.8 KB
assets/factories/event-factory.apexother9.6 KB
assets/factories/hierarchy-factory.apexother16.0 KB
assets/factories/lead-factory.apexother6.4 KB
assets/factories/opportunity-factory.apexother7.3 KB
assets/factories/task-factory.apexother8.1 KB
assets/factories/user-factory.apexother8.8 KB
assets/json/account-contact-tree.jsonconfig3.6 KB
assets/json/account-opportunity-tree.jsonconfig3.3 KB
assets/json/full-hierarchy-tree.jsonconfig5.8 KB
assets/soql/aggregate.soqlother12.3 KB
assets/soql/child-to-parent.soqlother9.8 KB
assets/soql/parent-to-child.soqlother8.6 KB
assets/soql/polymorphic.soqlother11.1 KB
assets/soql/subquery.soqlother16.2 KB
references/anonymous-apex-guide.mdmarkdown2.0 KB
references/bulk-operations-guide.mdmarkdown1.8 KB
references/bulk-testing-example.mdmarkdown4.9 KB
references/cleanup-rollback-example.mdmarkdown8.2 KB
references/cleanup-rollback-guide.mdmarkdown1.7 KB
references/crud-workflow-example.mdmarkdown4.0 KB
references/governor-limits-reference.mdmarkdown1.8 KB
references/orchestration.mdmarkdown7.0 KB
references/relationship-query-examples.mdmarkdown5.7 KB
references/sf-cli-data-commands.mdmarkdown2.8 KB
references/soql-relationship-guide.mdmarkdown2.0 KB
references/test-data-best-practices.mdmarkdown3.2 KB
references/test-data-factory-usage.mdmarkdown7.6 KB
references/test-data-patterns.mdmarkdown2.4 KB
scripts/soql_validator.pyscript10.9 KB
scripts/validate_data_operation.pyscript13.5 KB

assets/factories/opportunity-factory.apex

View on GitHub
/**
 * Test Data Factory for Opportunity records
 * Supports bulk creation with Account relationships and stage variations
 *
 * Usage:
 *   List<Opportunity> opps = TestDataFactory_Opportunity.create(200);
 *   List<Opportunity> oppsForAccount = TestDataFactory_Opportunity.createForAccount(50, accountId);
 *   List<Opportunity> closedWon = TestDataFactory_Opportunity.createWithStage(100, 'Closed Won');
 */
public class TestDataFactory_Opportunity {

    private static final String DEFAULT_NAME_PREFIX = 'Test Opportunity ';
    private static final String DEFAULT_STAGE = 'Prospecting';
    private static final Integer DEFAULT_CLOSE_DAYS = 30;

    /**
     * Create and insert Opportunity records (creates parent Account automatically)
     * @param count Number of records to create
     * @return List of inserted Opportunity records with IDs
     */
    public static List<Opportunity> create(Integer count) {
        return create(count, true);
    }

    /**
     * Create Opportunity records with insert option
     * @param count Number of records to create
     * @param doInsert Whether to insert records
     * @return List of Opportunity records
     */
    public static List<Opportunity> create(Integer count, Boolean doInsert) {
        // Create a parent Account
        Account parentAccount = new Account(Name = 'Test Parent Account for Opportunities');
        insert parentAccount;

        return createForAccount(count, parentAccount.Id, doInsert);
    }

    /**
     * Create Opportunity records for a specific Account
     * @param count Number of records to create
     * @param accountId Parent Account ID
     * @return List of inserted Opportunity records
     */
    public static List<Opportunity> createForAccount(Integer count, Id accountId) {
        return createForAccount(count, accountId, true);
    }

    /**
     * Create Opportunity records for a specific Account with insert option
     * @param count Number of records to create
     * @param accountId Parent Account ID
     * @param doInsert Whether to insert records
     * @return List of Opportunity records
     */
    public static List<Opportunity> createForAccount(Integer count, Id accountId, Boolean doInsert) {
        List<Opportunity> records = new List<Opportunity>();
        for (Integer i = 0; i < count; i++) {
            records.add(buildRecord(i, accountId));
        }
        if (doInsert && !records.isEmpty()) {
            insert records;
        }
        return records;
    }

    /**
     * Create Opportunities with a specific Stage
     * @param count Number of records to create
     * @param stageName StageName picklist value
     * @return List of inserted Opportunity records
     */
    public static List<Opportunity> createWithStage(Integer count, String stageName) {
        Account parentAccount = new Account(Name = 'Test Parent Account for ' + stageName + ' Opps');
        insert parentAccount;

        return createWithStageForAccount(count, stageName, parentAccount.Id);
    }

    /**
     * Create Opportunities with a specific Stage for an Account
     * @param count Number of records to create
     * @param stageName StageName picklist value
     * @param accountId Parent Account ID
     * @return List of inserted Opportunity records
     */
    public static List<Opportunity> createWithStageForAccount(Integer count, String stageName, Id accountId) {
        List<Opportunity> records = new List<Opportunity>();
        for (Integer i = 0; i < count; i++) {
            Opportunity opp = buildRecord(i, accountId);
            opp.StageName = stageName;

            // Set Probability based on stage
            if (stageName == 'Closed Won') {
                opp.Probability = 100;
            } else if (stageName == 'Closed Lost') {
                opp.Probability = 0;
            }

            records.add(opp);
        }
        if (!records.isEmpty()) {
            insert records;
        }
        return records;
    }

    /**
     * Create Opportunities with varied Stages for pipeline testing
     * @param count Number of records to create
     * @param accountId Parent Account ID
     * @return List of inserted Opportunity records with varied stages
     */
    public static List<Opportunity> createWithVariedStages(Integer count, Id accountId) {
        List<String> stages = new List<String>{
            'Prospecting', 'Qualification', 'Needs Analysis',
            'Value Proposition', 'Id. Decision Makers', 'Perception Analysis',
            'Proposal/Price Quote', 'Negotiation/Review', 'Closed Won', 'Closed Lost'
        };

        List<Opportunity> records = new List<Opportunity>();
        for (Integer i = 0; i < count; i++) {
            Opportunity opp = buildRecord(i, accountId);
            opp.StageName = stages[Math.mod(i, stages.size())];
            records.add(opp);
        }

        if (!records.isEmpty()) {
            insert records;
        }
        return records;
    }

    /**
     * Create Opportunities with varied Amounts for revenue testing
     * @param count Number of records to create
     * @param accountId Parent Account ID
     * @param minAmount Minimum amount
     * @param maxAmount Maximum amount
     * @return List of inserted Opportunity records
     */
    public static List<Opportunity> createWithVariedAmounts(Integer count, Id accountId, Decimal minAmount, Decimal maxAmount) {
        List<Opportunity> records = new List<Opportunity>();
        Decimal range = maxAmount - minAmount;

        for (Integer i = 0; i < count; i++) {
            Opportunity opp = buildRecord(i, accountId);
            // Distribute amounts evenly across the range
            opp.Amount = minAmount + (range * i / count);
            records.add(opp);
        }

        if (!records.isEmpty()) {
            insert records;
        }
        return records;
    }

    /**
     * Build a single Opportunity record with default values
     * @param index Record index for unique naming
     * @param accountId Parent Account ID
     * @return Opportunity record (not inserted)
     */
    private static Opportunity buildRecord(Integer index, Id accountId) {
        String indexStr = String.valueOf(index).leftPad(5, '0');

        return new Opportunity(
            Name = DEFAULT_NAME_PREFIX + indexStr,
            AccountId = accountId,
            StageName = DEFAULT_STAGE,
            CloseDate = Date.today().addDays(DEFAULT_CLOSE_DAYS + index),
            Amount = 10000 + (index * 1000),
            Probability = 20,
            Type = 'New Customer',
            LeadSource = 'Web',
            NextStep = 'Follow up call',
            Description = 'Test opportunity created by TestDataFactory for automated testing'
        );
    }

    /**
     * Get IDs of created records for cleanup
     * @param records List of Opportunity records
     * @return Set of Opportunity IDs
     */
    public static Set<Id> getIds(List<Opportunity> records) {
        Set<Id> ids = new Set<Id>();
        for (Opportunity opp : records) {
            if (opp.Id != null) {
                ids.add(opp.Id);
            }
        }
        return ids;
    }

    /**
     * Delete records by IDs (cleanup utility)
     * @param recordIds Set of Opportunity IDs to delete
     */
    public static void cleanup(Set<Id> recordIds) {
        if (!recordIds.isEmpty()) {
            delete [SELECT Id FROM Opportunity WHERE Id IN :recordIds];
        }
    }
}
finishing-a-development-branchobra/superpowersUse when implementation is complete, all tests pass, and you need to decide how to integrate the workStars: 323kUpdated Claude CodeCodexVerifiedInstall
systematic-debuggingobra/superpowersUse when encountering any bug, test failure, or unexpected behavior, before proposing fixesStars: 323kUpdated Claude CodeCodexVerifiedInstall
test-driven-developmentobra/superpowersUse when implementing any feature or bugfix, before writing implementation codeStars: 323kUpdated Claude CodeCodexVerifiedInstall
skill-creatoranthropics/skillsCreate new skills, modify and improve existing skills, and measure skill performance. Use when users want to create a skill from scratch, edit, or optimize an existing skill, run evals to test a skill, benchmark skill performance with variance analysis, or optimize a skill's description for better triggering accuracy.Stars: 198kUpdated Claude CodeCodexVerifiedInstall