Skip to content
Igor Zhutaiev edited this page Mar 9, 2016 · 18 revisions

What is Tidbit?

Tidbit is a data generation tool for the SugarCRM application.

Tidbit Tutorial

This tutorial will guide you step-by-step through the process of installing and running Tidbit. The only requirement is a working installation of SugarCRM.

Step 1: Clone from github

To obtain Tidbit, first ‘cd’ to the root directory of your Sugar installation. Then:

git clone git://github.com/sugarcrm/Tidbit.git

This will create a ‘Tidbit’ directory in your Sugar installation’s root directory.

Step 2: Run Tidbit

First, ‘cd’ to your Tidbit directory. The command-line interface to Tidbit is install_cli.php. Here’s a simple example usage:

php install_cli.php -l 10

This uses a ‘load’ argument of 10, meaning that 10 Accounts will be created, and records in other modules will be created in proportion to that number of accounts. The ratios are controlled by the values in the $modules array, located in the file install_config.php.
$modules is an array mapping module names to integer values. The default settings map ‘Accounts’ to 1000 and ‘Contacts’ to 4000, so 4 Contacts will be created for every 1 Account.

Another example:

php install_cli.php -l 50 -o --allmodules --allrelationships

Like the prior example, we use a ‘load’ argument. The ‘-o’ flag is for ‘obliterate’ mode. This will erase all data in tables populated by Tidbit before creating new data.
The ‘—allmodules’ flag tells Tidbit to generate records for any custom modules built using Module Builder. The ‘—allrelationships’ flag tells Tidbit to generate relationships between the records it creates whenever possible.

For a complete listing of command line options, you can display the usage string with the following:

php install_cli.php -h

Useful Articles how to extend or change Tidbit

Clone this wiki locally