HPCC-11438 DOCS:Data Tutorial update ECL Watch V

Fix HPCC-11438 DOCS:Data Tutorial update ECL Watch V
Updates to Data Tutorial images and text
for ECL Watch 5.0

Signed-off-by: g-pan <greg.panagiotatos@lexisnexis.com>

docs/HPCCDataTutorial/DataTutorial.xml

@@ -33,7 +33,7 @@
       used in this manual are fictitious. Any similarity to actual persons,
       living or dead, is purely coincidental.</para>
 
-      <para> </para>
+      <para></para>
     </legalnotice>
 
     <xi:include href="common/Version.xml" xpointer="FooterInfo"
@@ -260,9 +260,9 @@
         defined in your HPCC's environment. A daemon (DaFileSrv) must be
         running on that server to enable file sprays and desprays.</para>
 
-        <para>For smaller data files, maximum of 2GB, you can use the
-        upload/download file utility in ECL Watch (a Web-based interface to
-        your HPCC platform). The sample data file is ~100 mb.</para>
+        <para>For smaller data files, you can use the upload/download file
+        utility in ECL Watch (a Web-based interface to your HPCC platform).
+        The sample data file is ~100 mb.</para>
 
         <orderedlist>
           <listitem>
@@ -315,9 +315,13 @@
           <listitem>
             <?dbfo keep-together="always"?>
 
-            <para>From ECL Watch page, click on the <emphasis
-            role="bold">Upload/download File </emphasis> link in the menu on
-            the left side.</para>
+            <para>From the ECL Watch home page, click on the <emphasis
+            role="bold">Files</emphasis> icon, then click the <emphasis
+            role="bold">Landing Zones</emphasis> link from the navigation
+            sub-menu.</para>
+
+            <para>Press on the <emphasis role="bold">Upload </emphasis>action
+            button on the Landing Zones tab.</para>
 
             <para><figure>
                 <title>Upload/download</title>
@@ -330,13 +334,21 @@
                 </mediaobject>
               </figure></para>
 
-            <para>Once you click on the Upload/download file link, it will
-            take you to the Dropzones and Files page, where you can choose to
-            <emphasis role="bold">Browse</emphasis> your machine for a file to
-            upload:</para>
+            <para>Once you press the Upload button, a dialog opens where you
+            can choose to <emphasis role="bold">Browse</emphasis> for a file
+            to upload. </para>
+          </listitem>
+
+          <listitem>
+            <para>Browse the files on your local machine, select the file to
+            upload and then press the <emphasis role="bold">Open</emphasis>
+            button.</para>
+
+            <para>The file you selected should appear in the <emphasis
+            role="bold">File Uploader</emphasis> dialog. </para>
 
             <para><figure>
-                <title>Dropzones and Files</title>
+                <title>File Uploader</title>
 
                 <mediaobject>
                   <imageobject>
@@ -348,19 +360,7 @@
           </listitem>
 
           <listitem>
-            <para>Press the <emphasis role="bold">Browse</emphasis> button to
-            browse the files on your local machine, select the file to upload
-            and then press the <emphasis role="bold">Open</emphasis>
-            button.</para>
-
-            <para>The file you selected should appear in the <emphasis
-            role="bold">Select a file to upload:</emphasis> field. The data
-            file is named: <emphasis role="bold">OriginalPerson.
-            </emphasis></para>
-          </listitem>
-
-          <listitem>
-            <para>Press on <emphasis role="bold">Upload Now</emphasis> to
+            <para>Press the <emphasis role="bold">Start</emphasis> button to
             complete the file upload.</para>
           </listitem>
         </orderedlist>
@@ -384,7 +384,7 @@
         role="bold">YN</emphasis><emphasis
         role="bold">::OriginalPerson</emphasis><emphasis role="bold">
         </emphasis>where <emphasis role="bold">YN</emphasis> are your
-        initials. The Distrubuted File Utility maintains a list of logical
+        initials. The Distributed File Utility maintains a list of logical
         files and their corresponding physical file locations.</para>
 
         <orderedlist>
@@ -399,32 +399,68 @@
           </listitem>
 
           <listitem>
-            <para>Click on the <emphasis role="bold">Spray Fixed</emphasis>
-            hyperlink under the DFU Files menu on the left.</para>
+            <?dbfo keep-together="always"?>
 
-            <para>The <emphasis role="bold">DFU Spray Fixed</emphasis> page
-            displays.</para>
+            <para>From the ECL Watch home page, click on the <emphasis
+            role="bold">Files</emphasis> icon, then click the <emphasis
+            role="bold">Landing Zones</emphasis> link from the navigation
+            sub-menu.</para>
+
+            <para>On the Landing Zones tab, click on the arrow next to your
+            mydropzone container to see a list of uploaded files. <figure>
+                <title>mydropzone</title>
+
+                <mediaobject>
+                  <imageobject>
+                    <imagedata fileref="images/LZimg000.jpg"
+                               vendor="eclwatchSS" />
+                  </imageobject>
+                </mediaobject>
+              </figure></para>
+
+            <para>Find the file you want to spray in the list
+            (OriginalPerson), check the box next to that file name to select
+            that file. </para>
+
+            <para>Once you select the file from the list, the <emphasis
+            role="bold">Spray</emphasis> action buttons become enabled.
+            </para>
           </listitem>
 
           <listitem>
-            <para>Using the Source <emphasis
-            role="bold">Machine/dropzone</emphasis> drop list, select the
-            Landing Zone where the file was placed.</para>
+            <para>Press the <emphasis role="bold">Fixed</emphasis> action
+            button. <figure>
+                <title>Spray: Fixed action button</title>
 
-            <para>In the VM or Community Edition, there is only one Landing
-            Zone.</para>
+                <mediaobject>
+                  <imageobject>
+                    <imagedata fileref="images/LZimg001.jpg"
+                               vendor="eclwatchSS" />
+                  </imageobject>
+                </mediaobject>
+              </figure></para>
 
-            <para>The IP Address is automatically filled and the Local Path is
-            partially filled with the default folder on your landing
-            zone.</para>
+            <para>The <emphasis role="bold">Spray Fixed</emphasis> dialog
+            displays.</para>
           </listitem>
 
           <listitem>
-            <para>Complete the <emphasis role="bold">Local Path</emphasis> to
-            include the complete file name or use the <emphasis
-            role="bold">Choose File</emphasis> button to select the file from
-            a list of files in the folder. (The file to choose is
-            <emphasis>OriginalPerson</emphasis>)</para>
+            <para>The Target name field is automatically filled in with the
+            selected file. <figure>
+                <title>Spray Fixed dialog</title>
+
+                <mediaobject>
+                  <imageobject>
+                    <imagedata fileref="images/LZimg002.jpg"
+                               vendor="eclwatchSS" />
+                  </imageobject>
+                </mediaobject>
+              </figure></para>
+          </listitem>
+
+          <listitem>
+            <para>Choose the mythor cluster from the <emphasis
+            role="bold">Group</emphasis> drop list. </para>
           </listitem>
 
           <listitem>
@@ -433,11 +469,10 @@
           </listitem>
 
           <listitem>
-            <para>Fill in the <emphasis role="bold">Label</emphasis> using the
-            naming convention described earlier: <emphasis
+            <para>Fill in the <emphasis role="bold">Name Prefix</emphasis>
+            using the naming convention described earlier: <emphasis
             role="bold">tutorial::</emphasis><emphasis
-            role="bold">YN</emphasis><emphasis
-            role="bold">::OriginalPerson</emphasis> (remember, <emphasis
+            role="bold">YN</emphasis> (remember, <emphasis
             role="bold">YN</emphasis> are your initials).</para>
           </listitem>
 
@@ -450,28 +485,18 @@
 
             <para><emphasis role="bold">Note:</emphasis> This option is only
             available on systems where replication has been enabled.</para>
-
-            <para><figure>
-                <title>Dropzones and Files</title>
-
-                <mediaobject>
-                  <imageobject>
-                    <imagedata fileref="images/DTimg01.jpg" />
-                  </imageobject>
-                </mediaobject>
-              </figure></para>
           </listitem>
 
           <listitem>
-            <para>Press the <emphasis role="bold">Submit<emphasis role="bold">
+            <para>Press the <emphasis role="bold">Spray<emphasis role="bold">
             </emphasis></emphasis>button.</para>
           </listitem>
 
           <listitem>
             <?dbfo keep-together="always"?>
 
-            <para>Click on the <emphasis role="bold">View Progress</emphasis>
-            hyperlink</para>
+            <para>The workunit details page displays. You can view the
+            progress of the spray. </para>
 
             <para><figure>
                 <title>View Progress</title>
@@ -482,18 +507,9 @@
                                vendor="eclwatchSS" />
                   </imageobject>
                 </mediaobject>
-              </figure>The Workunit progress page displays.</para>
-
-            <para><figure>
-                <title>Spray Complete</title>
+              </figure></para>
 
-                <mediaobject>
-                  <imageobject>
-                    <imagedata fileref="images/DTimg03.jpg"
-                               vendor="eclwatchSS" />
-                  </imageobject>
-                </mediaobject>
-              </figure> Once the spray is complete, we can proceed.</para>
+            <para> Once the spray is complete, we can proceed.</para>
           </listitem>
         </orderedlist>
       </sect2>
@@ -525,9 +541,8 @@
           <?dbfo keep-together="always"?>
 
           <para>Rt-Click on the <emphasis role="bold">My Files</emphasis>
-          folder in the Repository<emphasis role="bold"></emphasis> window,
-          and select <emphasis role="bold">Insert Folder</emphasis> from the
-          pop-up menu.</para>
+          folder in the Repository window, and select <emphasis
+          role="bold">Insert Folder</emphasis> from the pop-up menu.</para>
 
           <para><figure>
               <title>Insert Folder</title>
@@ -545,7 +560,7 @@
 
           <para>Enter <emphasis role="bold">Tutorial</emphasis><emphasis
           role="bold">YourName</emphasis>(where <emphasis>YourName</emphasis>
-          is your name)<emphasis></emphasis>for the label, then press the OK
+          is your name)<emphasis> </emphasis>for the label, then press the OK
           button.</para>
 
           <para><figure>
@@ -680,8 +695,8 @@ END;    </programlisting> <figure>
           </listitem>
 
           <listitem>
-            <para>Write the following code (remember to replace
-            <emphasis>YN</emphasis>with your initials):</para>
+            <para> Write the following code (remember to replace
+            <emphasis>YN</emphasis> with your initials):</para>
 
             <para><programlisting>IMPORT TutorialYourName;
 EXPORT File_OriginalPerson :=
@@ -769,8 +784,8 @@ COUNT(TutorialYourName.File_OriginalPerson);
             <para><programlisting>IMPORT TutorialYourName;
 <emphasis role="bold">OUTPUT</emphasis>(TutorialYourName.File_OriginalPerson);</programlisting></para>
 
-            <para>Note: The modified portion is shown in <emphasis
-            role="bold">bold</emphasis>.</para>
+            <para><emphasis role="bold">Note: </emphasis>The modified portion
+            is shown in <emphasis role="bold">bold</emphasis>.</para>
           </listitem>
 
           <listitem>
@@ -1019,7 +1034,7 @@ OUTPUT(FetchPeopleByZip);
     </sect1>
 
     <sect1 id="Publishing_your_Query">
-      <title>Publishing your Query</title>
+      <title>Publishing your Thor Query</title>
 
       <para>Now that we have created an indexed query, the next step is to
       enable access to it through a Web interface.</para>
@@ -1064,10 +1079,8 @@ OUTPUT(resultset);
         </listitem>
 
         <listitem>
-          <?dbfo keep-together="always"?>
-
-          <para>Press the <emphasis role="bold">Publish</emphasis> button, you
-          may need to scroll down the main window.</para>
+          <para>Press the <emphasis role="bold">Publish</emphasis> button, on
+          the ECL Watch tab.</para>
 
           <para><figure>
               <title>Publish Workunit</title>
@@ -1078,22 +1091,24 @@ OUTPUT(resultset);
                 </imageobject>
               </mediaobject>
             </figure></para>
-        </listitem>
 
-        <listitem>
-          <para>When the workunit is published, a notice dialog
-          displays.</para>
-
-          <para><figure>
-              <title>Workunit Published</title>
+          <para>The Publish dialog displays, with the Job Name field
+          automatically filled in. You can add a comment in the Comment field
+          if you wish, then press Submit. <figure>
+              <title>Submit </title>
 
               <mediaobject>
                 <imageobject>
-                  <imagedata fileref="images/DT173-18b.png" />
+                  <imagedata fileref="images/DTimg12b.jpg" />
                 </imageobject>
               </mediaobject>
             </figure></para>
         </listitem>
+
+        <listitem>
+          <para>If there are no error messages, the workunit is
+          published.</para>
+        </listitem>
       </orderedlist>
 
       <sect2 id="Execute-using-the-Data-Delivery-Engine">
@@ -1110,8 +1125,6 @@ OUTPUT(resultset);
         nnn.nnn.nnn.nnn is your ESP Server’s IP address and pppp is the port.
         Default port is 8002)</emphasis></para>
 
-        <para></para>
-
         <para><figure>
             <title>WsECL</title>
 
@@ -1134,7 +1147,7 @@ OUTPUT(resultset);
             <?dbfo keep-together="always"?>
 
             <para>Click on the <emphasis
-            role="bold">fetchpeoplebyzipservice.1</emphasis> hyperlink.</para>
+            role="bold">fetchpeoplebyzipservice</emphasis> hyperlink.</para>
 
             <para>The form for the service displays.</para>
 
@@ -1151,7 +1164,7 @@ OUTPUT(resultset);
 
           <listitem>
             <para>Provide a zip code (e.g., 33024) in the <emphasis
-            role="bold">zipvalue</emphasis> field, , select <emphasis
+            role="bold">zipvalue</emphasis> field. Select <emphasis
             role="bold">Output Tables</emphasis> from the drop list, then
             press the <emphasis role="bold">Submit</emphasis> button.</para>
 
@@ -1181,7 +1194,7 @@ OUTPUT(resultset);
       publish it to a Roxie cluster. <orderedlist>
           <listitem>
             <para>In the ECL IDE, select the Builder tab on the
-            FetchPeopleByZipService file builder window,</para>
+            FetchPeopleByZipService file builder window.</para>
           </listitem>
 
           <listitem>
@@ -1246,18 +1259,17 @@ OUTPUT(resultset);
         <orderedlist>
           <listitem>
             <para>Select the workunit tab for the FetchPeopleByZipService that
-            you just compiled.</para>
-          </listitem>
+            you just compiled. </para>
 
-          <listitem>
-            <para>Select the ECL Watch tab.</para>
+            <para>This opens the workunit in an ECL Watch tab.</para>
           </listitem>
 
           <listitem>
             <?dbfo keep-together="always"?>
 
-            <para>Press the <emphasis role="bold">Publish</emphasis> button
-            (you may need to scroll down the main window)</para>
+            <para>Press the <emphasis role="bold">Publish</emphasis> action
+            button, then verify the information in the dialog and press
+            <emphasis role="bold">Submit</emphasis>. </para>
 
             <para><figure>
                 <title>Publish Query</title>
@@ -1267,17 +1279,7 @@ OUTPUT(resultset);
                     <imagedata fileref="images/DTimg19.jpg" />
                   </imageobject>
                 </mediaobject>
-              </figure>When it successfully publishes, you will see:</para>
-
-            <para><figure>
-                <title>Workunit Published</title>
-
-                <mediaobject>
-                  <imageobject>
-                    <imagedata fileref="images/DT173-18b.png" />
-                  </imageobject>
-                </mediaobject>
-              </figure></para>
+              </figure>This publishes the query.</para>
           </listitem>
         </orderedlist>
       </sect2>