DCS: Adds examples for passing custom configs

The Document Conversion Service behavior can be customized by passing in
various properties as part of the conversion request. See documentation
for more details and exact config property names.

Author: mfulgo

README.md

@@ -303,7 +303,16 @@ var document_conversion = watson.document_conversion({
 document_conversion.convert({
   // (JSON) ANSWER_UNITS, NORMALIZED_HTML, or NORMALIZED_TEXT
   file: fs.createReadStream('sample-docx.docx'),
-  conversion_target: document_conversion.conversion_target.ANSWER_UNITS
+  conversion_target: document_conversion.conversion_target.ANSWER_UNITS,
+  // Add custom configuration properties or omit for defaults
+  word: {
+    heading: {
+      fonts: [
+        { level: 1, min_size: 24 },
+        { level: 2, min_size: 16, max_size: 24 }
+      ]
+    }
+  }
 }, function (err, response) {
   if (err) {
     console.error(err);

test/test.document_conversion.v1-experimental.js

@@ -21,6 +21,14 @@ describe('document_conversion', function() {
 
   var payload = {
     conversion_target: 'ANSWER_UNITS',
+    word: {
+      heading: {
+        fonts: [
+          { level: 1, min_size: 24 },
+          { level: 2, min_size: 16, max_size: 24 }
+        ]
+      }
+    },
     file: fs.createReadStream(__dirname + '/resources/sampleWORD.docx'),
   };
 
@@ -68,5 +76,11 @@ describe('document_conversion', function() {
       assert.equal(req.method, 'POST');
       assert(req.formData);
     });
+
+    it('should send extra config params', function() {
+      var req = servInstance.convert(payload, noop);
+      var config = JSON.parse(req.formData.config.value);
+      assert(config.word.heading.fonts);
+    });
   });
 });

test/test.integration-all-services.js

@@ -591,7 +591,15 @@ describe('integration-all-services', function() {
     it('convertFile()', function(done) {
       document_conversion.convert({
         file: fs.createReadStream(__dirname + '/resources/sampleWORD.docx'),
-        conversion_target: 'ANSWER_UNITS'
+        conversion_target: 'ANSWER_UNITS',
+        word: {
+          heading: {
+            fonts: [
+              { level: 1, min_size: 24 },
+              { level: 2, min_size: 16, max_size: 24 }
+            ]
+          }
+        }
       }, failIfError.bind(failIfError, done));
     });
   });