Errors (Managed Package)

Not Found (Managed Package)

For the managed package runtime, generally errors are due to missing or incorrect references to other objects.

This information is for Omnistudio for Managed Packages. For Omnistudio on standard runtime, see Omnistudio Help.

Error >> DataRaptor --- GetProducts --- Not Found

The Omnistudio Data Mapper Not Found error means that likely someone deleted or changed the name of the Data Mapper being referenced without updating the Omniscript that uses it.

Error >> VlocityUITemplate --- ShowProducts --- Not Found

The VlocityUITemplate --- ShowProducts --- Not Found error during export means that something, likely an Omniscript, has a reference to a VlocityUITemplate that isn't currently active or doesn't exist in the org as a VlocityUITemplate. In some cases the VlocityUITemplate for an Omniscript can actually be included inside the Visualforce page in which the Omniscript is displayed. In that case, the error can be ignored.

No Match Found (Managed Package)

For the managed package runtime, errors that occur during export often cause errors during deployment. Errors during deployment also occur when a Salesforce Id reference isn't found in the target system.

This information is for Omnistudio for Managed Packages. For Omnistudio on standard runtime, see Omnistudio Help.

Deploy Error >> Product2/02d3feaf-a390-2f57-a08c-2bfc3f9b7333 --- iPhone --- No match 
found for vlocity_cmt__ProductChildItem__c.vlocity_cmt__ChildProductId__c - 
vlocity_cmt__GlobalKey__c=db65c1c5-ada4-7952-6aa5-8a6b2455ea02

In this error, the product being deployed is the iPhone with global key, 02d3feaf-a390-2f57-a08c-2bfc3f9b7333. The error states that one of the product child items couldn’t find the referenced product with global key, db65c1c5-ada4-7952-6aa5-8a6b2455ea02. To address the error, the other product must also be deployed.

No match found for indicates a reference field on the SObject with missing data: <SObject>.<FieldName> or in this example, vlocity_cmt__ProductChildItem__c.vlocity_cmt__ChildProductId__c.

Next, the error indicates what data is in the data pack's saved reference: vlocity_cmt__GlobalKey__c=db65c1c5-ada4-7952-6aa5-8a6b2455ea02. This value is the global key of the Product2 being referenced by the field, ChildProductId__c on the SObject ProductChildItem__c. If it’s clear that the referenced data exists, Product2 with vlocity_cmt__GlobalKey__c=db65c1c5-ada4-7952-6aa5-8a6b2455ea02, make sure that the matching key for this SObject type is correctly aligned between your two environments.

SASS Compilation Error (Managed Package)

For the managed package runtime, when SASS fails to compile, the issue is generally related to the export not including VlocityUITemplates that are referenced as part of the SASS compilation.

This information is for Omnistudio for Managed Packages. For Omnistudio on standard runtime, see Omnistudio Help.

SASS Compilation Error VlocityUITemplate/cpq-total-card 
Failed to compile SCSS: 
.\VlocityUITemplate\cpq-total-card\cpq-total-card.scss SASS 
compilation failed, see error message for details: Error: 
on line 2 of /stdin 
>> @import "cpq-theme-variables";

Export the missing data with this command:

vlocity -job <JobFile> packExport -key VlocityUITemplate/cpq-theme-variables

Validation Errors (Managed Package)

For the managed package runtime, deployments run all of the triggers associated with objects during their import. Because there are various rules across the data model, sometimes errors occur due to attempts to create incorrect data. These issues must be fixed on a case-by-case basis.

This information is for Omnistudio for Managed Packages. For Omnistudio on standard runtime, see Omnistudio Help.

Some errors are related to potential data quality issues. For example:

Product2/adac7afa-f741-80dd-9a69-f8a5aa61eb56 >> IPhone Charger - Error - Product 
you’re trying to add is missing a Pricebook Entry in pricebook >>2018 Pricebook<< 
Please add product to pricebook and try again

This error indicates that one of the child products that’s being added to this product might cause issues because the child product isn't in the 2018 Pricebook. The most simple workaround is to temporarily disable the listed pricebook. This error is generally caused by a cascading failure and can also be solved by deploying the listed pricebook on its own with a command like this example:

vlocity packDeploy -manifest '["Pricebook2/2018 Pricebook"]'

No Configuration Found (Managed Package)

For the managed package runtime, here are some suggestions if you see the No Configuration Found error.

This information is for Omnistudio for Managed Packages. For Omnistudio on standard runtime, see Omnistudio Help.

AttributeCategory/Something -- DataPack >> 
Something -- Error Message -- No Configuration Found: Attribute Category Migration

Run packUpdateSettings or add autoUpdateSettings: true to your job file.

Duplicate Value Found (Managed Package)

For the managed package runtime, some errors are related to conflicting data.

This information is for Omnistudio for Managed Packages. For Omnistudio on standard runtime, see Omnistudio Help.

For Attribute Category Display Sequence you receive this error:

Error >> AttributeCategory/Product_Attributes --- Product Attributes --- 
duplicate value found: <unknown> duplicates value on record with id: <unknown>

This error means that a unique field on the object is a duplicate of an existing unique field value. Unfortunately it doesn’t always provide the actual Id. Update the display sequence value for an existing attribute category object in the target org.

Records with the same display sequence can be found via this SOQL query:

Select Id, Name from %vlocity_namespace%__AttributeCategory__c where 
%vlocity_namespace%__DisplaySequence__c = %DisplaySequence__c from 
DataPack.json file%

Multiple Imported Records Incorrectly Create the Same Salesforce Record (Managed Package)

For the managed package runtime, these errors mean there are duplicates in the data.

This information is for Omnistudio for Managed Packages. For Omnistudio on standard runtime, see Omnistudio Help.

Catalog/Data – Datapack >> Data – Error Message – Incorrect Import Data. Multiple 
Imported Records will incorrectly create the same Salesforce Record. 
vlocity_cmt__CatalogProductRelationship__c: 20MB Plan

Multiple records exist with the same data for the product name,

vlocity_cmt__CatalogProductRelationship__c: 20MB Plan

The matching key for a CatalogProductRelationship__c object is:

%vlocity_namespace%__CatalogId__c, %vlocity_namespace%__Product2Id__c

This error means that there are two references to the same product inside the same catalog, which isn't allowed. Remove the duplicates from the source org and re-export.

Some Records Were Not Processed (Managed Package)

For the managed package runtime, this error means that during the deployment, some of the records that exist as part of the data pack data were not upserted into Salesforce.

This information is for Omnistudio for Managed Packages. For Omnistudio on standard runtime, see Omnistudio Help.

Product2/adac7afa-f741-80dd-9a69-f8a5aa61eb56 -- Datapack >> IPhone Charger -- Error 
Message -- Some records were not processed. Please validate imported data types.

There’s likely a mismatch between the configuration data in the target org compared to the source org. To solve this issue, rerun packUpdateSettings in both orgs.