Versions Compared

Old Version 34

changes.mady.by.user Former user

Saved on

compared with

New Version Current

changes.mady.by.user Megan Ellis

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Section
 
Column


The frevvo SharePoint Connector and wizard, make it easy to create forms and approval workflows that validate information, route for signatures as required and save the data and documents to a secure SharePoint website. The Connector was designed to integrate with Office 365 SharePoint Online.

All customers need a valid Office 365 SharePoint account.

Submissions can contain multiple files of different types - Invoice, Receipt, PO etc. You may want to save these files in different locations on your SharePoint site.

The SharePoint Connector wizard, allows you to:

  1. Save the form/flow data and metadata to a SharePoint destination. The destination could be a folder in a document library and/or a list item.
  2. Designers select the SharePoint destination from a dropdown
  3. Map form/flow control values to the SharePoint columns.
  4. Configure two destinations for your data.

The SharePoint wizard guides you through connecting your forms/flows to SharePoint.

 


Column
width300px

On This Page:

Table of Contents
maxLevel2

...

  1. Cloud Customers Connecting to SharePoint Online - This configuration had been certified by frevvo. Follow these steps:
    1. Configure Live Forms as a SharePoint Add-in
    2. Configure SharePoint for your Live Forms tenant.
    3. Connect your Forms/Flows using the SharePoint wizard.

  2. In-house Customers connecting to SharePoint Online - This configuration has been certified by frevvo.   Follow these steps:

    Info

    frevvo only supports/certifies the SharePoint Connector running in the Apache Tomcat container.

    1. Configure Live Forms as a SharePoint Add-in
    2. Configure SharePoint for your Live Forms tenant
    3. Install the SharePoint Connector.

    4. Connect your Forms/Flows using the SharePoint wizard.

      Warning

      Prerequisites for this configuration:

      Tip

      When configuring a test tenant for the SharePoint Connector, use the frevvo.certificate.signature property to bypass SSL Security. Do not do this for a Production tenant.

  3. In-house customers using SharePoint On-premise - this configuration is supported but not certified.

    1. Customers using SharePoint On-premise also need an Office 365 SharePoint Online account. This is necessary to obtain an authorization token. There is no data transfer from the SharePoint On-premise to SharePoint Online.

    2. Customers are responsible for configuring the On-premise installation and the integration with SharePoint Online.

    3. The On-premise version of SharePoint must be version 2013+.

    4. Refer to this Microsoft website for information about how to use Office 365 to allow  to authenticate.

  4.  Live Forms Cloud customers connecting to SharePoint On-premise - This configuration is supported but considered unlikely as SharePoint On-premise requires your On-premise SharePoint to be exposed to the Cloud. 
    1.  Customers are responsible for configuring the On-premise installation and it's exposure to the Cloud.     

Configuring the SharePoint Connector

...

If your environment includes an in-house server, you must install the SharePoint Connector in the tomcat bundle on this machine. Cloud customers can skip this step.

  1. Stop
  2. Download the SharePoint Connector.
  3. Unzip the SharePoint Connector zipfile to a temporary location.
  4. Extract the sharepoint.war file to <frevvo-home>//tomcat/webapps directory on your server.
  5. Start .

Warning
Just a reminder about the prerequisites:

Step 1 - Configure Live Forms as a SharePoint App/Add-in

...

Remember SharePoint only allows https.

Tip
We recommend that you create a separate user in SharePoint for frevvo forms connection, and use that user while configuring the Save to SharePoint wizard in frevvo forms. This frevvo specific SharePoint user always remains active and eliminates issues if the designer user configured your forms to submit to SharePoint using their own SharePoint login and then leaves the company.

Step 2 - Configure the Live Forms Tenant for SharePoint

...

Click Trust It to authenticate and grant permission to . You will not see the trust screen on subsequent logins. The wizard will display.

Tip
  • We recommend that you create a separate user in SharePoint for frevvo forms connection, and use that user while configuring the Save to SharePoint wizard in frevvo forms. This frevvo specific SharePoint user always remains active and eliminates issues if the designer user configured your forms to submit to SharePoint using their own SharePoint login and then leaves the company.
  •  At least one designer user must also be a SharePoint user with the correct privileges to provide consent when invoking the Save to SharePoint wizard if your tenant is configured with the Azure SAML Security Manager .

...

  1. Test your form/flow by filling in data, adding attachments, and submiting/completing it.
  2. Login to your SharePoint account and navigate to the specified destination. The image shows submissions saved to a SharePoint list named Demo List and the John Edwards submission data and attachments.

Troubleshooting

The SharePoint Connector generates it's own logfile. Typically, the log is first place to look for information when an issue is encountered. Information about the logfile and some common issues with solutions are listed below.

SharePoint Connector Logfile

If you are using the frevvo tomcat bundle, the SharePoint Connector log is located in <frevvo-home>\tomcat\logs. The logfile is named sharepoint-connector.YYYY-MM-DD.log. Generating separate logfiles make it much easier to search for errors when troubleshooting connector issues. The connector is designed to use the frevvo-config.properties file.

The SharePoint connector logfile defaults to INFO loglevel. To see DEBUG level messages in the SharePoint Connector log:

...

Code Block
logging.level.com.frevvo.connector=DEBUG
logging.level.com.frevvo.connectors=DEBUG

Generate the SharePoint Connector log in JSON format

...

Using the SharePoint Connector in an Azure SAML Security Manager tenant

At least one designer user that is going to be connecting forms/flows to SharePoint with the Save to SharePoint wizard must also be a SharePoint user with the correct privileges to provide consent if your tenant is configured with the Azure SAML Security Manager.

Troubleshooting

Some common issues with solutions are listed below.

Doc Post Failure

If the submission doesn't reach your SharePoint website - if does not receive a response back from SharePoint with a status code of 200, you can find information about the error from the submission table.

...

  1. Browse http://<your server:port>/sharepoint/info  - the version information is returned as shown in the image.

 

 

...