Description	Waiting Room plugin to store records from Crew Inspector
Latest Version	2024.20.2.1
Release Date	23 May 2024
Download Path	Download
Type	APM Plugin

Change Log:

Version

Date

Description

2024.10.2.1

23 May 2024

APMPI-1199 -

In the APM WaitngRoom plugin, added the following enhancements:

Added the API Key field.

Removed the API_Password.
Connected and found the /AIWS_WaitingRoom method in the new AUS/AdonisUploadService.svc

Introduction

The Waiting Room plugin stores records which have not been imported from the APM plugins that use the AIWS and AUS APIs due to errors. The plugin is designed to easily identify the issue and find its solution.

Functionality

The section will teach you how to operate the plugin.

To get started, first, open the plugin. For this, switch to the Tools ribbon tab and click the Import button. From the drop-down list, select Waiting Room:

The plugin main page then appears:

Reveal Errors

On accessing the plugin, you can view the list of records that failed to be imported to APM. To view the description of the error(s), select a record and expand it:

The Error/Text column specifies the error code and its description. For more information, see Interfaces Errors/Text and Solutions.
The Solution column contains the instructions to be followed to resolve the issue. For more information, see Fixing Errors.

In case the error text refers to the XREF missing or incorrect data, please read Associate Records with XREF for possible solutions.

To view the initial set of data being imported to APM, click the View link:

Fix Errors

Based on the error description and the provided solution, you can resolve the issue manually (for more information, see Associate Records with XREF) or contact the Administrator and proceed with the data import. For this, make sure to carefully follow the provided instructions:

Once completed, click IMPORT TO ADONIS on the plugin toolbar to run the import process.

Associate Records with XREF

The XREF functionality in Adonis is designed to associate records in the Adonis lookup tables, such as General Codes and Organization Structure, with their corresponding codes used in external systems.

Before getting started, make sure, the third-party interface is predefined in APM.

Log into the Adonis Personnel Manager. Once logged in, navigate to the Setup ribbon tab > General Codes > Miscellaneous > Interfaces and proceed with the following steps:

On the ribbon, click New to make the dialog appear:
Enter a Code (mandatory field), a unique alpha-numeric APM code.
In the Text field, indicate the name of an interface and its alternative name, if needed, in the Alternative field.
In the Sort field, define the order number of a record (where 0 means the first record in the list).
In the Is Passive field, specify whether the code is to be active or passive. Passive codes appear as disabled. Setting a code to Passive is recommended if it is no longer in use.
In the APP Modules field, select the Adonis Personal Portal module(s) where you want to use the code.
Click OK to proceed.

Log into the Adonis Personnel Manager. Once logged in, navigate to the Setup ribbon tab > General Codes and proceed with the following steps:

Select the category code to be affected (e.g. Medical Codes, Personal Detail Ranks, etc.)and click Open on the toolbar.
Switch to the XREF tab and click the Append button. Clicking the command enables the fields to be filled out:
- Interface. Select the interface from the drop-down list. If the interface is unavailable, you need to define the interface by following the instructions in How to add an xref interface above.
- Xref Code. Enter a cross-reference value of the 3rd party system.
- Comment. Enter any comment you want to add.
When completed, click OK to apply the changes.

Housekeeping

The section will guide you through the plugin installation and configuration procedures.

Download and Installation

To install the plugin, navigate to Install APM Plugin and follow the step-by-step instructions carefully.

The latest plug-in version is available here: Waiting Room.

Connection Settings Configuration

To view the records, you need to establish a connection with AdonisIntegrationWebService.

For this, follow the steps below:

In the Waiting Room plugin, navigate to Settings:
In the Settings dialog, fill in the following fields:
- In the AUS Url field, enter the webservice URL.
- In the API Key field, enter the API Key that has been generated in the APP
Click Test Connection to make sure the connection is successfully established and click OK to proceed:
Click Save for the changes to take effect.