DDI 4 Sprint in Toronto, June 2014

Introduction

We started with the concept for a production workflow as designed in the previous sprint in Vancouver (figure 1) and identified a couple of issues (documented in the Wiki: IASSIST sprint, technical group). Because we were able to solve most of these issues during the sprint, this document focuses on only a subset of issues where the solution is important to document for subsequent work.

Out of our 11 issues, we selected one as our overall goal for this sprint: to produce a working prototype for the production workflow to prove the overall concept.

Figure 1: Production system as designed in Vancouver (deprecated)

Issues discussed

Identifiers

...

XMI export from Drupal should put its own UUID there. The information is confirmed by manual testing to be both displayed in EA, exported safely and visible again on re-import. Behavior on object changes, deletion, etc. needs to be determined. 

Update:

UUIDs are now automatically created in Drupal for all packages and objects. These get exported in the xmi export from Drupal. However a prefix (ddi4-)needs to be added as xml id doesn’t support numbers as first character. will be used as prefix.

Example: ddi4-0bea67ee-c3e0-4620-b8f0-3f763d734ec8

In the docbook export from Drupal a suffix might also be added to specify sections in the document.

Example: ddi4-0bea67ee-c3e0-4620-b8f0-3f763d734ec8-definition

Diagrams

We identified a basic structure for diagrams to document our model.

...

After substantial discussion of the production workflow (Vancouver version) we did some modifications to the design, documented in figure 2.

Figure 2: Production system as designed in Toronto

Handling updates in Drupal and EA

...

EA can version per package. XMI is used as transport format between EA and version control repository.

Figure 3: Using Drupal and EA with one central repository

Drupal could use the version control repository as source for the own data base tables.

...