Installing Formcentric Connect

Last updated:

Before you can use Formcentric Connect in FirstSpirit, you need to set it up once. The setup involves steps in both Formcentric and FirstSpirit.

Creating an API Client in Formcentric

To allow FirstSpirit to securely communicate with your Formcentric account, you need to generate API credentials.

  1. Click your profile picture in the top-right corner and select Admin centre.
  2. In the left sidebar, navigate to API Clients.
  3. Click New API Client in the top right corner.
  4. Enter a descriptive name (e.g., "FirstSpirit") and click Create.
  5. Copy and save the displayed Client Secret immediately to a secure location. The secret will never be shown again.

You have successfully created an API client. Make a note of the client ID and the client secret. You will need both when configuring Formcentric Connect in FirstSpirit.

Adding your domain in Formcentric

For your forms to load on your FirstSpirit website, your website domain must be registered in Formcentric.

  1. Click your profile picture in the top right corner and select Admin Center.
  2. In the left sidebar, navigate to Security.
  3. Enter your website domain in the New Domain or Subdomain field, for example www.your-website.com.
  4. Click Add.

You registered a new domain.

Installing the Module in FirstSpirit

Formcentric Connect is provided as a FirstSpirit module (.fsm).

Installing the module

  1. In the ServerManager, open Server Properties and select Modules.
  2. Click Install and select the module archive file.
  3. When asked whether to automatically start the services included in the module, confirm with Yes.

Installing the ContentCreator WebApp

  1. In the ServerManager, switch to the Web Applications section.
  2. Add the Formcentric WebEditor to the ContentCreator web application by clicking Add.
  3. In the selection dialog, choose Formcentric WebEditor and confirm with OK.
  4. Update the ContentCreator web application on the web server.

Adding the Formcentric Connect Project App to your project

  1. Open the project configuration of the desired project by double-clicking the project in the project overview.
  2. In the left menu, select Project Components and click Add.
  3. In the selection dialog, choose Formcentric Resources and confirm.
  4. In the configuration, enter the client ID and client secret you noted when creating the API client.

The configuration screen can be seen.

Once the installation is complete, Formcentric Connect is available in your FirstSpirit project. In the Content Creator, the Formcentric icon appears in the report area on the right-hand side. In the SiteArchitect, it appears in the Organize section of the vertical toolbar. Editors can use this icon to embed forms on pages. See also Formcentric Connect im ContentCreator nutzen and Formcentric Connect im SiteArchitect nutzen.

Customising the paragraph template

Formcentric Connect includes a paragraph template that you can customise after installation to meet your requirements. All configuration options described in the FirstSpirit documentation for paragraph templates are available to you.

Feedback

ISO/IEC 27001 Icon
IT-Mittelstand Software Hosted in Germany
IT-Mittelstand Software Made in Germany