Skip to main content
Older versions of Internet Explorer will not support certain site features. Chrome, Safari, Firefox, and Edge will provide the best experience.
Spok

Adding and Managing Tenants

When you choose the Administration|Tenants|Tenants menu option in the Spok Hosted Administration interface, you have the ability to view, add, edit, license, and delete tenants. 

Tenants in the Spok Hosted Administration system represent multiple sites. For example, tenants can represent entire hospital organizations that are made up of smaller geographic locations called “sites.” More specifically, “Hospital ABC” could have an “ER Building” and an “OBGYN Building.” In this situation, “Hospital ABC” would be the tenant because it is the larger organization structure that is made up of multiple sites. The “ER Building” and the “OBGYN Building” are sites within that tenant.

A tenant is an organizational layer of data between a customer and a site. A customer is someone who has purchased Spok products, and most often they will be a hospital or a network of hospitals. And sites are smaller geographic locations that make up a customer. Here are two example scenarios:

  • “ABC Hospitals” purchases the Spok Mobile product. They are added as a customer with a name of “ABC Hospitals.” The “ABC Hospitals” customer has an entire network of hospitals, and they will be managing data in two separate data centers for all of its hospital locations. The two data centers where the information is stored for all of their hospital locations are considered tenants, and the data centers are entered as tenants in the Manage Tenants page. And the separate hospital locations of the “ABC Hospitals” customer, such as Dallas and Minneapolis, are considered sites. And these sites are associated with the appropriate tenant.

SMHAdmin_4.3_Tenants.png

  • “Hospital ABC” purchases the Spok Mobile product. They are added as a customer with a name of “Hospital ABC.” The “Hospital ABC” customer has only one location with separate buildings, and they will be managing data in a single data center. The data center where the information for each of the hospital’s buildings is stored is considered a tenant, and the data center is entered as a tenant in the Manage Tenants page. And in this case, the tenant should be added with the same name as the customer. The separate buildings of the “Hospital ABC” customer, such as the ER Building and the OBGYN Building, are considered sites. And these sites should be associated with the “Hospital ABC” tenant.

SMHAdmin_4.3_Tenants2.png

IMPORTANT NOTE: The customer name is for Spok accounting and finance use, whereas the tenant name is what the customers see.

Using the Tenant Grid

The tenant grid, which is the list of available tenants that are currently being managed in the system, can be refreshed, searched, rearranged, and reordered. For more information on navigating the tenant grid, please refer to Getting Started.

Viewing Tenants

Existing tenants that are in the system can be viewed in the Manage Tenants screen.

  1. In the Spok Hosted Administration interface, choose the Administration|Tenants|Tenants menu option. The Manage Tenants screen displays, showing the tenant grid.

SMHAdmin_4.3_ManageTenants.png

Adding Tenants

New tenants can be added to the system.

  1. In the Spok Hosted Administration interface, choose the Administration|Tenants|Tenants menu option. The Manage Tenants screen displays, showing the tenant grid.

SMHAdmin_4.3_ManageTenants2.png

  1. In the Manage Tenants screen, click Add . The Create Tenant screen displays.

SMHAdmin_4.3_ManageTenantsAddHighlighted.png

SMHAdmin_4.3_CreateTenant.png

  1. In the Name field, enter a unique name for the tenant.
  2. From the Language list box, select the language that should be used by the tenant. The options are: Bulgarian, English, French, German, Italian, and Spanish.
  3. From the TimeZone list box, select the time zone that should be used. The time zone is assigned by default to user profiles when a new profile is created.
  4. In the Enterprise URL field, enter the fully qualified domain name (FQDN) or IP address of the customer’s Premise system (Example: http://FQDN_or_IP_Address).

SMHAdmin_4.3_InfoSection.png

  1. From the Customer Name drop-down menu, select the appropriate customer.

To narrow down the options, you can begin typing the desired customer name. The list will filter out any options that don’t match your entry.

SMHAdmin_4.3_CustomerSection.png

  1. From the Long Date Format and Long Time Format fields, select the long date and time formats.

The long date format includes the day, month abbreviation, and full year (i.e. 25 Feb 2014).

The long time format includes the hour, minutes, and seconds, as well as AM or PM notation (i.e. 1:22:24 AM).

  1. From the Short Date Format and Short Time Format fields, select the short date and time formats.

The short date format includes the day, month, and year in number format only (i.e. 02/25/2014).

The short time format includes only the hour and minutes (i.e. 01:22).

NOTE: Some time options have “tt” included in the format option. The “tt” is converted to the a.m./p.m. notation.

SMHAdmin_4.3_SettingsSection.png

  1. Scroll down to the Applications and Features section.

SMHAdmin_4.3_ApplicationsAndFeaturesSection.png

  1. Enable the Spok Mobile option if this tenant has purchased Spok Mobile.
  2. Enable the Client Initiated Messaging option if the devices at the site should have the ability to send Spok Mobile messages to other devices with Spok Mobile. If this option is disabled, users do not have the ability to initiate messages to other Spok Mobile application users. Instead, they can only respond to incoming messages on their devices. This option must be purchased by the site before it can be enabled.
  3. Enable the Display “From” Field option if the devices at the site should display a From field at the top of incoming Spok Mobile messages. For example, when Spok Mobile application users receive an incoming message on their device, there is a From field at the top of the message that includes who sent the incoming message. If this field is disabled, users do not have the ability to view who sent the incoming message to their device. This option must be purchased by the site before it can be enabled.
  4. Add sites to this tenant if necessary.

Adding Sites

Sites can be added into the Spok Mobile configuration in the Configuration screen. Please note that depending on the type of message delivery chosen from the Message Delivery drop-down menu, the Site List section may include an additional field. When the Local message delivery option is chosen, the Host System URL field displays. For detailed information on the Host System URL field, please refer to Editing System Settings.

  1. Go to the Mobile Sites section in the Create Tenant screen.

NOTE: The Spok Mobile checkbox must be selected in order for this section to display.

SMHAdmin_4.3_CreateTenant2.png

  1. In the Mobile Sites section, click Add . A new, editable row is added.

SMHAdmin_4.3_SiteIDField.png

SMHAdmin_4.3_SiteIDFieldEditable.png

  1. In the Site ID field, enter the site ID name for the new site. The Site ID is used to determine which customer’s site needs to be supported on the instance of the Spok Mobile Server. Multiple customer site IDs can be added for an installation that supports multiple host systems. The site IDs must be unique. Please note that it is important that the site ID that is set up in the Spok Enterprise Administration page must match this value. For detailed information on setting this up, please refer to the Implementation_Guide_Spok_Mobile document.
  2. In the Name field, enter a name for the new site. Please note that site names must be unique. This name will be what displays on Spok Mobile devices.
  3. To add the new site, click Update . The site is added to the list.

SMHAdmin_4.3_SiteIDFieldNewInfo.png

Editing Sites

Existing sites in the system can be edited.

  1. Go to the Mobile Sites section in the Create Tenant screen.

SMHAdmin_4.3_CreateTenant3.png

  1. Click on the Site ID you would like to edit. The fields become editable and an Update button displays next to the site fields.  

SMHAdmin_4.3_SiteIDEditable.png

  1. Edit the desired information. Please note that the Site ID should be a name for the site being entered.
  2. Click Update next to the edited site. The changes to the site are saved.

Deleting Sites

Existing sites can be removed from the system.

  1. Go to the Mobile Sites section in the Create Tenant screen.

SMHAdmin_4.3_CreateTenant3.png

  1. Next to the site you would like to remove, click Delete . A confirmation dialog displays.

SMHAdmin_4.3_ConfirmDialog.png

  1. Click Yes to remove the site. The site is removed from the list.
  2. Enable the Local Message Delivery option if desired.

SMHAdmin_4.3_InfoSectionEmpty.png

  1. Scroll back down to the Applications and Features section. The Client Initiated Messaging option and the Display “From” Field option have been automatically selected.
  2. Disable these options as desired.
  • The Client Initiated Messaging option allows the Spok Mobile devices that are configured in the system to be able to send Spok Mobile messages to other devices with Spok Mobile. If this option is disabled, users do not have the ability to initiate messages to other Spok Mobile application users. Instead, they can only respond to incoming messages on their devices. Client-initiated messaging can only be used if local message delivery is selected.
  • The Display “From” Field option enables Spok Mobile devices that are configured in the system to display a From field at the top of incoming Spok Mobile messages. For example, if this option is enabled, when Spok Mobile application users receiving an incoming message on their device, there is a From field at the top of the message that includes who sent the incoming message. If this field is disabled, users do not have the ability to view who sent the incoming message to their device.

SMHAdmin_4.3_ApplicationsAndFeaturesSectionEnabled.png

  1. Click the Save link at the top of the screen to save your changes.

Editing Tenants

Existing tenants can be edited in the system.

  1. In the Spok Hosted Administration interface, choose the Administration|Tenants|Tenants menu option. The Manage Tenants screen displays, showing the tenant grid.

SMHAdmin_4.3_ManageTenants3.png

  1. In the Manage Tenants screen, click the Edit link next to the appropriate tenant. The Edit Tenant <Tenant Name> screen displays.

SMHAdmin_4.3_ManageTenantsEditHighlighted.png

SMHAdmin_4.3_EditTenantPopulated.png

  1. Change the information as needed. For more information on these fields, please refer to Adding and Managing Tenants.
  2. Click the Save button to save your changes.

Deleting Tenants

Existing tenants can be deleted from the system.

  1. In the Spok Hosted Administration interface, choose the Administration|Tenants|Tenants menu option. The Manage Tenants screen displays, showing the tenant grid.

SMHAdmin_4.3_ManageTenants3.png

  1. From the list of available tenants, find the tenant you would like to delete.
  2. Click the Delete link next to the appropriate tenant. A warning dialog displays.

SMHAdmin_4.3_ManageTenantsDeleteHighlighted.png

SMHAdmin_4.3_ConfirmDialog.png

  1. Click Yes. The tenant is deleted.