Vina Custom Parameters

The XMPP adapter defines parameters that enable you to customize the behavior and appearance of Vocera Vina clients in your environment.

Note: You can also specify parameters that enable you to link third-party apps to Vocera Vina clients. See Third-Party App Parameters for more details.

To create or access the custom parameters, login to the Vocera Platform Web Console as an administrator, then click Settings, Adapters, and XMPP. Click Edit and scroll down to the Custom Parameters section.

This table lists the custom parameters that are available. Integer ranges listed here are recommended but not enforced.

Parameter Name	Description	Values	Default	Unit
`vocera.max-message-length`	The maximum length of a message that the user can send.	50-2500	500	characters
`vocera.max-message-history`	The maximum number of messages retained in a 1-1 conversation or multi-user conversation. This does not apply to alert conversations.	10-200	80	rows
`vocera.optional-push-registration`	Tells the client to allow login even if cloud push registration fails. This is meant for closed demo systems that do not have access to update tokens and certificates. Clients will still warn users.	true,false	false	boolean
`vocera.notification-sound-timeout`	The elapsed time before the sound for a notification is to stop playing. This ensures that a user who has not been logged in for some time is not overwhelmed by sounds or hears a sound for an hours-old message.	2-10080	30	minutes
`vocera.panic-debounce`	The elapsed time before pressing the panic button a second time ends a panic broadcast.	5-60	5	seconds
`vocera.panic-volume`	Sets the speaker volume on the panic broadcast initiator's device.	0-100	null	percent
`vocera.phone-number-regex`	Regular expression used to determine if a number is a phone number that can be called.	N/A	`(?<=(\s\|^))[\+\d\(][\/\-\x20\d\(\)]*\d{2,}`	string
`vocera.counter-update-timeout`	The elapsed time period that the iOS Notification Service Extension uses to determine what badge number to use when a new APNS message notification is received. If the conversation is updated in a live, XMPP-connected app during the specified time period, use the App badge number. Otherwise, use the APNS-supplied badge number.	1-100	5	seconds
`vocera.show-snackbar-inactive-timeout`	The amount of time that the app has to wait before displaying a status message indicating an inactive state.	1-30	5	seconds
`vocera.context.industry`	Update the terminology used in the app based on the specified industry.	hospital hospitality senior living care general	hospital	string
`vocera.location.always`	Disable background location requests (iOS only).	true,false	true	boolean
`vocera.disallowed-passwords`	Disallow any login if the password matches the specified regular expression. Supported in Vocera Vina 10.1 and later.	N/A	none (must be explicitly added)	string