You enable the voice inspection feature so that inspectors can complete hands-free
inspections on a mobile device. The inspection form is read aloud to the inspector and the
inspector's verbal responses are recorded in the inspection form.
Before you begin
Voice inspections are available to customers who have IBM® Maximo® Manage, IBM Maximo Assist, and IBM Maximo Mobile. To enable voice inspections, you must
ask your sales representative for the IBM Watson®
service instance and API key information.
About this task
Note: Starting in Maximo Application Suite 9.0, the voice inspection feature is no
longer available in Maximo Assist. If voice inspections is enabled and
you are upgrading to Maximo Application Suite 9.0, this feature is automatically
removed during the upgrade.
Procedure
-
In Maximo Application Suite, configure
Maximo Assist for IBM Watson™ services:
- Log in to Maximo Application Suite.
- On the Suite administration page, select
catalog from the menu, then click the Assist
tile.
- Select View deployment details, find your workspace, and select
Go to workspace details page.
- From the Actions menu, select Update
configuration.
- In the Configurations list, edit one of the IBM Watson services.
- In the Endpoint field, specify your IBM Watson service instance.
- Required: Configure the API key for IBM Watson services:
- Repeat steps 1d - 1f for all other IBM
Watson services in the Configurations list.
- Select Apply changes and then select
Activate.
Option |
Description |
If you are configuring IBM Watson services
for the first time |
Enter the API key for your IBM Watson
service. |
If you are updating an existing configuration for IBM Watson services. |
Click Replace secret. |
- Assign the Assist user role to the inspectors who want to complete voice
inspections:
- On the Suite administration page, select
Users from the menu, and open the user record for the
inspector.
- Click Edit and in the Application access
section of the user record, in the Assist row, in the Access field, select
User as the user role.
- Save the changes and wait for the update to complete.
- Repeat steps 2a - 2c for other inspectors who want to complete voice
inspections.
- In Maximo Assist,
create the Assist API
key:
- Log in to Maximo Assist, select
, and
click Create API key.
- Specify a name and description for the new API key.
- In the Role association section, select the Voice
APIs role and then click Save.
- Required: In the API key successfully
created dialog box, copy and save the generated API key.
The API key details
are required to configure a system property for voice inspections.
- In Maximo Manage, configure
voice inspections:
- Log in to Maximo Manage and
in the System properties application, add the following properties:
Property |
Description |
Type |
Value |
mxe.mobile.inspection.features.assistvoice |
Enables the voice assistant in mobile inspection forms in Maximo Application Suite.
|
Yorn |
1 |
mxe.mobile.inspection.features.assistvoice.epname |
Defines the endpoint name that is used by the voice assistant.
|
ALN |
ASSIST_VOICE |
mxe.mobile.inspection.features.assistvoice.domain |
Defines the voice assistant domain. The domain must contain the protocol, hostname, and port of
the service.
|
ALN |
The URL of the Maximo Assist application |
mxe.mobile.inspection.features.assistvoice.apikey |
Defines the API key that is used to authenticate the voice assistant.
|
ALN |
The API key generated in step 3d |
- Save your changes, select the four new properties, and then click Live
Refresh.
- Add a crontask for voice inspections:
- In the Cron Task Setup application, select New crontask
Definition and enter the following details:
- Cron Task
- AssistVoiceCronTask
- Class
- psdi.app.inspection.AssistVoiceCronTask
- Access Level
- FULL
- Add a crontask instance with the following details:
- Cron Task Instance Name
- DailyTask
- Schedule
- 1d,0,0,0,*,*,*,*,*,*
- Run as User
- MAXADMIN
- Set the crontask to active and save the definition.
- Enable voice inspections:
- In the Manage Inspection Forms tool, create a revision of the inspection that you want
to enable voice inspections for.
- Open Form settings, select Enable voice
inspection, save the inspection, and set the revision to active.
Results
In Maximo Mobile, in the
inspection record, the inspector can tap the microphone icon to start a voice inspection. Voice
inspections can be completed on inspections that have a status of in progress.