Versions Compared

Old Version 1

changes.mady.by.user Inese Auzina

Saved on

compared with

New Version Current

changes.mady.by.user Inese Auzina

Saved on

Key

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

Click on Images to Expand Them

Special Pages are such wizard pages that can perform some specific actions, that are built into the Docupace system code. These pages cannot hold fields on them and do not have a visualization. Special pages do have additional settings, that allow to configure their behavior.

To add a special page proceed as follows:

Rw ui steps macro
Rw step

Open the JSON tab of the Docupace Start screen. This tab lets you edit the underlying JavaScript code of the wizard directly. It also let you add features that cannot be added visually, yet. Currently Special Pages can be added through JSON tab, and then configured through the Wizard tab.

Image Added


Adding new special pages in JSON tab

Rw step

Add code within the pages object to create a new Special page.

Rw step

Open the Wizard tab of the Docupace Start screen. Select the page name of the newly created page from the list and click +Add button to add the Special Page to the page tree.

Image Added

Adding new special pages in Wizard tab

Rw step

Select the page name of the newly created page in the page tree and click Page Settings button.

Image Added

Page Settings for a SpecialPage

Rw step

Fill out the Page settings depending on the type of Special page you have created. Most settings are common to regular wizard pages as well as to the Special pages. All settings are described in the Page Settings topic.

Image Added

Custom Page Settings for a SpecialPage

Rw step

Click Apply button in the bottom of the screen to close the Widget Design Screen and apply changes.

Rw step

Click Save button in the top of the Widget Details Screen to save these changes.

The following special pages are currently supported:

Page type & Description

Code sample

initStartingPointData
Loads any initial data for this wizard, if such is available. E.g. if the wizard is launched from another wizard, previously filled data is forwarded on to this wizard. This page is created automatically for a new wizard.

Code Block
"initStartingPointData": { 
      "pageType": "initStartingPointData" 
    },

mapStartingPointData
Loads additional data for this wizard. This data is added to data loaded with the initStartingPointData page. There are mappings configured in "FM M-to-M converters (249)" domain, which define what data will be loaded by this page. Some are built-in based on Docupace version. Others are configured per customer site.

Code Block
"mapStartingPointData": { 
     "pageType": "mapStartingPointData" 
},

searchableTilesSelect
Loads a page with the data displayed as large tiles with names and icons, where one tile can be selected and the corresponding action launched. For example, a list of vendors as tiles.

Note. This special page is deprecated. Use a regular page with Single Selection, Domain Tile Selection or a Domain Single Selection field with Display Type = Tile List (tiles can then be formatted using Option template setting).

Code Block
"searchableTilesSelect": { 
  "pageName": "Vendor selection", 
  "pageType": "searchableTilesSelect" 
},

createWorkItem
Creates a Work Item, passing to it the data entered in previous pages. Documents can be uploaded to the created Work Item and Work Item's ID can then be displayed.

Code Block
"createWorkItem": { 
  "pageName": "Creating Work Item...", 
  "pageType": "createWorkItem" 
},

createOrUpdateWorkItem
If information about a previously created WI is available, this WI will be updated. If not - a new WI will be created.
The following fields are required in page config:
"workItemIdMetaField": "Request1.Ari.Id",
"workItemNamespace": "BASE"
Request1.Ari.Id - means that id of WI to update will be present in startingPointData under this key (startingPointData["Request1.Ari.Id"])
Namespace defines the source of field data. If data is created within Docupace, workItemNamespace = BASE. But if imported from other systems, could be something else, e.g. REDTAIL, ESIGN, etc.
List of namespaces are defined in the "FM Namespaces (247)" domain.

Code Block
"createOrUpdateWorkItem": { 
     "pageName": "Updating Work Item...", 
     "workItemIdMetaField": "Request1.Ari.Id", 
     "pageType": "createOrUpdateWorkItem", 
     "workItemNamespace": "BASE" 
},

skipTo
Navigates to a different page, based on defined conditions.
Only transition with the name "skip" will work. This transition will define to which page the wizard will be redirected.
You can also have multiple conditions with different page IDs. Conditions will be checked one by one. First condition which is evaluated to truthful value, defines the page to go to.

Code Block
"skipTo": { 
    "pageType": "skipTo", 
    "skipTransition": "skip" 
},