.env.local.example

# Copy this file to env/.env.local before running locally.

# Built-in environment variables
TEAMSFX_ENV=local
APP_NAME_SUFFIX=local
CONNECTOR_ID=your_connector_id
CONNECTOR_NAME=your_connector_name
CONNECTOR_DESCRIPTION=Salesforce CRM Custom connector for Leads, Accounts, Contacts, Opportunities, Cases, and Customer Projects. This custom connector brings Salesforce Sales Cloud data into Microsoft Search and Microsoft 365 experiences. The content in this connection can also be referred to as SFDC, Salesforce data, or Salesforce Sales Cloud. Keywords: SFDC, accounts, buyers, contracts, purchasers, cases, leads, opportunities, contacts, customer projects

# Salesforce Configuration
SALESFORCE_INSTANCE_URL=https://your-org.my.salesforce.com/
SALESFORCE_API_VERSION=v60.0
SALESFORCE_CLIENT_ID=your_salesforce_connected_app_client_id
# Set SECRET_SALESFORCE_CLIENT_SECRET in env/.env.local.user.

# Azure AD App Configuration
AAD_APP_CLIENT_ID=your_entra_app_client_id
AAD_APP_OBJECT_ID=your_entra_app_object_id
AAD_APP_TENANT_ID=your_entra_tenant_id
AAD_APP_OAUTH_AUTHORITY=https://login.microsoftonline.com/your_entra_tenant_id
AAD_APP_OAUTH_AUTHORITY_HOST=https://login.microsoftonline.com
# Set SECRET_AAD_APP_CLIENT_SECRET in env/.env.local.user.
# Use the Entra client secret value, not the secret ID.

# ── Tuning & Retry Settings (all optional – defaults shown) ──

# Graph API retry settings
GRAPH_API_VERSION=beta
GRAPH_MAX_RETRIES=4
GRAPH_RETRY_BACKOFF_BASE=2
 
# Connection provisioning timeout and retry interval (seconds)
CONNECTION_TIMEOUT_SECONDS=600
CONNECTION_RETRY_INTERVAL_SECONDS=15
 
# Schema provisioning retry interval (seconds)
SCHEMA_RETRY_INTERVAL_SECONDS=15

# Salesforce SOQL LIMIT clause.
# Set to 0 (recommended for production) to let Salesforce paginate the full result
# set automatically at 2000 records/page via nextRecordsUrl — no artificial cap.
# Set to a small positive number (e.g. 5) only for local dev/debug runs.
SALESFORCE_QUERY_LIMIT=0
 
# Max IDs in a single SOQL IN clause 
SALESFORCE_BATCH_SIZE=100
 
# Max depth when following ControlledByParent ACL chains
ACL_MAX_PARENT_DEPTH=5

# ── Batching / parallelism ──
# Number of Salesforce records processed per chunk (ACL resolve + Graph $batch cycle).
# Aligning to 2000 = one Salesforce page per cycle. Safe to increase up to ~5000.
INGEST_CHUNK_SIZE=2000

# Number of PUT/DELETE requests per Graph $batch POST.
# Hard-capped at 20 by the Graph API — do not set above 20.
INGEST_GRAPH_BATCH_SIZE=20

# Flighting to determine whether to use the new ACL engine
USE_NEW_ACL_ENGINE=false

# Number of concurrent Graph $batch POST workers (flight: 1 = sequential, 4-8 recommended for large orgs)
# Higher values increase throughput but may trigger 429 throttling - start with 2 and tune.
GRAPH_BATCH_WORKERS=4

USE_GROUP_ACL=true

USE_ENTITY_DEFINITION_OWD=true

# Force specific object OWD values for testing (JSON object, e.g. {"Account":"Private"})
# Leave empty or omit to use real Salesforce OWD values
OWD_OVERRIDES={"Account":"Private"}