Creating a statement within a document - AcceleratorKMS - Version 5.0 - Help - Hexagon

AcceleratorKMS Traditional Content Writing

Language
English
Product
AcceleratorKMS
Search by Category
Help
AcceleratorKMS Version
5.0

Statements are used to build content within a document.

Before you begin

You must open the content in edit mode.

About this task

All documents, regardless of the document type, are built using statements. During content creation or editing, you can add existing statements or create new ones.

Branch statements are used as decision points to determine the next statements in the document. A branch statement prompts the user to select either Yes or No. When the user selects either Yes or No, the relevant statements for that decision are displayed. After selecting Yes or No, the user can deselect it by clicking the decision button again.

The following can be added by your Administrator:

  • Scan code statements are used when a code value is required to be scanned for equipment verification purposes. After a scan code statement is created, the code value is manually entered or the code is scanned using the camera on a mobile device. During completions, the barcode or QR code is scanned using a camera on a mobile device to capture the code.

    Barcode and QR code requirements:

    • QR code must be dark with a light background.

    • The contrast between the QR code and the background must be at least 50 percent.

    • The dimensions of the QR codes must be at least one inch in height and width, including margins.

  • Data collection statements allow operators to record data, such as current temperature, pressure, vibration level, or any other required data they need to record. You add the statement, define the key type (such as All, Text, Numeric, Date/Time, Single select list, Multi-select list), and the key ID. Optionally, during a completion, data collection statements can be configured to scan text and numeric inputs. A numeric range can be set on data collection statements.

Procedure

A statement is saved differently depending on the following:

  • A statement is automatically saved to the database as it is created. You must click Preview on the document if you want to save it to your document.

  • Newly added content within a block is saved when you click Preview for the block. If your document was not saved, the content added to the block is still preserved.

Modifications to existing statements are saved after you click Preview and Save on the statement. You do not need to click Preview on the document to preserve your changes.

  1. In the main section of the document, click the ellipsis icon > +Item.

    A statement text box appears.

    If you want to add a statement in a new or existing block, see the section Blocks - create and manage within this guide.

  2. Click the Type drop-down list, and select from one of the following:

    • Information

    • Procedural

    • Branch

    • Block

    • Other types, such as, Scan code, Data collection and Table might be listed if created by your Administrator

  3. If you select either Procedural or Branch types, click the Role drop-down list, and select a role.

    The role drop-down list is only required when procedural and branch types are selected and only roles defined with role operation "Can complete content" will appear for selection in the role drop-down list.

    SHARED Tip When adding an item of any type using Quick add, the system performs a search on existing items to maximize reuse potential. A search toggle is now available to turn search on or off. When Quick add search is on as shown in the following figure, the system performs a search and returns results of existing items. When search is off, the system does not perform a search. To maximize reuse, it is recommended to keep search turned on. However, in some cases where reuse is not relevant, it might be desirable to turn search off to avoid unnecessary searching.

    SHARED Tip You can copy/paste text to build new statements or to easily find existing statements.

    SHARED Tip If there is an existing statement that is similar to what you want, you can select it and modify it. After you modify the statement, the Reuse button changes to Create, which allows you to quickly build a new statement from an existing statement.

  4. In the Quick add field, start typing the text you want to add and then choose one of the following:

    • Select a statement from the list of existing statements, and click Reuse.

    • Complete entering your new statement text, and click Create.

  5. Click Preview and Save. This ensures the newly added statements are fully added to the document.

Results

The statement is added to the document.

What to do next

  • If you want to add more details and attachments to the statement, you must edit the statement. For more details, see Creating a statement using the statement editor.

  • If the statement contains a variable, define a value for the variable; otherwise, the variable remains undefined. Content drafts cannot be published until all undefined variables are resolved.

  • If the statement was added to a document template, you can change the conditions within the template to determine when the statement is displayed. These settings allow you to set the statement to be shown for a specific asset or attribute, or you can hide the statement for a specific asset.

  • If the added statement was a branch statement, add the additional statements that are required if you select either Yes or No for the branch statement. You can either add items within a branch statement by using the +Item, +Sections, or +Items options within or outside the statement. If you choose to add items or sections outside a branch, you must then drag and drop that content within the branch statement.

  • If the added statement was a data collection statement, add an existing data collection key or define a new one by entering the key's type and id. Content drafts cannot be published until all undefined data collection keys are resolved for any data collection statements.

  • If the added statement needs sub-statements, create each of the required statements and place them under the originating statement as subordinates using drag and drop. For details, see Organizing content using drag and drop.

Statement fields

Use these fields when you create or edit a statement.

Field

Description

Usage

Indicates the number of times the statement is used in content and templates. Click the usage number to display the list of content and templates.

Type

Default statement types include: Information, Procedural, Caution, Warning, and Branch. Other types, like Scan code, can be defined by administrators.

Sequence is critical (check box)

Indicates that the statement must be performed prior to remaining steps in the content. The system displays a note in the text area of the step for anyone completing the step.

This is only available in the statement editor when editing a statement or when creating a statement outside of content.

Text

Provides information or action for the user.

Role

The user role responsible for completing the statement.

Tags

Provides user the ability to add words or phrases that can be used when searching for a statement

More details

Provides additional information related to a statement. This text is hidden from view and can be accessed by clicking 'More details'. It contains supporting information that most users don’t need immediately, which is why it is collapsed by default. Any information that needs to be displayed or seen by all users should be included in the main statement, not under 'More details'.

When in edit or review mode, 'More details' is expanded by default.

Reusable variables

All reusable variables used in the Statement or More details areas are listed in the Reusable Variables area.

Attachments

Add, remove, or edit attachments that contain images or additional information that the user might need. Maximum file size is 100 MB.

  • Save the statement first and then edit the statement to add an attachment.

  • To maintain site speed, it's advisable to attach files under 20 MB, since AcceleratorKMS does not automatically compress images upon upload.

Training

Add text or attachments that are viewable to the user only when they are completing learning modules in AcceleratorLXP for the affected content. Typically, you would add extra information that might be helpful during training, but not required during a regular content completion. This is only visible when enabled by the Administrator.