add redaction, fix links, update curl examples

Author: qqmyers

6.1curlcommands.md

@@ -2008,7 +2008,61 @@ curl -X POST -H 'Content-type: application/json' http://localhost:8080/api/admin
 These previewers support the [REFI-QDA standard](https://www.qdasoftware.org/) format for qualitative research files.
 They allow viewing of the authors, codes, sources, annotations, and relationships listed in the codebook, 
 with added functionality to view code use frequency and filter by the entries in these tables. The REFI-QDA Project previewer
-also allows viewing the annotation anchor text retrieved from the zipped source files.
+also allows viewing the annotation anchor text retrieved from the zipped source files and download of the original and text versions of source files.
+Further, for users who can edit the dataset, the Codebook and Project Previewers allow creation of "redacted" versions that become publicly previewable 
+even when the datafiles themselves are restricted. The "View *" previewers will only show when the user can download the datafile, while the "View Redacted *" previewers
+will show all the time. As the first available previewer shows as the default one in the dataset files table, it is recommended that these previewers
+be installed in the order shown below (so the full previewers are the default for those who can download the datafile).
+
+
+
+```bash
+curl -X POST -H 'Content-type: application/json' http://localhost:8080/api/admin/externalTools -d \
+'{
+  "displayName":"View REFI-QDA Codebook",
+  "description":"View the contents of a REFI-QDA codebook file.",
+  "toolName":"refiqdaCodebookPreviewer",
+  "scope":"file",
+  "types":["preview"],
+  "toolUrl":"/dataverse-previewers/previewers/betatest/REFIQDAPreview.html",
+  "toolParameters": {
+      "queryParameters":[
+        {"fileid":"{fileId}"},
+        {"siteUrl":"{siteUrl}"},
+        {"datasetid":"{datasetId}"},
+        {"datasetversion":"{datasetVersion}"},
+        {"locale":"{localeCode}"}
+      ]
+    },
+  "contentType":"text/x-xml-refiqda",
+  "allowedApiCalls": [
+    {
+      "name": "retrieveFileContents",
+      "httpMethod": "GET",
+      "urlTemplate": "/api/v1/access/datafile/{fileId}?gbrecs=true",
+      "timeOut": 3600
+    },
+    {
+      "name": "downloadFile",
+      "httpMethod": "GET",
+      "urlTemplate": "/api/v1/access/datafile/{fileId}?gbrecs=false",
+      "timeOut": 3600
+    },
+    {
+      "name": "uploadRedactedFile",
+      "httpMethod": "POST",
+      "urlTemplate": "/api/v1/access/datafile/{fileId}/auxiliary/qdc/1.0",
+      "timeOut": 3600
+    },
+    {
+      "name": "getDatasetVersionMetadata",
+      "httpMethod": "GET",
+      "urlTemplate": "/api/v1/datasets/{datasetId}/versions/{datasetVersion}",
+      "timeOut": 3600
+    }
+  ]
+}'
+```
 
 ```bash
 curl -X POST -H 'Content-type: application/json' http://localhost:8080/api/admin/externalTools -d \
@@ -2018,7 +2072,7 @@ curl -X POST -H 'Content-type: application/json' http://localhost:8080/api/admin
   "toolName":"refiqdaProjectPreviewer",
   "scope":"file",
   "types":["preview"],
-  "toolUrl":"https://gdcc.github.io/dataverse-previewers/previewers/betatest/REFIQDPXPreview.html",
+  "toolUrl":"/dataverse-previewers/previewers/betatest/REFIQDPXPreview.html",
   "toolParameters": {
       "queryParameters":[
         {"fileid":"{fileId}"},
@@ -2042,6 +2096,12 @@ curl -X POST -H 'Content-type: application/json' http://localhost:8080/api/admin
       "urlTemplate": "/api/v1/access/datafile/{fileId}?gbrecs=false",
       "timeOut": 3600
     },
+    {
+      "name": "uploadRedactedFile",
+      "httpMethod": "POST",
+      "urlTemplate": "/api/v1/access/datafile/{fileId}/auxiliary/qdpx/1.0",
+      "timeOut": 3600
+    },
     {
       "name": "getDatasetVersionMetadata",
       "httpMethod": "GET",
@@ -2055,12 +2115,62 @@ curl -X POST -H 'Content-type: application/json' http://localhost:8080/api/admin
 ```bash
 curl -X POST -H 'Content-type: application/json' http://localhost:8080/api/admin/externalTools -d \
 '{
-  "displayName":"View REFI-QDA Codebook",
-  "description":"View the contents of a REFI-QDA codebook file.",
-  "toolName":"refiqdaCodebookPreviewer",
+  "displayName":"View Redacted REFI-QDA Project",
+  "description":"View the contents of a redacted EFI-QDA project file.",
+  "toolName":"refiqdaRedactedProjectPreviewer",
   "scope":"file",
   "types":["preview"],
-  "toolUrl":"https://gdcc.github.io/dataverse-previewers/previewers/betatest/REFIQDAPreview.html",
+  "toolUrl":"/dataverse-previewers/previewers/betatest/REFIQDPXPreview.html",
+  "toolParameters": {
+      "queryParameters":[
+        {"fileid":"{fileId}"},
+        {"siteUrl":"{siteUrl}"},
+        {"datasetid":"{datasetId}"},
+        {"datasetversion":"{datasetVersion}"},
+        {"locale":"{localeCode}"}
+      ]
+    },
+  "contentType":"application/x-zip-refiqda",
+  "requirements": {
+    "auxFilesExist": [
+      {
+        "formatTag": "qdpx",
+        "formatVersion": "1.0"
+      }
+    ]
+  },
+  "allowedApiCalls": [
+    {
+      "name": "retrieveFileContents",
+      "httpMethod": "GET",
+      "urlTemplate": "/api/v1/access/datafile/{fileId}/auxiliary/qdpx/1.0?gbrecs=true",
+      "timeOut": 3600
+    },
+    {
+      "name": "downloadFile",
+      "httpMethod": "GET",
+      "urlTemplate": "/api/v1/access/datafile/{fileId}/auxiliary/qdpx/1.0?gbrecs=false",
+      "timeOut": 3600
+    },
+    {
+      "name": "getDatasetVersionMetadata",
+      "httpMethod": "GET",
+      "urlTemplate": "/api/v1/datasets/{datasetId}/versions/{datasetVersion}",
+      "timeOut": 3600
+    }
+  ]
+}'
+```
+
+```bash
+curl -X POST -H 'Content-type: application/json' http://localhost:8080/api/admin/externalTools -d \
+'{
+ "displayName":"View Redacted REFI-QDA Codebook",
+  "description":"View the contents of a redacted REFI-QDA codebook file.",
+  "toolName":"refiqdaRedactedCodebookPreviewer",
+  "scope":"file",
+  "types":["preview"],
+  "toolUrl":"/dataverse-previewers/previewers/betatest/REFIQDAPreview.html",
   "toolParameters": {
       "queryParameters":[
         {"fileid":"{fileId}"},
@@ -2071,17 +2181,25 @@ curl -X POST -H 'Content-type: application/json' http://localhost:8080/api/admin
       ]
     },
   "contentType":"text/x-xml-refiqda",
+  "requirements": {
+    "auxFilesExist": [
+      {
+        "formatTag": "qdc",
+        "formatVersion": "1.0"
+      }
+    ]
+  },
   "allowedApiCalls": [
     {
       "name": "retrieveFileContents",
       "httpMethod": "GET",
-      "urlTemplate": "/api/v1/access/datafile/{fileId}?gbrecs=true",
+      "urlTemplate": "/api/v1/access/datafile/{fileId}/auxiliary/qdc/1.0?gbrecs=true",
       "timeOut": 3600
     },
     {
       "name": "downloadFile",
       "httpMethod": "GET",
-      "urlTemplate": "/api/v1/access/datafile/{fileId}?gbrecs=false",
+      "urlTemplate": "/api/v1/access/datafile/{fileId}/auxiliary/qdc/1.0?gbrecs=false",
       "timeOut": 3600
     },
     {

previewers/betatest/js/refiqda.js

@@ -16,5 +16,5 @@ function writeContent(fileUrl, file, title, authors) {
   }
   fetch(fileUrl)
     .then(response => response.text())
-    .then(data => parseData(data));
+    .then(data => parseData(data, file));
 }