Versions Compared

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 scenario has 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. Download the SharePoint Connector. Rename it to sharepoint.war. Copy it to the <frevvo-home>\tomcat\webapps folder
    4. Connect your Forms/Flows using the SharePoint wizard.

  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

...

  1. Login to as the tenant admin

  2. Click the Edit Tenant link.

  3. Click the  blue arrow to expand the SharePoint section.
  4. Enter the Connector URL. - This URL is needed if you are using  in the cloud and installing the connector locally. Enter the URL where your installation that is configured for SharePoint is located. This URL must use the https protocol.

    The URL in the Connector URL field will override the connector URL that is specified in the configuration property in the <frevvo-home>\tomcat\conf\frevvo-config.properties file. In some cases you can leave this field blank.

    Info

    The default value is shown below:
    frevvo.sharepoint.connector.url=http://localhost:8082/sharepoint

  5. Enter the Client Id and the Client Secret that you saved in Step 1 into the respective fields.



  6. Enter the SharePoint Domain Name e.g. <Your SharePoint tenant name>.sharepoint.com - there is a dot between the SharePoint tenant name and sharepoint.com
  7. To determine the realm for your SharePoint site :
    1. Navigate to https://<tenant>.sharepoint.com/_layouts/appprincipals.aspx - change the <tenant> to the name of your SharePoint tenant - e.g. https://frevvo.sharepoint.com/_layouts/appprincipals.aspx

    2. Find your registered application in the list and and look at the App Identifier column. The unique identifier after the @-sign in the App Identifier is the app realm and must be entered in the Realm field.



  8. Click Submit
  9. Browse http://<your server:port>/sharepoint/health (replace <your server:port> with your frevvo server:port) to check the status of the connector. If the connector is up and running, you will see { "status" : "UP" }.
  10. Proceed to Connect Forms/Flows with the Save to SharePoint wizard

Step 3 - Connect Forms and Flows with the SharePoint wizard

...