afv-library/skills/handling-sf-data/references/orchestration.md

Multi-Skill Orchestration: handling-sf-data Perspective

This document details how handling-sf-data fits into the multi-skill workflow for Salesforce development.

---

Standard Orchestration Order

┌─────────────────────────────────────────────────────────────────────────────┐
│  STANDARD MULTI-SKILL ORCHESTRATION ORDER                                   │
├─────────────────────────────────────────────────────────────────────────────┤
│  1. sf-metadata                                                             │
│     └── Create object/field definitions (LOCAL files)                       │
│                                                                             │
│  2. sf-flow                                                                 │
│     └── Create flow definitions (LOCAL files)                               │
│                                                                             │
│  3. deploying-metadata                                                               │
│     └── Deploy all metadata (REMOTE)                                        │
│                                                                             │
│  4. handling-sf-data  ◀── YOU ARE HERE (LAST!)                                      │
│     └── Create test data (REMOTE - objects must exist!)                     │
└─────────────────────────────────────────────────────────────────────────────┘

---

⚠️ Why handling-sf-data Goes LAST

handling-sf-data operates on REMOTE org data. Objects/fields must be deployed before handling-sf-data can:

• Insert records
• Query existing data
• Run test factories
• Generate bulk test data

ERROR: "SObject type 'Quote__c' is not supported"
CAUSE: Quote__c object was never deployed to the org
FIX:   Run deploying-metadata BEFORE handling-sf-data

---

Common Errors from Wrong Order

Error	Cause	Fix
SObject type 'X' not supported	Object not deployed	Deploy via deploying-metadata first
INVALID_FIELD: No such column 'Field__c'	Field not deployed OR FLS	Deploy field + Permission Set
REQUIRED_FIELD_MISSING	Validation rule requires field	Include all required fields
FIELD_CUSTOM_VALIDATION_EXCEPTION	Validation rule triggered	Use valid test data values

---

Test Data After Triggers/Flows

When testing triggers or flows, always create test data AFTER deployment:

1. sf-apex   → Create trigger handler class
2. sf-flow   → Create record-triggered flow
3. deploying-metadata → Deploy trigger + flow + objects
4. handling-sf-data   ◀── CREATE TEST DATA NOW
              └── Triggers and flows will fire!

Why? Test data insertion triggers flows/triggers. If those aren't deployed, you're not testing realistic behavior.

---

The 251-Record Pattern

Always test with 251 records to cross the 200-record batch boundary:

┌─────────────────────────────────────────────────────────────────────────────┐
│  BATCH BOUNDARY TESTING                                                     │
├─────────────────────────────────────────────────────────────────────────────┤
│  Records 1-200:    First batch                                              │
│  Records 201-251:  Second batch (crosses boundary!)                         │
│                                                                             │
│  Tests: N+1 queries, bulkification, governor limits                         │
└─────────────────────────────────────────────────────────────────────────────┘

Command:

sf apex run --file test-factory.apex --target-org alias
# test-factory.apex creates 251 records

---

Cross-Skill Integration Table

From Skill	To handling-sf-data	When
sf-apex	→ handling-sf-data	"Create 251 Accounts for bulk testing"
sf-flow	→ handling-sf-data	"Create Opportunities with StageName='Closed Won'"
running-apex-tests	→ handling-sf-data	"Generate test records for test class"

From handling-sf-data	To Skill	When
handling-sf-data	→ sf-metadata	"Describe Invoice__c" (discover object structure)
handling-sf-data	→ deploying-metadata	"Redeploy field after adding validation rule"

---

Prerequisites Check

Before using handling-sf-data, verify:

# Check org connection
sf org display --target-org alias

# Check objects exist
sf sobject describe --sobject MyObject__c --target-org alias --json

# Check field-level security (if field not visible)
sf data query --query "SELECT Id FROM FieldPermissions WHERE SobjectType='MyObject__c'" --use-tooling-api --target-org alias

---

Factory Pattern Integration

Test Data Factory classes work with handling-sf-data:

sf-apex:  Creates TestDataFactory_Account.cls
          ↓
deploying-metadata: Deploys factory class
          ↓
handling-sf-data:  Calls factory via Anonymous Apex
          ↓
          251 records created → triggers fire → flows run

Anonymous Apex:

List<Account> accounts = TestDataFactory_Account.create(251);
System.debug('Created ' + accounts.size() + ' accounts');

---

Cleanup Sequence

After testing, clean up in reverse order:

1. handling-sf-data   → Delete test records
2. deploying-metadata → Deactivate flows (if needed)
3. deploying-metadata → Remove test metadata (if needed)

Cleanup command:

sf apex run --file cleanup.apex --target-org alias
# cleanup.apex: DELETE [SELECT Id FROM Account WHERE Name LIKE 'Test%']

---

Related Documentation

Topic	Location
Test data patterns	handling-sf-data/references/test-data-patterns.md
Cleanup guide	handling-sf-data/references/cleanup-rollback-guide.md
Factory templates	handling-sf-data/assets/factories/