External References System Map and Process Overview

In LogicNets-based applications, users may need to check more detailed information or view-related information on the question or current context. You can store this information as a resource, which is typically a piece of formatted text or graphics. Resources are stored in different locations, including the following:

• in the LogicNets application itself in the content folder
• in the LogicNets KnowledgeCenter
• in an external location, such as a content-management system

This article explains the interaction between an external content/document management system (DMS), the LogicNets Designer and the runtime application.

During "Design" Phase

1. The Designer user starts from the DMS system via the LogicNets Designer Starter.
2. The Designer user can create a new reference in the LogicNets Designer by selecting a pre-configured source. The LogicNets Designer starts the External Reference Browser and selects a reference.
3. The External Reference Browser sends the selected reference meta back to the LogicNets Designer in JSON format.
4. The Designer user saves this information in the existing references structures in the logicnets. This is a Lua-based data structure.
5. When the Designer user closes the LogicNets Designer application, the system scans all of the logicnets references and stores them in a meta-xml file. The project, including this meta-xml file, is saved back into the DMS system.
6. The DMS user may update some properties of the meta-xml file on the DMS system.

During "Publish" Phase

1. The DMS system can ask the LogicNets system to publish a project. The LogicNets system returns a published package and the corresponding meta-xml.
2. The DMS user may update some properties of the meta-xml file on the DMS system.
3. The DMS system sends the published package (+XML) to an end-user-production system and installs the package.

During "Run-time" Phase

1.  The end user starts the application and the LogicNets runtime engine reads the meta-xml, converts it to Lua-structure, and stores it in the session for quick reference.
2. When the end user navigates to a reference link, the LogicNets runtime engine detects the reference details in the logicnet and checks whether there are updated properties available in the references structure in the session.
3. The Logicnets runtime engine uses the latest properties and renders the link content on screen.

Configuration

You can find information on configuring external reference sources here.