picklist menus at bottom of Reference Guide

Author: ddooley

lib/DataHarmonizer.js

@@ -1129,12 +1129,35 @@ class DataHarmonizer {
           row_html += `<td>${slot_dict.examples}</td>`;
         }
         if (this.columnHelpEntries.includes('menus')) {
-          row_html += ` <td>${slot_dict.sources || ''}</td>`;
+          row_html += ` <td>${slot_dict.menus || ''}</td>`;
         }
         row_html += '</tr>';
       }
     }
 
+    // Note this may include more enumerations than exist in a given template.
+    let enum_html = ``;
+    for (const key of Object.keys(this.schema.enums).sort()) {
+      const enumeration = this.schema.enums[key];
+      let title = enumeration.title != enumeration.name ? enumeration.title : '';
+      enum_html += `<tr class="section">
+      <td colspan="2" id="${enumeration.name}">${enumeration.name}</td>
+      <td colspan="2">(${title})<br/>${this.renderSemanticID(enumeration.enum_uri)}</td>
+      </tr>`;
+
+      for (const item_key in enumeration.permissible_values) {
+        const item = enumeration.permissible_values[item_key];
+        let text = item.text != item_key ? item.text : '';
+        enum_html += `<tr>
+        <td>${this.renderSemanticID(item.meaning)}</td>
+        <td>${item_key}</td>
+        <td>${text}</td>
+        <td></td>
+        </tr>`;
+      }
+    }
+
+
     var win = window.open(
       '',
       'Reference',
@@ -1195,7 +1218,19 @@ class DataHarmonizer {
     </tbody>
     </table>
     </div>
-    </body>
+    
+        <div>
+          <table>
+            <thead>
+              <tr class="section">
+                <td colspan="4"><h3>${i18next.t('help-picklists')}</h3>
+                </td>
+              </tr>
+            </thead>
+            <tbody>${enum_html}</tbody>
+          </table>
+        </div>
+      </body>
     </html>
     `;
     return false;
@@ -1948,6 +1983,7 @@ class DataHarmonizer {
       guidance: '',
       examples: '',
       sources: '',
+      menus: ''
     };
 
     let guidance = [];
@@ -1992,7 +2028,13 @@ class DataHarmonizer {
       guidance.push(i18next.t('reference_guide_msg_unique_record'));
     }
     if (field.sources && field.sources.length) {
-      let sources = [];
+      let menus = [];
+      for (const item of field.sources) {
+        menus.push('<a href="#'+ item + '" target="_self">' + item +'</a>');
+      }
+      guide.menus = '<ul><li>' + menus.join('</li><li>') + '</li></ul>';
+      /*
+      // List null value menu items directly
       for (const [, item] of Object.entries(field.sources)) {
         // List null value menu items directly
         if (item === 'NullValueMenu') {
@@ -2004,7 +2046,8 @@ class DataHarmonizer {
           sources.push(item);
         }
       }
-      guide.sources = '<ul><li>' + sources.join('</li>\n<li>') + '</li></ul>';
+      */
+      guide.sources = '<ul><li>' + field.sources.join('</li><li>') + '</li></ul>';
     }
     if (field.multivalued) {
       guidance.push(i18next.t('reference_guide_msg_more_than_one_selection'));
@@ -2035,9 +2078,9 @@ class DataHarmonizer {
 
         if (first_item === true) {
           first_item = false;
-          examples += '<ul><li>' + i18next.t(item.value) + '</li>\n';
+          examples += '<ul><li>' + i18next.t(item.value) + '</li>';
         } else {
-          examples += '<li>' + i18next.t(item.value) + '</li>\n';
+          examples += '<li>' + i18next.t(item.value) + '</li>';
         }
       }
       guide.examples = examples + '</ul>';

web/translations/translations.json

@@ -243,6 +243,10 @@
     "en": "Menus",
     "fr": "Menus"
   },
+  "help-picklists": {
+    "en": "Controlled vocabulary picklists",
+    "fr": "Des listes de choix de vocabulaire contrôlé"
+  },
   "reference_guide_title": {
     "en": "Reference Guide for",
     "fr": "Guide de référence pour"