Updated over 9 years ago by Jon Goldberg

Exporting Salsa for CiviCRM¶

When logged in as a Manager, "Query/Export" will give you a full export of contact data. There's a "Select My Entire List" button. There's also an "include my deleted supporters" checkbox, which you may want to check (but probably not). This will NOT get you groups/tags.

Exporting Data not on the Contact Entity¶

You need to get to custom reports. If you have the Reports tab, great; if not, you can get there by clicking "Supporter Management" tab, then "Built-in Reports", then "Clone and Edit" a report, then select "List Custom Groups". Or go straight here: https://hq-org.salsalabs.com/dia/hq/reports/list.jsp?table=report

Important: When selecting foreign keys (e.g. "Supporter KEY") from the Columns tab, be sure to give a custom label. This will cause the key to display correctly, instead of giving a link to the supporter's record.

Groups¶

• Create a new report.
• Select the type of report you would like to create: Standard report
• Use "Advanced Object Chooser".
• Report "Supporter Groups", then "Groups". Press "Save".
• Select the "Columns" tab and select your columns. I like just "Supporter Key" and "Group Name".
• In Conditions, "Group Name" should be "Not Empty".
• Save, Run the report.
• Click the "Export" link.

Tags¶

• Create a new report.
• Select the type of report you would like to create: Standard report
• Use "Advanced Object Chooser".
• Report on "Tags", then "Tags Data", then "Database Table". Press "Save".
• Select the "Columns" tab and select your columns. I like just "Tag" and "Table Key".
  • "Table Key" is the Supporter Key. It's similar to "entity_id" in CiviCRM.
• In "Conditions", "Table Name" should equal "supporter".
• Add another condition: "Tag.Tag" is "Not Empty".
• Save, Run the report.
• Click the "Export" link.

Events¶

As above, but no conditions, and report on the "Event" table. If you're only importing legacy events, this is a good list of easy fields to import:
Event KEY
Reference Name
Event Name
Description
Start
End
Deadline
Maximum Attendees

Participants¶

As above. Report on tables "Supporter Event", then "Event". Note that there are a lot of tables that look like "Supporter Event", like "Supporterevent" and "Supporter Events"!

Note that if you're matching on a unique field from "Events", you can just export "Supporter Event" and not the "Event" table.
Here are the fields I exported and what I matched them to:
Supporter KEY external_identifier
Event KEY event_key
Status status
Type role
Date Created register_date

Actions¶

Salsa has a separate table for actions, making them structurally comparable to Civi Events. A good match in Civi is the Survey entity, which is used for petitions.

Export as above. Report on table "Action".
Condition: "Reference Name" is not empty.

Note: "Description" is likely to contain HTML that breaks the export. I find it helpful to export it as the last column.

Supporter_Actions¶

Export "action" and "supporter_action" and "supporter_action_comment" in that order.
Condition: supporter_key IS NOT NULL

Here's the fields I grabbed with their mapping:
supporter_action.supporter_key
action.Reference Name
supporter_action.Date_Created
supporter_action_comment.Comment details

Chapters¶

• Create a new report.
• Select the type of report you would like to create: Standard report
• Use "Advanced Object Chooser".
• Report "Supporter Chapter", then "Chapter". Press "Save".
• Select the "Columns" tab and select your columns. I like just "Supporter KEY" and "Chapter.Name".
• In Conditions, "Chapter.Name" should be "Not Empty".
• Save, Run the report.
• Click the "Export" link.

Receive_Email field¶

Here's a TSV of how to interpret the "Receive_Email" field.
code # of records meaning
-24 11066 INACTIVE: (5.1.1 User Unknown)
-26 1265 INACTIVE: Address contains RFC spec. invalid characters / is improperly formatted
-3 10596 INACTIVE: UNSUBSCRIBED (actively unsubscribed by user)
-30 8 INACTIVE (Reported as Spam): Other Blacklist (BLACKLIST)
-32 11 (Unknown Status)
-35 1 INACTIVE (Reported as Spam): Outblaze
-4 1 (Unknown Status)
-42 349 INACTIVE (Recipient Initiated Spam Report): MSN/Hotmail/WebTV
-44 10 INACTIVE (Recipient Initiated Spam Report): UNTI (Juno/NetZero/FreeServers)
-45 818 INACTIVE (Recipient Initiated Spam Report): Yahoo
-46 69 INACTIVE (Recipient Initiated Spam Report): Comcast.net
-47 545 INACTIVE (Recipient Initiated Spam Report): AOL
-48 1 INACTIVE (Recipient Initiated Spam Report): RoadRunner
-50 10 ISP Specific Bounces: AIM.com Unactivated account
-51 3 INACTIVE (Recipient Initiated Spam Report): Excite
-52 18 INACTIVE (Reported as Spam): Earthlink
-53 15 (Unknown Status)
-54 1 (Unknown Status)
-60 4 Bad Address/Expired address, etc (n.b.: These addresses are all @democracyinaction.org)
-9 5 INACTIVE: DEATH (supporter has died)
0 1101 0 - Inactive or Unknown(not subscribed)
1 64352 1 - Imported or unknown (subscribed)
10 3 ACTIVE: CONFIRMED (Double opt-in)
3 8924 ACTIVE: CLIENT (Client has directly signed up)