**ContactManager** is a device intended to manage local contact for DataStorage, updating its reference in PANIC phonebook.
It is published under the [GNU Lesser General Public License](https://www.gnu.org/licenses/lgpl-3.0.en.html)
<br /><br />
---
---
# License
It is published under the [GNU Lesser General Public License V3](https://www.gnu.org/licenses/lgpl-3.0.en.html)
*(see LICENSE.txt file)*.
<br /><br />
---
---
# Environment configuration
...
...
@@ -12,7 +19,7 @@ To properly work, this device needs:
-Python ≥ 3.6.8
-pytango ≥ 9.4.1, but ≠ 9.5.1
<br /><br />
---
---
# Device Properties
...
...
@@ -20,8 +27,9 @@ To properly work, this device needs:
|Name|Type|Description|
| ---- | ---- | ----------- |
| ContactKey | String | The key for which to modify the value in PANIC Phonebook. |
| ContactList | String[] | The contacts this device should know.<br />Each contact should be written this way:<br />Contact_Name:PhoneBook_Value<br /><br />The Contact_Name entries will represent the possible enum labels for contact attribute.<br />The PhoneBook_Value is what to write in PANIC Phonebook at the key defined in ContactKey property when contact attribute is set with Contact_Name.<br /><br />Example:<br /><pre>John:john.doe[]()@synchrotron-soleil.fr<br />Jack:%JACK<br />Telma:telma.louise[]()@synchrotron-soleil.fr</pre><br /><br />With this example, contact attribut will have the enum labels [\"Unknown\", \"John\", \"Jack\", \"Telma\"]. |
| ContactList | String[] | The contacts this device should know.<br />Each contact should be written this way:<br />Contact_Name:PhoneBook_Value<br /><br />The Contact_Name entries will represent the possible enum labels for contact attribute.<br />The PhoneBook_Value is what to write in PANIC Phonebook at the key defined in ContactKey property when contact attribute is set with Contact_Name.<br /><br />Example:<br /><pre>John:john.doe[]()@synchrotron-soleil.fr<br />Jack:%JACK<br />Telma:telma.louise[]()@synchrotron-soleil.fr</pre><br />With this example, contact attribut will have the enum labels [\"Unknown\", \"John\", \"Jack\", \"Telma\"]. |
<br /><br />
---
---
# Attributes
...
...
@@ -33,6 +41,7 @@ Every attributes are at OPERATOR Level.
| panicPhonebookReady | no | Scalar | READ | DEV_BOOLEAN | Whether PANIC Phonebook was found. |
| contact | yes | Scalar | READ_WRITE | DEV_ENUM | What to write in PANIC Phonebook for the key defined in ContactKey property.<br />The effective written value will be the one in ContactList property for which the key matches the selected label in contact attribute.<br /><br />"Unknown" will always be present in enum labels at first index.<br />Setting contact attribute with "Unknown" will have effect neither on PANIC Phonebook, nore on contact read value.<br />contact read value may return "Unknown" when the value in PANIC Phonebook for the key defined in ContactKey property matches no known value, or when this key is not present in PANIC Phonebook. |
<br /><br />
---
---
# Commands
...
...
@@ -45,6 +54,7 @@ Every commands are at OPERATOR Level.
| State | DEV_VOID | DEV_STATE | This command gets the device state (stored in its device_state data member) and returns it to the caller. |
| Status | DEV_VOID | DEV_STRING | This command gets the device status (stored in its device_status data member) and returns it to the caller. |
