Export Parts - Oracle CPQ as Parts Source
Overview
Updating the Partner Parts Database
Parts
- If an attempt is made to export a part that has already been added to the Partner database in an earlier export, then that part is updated to the latest export.
- If a new part (a part that was created after the last export) is exported, then that part is added to the Partner parts database.
With Parts Extended Description
- Parts Extended Description Fields can be mapped to custom fields in partner systems.
- The Parts database must be synchronized before Extended Description export is performed.
- If the size of the exported data is larger than the mapped field size in Salesforce, the export data may be truncated.
- If the size of the exported data is larger than the mapped field size in Siebel, then an error is thrown.
Updating the Partner Price Books (Salesforce Only)
Using a Price Books Export
- A Price Book in CPQ can be mapped to a Price Book in Salesforce in a one-to-one relationship only.
- If a part that has a base price but is not associated with a Price Book is exported, then that part will be associated with the Standard Price Book in Salesforce.
Administration
Exporting Parts with Oracle CPQ as the Parts Source
If the Partner system is Salesforce, then map the default Price Book to the Salesforce standard Price Book. Go to Step 6 if the Partner system is Siebel.
- Navigate to the Price Book Administration page.
- Click Admin to go to the Admin Home Page.
Click Parts under Products.
The Parts Search for Admin page opens.
Click List in the Price Book section.
The Price Book Administration List page opens.
Click the Name of the Price Book you want to export.
The Price Book Administration page opens.
-
In the Integration section, fill in the Partner Price Book ID.
The Partner Price Book ID is available as a 15 character alphanumeric ID on the URL of that particular Price Book’s page on Salesforce.com.
-
Repeat Steps 1-2 to map the chosen Price Books with the corresponding Salesforce Price Books.
Price books can only be mapped in as a one-to-one relationship.
-
Click Integration to access the List Integrations page.
The SOAP Generator XSL and the Result Parser XSL must be loaded for both parts import and, if applicable, Price Book import.
- In the List Integrations page, click the Name (for example, Import Parts or Import Price Book Entries).
-
Load the SOAP Generator XSL and the Result Parser XSL by clicking Browse and loading the needed files.
Default SOAP Generator XSL and Result Parser XSLs are provided via links
- Click Apply to save your changes and remain on the page.
Handling Salesforce Multi-select Attributes for mapping with corresponding Attributes
Use the template provided in the Result XSL, to map the multi-select attributes of Salesforce with the corresponding attributes:
</xsl:template>
<!-- Template to replace charsIn(";") delimiter string with charsOut("~") delimiter string -->
<xsl:template name="replaceCharsInString">
<xsl:param name="stringIn"/>
<xsl:param name="charsIn"/>
<xsl:param name="charsOut"/>
<xsl:choose>
<xsl:when test="contains($stringIn,$charsIn)">
<xsl:value-of select="concat(substring-before($stringIn,$charsIn),$charsOut)"/>
<xsl:call-template name="replaceCharsInString">
<xsl:with-param name="stringIn" select="substring-after($stringIn,$charsIn)"/>
<xsl:with-param name="charsIn" select="$charsIn"/>
<xsl:with-param name="charsOut" select="$charsOut"/>
</xsl:call-template>
</xsl:when>
<xsl:otherwise>
<xsl:value-of select="$stringIn"/>
</xsl:otherwise>
</xsl:choose>
</xsl:template>
- Select Export Parts and/or Export Price Book Entries.
-
Click Export to invoke the Export action.
Click Schedule, in the List Integrations page, to access the scheduler. You can schedule integrations hourly, daily, weekly, monthly, or on demand.
CRM Delta Parts Sync
The Integration of Parts, Parts Extended Descriptions, and Price Book information between CRMs and Oracle CPQ occurs incrementally. You can choose to send parts when syncing/scheduling a Delta Parts Sync; for example, when exporting and/or importing parts from the last export/import date.
- Navigate to the List Integrations page.
- Click Admin to go to the Admin Home Page.
Click Parts under Products.
The Parts Search for Admin page opens.
Click List in the Price Book section.
The Price Book Administration List page opens.
Click the Name of the Price Book you want to export.
The Price Book Administration page opens.
Click Integration.
The List Integrations page opens.
-
Select the Delta checkbox.
This reduces overall Integration time.
Establish Oracle CPQ as the Parts Source for an Oracle Product Information Management (PIM) Integration
The Export Parts integration synchronizes any changes made to parts in the Oracle CPQ into the PIM Item Master.
View Parts Source in Oracle CPQ:
- Sign in to Oracle CPQ as a parts administrator or as a Full Access user.
- Navigate to the Admin Home page.
- Click Parts under Products. The Parts Search for Admin page appears. The application listed under Item Master is currently the Parts Master ("BigMachines" means that Oracle CPQ is the Parts source).
Export Parts:
- Sign in to Oracle CPQ as a Full Access user.
- Navigate to the Admin Home page.
- Click Parts under Products. The Parts Search for Admin page appears.
- Click Integration.
- Select the check box for the Export Parts integration.
-
Upload the Integration XSL file for SOAP Generation. The integration uses the "process Item" SOAP web service of Product Information Management. Both the standard and custom part fields can be mapped in the SOAP Generation XSL file, according to the business requirements in the implementation. The field, _partner_part_id, is the primary field for mapping and is used as cross-reference for the integration.
- Click Export to perform a one-time integration, or click the Schedule button to schedule a one-time integration or recurring integrations.
- If you schedule one or more integrations, the new schedule details for job import dialog box appears.
- Select a Schedule Type and the corresponding frequency.
- Monthly: Select the day of the month and the time of the integration.
- Weekly: Select the day of the week and the time of the integration.
- Daily: Select the time of the integration.
- Hourly: Select an interval of 1-23 hours.
- On Demand: Select the date and time of a one-time integration.
- You can add start and end dates for a recurring integration.
- Select either All Parts or Delta, depending on whether all parts always need to be integrated or only parts that are modified since the last integration.
- When you're done with the scheduling details, click Add Schedule.
- You can refer to the integration logs available in the Parts Integration and error logs for any troubleshooting or diagnosis.
Notes
Parts Export no longer includes Price Book Associations columns. Users may still import older Excel documents that contain Price Book Associations columns.
Parts Integration is not enabled for all applications. Contact your Oracle CPQ application sales representative to enable this feature.
Export Price Book Associations separately.
Price Book Entries should be exported only after the parts are exported. If you to run a Price Book Entries export without running a parts export, then you must manually make sure that the parts databases are synchronized.
Related Topics
See Also