Solution User Guide For: Connect version: 2019.2, Capture OnTheGo App version 10.6.
Solution User Guide Version 2019.2 Last Revision: 2020-02-11 Objectif Lune, Inc. 2030 Pie-IX, Suite 500 Montréal, QC, Canada, H1V 2C8 +1 (514) 875-5863 sales@ca.objectiflune.com www.objectiflune.com All trademarks displayed are the property of their respective owners. © Objectif Lune, Inc. 1994-2020. All rights reserved. No part of this documentation may be reproduced, transmitted or distributed outside of Objectif Lune Inc.
Table of Contents Table of Contents 4 What Is Capture OnTheGo 5 What Capture OnTheGo Can Do for You The Capture OnTheGo App's Main Features 5 7 The Capture OnTheGo Architecture 8 Managing a Capture OnTheGo Solution Software Licenses How it works 8 9 9 10 Template Design 12 The Basic Processes Involved in the Capture OnTheGo Workflow 14 The process that publishes a document Configuring an Output to Capture OnTheGo Plugin The process that replies to document requests from Capture OnTheGo users T
What Is Capture OnTheGo Capture OnTheGo is a solution that brings forms into the digital age. Good bye paper forms, hello e-forms. PlanetPress® or PReS® Connect creates these e-forms that you can download to your mobile device (iOS, Android or Windows 10). You can then add text, pictures, annotations, numbers, dates, signatures, as well as validate the forms, whether online or offline. It also lets you distribute and manage PDF documents, such as guides or disclaimers.
l l Since Capture OnTheGo can interact directly with your systems, there is no manual data entry. No one needs to enter the data collected by your people on the road. Capture OnTheGo sends the data, the pictures and the signatures right to your systems. Capture OnTheGo can also perform other tasks for you. It can automatically send copies of filled forms to your clients, for instance.
The Capture OnTheGo App's Main Features Capture OnTheGo users can do the following: l l l Download PDF documents, such as user guides or data sheets. Download HTML forms that can be filled out directly on mobile devices. These forms can be blank, but in most cases they will contain information that needs to be completed or validated.
The Capture OnTheGo Architecture The Capture OnTheGo solution is composed of four separate parts: l l l l PlanetPress® or PReS® Connect in which you create the forms that will be sent to your mobile device. The DataMapper module lets you add data to your forms, and the Designer module uses a simple interface using wizards and drag and drop to create the forms themselves.
l l Capture OnTheGo repository manager: To use Capture OnTheGo, you need to use a Capture OnTheGo virtual repository, for which you require a license. Note that the number of users that can have access to a given repository is limited. The repository manager can create and delete users and groups, as well as add and remove users to/from groups, as required. Capture OnTheGo app users: These are the people on the front line.
How it works Although there are many possible scenarios, the standard Capture OnTheGo workflow generally goes as follows. Note that some of the steps listed below do not involve an exchange of information between the Capture OnTheGo app and PlanetPress® or PReS® Workflow. Those steps that do involve communication between PlanetPress® or PReS® Connect and the App or the Capture OnTheGo Server have been clearly identified. 1. A host system generates a data file.
with the received data. This may include simply storing the data, merging it with the appropriate document and printing the results, sending it to other systems, etc.
Template Design More often than not, the process of using Capture OnTheGo begins with the creation of a form with various Capture OnTheGo and form widgets. The form can also contain data from external sources through the use of the DataMapper module. Capture OnTheGo templates can be created in the PlanetPress® or PReS® Connect Designer module. Basically, a Capture OnTheGo form is a web form.
a template can be used repeatedly to generate a form. There is no difference, however, in the way they are designed, except that templates should not contain pre-filled personal data fields. One of a web form's properties is its action, which is the URL where the form data is sent when the form is filled out and submitted.
The Basic Processes Involved in the Capture OnTheGo Workflow PlanetPress® or PReS® Connect is an extremely flexible solution that lets you do almost anything you want with your data. So although the three basic processes explained in this section are required to enable a Capture OnTheGo solution, you may add as many plugins and processes as you like to customize a solution that perfectly suits your needs.
This process watches a certain folder. When a file enters that folder, a data mapping is performed on it. Then an HTML file is created and saved to another folder. The Output to Capture OnTheGo plugin sends a ticket (not the actual HTML file) to the Capture OnTheGo Server, so that when the intended user logs in, the name of the HTML file will appear in the App's Repository, signaling to the user that the file is available for download.
Configuring an Output to Capture OnTheGo Plugin Repository Tab The Repository tab is where you enter the connection information necessary to create the link between OL Connect or PlanetPress and Capture OnTheGo. l l l Repository ID: Enter a valid Capture OnTheGo Server user name (mandatory). Password: Enter the password (mandatory) that corresponds to the Repository ID entered above. Show password: Check this box if you want to see the password you type in the Password box.
l Title: Enter the document name that Capture OnTheGo users will see on their device. Choose a name that will let users clearly identify the document. l Author(s): Enter a name identifying the document’s creator(s). l Description: Enter a description helping users identify the document. l Metadata: This group lets you determine which Capture OnTheGo users can see the document and where they will see it.
l l l Auto-Download: This option determines whether the document is to be automatically downloaded to the users’ devices (documents that are not automatically downloaded are first listed on users’ devices – users must then tap the download button, if they want to have the document on their device). You may enter ‘Yes’, ‘No’, or a variable.
again. A template will only be deleted from the app's template library after the number of days set in Days to keep each instance. The process that replies to document requests from Capture OnTheGo users The previous process informed the Capture OnTheGo Server that a new document was now available. So Capture OnTheGo App users that have access to this document can now see it and download it from a PlanetPress HTTP Server or a regular Web server.
Note: To make sure that documents are served only to users of the COTG app, the Input task authenticates download requests, using the authentication key of the COTG repository. This key can be found in the Parameters section of the COTG Web Administration Panel. Enter the key in the HTTP Server Input 2 User Options in the Workflow preferences (see HTTP Server Input 2 User Options (PreS) or HTTP Server Input 2 User Options (PlanetPress)).
first loaded, renamed to the original name included in the request (the full path is reduced to the file name), and sent to the client. Finally, the document is deleted from the server. Downloaded PDF documents can then be opened for viewing, and HTML documents can be used to collect information that can then be sent back for processing. The Process that Receives Data from Capture OnTheGo Users HTML documents that were downloaded can be used to collect information.
For this to happen, one last process is needed. This process also includes an HTTP Server Input task, but in this case, the task is used to reply to POST requests, rather than GET requests. When a Capture OnTheGo App user taps the Submit button, a POST request is sent to a PlanetPress or PreS HTTP Server. The server replies by collecting the information, which is passed down to other tasks. The process may include multiple branches and a large variety of tasks.
1. Check the Use custom HTTP server response code option of the Server Input task (HTTP Server Input or NodeJS Server Input) and select the Job Info variable in which the response code will be stored. 2. In the Workflow process, after storing the submitted data, set the value of the respective Job Info variable to 291. This can be done using the Set Job Infos and Variables task or a Run Script task.
Using the Capture OnTheGo Server Console The Capture OnTheGo Server Console lets you manage individual users, groups, documents, as well as modify the look of the Capture OnTheGo App, as displayed on your user’s intelligent devices. The Console can be accessed using a browser: go to https://configus.captureonthego.com. Credentials must be entered on the Login page to gain access to the Console’s Home page Once you have logged into the Capture OnTheGo Server Console, you land on the Console’s Home page.
The links at the top let you access the various functionalities offered by the Console. To log out or to change the current page language, click the links found in the lower right corner of the page. Managing Users The Users page of the Capture OnTheGo Server Console lets you add users, edit user profiles, as well as remove users.
Adding a User To add a new user, you must actually edit an “empty” user. An “empty” user is represented by an empty line, as can be seen at the bottom of the illustration above. 1. If there is no empty line, simply click the Add a User button to add one. To edit an “empty” user, click the Modify link. When you do this, the line changes appearance, as can be seen below. 2.
Changing a User 1. To change an existing user, click the Modify link to the left of the user’s information. When you do this, the line changes appearance, as can be seen below. 2. Edit the information, as required, in the First Name, Last Name, Email Address boxes. Note that the Password box is empty, but if you enter a new password, the user’s password will be changed. Check the appropriate groups (if the group you need is not displayed, refer to "Managing Groups" below).
Adding a Group To add a new group, you must actually edit an empty group. An empty group is represented by an empty line, as can be seen at the top of the illustration above. 1. If there is no empty line, simply click the Add a Group button to add one. To edit an empty group, click the Modify link. When you do this, the line changes appearance, as can be seen below. 2. Enter the relevant information in the Group Name box. 3. Click Save. If the information has been entered correctly, the new group is saved.
Managing Documents The Documents page of the Capture OnTheGo Server Console lets you view document details and remove documents. Viewing a Document’s Details To view a document’s details, simply click Details link to the left of the document’s information. When you do this, the line changes appearance, as can be seen below.
In the Document Details popup, click on the Edit button at the bottom-left to edit some parts of the document. Note that not all fields can be edited. Removing Documents To remove a single document, simply click the X sign found to the right of the document. To remove multiple documents, select them by clicking the check box to the left of the documents, and click Delete Selected Documents. A message box is displayed to ask for confirmation.
l 1536 by 286 pixels: the best size if the app is to be used on a phone type device. l 2048 by 286 pixels: the best size if the app is to be used on a tablet type device. To select a new logo, simply click the Browse button, select the desired logo file and click OK.
Using the Capture OnTheGo App To begin with, users must download the Capture OnTheGo App from a digital distribution platform, such as the Apple App Store, Google Play store or Windows Store. This app is free to download. Capture OnTheGo and the Capture OnTheGo App are the result of a partnership between Objectif Lune and NuBook, each partner being responsible for part of the solution.
l Simply locate and open Capture OnTheGo on your device l Click “My Library” l Select “User Guide”.
l You can also have this guide printed or emailed using the “Share” button located on the toolbar Note Make a short tap to activate the toolbar and press the Share button Page 34
System Requirements The Capture OnTheGo App (version : 10.6.3) requires iOS 7 or higher on Apple devices, Android OS 5.0 or higher on any Android device and Windows 10. Ports used Which port is used by the app depends on which server it is connecting to. (See "How it works" on page 10 for an explanation.) l l The app uses port 443 when connecting to the Capture OnTheGo server to get access to the tickets. For communication with the Workflow server the app uses the port designated in Workflow.
Manual procedure 1. Open Regedit and navigate to HKEY_CURRENT_USER\Software\Classes\Local Settings\Software\Microsoft\Windows\CurrentVersion\AppContainer \Mappings 2. Press CTRL+F and search for OnTheGo. 3. On the left-hand side is the SID for the application. Right-click on it and select Copy Key Name. 4. Open a Command Prompt Window in Administrator mode. 5.
