What are you looking for?

    Didn't find what you were looking for?

    Extend your Search in Community

    Got any questions?

    We're always happy to help with questions you might have. Contact Us

    Didn't find what you were looking for?

    Extend your Search in Community

    Got any questions?

    We're always happy to help with questions you might have. Contact Us

Manager Topics

Form Spaces Overview

   Journey Manager (JM) Previously known as Transact Manager (TM). |   System Manager / DevOps |   Updated in v18.11 This feature was updated in v18.11.

Manager provides form spaces that are used to host forms and expose them to users, handle form requests, such as form submissions, list tasks assigned to users, and perform user authentication. You can configure a form space to define whether hosted forms require authentication or not by selecting a security manager and authentication mode.

In Java Enterprise Edition (JEE) terms a form space is a Java Web Application, which is deployed using a Web Application Archive (WAR) file. Unlike traditional JEE applications, Manager form spaces WAR files are used to initialize the Manager database with appropriate configurations and HTML content. The Java application code is provided by the application server modules and the HTML content is rendered from the Manager database. We use this model to make application upgrades easier. J2EE Application Server restrictions mean that you are always required to deploy a WAR file to apply new changes. After that, the WAR files content becomes the base content in the database. Then, the active content in a form space is either edited in Manager or imported as an archive ZIP file.

Note

The form space name follows this pattern: avoka-sf-portal-<portal context>.war.

A form space WAR file includes configurations and HTML content only. It doesn't include any application source code. The typical form space WAR file contains:

  • Page Templates as HTML files. They are stored in:
    • Unsecured root directory, which can be accessed anonymously.
    • Secure directory, which requires an authentication user session. This directory contains the pages users sees on the form space after logging in, for example, the Tasks or To Do page.
  • Resources that are used to style a form space, including:
    • css
    • images
    • includes: HTML snippets
    • js: JavaScript files
  • WEB-INF that contains the list of XML files and the classes. The most important files are:
    • web.xml: The web application deployment descriptor file describes how the web application should be deployed to the application server. It is required for every web application. This file has the context path space name substitutions applied by the installer.
    • jboss-web.xml: This file has the context path space name substitutions applied by the installer and the context path specified in the installer has been written into the context-root element.
  • WEB-INF/classes contains the compile Java packages and classes. The most important files are:
    • db-config.xml: It is used to create all the new form space properties when the WAR file is deployed. The Roles for the form space are also defined here. This file has the context path space name substitutions applied by the installer.

Manager comes with the following default form spaces, which you can opt in or out during Manager installation:

Salesforce

Salesforce is the form space to enable integration with Salesforce.

TransactField App

TransactField App is the business field work personnel form space that allows working offline. It provides a mobile app and PC application which enables business field staff to complete forms offline. Once online, the application allows them to sync their work with the Manager server, and receive new work tasks to complete. TransactField App supports authenticated users only.

Web Plug-in

Web Plug-in is the default form space for forms to be discovered and linked to public web sites. It provides a form space for customer facing sales and service transactions. It is linked from your (organization) website, but can also be embedded on your website if the form is fairly small. Web Plugin supports unauthenticated and authenticated users. Maestro requires this form space for building and publishing form versions.

Work Space

Work Space allows business staff to perform work functions as a group by creating tasks, collaboration jobs, completing ad-hoc forms, and providing help desk support. The work space is generally used by authenticated users but it also supports unauthenticated transactions as well.

Note

You should use the Work Spaces instead.

You can install the following pre-configured form spaces:

Work Spaces

Work Spaces is the recommended form space for the business staff to perform work group functions.  |   v18.11 This feature was introduced in v18.11.

Note

Maguire is the example of self-service form space.  |  Removed in v18.05 This feature was removed in v18.05.

Every form in the Journey platform is associated with one or more configured form spaces. If a form is associated with multiple form spaces, the form and all its saved and completed submissions will be visible and available to all of those spaces.

A form space can be licensed for internal and external transactions depending on the customer license agreement. You can generate transaction licensing reports to view internal and external transaction trends.

To create a new form space, you can import it as a WARWAR file (Web Application Resource or Web application ARchive) is a file used to distribute a collection of JAR-files, JavaServer Pages, Java Servlets, Java classes, XML files, tag libraries, static web pages (HTML and related files) and other resources that together constitute a web application. file. You can then promote it from one environment to another.

Note

Manager comes with a number of modules, which configuration might look similar to form spaces. However, modules are very different to form spaces, and you can think of them as the separate products deployed in Manager.

Next, learn how to view form spaces.

Feedback

Did this topic provide the information you need or leave you wanting to know more? Is there some way we can make this topic better? Let us know how we can improve this documentation.

Contact Us

Community

Our Community is a dynamic, user-driven source of information that provides a home for sharing Journey platform knowledge where you can ask questions and get answers quickly.

Explore Community

Support

Temenos is committed to supporting our customers with Journey platform solutions installed in the cloud or on premise. Learn more about our Customer Care Team, and its policies, procedures, and processes.

Learn More