Taking a snapshot of data for export to a table or file

Use the Snapshot process to capture data for export to a table or file. Select the source of the values that you want to capture, and define the output table or a file for those values.

Procedure

  1. Open a flowchart for editing.
  2. Drag the Snapshot process Camera from the palette to your flowchart.
  3. Connect one or more configured processes to provide input to the Snapshot process.
    Note: All of the cells that you select as input must have the same audience level.
  4. Double-click the Snapshot process in the flowchart workspace.

    The Snapshot process configuration dialog box opens and the Snapshot tab is open by default.

  5. Use the Snapshot tab to specify how to capture data.
    1. Use the Input list to specify which cells to use as the data source for the snapshot.
      Note: If the Snapshot process is not connected to a process that provides output cells, there are no cells to select from in the Input list. Also, the Multiple cells option is available only if the input process generates multiple cells.
    2. Use the Export to list to select a table or file for the Snapshot output.
      Note: You can test the Snapshot process by running the process with output exported to a temporary file that you can review.
      • You can select an existing table from the list
      • If the table that you want to use is not in the list, or if you want to output to an unmapped table, select Database table. Use the Specify database table dialog box to specify the table and database name. User variables are supported in the table name that you specify here.
      • You can select File to open the Specify output file dialog, so you can define how to output to a Flat file with data dictionary, Flat file based on existing data dictionary, or Delimited file.
      • If you want to create a new user table, select New mapped table from the Export to list. For instructions on mapping tables, see the IBM® Campaign Administrator's Guide.
      • Choose [Extract table] if you want to export to an extract table, which has a UAC_EX prefix. An extract table persists so that users can continue to access it to perform operations such as profiling its fields.
    3. Select an option to specify how updates to the output file or table are handled:
      • Append to existing data. Add the new information to the end of the table or file. If you select this option for a delimited file, labels are not exported as the first row. This is a best practice for database tables.
      • Replace all records. Remove any existing data from the table or file, and replace it with the new information.
      • Update records. Available only if you are exporting to a table. All fields that are specified for the snapshot are updated with the values from the current run of the process.
      • Create new file. Available only if you are exporting to a file. This option is selected by default if you are exporting to a file. Each time that you run the process, a new file is created with an underscore and digit appended to the file name (file_1, file_2, and so on).
  6. To specify which fields to snapshot, use the controls to move selected fields from the Candidate fields list to the Fields to snapshot list. You can select multiple fields with Ctrl+Click or select a range of fields with Shift+Click.
    Note: To view the values in a field, select a field in the Candidate fields list and click Profile.
    • If you selected a table as the snapshot destination, the fields in that table appear in the Candidate fields list. You can automatically find matching fields by clicking the Match button. Fields with exact matches for the table field names are automatically added to the Fields to snapshot list. If there are multiple matching fields, the first match is taken. You can manually modify the pairings by using Remove << or Add >>.
    • To include generated fields, expand the list of IBM Campaign generated fields in the Candidate fields list, select a field, then use the controls to move the field to the Fields to snapshot list.
    • To work with derived fields, click the Derived fields button.
    • You can reorder the Fields to snapshot by selecting a field and clicking Up 1 or Down 1 to move it up or down in the list.
  7. To skip records with duplicate IDs or to specify the order in which records are output, click More to open the Advanced settings dialog.
    1. To remove duplicate IDs within the same input cell, select Skip records with Duplicate IDs. Then choose the criteria to determine which record to retain if duplicate IDs are found.
      For example, select MaxOf and Household_Income to specify that when duplicate IDs are found, Campaign exports only the ID with the highest household income.
      Note: This option removes duplicates only within the same input cell. Your snapshot data can still contain duplicate IDs if the same ID displays in multiple input cells. To remove all duplicate IDs, use a Merge or Segment process upstream of the Snapshot process to purge duplicate IDs or create mutually exclusive segments.
    2. To sort the snapshot output, select the Order by check box, then select the field to sort by and the sort order.
      For example, select Last_Name and Ascending to sort IDs by surname in ascending order.
    3. Click OK.
  8. Use the General tab to set the following options:
    • Process name: Assign a descriptive name. The process name is used as the box label on the flowchart. It is also used in various dialogs and reports to identify the process.
    • Note: Use the Note field to explain the purpose or result of the process. The contents of this field appears when you rest your cursor over the process box in a flowchart.
  9. Click OK to save and close the configuration.

Results

The process is now configured. You can test run the process to verify that it returns the results you expect.