- 1 System Requirements
- 2 Hardware Requirements
- 3 Installation
- 4 Setting Global Variables
- 5 MOST Configuration to Enable Remote Printing of Documents at the MFP
- 6 MOST SharePoint Tutorial
- 7 Viewing your document in FabSoft’s SharePoint Demonstration Site
- 8 SharePoint Service
- 9 Maintenance
- 10 Troubleshooting
- Reform 15 PDC Base
- MOST Plugin
- Reform SharePoint Plugin
- MOST SharePoint Plugin
- For Evaluation and Demonstration: Windows 7, 8, Server 2008, or Server 2012 (64bit only).
- For Production Systems: Windows Server 2008 or Server 2012 (64bit only)
- Virtual servers are fully supported.
- Microsoft .NET Framework 4.5 (this will be automatically installed if the installer
does not find it on the system)
- Microsoft SQL Express (SQL Server Express will be automatically installed by the
SharePoint installer if it is not present on the current system)
- SharePoint 2007, 2010, 2013, or Office 365 SharePoint, for demonstrations a SharePoint account is provided
All required Reform software downloads can be found at www.fabsoft.com in the Downloads section.
Please reference both the SharePoint Plugin Documentation and MOST Documentation regarding Hardware Requirements.
To install MOST-SharePoint to your existing Reform installation, you will need to download and run the Reform-MOST-SharePoint installation executable.
Step through the prompts and accept the User License Agreement. The installation will begin. Allow the installation to complete and then read on to the next section to learn how to set up MOST SharePoint integration.
The default installation directory for Reform and its Plugins is C:\Program Files\Reform…\. If you have changed the path during the Reform installation routine, please refer to the appropriate path instead of the default one referenced throughout this documentation.
After the installation, the MOST Manager should be restarted (may be running as a service) as it requires newly added files to be loaded upon startup. To open the MOST Manager, go to Start > Programs > Reform… > MOST > Manager. Press the red Stop button and then the green Start button to restart it.
The Reform Spooler Service must also be restarted. Open up the Spooler by going to Start > Programs > Reform… > Spooler. Click the Refresh button or the red stop button and then the blue start button.
Importing MOST Screen
Please refer to the MOST manual for more information regarding MOST terminology and Setup.
To import MOST screens for SharePoint Go to Start > Programs > Reform… > MOST-SharePoint > Install MOST Screens
If not already open, MOST Designer will appear. You will be prompted if you want to Import SharePoint into MOST. Click Yes. If asked if you want to overwrite files, click Yes.
You can leave MOST Designer open as it will be used in the following section.
Setting Global Variables
We need to setup the communication beween MOST and SharePoint. To do so, we have to configure certain parameters in MOST’s Global variables screen. If the MOST Designer is not already open, go to Start > Programs > Reform… > MOST > Designer.
Go to Data > Global Variables on the menu bar.
These are the Global Variables required to access our Hosted Demonstration SharePoint server. Your SharePoint server settings may differ. Select each variable one by one, enter its value in the provided box and then click the update button. CommunicationType, SPCacheType and SPModel global variables allow you to select available values from a drop down list.
1. Variable Name = SPProxyPassword Value= Go To: http://www.fabsoft.com/SharePoint/ in your web browser to get the current password.
- If you would like all users to authenticate to the SharePoint site as the same account, the SPProxyUsername and SPProxyPassword options can be used.
- This tutorial will allow all users to authenticate as an existing FabSoft account. As the password for this tutorial changes periodically, the link specified above is used to maintain and publish the current password. If a different SharePoint site is being used, and the Proxy account is desired, enter the associated password for this setting.
2. Variable Name = SPProxyUserName Value= tutorial
- If you would like all users to authenticate to the SharePoint site as the same account, the SPProxyUsername and SPProxyPassword options can be used.
- This tutorial will allow all users to authenticate as an existing FabSoft account. If a different SharePoint site is being used, and the Proxy account is desired, enter the associated username for this setting.
3. Variable Name=SPDomain Value=
- If you authenticate to the SharePoint site with a username formatted as Domain\Username, then specify the Domain portion in this setting. Typically this option is left blank and the SPUserNamePadding option is used instead.
4. VariableName=SPSiteURLs Value= https://fabsoft2.sharepoint.com/Demonstration%20Site/
- The desired SharePoint Site URL should be specified as this setting. To determine the URL, simply browse to your SharePoint site using a web browser. Then, copy the portion of the URL up to the last "/". For example, if the URL in the web browser is "https://fabsoft2.sharepoint.com/Demonstration%20Site/default.aspx", then the URL for this setting will be "https://fabsoft2.sharepoint.com/Demonstration%20Site/".
5. Variable Name=SPUserNamePadding Valueemail@example.com
- If you authenticate to the SharePoint site with a username formatted as Username@Domain, then specify the Domain portion (including the "@" symbol) in this setting. The Username Padding will append the specified text to all usernames when authenticating to SharePoint.
For our demonstration server, we use a Proxy Username and Password in order to authenticate to the Hosted SharePoint server. This means that any user who logs into MOST and utilizes the SharePoint colection will be doing so using the Proxy information. If a Proxy Username and Password is not specified, the user’s MOST credentials will be used to authenticate to SharePoint. The SPUsernamePadding variable is used to append the SharePoint server information to the user’s login name in order to authenticate using the full credentials.
Click File > Save or use the small save icon
to save all the global variables.
Assigning Collection to Users
1. Open your MOST Designer if not already opened (Start > Programs > Reform… > MOST > Designer).
2. On the MOST Designer tool bar, click on Data > Users and Groups
3. Select the demo user from the User/Groups list. We will be adding the SharePoint collection for this user. The same process can be used for any user or group.
4. Select SharePoint from the Available Collections and click the
to add the SharePoint collection.
5. File > Save or use the small save icon
to save your changes.
MOST Configuration to Enable Remote Printing of Documents at the MFP
*If CommunicationType global variable is set to Local (MFP can be reached by IP on a local network), this step can be skipped. In order to print documents remotely (when a MFP is not reachable by IP), the CommunicationType should be set to Remote and the following steps should be taken.
Remote Printing must be enabled in the MOST Manager if the CommunicationType is set to Remote in the Global Variables configuration.
1. To do so, first make sure MOST Manager is open by going to Start > Programs > Reform… > MOST > Manager. It may be running in your task bar, so check for the small
icon and double click on it to bring up MOST Manager.
2. Go to Edit > Settings
3. Go to the Devices tab. Here we need to check the Enable Remote Print checkbox if it is not already done so. You must also specify your Reform installation’s Queue directory which is usually C:\Program Files\Reform…\Queue. Use the browse button
to select this directory. The polling interval is how often the MFP will check this directory for documents to print. If 30 seconds is not optimal for your environment, please change it to the desired value.
4. After you have finished configuring Remote Printing, please click the Save button. You will be prompted that the server must be restarted, click Yes.
You have successfully configured MOST to enable the remote printing of SharePoint documents at your MFP.
The emulator shows you exactly what you would see on an MFP, and it functions in the same way (SharePoint documents cannot be printed using the emulator, it requires an MFP). This same process could be tested with the same exact steps, but by installing MOST on the MFP by following the instructions in the MOST manual. (Please refer to the MOST manual on how to setup MOST in the MFP or any other MOST related issues.)
1. Login to MOST at an MFP or use MOST Desktop (Start > Program > Reform… > MOST > Misc > MOST Desktop) using the demo account. Username is demo, password is demo.
2. The emulator will now connect to the MOST server and login. It may take several seconds to log in, since MOST must connect to the SharePoint server to retrieve the account settings.
3. You will notice that your upload directory list has been populated with available SharePoint sites. To expand a SharePoint site, click the + symbol next to its name.
4. Clicking the "+" will display the available directories in the selected SharePoint Site.
5. Select Tutorial from the list. After making the selection you will notice in the Attributes box the attributes associated with the directory are displayed.
6. In the Filename field, type in a file name. Using a unique name will make it easier to locate the file using the SharePoint web interface. Ex filename: John Doe - MOST Demo
7. Enter today’s date in the date field.
8. Enter 100075 in the Deal Number field
9. Enter your name in the Customer Name field.
10. After filling out all the fields, place your documents in the feeder and click on Scan to SP. If using MOST Desktop, it will ask you to select a file to simulate your scan. Your scan document should be sent to SharePoint along with the attributes.
*Note – Please make sure the SharePoint service is running. Otherwise the document won’t be uploaded. Please see the section SharePoint Service in this document for more information on how to manually start the service.
11. Click on the SPStatus tab to see the status of your document. It may take a few seconds to refresh the list. We have sent a couple more documents for demonstration purposes.
12. Click on the SPPrint tab. If using MOST Desktop, you will only be able to Preview the document as an MFP is required to do the printing. In this tab, you will see the document that you just submitted. Navigate through the SharePoint site on the screen to the Tutorial directory. Select the John Doe MOST Demo.PDF file. Click on Preview to preview the document. Click on the Print button to print the document.
1. Open your internet browser and copy this address
2. You will be asked to enter the username and password on the next screen so please take note of the Username and Password. Click on Continue.
3. Enter the username and password from the previous screen. Click Ok.
4. On the left side under Documents, click on Tutorial to see your uploaded document.
5. Documents uploaded are listed below. You can open the document and also view the attributes associated with the document.
Go to Start > Programs > Control Panel > Administrative Tools > Services
To start the service: right click on RM_SharepointMonitor > Properties. Under Service status, click on Start.
This service acts as a liaison between Reform and Microsoft SharePoint. It allows for Reform to upload documents and their properties to the SharePoint server. Depending on your environment, it may be required that this service is run under a local administrative account
There are certain directories and SQL tables that need to be monitored for growth along with the SharePoint plugin for Reform. As a system processes more and more jobs, the size of these directories and SQL tables can grow very quickly. Overall system performance can be affected by the large amounts of space that the files may take up. Also, there exists a 10GB database limit if using the Microsoft SQL Server Express supplied with this installation. Obsolete files/database entries should be deleted according to your needs and file retention specifications.
Please see the Reform Health Monitor and Maintenance Utility section in the Reform User Manual for more information and instructions for monitoring and maintaining your server. It is recommended to monitor the following directories and SQL tables for growth:
Q: Nothing is happening after the form is processed. How can I determine the cause of an issue?
A: Check the Event Log for errors related to Reform or the SharePoint service. The Event Log can be access by going to Control Panel > Administrative Tools > Event Log. This will usually give you a good idea about why the MOST SharePoint plugin might be failing.
Other company or product names mentioned herein may be trademarks or registered trademarks of their respective companies
SharePoint Issue Ticket
*User’s Name: ___________________________________ *User’s Login Name: ________________________________
*User’s Email Address: ____________________________ User’s Building: ___________________________________
User’s Department: ______________________________ Support Contact’s Name: ____________________________
Support Contact’s Email: __________________________ Support Contact’s Phone: ____________________________
*Severity of Issue (Please check one):
|□ 0 - Test environment (non-production)|
|□ 1 - Users are affected, but able to continue business|
□ 2 - Users are affected and it is affecting business, other functionality is working properly
□ 3 - The software is not functioning properly at all – system outage
Number of Users Affected: _____________ List Each Users Login Name _________________________________
*Description of Issue:
*Observations about issue:
Frequency of Issue: Once / Random / Every Attempt / Other (Please Describe): _________________________________
First Occurrence (Date/Time): _____________________ Latest Occurrence (Date/Time): _________________________
- *Issue is occurring at (Fill in all fields for Reform Server and SharePoint):
- Reform Server(s)
Reform Server IP(s): ______________________________________________________________________________
SharePoint URL: _________________________________________________________________________________
* Additional Information
*Have any changes been made to the Reform Server or Environment? yes / no If yes, What? When? By Who?
*Can the user access SharePoint website? yes / no If no, please explain _____________________________________
*Did the user’s credentials (username/password) change recently? yes / no If yes, When? _______________________
*If speed is an issue, please list the time it takes a document to process to SharePoint: _______seconds / minutes
Additional information when using the MOST plug-in with Reform
- MFP (If using the MOST Plug-in for Reform from an MFP)
Number of MFPs Affected:_______________________
MFP Java Version:______________________________ MOST Version: __________________________________
MFP Serial #:__________________________________ MFP IP: ________________________________________
MFP Model #: _________________________________ MFP Location: ___________________________________
- Workstation (If using the MOST Desktop Plug-in for Reform from a workstation)
Number of Workstations Affected: ________________ Workstation OS: XP / Vista / 7
Workstation IP: ________________________________ Workstation Name: _______________________________
* Fields are required