Migrating from Proposals to Documents
Where once you relied on TinderBox Proposals, now you’re getting the job done in Conga Collaborate Documents.
Migrate your Conga Collaborate document records from the Octiv Proposal object to the Octiv Document object.
The Octiv Document object provides more flexibility in creating documents and will be the object supported and upgraded in future managed package releases. The Octiv Proposal object will not be removed for legacy customers, but updates will not be made to it going forward
Pre-Migration Preparation
There are a couple of things that you must check before migrating your proposals:
- If you have created custom fields on the Octiv Proposal object, make sure that you create those same fields on the Octiv Document object
- Check that your users have permissions to Read and Write to the Octiv Document object and also that they have Read/Write permissions on all the fields on the Octiv Document object
Export Octiv Proposal data
You can use whatever data loader tool you like, but we recommend dataloader.io. The instructions below apply specifically to dataloader.io, but also work with Salesforce Data Loader with some slight tweaks due to the different user interfaces.
Prepare Export File for Creating Octiv Documents
- Open the export file you created in the Export Octiv Proposal data section
- Copy the values in the column Created By ID
- Add a column to the right of Created By ID
- Paste the values copied in step 2 into the new, empty column
- Rename the column Owner ID
- Save this file as a CSV
Import Octiv Documents via dataloader.io
- In dataloader.io, click New Task, then select Import
- Select the Insert operation
- Search for and select Octiv Document
- Click Next
- Drag and drop the CSV file from the Prepare export file for creating Octiv documents section, or simply click Upload CSV and select the file from your computer
- Find Proposal Name under Source Header, and click Select under Salesforce Field
- Select Document Name. If you have created custom fields on either the Octiv Proposal or Octiv Document object, ensure that those columns in the CSV are mapped to their corresponding fields on the Octiv Document object
- Click Next
- Click Save & Run
- Verify that Documents were properly created by refreshing the report from the Export Octiv Proposal data section.
(Optional) Delete Octiv Proposals via dataloader.io
Migrating Octiv Proposal records to Octiv Document records does not delete the old Proposal records. If you wish to delete these old records, follow these steps:
- In dataloader.io, click New Task, then select Delete
- Search for and select the Octiv Proposal object
- Click Next
- Drag and drop the export file you built in the Prepare Export File for Creating Octiv Documents section, or simply click Upload CSV and select the file from your computer
- Click Next. The screen asks which column contains the IDs of the records to be deleted
- Select the row with Source Header Record ID
- Click Next
- Click Save and Run
Repeat this process as necessary until you’ve migrated all of your Octiv Proposal records to Octiv Document records.