You must have the data loader installed on your computer before completing bulk action tasks. View the data loader article for installation instructions. You must also be a Salesforce System admin to complete this task. App managers, Site owners/managers, etc. cannot complete this action.
Below are some common Salesforce Objects updated or inserted using Data loader.
Name in Data loader
People Data fields
Add new users and update people data if not using a Syncing source for people data like and HRIS.
Export and update content
Select Id, Simpplr__Text_Intro__c, Simpplr__Text_Main_Continued__c, Simpplr__Text_Main__c, Simpplr__Title__c FROM Simpplr__Simpplr_Content__c.
Import Expertise tags in bulk
Content Document (ContentDocument)
Update the OwnerID to change native file ownership.
Simpplr Site Role
Simpplr Site Role (Simpplr__Site_Role__C)
Check who has Site management credentials for your entire intranet.
Simpplr File (edited)
Simpplr File (Simpplr__File__C)
See the organization and locations of your native files.
Simpplr Audience (Simpplr__Audience__C)
See the audience counts for your sites.
Simpplr People (Simpplr__People__C)
Update people data in Simpplr when using a syncing source like an HRIS.
Adding new users
- Open the data loader application on your computer.
- Click Export.
- Toggle OAuth and select Production.
- Click log in and follow the prompts.
- Click Next.
- Select User (User) and choose your download location for the export. Then click Next.
- Select the fields you want to update. Be sure to include the user email and ID for any export. For new users, include all the fields you want on the user profiles in Simpplr. The following fields are required for all users:
- Click Finish then Yes, and finally Okay. Now open the export file. We'll use this export as our template for creating the new users.
- Create a blank Excel workbook (new Excel file).
- Copy the headers from your export into the first row of the new Excel sheet.
- Save your Excel file with an appropriate file name.
- Add the data for your new users. Use the existing data from your export where you don't have that data already and can see that all users from your export have that element. Note that ProfileId is a standard across all your users of the same type and a key field to pull across from your export.
- Save the Excel file with the new users and their data. Now go back to the data loader application.
- Use the Insert option to add your new users.
- Select the User (User) object.
- Click browse and select the applicable file. then click Next.
- Click Create or Edit a Map.
- Click Auto-Match Fields to Columns.
- This will populate the fields. Review the auto mapping for accuracy. If there are critical blanks, drag and drop the appropriate value from the list above and into the correct section below.
- When finished, click OK, then Next.
- Select a location for Error files on your computer and click Finish. A confirmation box will appear, click Yes.
Click this link for the Salesforce instructions on inserting users with the data loader. The following videos and articles will also help!
- Inserting Users with Data Loader
- How to Use the Data Loader Success and Error Files
- Prepare a CSV file for an import or update in Salesforce
- Install the Data Loader on Windows
- Install the Data Loader on macOS
- User (SOAP API Developer Guide)
- Insert, Update, or Delete Data Using Data Loader
Update People data in bulk
- Use the data loader to export users from the User (User) object. Click Export.
- Log in to the data loader and select User (User). Then click Next.
- Select the Query fields. At a minimum, Email, FederationIdentifier, FirstName, Id, IsActive, LastName, and Username are required. Some users want to update employee hire dates. To do this, add the Joining_Date__c field to your query when exporting users.
- Once you have your fields selected, click Finish and choose Yes from the popup.
- You should have a new Salesforce Export. In it, remove the users you don't need to update. Then update the relevant fields.
- Save your export in CSV format.
- Open the data loader again and click Update.
- Select User (User) and find your new CSV file. Click Next, then Okay.
- Click Create or Edit a Map.
- Click Auto-match Fields to Columns. this should populate the fields. If there are critical blanks, drag and drop the appropriate value from the list above into the correct section below. then click OK, and Next.
- Select a place for the Error files on your computer and click Finish. At the confirmation popup box, click Yes.
Export and update Simpplr content
One use case for exporting content is to replace links throughout the intranet content like Pages. By exporting content, you'll be able to see the written text within a Page, then you can perform a find and replace of the links you'd like to change.
Open the data loader and click Export, then choose Production and log in to your Prod environment.
- Click Allow when logging in to allow the data loader access to your Salesforce data. then click Next.
- Check the box next to Show all Salesforce objects, then find Simpplr content. (Simpplr__Simpplr_Content__c) and click.
- From the Choose a target for extraction field, click Browse, then find a place on your computer you will remember to save the file you're going to download. this may be your desktop, for example. Click Save in the popup. then click Next.
- From the next screen, edit the query field by inputting the following string of text: Select Id, Simpplr__Text_Intro__c, Simpplr__Text_Main_Continued__c, Simpplr__Text_Main__c, Simpplr__Title__c FROM Simpplr__Simpplr_Content__c. (Optionally you can include the object Simpplr__Site__c. This will allow you to sort content by sites, making it easier when sorting through the csv file.)
- Click Finish, then OK.
Note:You can also choose the items from the dropdown list to add to the query field.
- Navigate to the location you saved your file on your computer and open it. You should see all the content in the Simpplr__Text_Intro__C.
- Make any edits needed to the content and save it as a new csv file. Remember the save location because you'll be uploading the file back into Salesforce via the data loader.
To upload the file back into Salesforce:
- From the data loader home, select Update.
- From the list of objects, find and select Simpplr Content (Simpplr__Simpplr_Content__c). then click Browse and open your csv file. Click Next.
- From the popup, click OK.
- Click Create or Edit a Map.
- Select Auto-Match Fields to Columns, then click OK.
- Click Next, then Finish. This updates all content on Simpplr with the changes you made in your csv file.
Bulk upload expertise
You're able to create and upload Expertise in bulk using the data loader. Follow the same steps as above to export data:
- Find the object Simpplr Expertise (Simpplr__Expertise__c) and add it to the string for the export.
- Add both Simpplr__Display_Name__c and Simpplr__Name__c to the string and click Finish. this will begin your export.
- Open the csv file with Excel, and in the Simpplr__Display_Name__c column, enter new expertise, or replace the existing expertise name as how you want it to appear in Simpplr, e.g., Public Relations.
- In the Simpplr__Name__c field, the values must be alphanumeric in lower case, e.g., only Alphabets and Numbers, e.g publicrelations.
- Once you've completed and saved the csv file with the new expertise, open the data loader and use Insert. Follow the prompt to log in if it asks, select the Simpplr__Expertise__c object and insert the file. To finish, click Next, then Finish. The new data will be reflected in your Salesforce/Simpplr instance.
Reactivating previously deactivated users
If you've deactivated users and need to reactivate them for any reason (seasonal employees, interns, etc.) the data loader is the best way to switch their active status. To do so:
- Export a list of all your users (Active and Inactive) by clicking Export from the data loader home. Log into your Production environment (if not already), and when prompted, find the User (User) object and select.
- Choose a save location for your file and click Next.
- Where you see the option to choose the query fields below, select Email, Id, and IsActive. The generated query should look like the image below. Click FINISH.
- Make sure there were no errors during the extraction, then open the CSV file from the download location you set. We recommend opening the file with Excel.
- The CSV file should look similar to the image below. Deactivated users are marked "FALSE" in the ISACTIVE column. In that column, for the users you want to reactivate, change any fields currently marked "FALSE" to "TRUE". Save your file.
- Now you can upload the file via the data loader to save your changes in Salesforce/Simpplr.
- Back on the data loader home screen, click Update. Find the User (User) object again and choose the CSV file you just saved. Click Next.
- From the next screen, ensure the same fields from the extract are all selected (ID, EMAIL, ISACTIVE). If they're not there, click Create or Edit a Map and assign those fields. Click Next.
- Choose your Directory save location (where the file will be saved) and click Finish.
- Head back to Salesforce. In the User menu, verify your users have been reactivated by making sure the Active box is checked in their profile.