diff --git a/docs/salesforce.md b/docs/salesforce.md index 58f110b2..8ad0bed0 100644 --- a/docs/salesforce.md +++ b/docs/salesforce.md @@ -21,7 +21,6 @@ creates Snowfakery. The easiest way to learn about CumulusCI (and to learn how to install it) is with its [Trailhead Trail](https://trailhead.salesforce.com/en/content/learn/trails/build-applications-with-cumulusci). - ```s $ cci task run generate_and_load_from_yaml -o generator_yaml examples/salesforce/Contact.recipe.yml -o num_records 300 -o num_records_tablename Contact --org qa ... @@ -51,6 +50,14 @@ $ cci flow run test_everything ... ``` +The order in which sobjects is loaded is inferred by Snowfakery and CumulusCI +based primarily on which tables have fields that depend on which other +tables. Tables declared earlier in the recipe are also generally loaded +before tables declared later. If you need precise control over load +order, you can control that and many other aspects of the loading process +(e.g. batch size) with a `load.yml` file as described in the +[CumulusCI docs](https://cumulusci.readthedocs.io/en/latest/data.html#controlling-the-loading-process). + ## Incorporating Information from Salesforce There are various cases where it might be helpful to relate newly created synthetic @@ -323,7 +330,7 @@ in the `PersonContactId` field. There is also an alternate syntax which allows nicknaming: ```yaml -... +--- - object: Account fields: PersonContactId: