Data Generation Toolkit

This project aims to create toolkit of tools and documentation for generating test data sets based on admin-selected criteria.

Read our guide on getting data into your Salesforce Sandbox!

Project Vision/Goals

• Everyone has access to an open process/tool to reliably generate sample data for telling user stories.
• Admin-friendly interface to define requirements for the data generated.
• Data sets generated through this process could be appopriate for medium-sized orgs and can fit in a sandbox.
• Data sets generated through this process could be valid for large data valume (LDV) testing.
• Develop process for how you can build test data sets that follow a story (automated? manual? best practice doc?).
• Document avialable tools and processes to create and migrate data between orgs.
• Prioritize leadership development/capacity building through project leadership/contributions from customers, partners, devs, etc.

Example Use Cases We Aim to Support:

• QA an org populated with permutations of all, or nearly all, the types of data that are relavent to the project.
• Be able to reliably and easily load sample data into a given Salesforce org (production, sandbox or scratch).
• Have a data set for demos, potentially with the ability to add specific sets of data that could be used for story based training materials.
• Have a data set that ensures the privacy of people represented in the dataset (ie not real names).
• Have data sets at scales that allow for testing bulk data processing.

Ongoing Task Streams:

Currently the project team has two major efforts for our work:

• Documentation of existing tools and solutions.
• Creation of Snowmakery a community supported tool that will empower easy creation of data sets tailored to an org's needs.
• Sample Recipes for Salesforce.org packages.

Project Accomplishments:

• Project Personas: a collection of people we target our documentation about and to.
• Meet Alex: a guide to using data with Sandboxes.
• Snowfakery Example Library: a growing collection of Snowfakery data generator recipes for Salesforce.

We keep our most recent full notes from meetings and Sprints in the project wiki. The notes from the February 2021 Virtual Sprint are the most recent.

Proof of Concept Code:

During the course of this project some ideas have been tested in code, and to ensure that code isn't lost and doesn't confuse other efforts in this repo they are kept in the proofs-of-concept directory.

Currently those include:

1. A CumulusCI Task created during this project's first sprint to generate permutations of data.
2. A web-based Snowfakery recipe editor created during the fall 2020 virtual sprint. This was the second tool named Snowmakery and largely confirmed that this project's UI will bare that name.

Project Meetings

The main project team meets monthly to maintain momentum between sprints. You can contact us through the PowerOfUs Hub to get details for joining those meetings. Notes from project meetings are recorded on the wiki for this repository.

Project Audience

All Salesforce Admins and Developers

This project is aimed at helping ease the process of generating test data for projects. Nearly all Salesforce projects benefit from improving this process.

To help people identify with specific audiences while creating documentation we have created a series of project personas that we speak to and about in our materials. This is not a complete picture of everyone who will benefit, but it helps us focus our efforts and may help you understand us.

Project Leadership Team

Help us give you the thanks you deserve and ensure future contributors know who to contact if they have questions! Please ensure that all contributing members of the team are included.

• Team Leader(s):
  • Aaron Crosman (Attain)
  • Samantha Shain (William Penn Foundation)
  • Cassie Supilowski (OneGoal)
• Salesforce Liason:
  • Paul Prescod (Salesforce.org)

We also keep a complete list of contributors.

Past Project Accomplishments

• Between Sept '20 Virtual Sprint and Feb '21 Virtual Sprint
  • Completed first full draft of Data Generation Guide document; including technical edit
  • Kicked the tires on Snowfakery, for real
  • Made several public presentations
  • Implemented Project Boards to track issues and discussion topics
  • Survived despite pandemic, fascism, etc.
• 9/23-9/24 Virtual Sprint
  • Drafted architecture diagrams for a UI to sit on top of Snowfakery. This will be called Snowmakery! There are two proof of concepts that have been initiated. One is inside of the org, the other is in Heroku.
  • Analyzed survey data from 75 community members; updated relevant Personas based on survey insights
  • Established document outline and Admin Story for documentation project that describes how to Generate Data and Move Data between orgs
  • Documented limitations and considerations for Partial Data sampling algorithm and manual steps, third party apps, and code for creating mock data records
  • Documented steps for an Admin-audience to use CCI to move data records from one Dev Sandbox to another Dev Sandbox (or any two persistent orgs)
  • QA-ed documentation steps for CCI steps (referenced above)
• 3/31 -> 4/1 virtual sprint
  • Determined that Snowfakery accomplishes many of the original requirements brainstormed at the Philly Sprint (fall 2019) (namely: ability to generate mock data with related tables, random names and values, standard and custom objects, datasets of any size/scale, ability to populate Salesforce orgs)
  • Socialized Snowfakery to community members
  • Onboarded project leadership from multiple orgs and began application for inclusion in Open Source Commons program
  • Refined use cases and differentiated Snowfakery from (1) existing tools in the market (2) proprietary tools at Salesforce (3) Full Sandbox product
  • Brainstormed 2+ potential directions for extending Snowfakery to include an admin-friendly web interface
  • Reviewed documentation and install steps
  • Overhauled ReadMe file

Additional Useful References

• Project Meeting Notes.
• Snowfakery
  • Main Docs
  • Paul's SF Architechs blog on snowfakery
  • Snowfakery SF Examples
  • Aaron’s Noodling on a recipe editor (not currently functional)
  • Aarons blog post about generating NPSP Data
  • Samantha's Blog post about using Snowfakery
• Fellow Developers, What Should Our Last Name Be?
• Data Management with CumulusCI Trailhead
• Data Generation Toolkit project on Power of Us Hub
• Smart Sandbox: their website is still up but no longer active
• Faker Documentation
• NPSP Data Dictionary
• Wave Data Generator (generates data for Salesforce org, and builds linkages between objects)
• JSON/YAML Editor