Updating your Content Fragments for optimized GraphQL Filtering

Last update: 2023-10-02

To optimize the performance of your GraphQL filters, run a procedure to update your Content Fragments.

NOTE

After updating your Content Fragments, you can follow the recommendations for Optimizing GraphQL Queries.

Prerequisites

Ensure that you have a minimum of the 6.5.17.0 release of AEM.

Updating your Content Fragments

To run the procedure, use the following steps:

  1. Configure the OSGi settings for the Content Fragment Migration Job Configuration:

    OSGi Content Fragment Migration Job Configuration
  2. In the dialog, set these two parameters as follows:

    • ContentFragmentMigration:Enabled : 1
    • ContentFragmentMigration:Enforce : 1
  3. Save the specifications - the update procedure starts.

  4. Wait until the procedure is completed. The procedure is complete when the property cfGlobalVersion appears on /content/dam and is set to 1.

  5. Return to the OSGi configuration to deactivate the procedure.

    In the dialog for the Content Fragment Migration Job Configuration set these two parameters as follows:

    • ContentFragmentMigration:Enabled : 0
    • ContentFragmentMigration:Enforce : 0

Limitations

Be aware of the following limitations:

  • Optimization of the performance of GraphQL filters will only be possible after a complete update of all your Content Fragments (indicated by the presence of the cfGlobalVersion property for the JCR node /content/dam)

  • If Content Fragments are imported from a content package (using crx/de) after the update procedure is run, then those Content Fragments will not be considered in the GraphQL query results, until the update procedure is executed again.

On this page