How to Customize the System-Level Plugin Integration

Configure the system-level Environmental Services vendor integration by editing the <plugin> section of the evs.xml file, a structured XML document.

In most situations, the default values Vocera provides in the <plugin> section of evs.xml are sufficient. You do not need to modify this section of evs.xml unless you want to customize the default behavior of the web services retry handlers. In all other cases, the default values provided for the parameters in evs.xml are sufficient.

To customize the system-level web services integration for status updates:

  1. On the Vocera Environmental Services Integration server, open the \vocera\evs\resources\evs.xml file in a text editor, if it is not open already.
  2. Specify how often Vocera retries the web services update for cleaning request completion (if the first update attempt fails) by setting values for the tags in the <configuration><plugin><complete><retry> section of the evs.xml file.

    Specify a value within each pair of begin and end tags as follows:

    Tag Value
    <configuration>
       <plugin>
          <complete>
             <retry>
                <timeout/>
    Use the <timeout/> tag to specify the total duration of time (in seconds) that may elapse during completion update retries before a timeout occurs. By default, the value is 60 seconds.
    <configuration>
       <plugin>
          <complete>
             <retry>
                <interval/>
    Use the <interval/> tag to specify the total duration of time (in seconds) that Vocera will wait before attempting to update cleaning request completion status, if the previous update attempt failed. By default, the value is 5 seconds.
  3. Specify how often Vocera retries the web services in-progress update for cleaning requests (if the first update attempt fails) by setting values for the tags in the <configuration><plugin><inprogress><retry> section of the evs.xml file.

    Specify a value within each pair of begin and end tags as follows:

    Tag Value
    <configuration>
       <plugin>
          <inprogress>
             <retry>
                <timeout/>
    Use the <timeout/> tag to specify the total duration of time (in seconds) that may elapse during in-progress update retries before a timeout occurs. By default, the value is 60 seconds.
    <configuration>
       <plugin>
          <inprogress>
             <retry>
                <interval/>
    Use the <interval/> tag to specify the total duration of time (in seconds) that Vocera will wait before attempting to update cleaning request in-progress status, if the previous update attempt failed. By default, the value is 5 seconds.
  4. Save and close the evs.xml file.

The web services status udpate configuration is now complete. Following is an example of a typical web services configuration.

<plugin>
    <complete>
        <retry>
            <timeout>60</timeout>
            <interval>5</interval>
        </retry>
    </complete>
    <inprogress>
        <retry>
            <timeout>60</timeout>
            <interval>5</interval>
        </retry>
    </inprogress>
</plugin>