Overview

UHIMS Events refers to messages that UHIMS publishes to the UH Message Broker. It is a convenient way of receiving identity, affiliation, and contact information about the students, faculty and staff that your application serves. The data comes from several official sources, including Banner, PeopleSoft, RCUH, SECE and WPMS. UHIMS digests the information from these various systems and makes it available in one place.

Message Specs

• UHIMS Events - Message Specs
• UHIMS Events - Message Specs (future), includes retrofit messages

Note that <messageRoutingKey> in the above specs is not an actual XML tag. It represents the message routing key for the message being described.

Connection Settings

Requesting Access

1. Review UHIMS Events - Message Specs and determine which messages you are interested in.
2. Contact its-iam-help@lists.hawaii.edu to request access:
   • Provide a desired username for the UH Message Broker. This should be something related to your application, not your personal username, e.g.
     • student_housing
   • Provide a desired queue name. It will always be preceded by the above username, e.g.
     • student_housing.prod
     • You must register your queues with us. We will declare the queue and its bindings for you. This is to ensure the queues exist and have the correct settings for persistence, high-availability, etc.
   • Provide the message routing key pattern for the messages you want to be routed to your queue. It is OK to provide multiple patterns. Here are some examples:
     • # (you are interested in all messages)
     • username.# (you only want username messages)
     • affiliation...uhm.hris (you only want affiliation changes for UH Manoa coming from PeopleSoft)

Reading UHIMS Events

See Consumer Code Example