Preflight Check

A preflight check runs automatically at specific times before a scheduled update commences.

The preflight check ensures the customer org custom relationships limit is not exceeded during the scheduled update.

Note: You must access the System Administrator page within the Foundations workspace to enable the preflight check to run.

What is checked?

The following limit is checked during the preflight check:

The Custom Object Relationship Limit

Custom Object relationships link objects with each other so that when you view a record you can also see the related data.

Each Salesforce object can have a maximum of 40 custom relationships, including Master-Detail and Lookup.

40 custom relationships per Salesforce object is the default value. The limit can be increased to 50 by request.

Before Certinia scheduled updates are installed in a customer org, the preflight check is carried out by the system to ensure the custom relationship limits are not exceeded when the scheduled update is performed.

The custom relationship limit is determined by the custom object allocation for the customer org.

Retrieving Limits From the Customer Org

The custom relationship limits are retrieved from the customer org each day at 00:30 in the customer's timezone.

For more information on Salesforce custom relationships, see the Salesforce help.

Exceeding the Custom Relationship Limit

Custom relationship limits might be exceeded during a preflight check when:

  • The total number of custom relationships before upgrade plus any added to the new version of a Certinia package exceeds the limit.
  • The total number of custom relationships plus any added by the customer between versions of Certinia packages plus any added to the new version of a Certinia package exceeds the limit.

Running the Preflight Check

The preflight check runs automatically before the scheduled update commences as follows:

  • Seven days before
  • Four days before
  • One day before

Notification of Issues Found During a Preflight Check

Note:

Preflight check notifications display technical data associated with Salesforce standard objects and Certinia custom object relationships. No customer data contained in fields associated with Salesforce standard object or Certinia custom object relationships is displayed in preflight check notifications.

A failure of the preflight check initiates a notification on the customer org scheduled update case.

The notification is one of the following:

  • The preflight check failed.
  • The preflight check passes following an initial failure. A case comment is created.
  • The PPreq (Portfolio Push request) is Cancelled.

The Preflight Check Failed

A case comment is created. The notification lists the errors found during the preflight check.

The Preflight Check Passes Following an Initial Failure

The notification advises the preflight check ran successfully after an initial failure.

The PPreq is Cancelled

If the update couldn’t be performed because a preflight check failed within 24 hours of the scheduled start of the update, the PPreq will be cancelled. Contact the NPI team to schedule another update.

Note:

When a preflight check passes there is no requirement to create a notification on the scheduled update case.

Action Following a Preflight Check Failure

When a preflight check fails, remedial action can include the following:

  • Carrying out org housekeeping to reduce the number of custom object relationships.
  • Request the Salesforce custom relationships limit is increased.

The preflight check failure notification will contain details of which objects should be the focus of any remedial action.