Syncing Data Dictionary

This feature enables you to retrieve bulk DD data from the Z Understand server and seamlessly integrate it into the local DD.json file.

Prerequisites

  • Ensure that bulk DD data is available on the Z Understand server before proceeding.
  • Configure the Z Understand server within the Bobz extension.

Usage

Here is the sync data dictionary command:
/sync-data-dictionary <program ID>

Procedure

Use the Bob chat interface to run the /sync-data-dictionary command with the program ID:
/sync-data-dictionary <program ID> 
When prompted, approve the Data Dictionary tools for task. Bob then opens the updated Data Dictionary entries in the editor view for review. Verify the changes, and when you complete your review, click I'm done editing. The synchronization process then completes successfully, and the Data Dictionary is updated for the COBOL file.

Usage Scenarios

To view the number of new variable entries available in the central data dictionary after signing in to Z Understand, to update the local data dictionary by importing only the latest additions. Provide the following prompt or command:
update the data dictionary for @programXYZ
Note: If you are prompted to start a workflow, select No thanks option.
A new option appears if Z Understand server is configured, and for the following scenarios:

Scenario 1: Not Signed In to Z Understand

  1. The following option is displayed:

    Synchronize data dictionary from server

  2. No entry count is shown since the user is not authenticated.

Scenario 2: Already Signed In to Z Understand

  • The following option is displayed:

    Synchronize data dictionary from server (XX entries found)

  • The system shows the exact number of entries available for synchronization.
Scenario 3: No Updates are available from server
  • This scenario occurs when:
    • No entries exist on the server.
    • A recent synchronization has already been performed (with the above scenarios, or /sync-data-dictionary command), and no new updates have been made since then.
      Note: The last sync timestamp is stored in .bobz/local-settings.json.
  • In this case, the Synchronize data dictionary from server option is not displayed.