SitecoreDXG Documention
  • SitecoreDXG: The Documentation Experience Generator
  • Overview
    • SitecoreDXG: The Documentation Experience Generator
    • Comparison with SitecoreUML
    • CI/CD Integration
    • Helix Dependency Validation
  • Getting Started
    • Compatibility and System Requirements
    • Installing SitecoreDXG
      • General Installation
        • 1. Install the SitecoreDXG Generation Service
        • 2. Install RabbitMQ
        • 3. Install the SitecoreUML Service for Sitecore
        • 4. (Optional) Configure the Documentation Configuration Item for your Solution
        • 5. Install the Default RabbitMQ Middleman in a Custom Location
        • 6. (Optional) Integrate SitecoreDXG into your CI/CD Pipeline
      • Developer Installation
        • 1. Install the SitecoreDXG Generation Service for Developers
        • 2. Install RabbitMQ for Developers
        • 3. Install the SitecoreUML Service for Sitecore for Developers
        • 4. (Optional) Configure the Documentation Configuration Item for your Solution
        • 5. (Optional) Install the Default RabbitMQ Middleman for Developers
        • 6. (Optional) Integrate SitecoreDXG into your CI/CD Pipeline for Developers
    • Upgrading and Downgrading
    • Downloads
    • Using SitecoreDXG
      • Using the Default RabbitMQ Middleman and Trigger
        • Using the DocumentationConfiguration Object
      • Using the Provided AWS S3 Deploy Completion Handler
      • Using the Provided Azure Blob Storage Deploy Completion Handler
  • Architecture
    • Architecture Overview
    • Roles
      • Role Combinations
    • Components
    • Plugins
      • Trigger Plugins
      • Completion Handler Plugins
    • Middlemen
    • Understanding the Default RabbitMQ Middleman and Trigger
  • How To
    • CI/CD Integration
      • Integrating SitecoreDXG into your CI/CD Pipeline
      • Integrating the Default TeamCity RabbitMQ Meta-Runner
    • Creating a Custom Trigger
      • Executing Documentation Generation
      • Executing Meta-Data JSON Generation
    • Slack and Microsoft Teams Integration
      • Integrating with Slack via Webhooks
      • Integrating with Microsoft Teams via Webhooks
    • Creating a Custom Completion Handler
    • Creating a Custom Middleman
    • Viewing Helix Validation Errors
  • About the Generated Documentation
    • Overview
    • Models
      • Template Model
      • Template Field Model
      • Template Folder Model
      • Parent-Child Relationships of Models
      • Inheritance Relationship Model
      • Dependency Relationship Model
    • Views
      • Template View
      • Template Field View
      • Template Folder View
      • Parent-Child Relationship View
      • Inheritance Relationship View
      • Dependency Relationship View
    • Diagrams
      • SitecoreUML Syntax
      • Templates Diagram
      • Template Folders Diagram
      • Layer Diagrams
      • Module Diagrams
      • Module Templates Diagrams
    • Samples
Powered by GitBook
On this page
  • Executing Generation
  • High-Level Execution Flow
  1. Getting Started

Using SitecoreDXG

PreviousDownloadsNextUsing the Default RabbitMQ Middleman and Trigger

Last updated 6 years ago

SitecoreDXG is meant to be a command-line-based, GUI-less tool that can be called manually from CLI or from an automated process, like a CI/CD pipeline.

In order to understand how SitecoreDXG works, it is suggested that you review the information in the Architecture section before continuing. However, if you wish to get started quickly then the short version is that SitecoreDXG works by using a middleman to retrieve the serialized data from Sitecore and kick off the generation process. At the end of the process, optional completion handlers can be executed to "do something" with the generated output, or you can leave the generated output in the SitecoreDXG output directory for later review/use.

Executing Generation

The execution flow should start by executing the default RabbitMQ Middleman, which will handle kicking off the rest of the process. See and for more details on the default middlemen included with SitecoreDXG, and see below for a high-level overview of the execution workflow.

High-Level Execution Flow

At a high-level, the out of the box process works in the following way (using the RabbitMQ middleman and trigger):

  1. Middleman runs ()

    1. Retrieves serialized data from SitecoreUML Service that is installed on the desired Sitecore instance

    2. Submits returned response to the desired RabbitMQ generation queue (generation_queue__documentation for generating HTML documentation or generation_queue__mdj for generating just the Meta-Data JSON file)

  2. Trigger runs

    1. Trigger listens for messages added to the RabbitMQ generation queues

    2. Trigger detects a new message in one of the queues

    3. Trigger kicks off the generation action associated with the queue that the message was in and passes in the message contents

  3. SitecoreDXG Generation Service executes generation

    1. Generated output is saved to an output folder

    2. Completion handlers are called based on specified handlers when generation was called or else the default settings of the Generation Service

  4. (Optional) Completion handlers run

    1. Completion handlers run to do something with the generated output

Understanding the Default RabbitMQ Middleman and Trigger
Using the Default RabbitMQ Middleman and Trigger
executed from CLI or automated process