Let the platform do the work

Populating Target Lists From Large Reports

Overview

After creating a target list, you have the option to populate it from a report. However, larger reports will often timeout before completely filling the target list. As a result, the best way to populate a target list is to break the report into multiple chunks and bring the records over in batches.

Beginning with version 9.1.0, each user's license type (e.g. Sugar Serve) determines what functionality is available as described in the License Types Matrix documentation. Please note that the Target Lists module is not available for Sugar Serve users.

Use Case

Many customers have very large Campaigns that require very large Target Lists. This article will describe how to efficiently populate Target Lists for Campaigns without having to worry about timeouts.

Steps to Complete

  1. Navigate to the Target Lists module. 
  2. Create a new target list by clicking the Create button in the Target Lists module.
    rest/v11/doc_PagesFiles/d02adb78-7adc-08fa-17e5-550281253e55/file/uploadfile?force_download=0&platform=base
  3. Give it a Name and Type, then click "Save".
    rest/v11/doc_PagesFiles/9e01ff1d-7e6e-7d4f-4b31-55028123a786/file/uploadfile?force_download=0&platform=base
  4. Create a new report by selecting "Create Report" from the Reports module dropdown menu.
    rest/v11/doc_PagesFiles/156bc998-8ab6-a2d0-a18f-550281b065bb/file/uploadfile?force_download=0&platform=base
    1. Choose "Rows and Columns Report".
    2. Select a module, for example Contacts.
    3. Set the filters you need to limit the results to what you want in your target list.
      Note: If you want every record in the module, just leave this blank.
    4. Add the Contact Name field to the Display Columns.
    5. Name the report, then click "Save & Run".
      rest/v11/doc_PagesFiles/53df6f5d-c1ad-47cf-3529-550281e319d2/file/uploadfile?force_download=0&platform=base
  5. Use filters to break the report results into more manageable batches.

    1. Select the report you just created and click "Edit".

    2. Choose how you want to divide your results. Ideally, each batch should be less than 3,000 records to prevent a timeout, though the exact number depends on the server and network. Example filters:

      • Date Created "Is Between"starting date and ending date
      • Last Name "Starts With" specified letter of the alphabet
      • Primary Address State "Equals" specified state
      • Etc.
    3. Once you have selected your new filter(s) confirm the report name is the same, then click "Save & Run".
      rest/v11/doc_PagesFiles/53df6f5d-c1ad-47cf-3529-550281e319d2/file/uploadfile?force_download=0&platform=base
  6. Import the current report into the target list.
    1. From the Target List Edit View, navigate to the Contacts subpanel or whichever module your report was based on and choose "Select from Reports".
      rest/v11/doc_PagesFiles/898f16ac-a099-e935-988f-55028178c4a5/file/uploadfile?force_download=0&platform=base
    2. Search for the report you just created, then click on the report name. This will populate the target list with the first batch of records from your report.
  7. Repeat as necessary or until all the desired records have been imported to your desired target list.
    1. If you received a timeout and not all records were imported, your filter was too broad and the report will need to be filtered down to fewer records.
    2. If it was successful, edit your report again, changing the filter to get the next batch of records (different dates, first letter of last name, primary address state, etc.).