Troubleshooting

Resolving common issues with comparisons and deployments

+13

59 articles in this collection
Written by Kevin Boyle, Jason Mann, Luke and 13 others

Status updates

Incident explanation for API issue May 2021

Error "An internal server error has occurred"

Written by Valerio
Updated over a week ago

Incident explanation for automation jobs Feb 2021

All schedule jobs failed to run on 27th of Feb 2021

Written by Ben Roberts
Updated over a week ago

Incident explanation for API issue Apr 2020

Alternative error: "An unknown error occurred while logging in. Re-authorizing the org may help"

Written by Valerio
Updated over a week ago

Incident explanation for Custom metadata issue Sep 2019

INVALID_TYPE: sObject type '__mdt' is not supported is the error message

Written by Jason Mann
Updated over a week ago

Incident explanation for Winter '20 API issue Sep 2019

Incident explanation for Salesforce Winter '20 API issue

Written by Jason Mann
Updated over a week ago

General

Running tests synchronously in a test monitor

How to change the behavior of your Salesforce org such that test monitor runs will run the tests sequentially instead of in parallel

Written by Luke
Updated over a week ago

Custom metadata filter versus package.xml

Why doesn't my package.xml work?

Written by Valerio
Updated over a week ago

Connections and authentication

Resolving issues logging into Gearset via Salesforce

Fixing common OAuth and cookie issues when using Salesforce to log into Gearset

Written by Valerio
Updated over a week ago

Common authentication and comparison errors

Having trouble running a comparison? These are the most common causes and solutions

Written by Jason Mann
Updated over a week ago

Comparisons and deployments

Why can’t I find specific metadata in my Gearset comparison results?

Explanations for why a metadata item may be missing, and tips to fix this

Written by Carly Hammond
Updated over a week ago

How to use the bisection method to debug retrieval errors?

Written by Valerio
Updated over a week ago

How to solve the Salesforce error "You can't edit tab settings for DelegatedAccount, as it's not a valid tab."

Written by Valerio
Updated over a week ago

Why is my metadata deployed to source control in SFDX or MDAPI format?

How to ensure that your metadata is deployed in the correct format

Written by Valerio
Updated over a week ago

Which destructive changes does the metadata API not handle?

Written by Valerio
Updated over a week ago

Gearset cannot retrieve standard tabs

And how Gearset can retrieve standard tab visibilities

Written by Valerio
Updated over a week ago

Why are my managed package subcomponents showing up inconsistently?

Searching for managed package metadata in your org to org comparisons

Written by Valerio
Updated over a week ago

Why can't I find my difference?

I know there's a difference between my orgs, but I can't find it in Gearset's results - where is it?

Written by Kevin Boyle
Updated over a week ago

Why is XML order of some metadata in the comparison results different?

Salesforce metadata API returns the XML in non-deterministic manner

Written by Valerio
Updated over a week ago

Why are there metadata differences in my freshly refreshed sandbox?

Refreshing does not clone your production.

Written by Valerio
Updated over a week ago

A note on deploying custom object permissions on new profiles

Working around a known issue when setting custom object permissions to false

Written by Valerio
Updated over a week ago

Why can't I see any Apex classes in my comparison?

Written by Ali Daw
Updated over a week ago

Common causes of slow validations or deployments

Why deployment times can vary at different times of the day and the underlying causes

Written by Jason Mann
Updated over a week ago

Changes to Flows in v44 of the metadata API

Written by Valerio
Updated over a week ago

Why is the 'Changed on' date sometimes incorrect?

Understanding why some metadata have incorrect 'Changed on' and 'Changed by' information

Written by Valerio
Updated over a week ago

Why 'Unknown' is sometimes displayed as the 'Changed by' value in the results table

In the results table, we sometimes display 'Unknown' in the 'Changed by' column instead of the name of the user responsible for the change

Written by Stephen Chambers
Updated over a week ago

Known issues when tracking Case Layouts across a time period

Written by Valerio
Updated over a week ago

Incomplete permission report

Why are some results hidden from my permission report and how do I remove the warning?

Written by Ben Scabbia
Updated over a week ago

How to resolve the "QuickText is not a valid Tab" error when deploying Profiles

Error message "You can't edit tab settings for QuickText, as it's not a valid tab"

Written by Valerio
Updated over a week ago

How to resolve the Salesforce error INVALID_TYPE: Cannot use: WorkflowRule in this organization

Written by Claudia McPhail
Updated over a week ago

Are you getting "Invalid api version" when deploying Apex classes?

Written by Valerio
Updated over a week ago

Can Gearset migrate the Email Message Relation object and its encryption setting?

Issues seen with deploying Shield Platform Encryption on EmailMessageRelation

Written by Valerio
Updated over a week ago

What can I do about the error message "Cannot modify managed object"?

Written by Valerio
Updated over a week ago

Custom metadata type "X_mdt" is not available in this organization

Deploying new custom metadata to a target

Written by Valerio
Updated over a week ago

How can I resolve the error 'No more than 10 columns may be specified in lookupPhoneDialogsAdditionalFields'?

Cause and solution for this Salesforce validation/deployment error

Written by Carly Hammond
Updated over a week ago

Deploying Einstein Analytics with Gearset

Einstein Analytics is also known as Tableau CRM

Written by Claudia McPhail
Updated over a week ago

Version control

Whitespace changes for DX repos

Why am I seeing changes where spacing is being removed?

Written by Alex Walter
Updated over a week ago

Structuring your source control repository

There are several options for your metadata's directory structure in source control

Written by Oli Lane
Updated over a week ago

Common problems with viewing metadata in source control

Issues seen with repo directory structures

Written by Valerio
Updated over a week ago

Tips for comparing metadata in source control repositories

5 tips on working with source controlled metadata, structuring your repository, and working with package.xml files

Written by Jason Mann
Updated over a week ago

Connecting to popular on-premise source control systems

This article walks through how to connect to popular on-premise source control systems via username/password, and how to troubleshoot issues

Written by Kevin Boyle
Updated over a week ago

Where are my missing GitHub repositories in Gearset?

Revoke source control connections to find missing organization repositories or change GitHub account

Written by Valerio
Updated over a week ago

Changes to Gearset's XML formatting when writing to version control

Improving whitespace and XML formatting when writing to repositories

Written by Jason Mann
Updated over a week ago

Why do I need to re-authenticate my Bitbucket Cloud connection?

A guide to how to re-validate your connection and why it's necessary

Written by Catherine Bacon
Updated over a week ago

Does your Azure DevOps connection give the error "Gearset can't find any repositories"?

User with multiple Azure DevOps tenants can be connected to Gearset with the wrong one.

Written by Valerio
Updated today

Data loader

Understanding data deployment errors

Identifying and resolving issues when using Gearset's data loader

Written by Jason Mann
Updated over a week ago

Resolving data deployment errors: DUPLICATES_DETECTED

This article explains when and why the DUPLICATES_DETECTED errors occur, and how to fix them

Written by Alex Walter
Updated over a week ago

Resolving data deployment errors: INVALID_CROSS_REFERENCE_KEY: Record Type ID

Troubleshooting errors with Record Types when deploying data

Written by Oli Lane
Updated over a week ago

Resolving data deployment errors: DUPLICATE_VALUE:duplicate value found

This article explains when and why the DUPLICATE_VALUE:duplicate value found error occurs, and how to fix it

Written by Tom Smith
Updated over a week ago

Resolving data deployment errors: DUPLICATE_VALUE & DUPLICATE_EXTERNAL_ID

This article explains when and why the DUPLICATE_VALUE and DUPLICATE_EXTERNAL_ID errors occur, and how to fix them

Written by Tom Smith
Updated over a week ago

Resolving data deployment errors: CANNOT_INSERT_UPDATE_ACTIVATE_ENTITY

This article explains when and why the CANNOT_INSERT_UPDATE_ACTIVATE_ENTITY error occurs and how to fix it

Written by Tom Smith
Updated over a week ago

Resolving data deployment errors: FIELD_CUSTOM_VALIDATION_EXCEPTION

This article explains when and why the FIELD_CUSTOM_VALIDATION_EXCEPTION error occurs, and how to fix it

Written by Simon Breslaw
Updated over a week ago

Resolving data deployment errors: INVALID_OR_NULL_FOR_RESTRICTED_PICKLIST

This article explains when and why the INVALID_OR_NULL_FOR_RESTRICTED_PICKLIST error occurs, and how to fix it

Written by Simon Breslaw
Updated over a week ago

Resolving data deployment errors: REQUIRED_FIELD_MISSING

This article explains when and why the REQUIRED_FIELD_MISSING error occurs, and how to fix it

Written by Simon Breslaw
Updated over a week ago

Data backup

Why can't I restore [Object]History from my data backup?

Written by Toby Newman
Updated over a week ago

Why are there so many new records in my latest data backup run?

Adding support for previously excluded objects means their records will appear as new.

Written by Ali Daw
Updated over a week ago

Why do all the records in my external objects appear to be deleted in my latest data backup run?

External objects are now excluded from data backup runs, as that data resides outside of your Salesforce org

Written by Luke
Updated over a week ago

Replicating issues

How come Gearset doesn't show my item?

Part 1 of 3 of how to use the metadata API with Workbench

Written by Valerio
Updated over a week ago

How to replicate deployment errors with other tools?

Part 2 of 3 of how to use the metadata API with Workbench

Written by Valerio
Updated over a week ago

How to replicate metadata download speeds with Workbench

Part 3 of 3 of how to use the metadata API with Workbench

Written by Carly Hammond
Updated over a week ago