Loading
Nonprofit Success Pack (NPSP) Managed Package
Connect a New Object in Advanced Mapping

Connect a New Object in Advanced Mapping

Advanced Mapping comes with Contacts, Accounts, Opportunities, and other objects already mapped. You can connect additional objects that are directly related to Contacts, Accounts, or Opportunities.

Note
Note Instructions in this article pertain to connecting a previously unmapped object. If you only need to connect a new field, see Customize Advanced Mapping.

Advanced Mapping comes with Contacts, Accounts, Opportunities, and other objects already mapped. You can connect additional objects that are directly related to Contacts, Accounts, or Opportunities. Follow along to see how to connect a new object in Advanced Mapping.

We’ll use the example of Molly at Read Now, an organization dedicated to adult literacy. Molly created a custom object in Salesforce to store constituent responses to Read Now’s annual literature survey. This Survey object is a child of the Contact object, so that Molly can link survey responses to constituent records.

Follow along as Molly connects her custom Survey object in Advanced Mapping.

Create Fields on the NPSP Data Import Object

To map a new object, Molly first creates two fields on the NPSP Data Import object. She uses the Advanced Mapping naming convention of [Object Group Name] Import Status. She plans to name her new Object Group Survey 1, so she uses that as the prefix for her field names.

  1. Molly creates a text field on the NPSP Data Import object to store Survey 1 Import Status:

    New custom field dialog showing Survey 1 Import Status text field with length of 255

    Important
    Important The Import Status field must have a length of 255.
  2. Molly then creates a lookup relationship field called Survey 1 Imported. This field will store a link to the record that NPSP Data Importer created or updated. She relates the field to her custom Survey object.

    Custom lookup field showing selection of Survey in Related To list

Note
Note If you need a refresher on creating custom objects and fields, see Trailhead modules Custom Objects: Quick Look and Custom Fields: Quick Look.

Now, Molly is ready to create the Object Group.

Create an Object Group

Follow along with Molly as she creates an Object Group for her custom Survey object:

  1. Click the NPSP Settings tab. If you don't see the tab, find it in the App Launcher (App Launcher icon).

  2. Click System Tools | Advanced Mapping.
  3. Click Configure Advanced Mapping.

  4. Click Create New Object Group.

  5. Fill in the fields as follows:

    • Group Name: Survey 1 Group. Choose any unique name for the new Object Group.The standard naming convention is [Target Object] Group.

    • Object Name: Survey (Survey__c).  Indicates the target object where the records ultimately end up.

    • Is Child/Parent: Child. Describes how the new Object Group is related to the Object Group in the Of this Object Group field. In this example, Survey 1 Group is a child of Contact 1. 

    • Of this Object Group: Contact 1. The Object Group that the new Object Group is related to. 

    • Through this field: Survey 1 Survey Participant (Survey_1_Survey_Participant__c). Indicates the field on the child object that connects the Object Groups.

    • Link to Record: Survey 1 Imported (Survey_1_Imported__c). Stores a link to the record that was created or updated.

    • Import Status: Survey 1 Import Status (Survey_1_Import_Status__c). Indicates whether NPSP Data Importer successfully processed the record. 

      Create Object Group dialog with fields populated for a new Survey 1 Group Object Group

  6. Save your work.

 
Cargando
Salesforce Help | Article