SitecoreDXG Documention
OverviewGetting StartedDownloadsGitHub Repository
Search…
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
Upgrading and Downgrading
Downloads
Using SitecoreDXG
Using the Default RabbitMQ Middleman and Trigger
Using the Provided AWS S3 Deploy Completion Handler
Using the Provided Azure Blob Storage Deploy Completion Handler
Architecture
Architecture Overview
Roles
Components
Plugins
Middlemen
Understanding the Default RabbitMQ Middleman and Trigger
How To
CI/CD Integration
Creating a Custom Trigger
Slack and Microsoft Teams Integration
Creating a Custom Completion Handler
Creating a Custom Middleman
Viewing Helix Validation Errors
About the Generated Documentation
Overview
Models
Views
Diagrams
Samples
Powered By GitBook
Using SitecoreDXG
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 Understanding the Default RabbitMQ Middleman and Trigger and Using the Default RabbitMQ Middleman and Trigger 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. 1.
    Middleman runs (executed from CLI or automated process)
    1. 1.
      Retrieves serialized data from SitecoreUML Service that is installed on the desired Sitecore instance
    2. 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. 2.
    Trigger runs
    1. 1.
      Trigger listens for messages added to the RabbitMQ generation queues
    2. 2.
      Trigger detects a new message in one of the queues
    3. 3.
      Trigger kicks off the generation action associated with the queue that the message was in and passes in the message contents
  3. 3.
    SitecoreDXG Generation Service executes generation
    1. 1.
      Generated output is saved to an output folder
    2. 2.
      Completion handlers are called based on specified handlers when generation was called or else the default settings of the Generation Service
  4. 4.
    (Optional) Completion handlers run
    1. 1.
      Completion handlers run to do something with the generated output
Getting Started - Previous
Downloads
Next
Using the Default RabbitMQ Middleman and Trigger
Last modified 3yr ago
Copy link
Outline
Executing Generation
High-Level Execution Flow