Для импорта и экспорта групповых изменений в окне «Агенты» интерфейс GAX использует файлы данных с разделителями-запятыми (CSV). В этом разделе описывается формат CSV-файла и содержится несколько примеров.
В исходном файле каждая строка представляет собой отдельного пользователя или агента. Каждый пользователь или агент может быть указан в исходном файле только один раз. Уникальным идентификатором пользователя в контексте исходного файла является поле Имя пользователя.
Столбцы файла представляют собой свойства пользователя или агента. В первой строке файла указаны имена столбцов, определяющие поля. Порядок столбцов не имеет значения. После каждого заголовка столбца или значения ставится запятая. Если же значение в столбце отсутствует, запятая ставится сразу после предыдущей запятой. В зависимости от настроек пользователя или предназначения файла любой необязательный столбец, имеющийся в исходном файле, можно опустить.
В исходном файле для каждого пользователя или агента содержатся перечисленные ниже свойства.
| Имя
|
Тип
|
Обязательно?
|
Описание
|
Структура CSV-файла импорта
| Действие
|
ДОБАВИТЬ, ОБНОВИТЬ
|
Да
|
Указывает действие, которое требуется выполнить с данными агента: создать нового агента (ДОБАВИТЬ) или изменить существующего (ОБНОВИТЬ).
|
| Имя
|
Строка
|
Да
|
Имя пользователя или агента.
|
| Фамилия
|
Строка
|
Да
|
Фамилия пользователя или агента.
|
| Идентификатор сотрудника
|
Строка
|
Да
|
Идентификатор пользователя или агента
|
| Имя пользователя
|
Строка
|
Да
|
Имя пользователя или имя пользователя агента.
|
| Пароль
|
Строка
|
Нет
|
Пароль, который должен использоваться с именем пользователя
|
| Изменение пароля
|
Логическое значение (Д или Н)
|
Нет
|
Необходимо ли пользователю или агенту обновить пароль при следующем входе?
|
| Является агентом
|
Логическое значение
|
Да
|
Определяет, представляет ли запись пользователя или агента (от этого зависит функциональность).
|
| Внешний идентификатор
|
Строка
|
Нет
|
Внешний идентификатор
|
| Адрес электронной почты
|
Строка
|
Нет
|
Адрес электронной почты пользователя или агента (обычно совпадает с именем пользователя).
|
| Расширение
|
числовая строка
|
Нет
|
Расширение агента по умолчанию. Если расширение указано, начинается процедура создания места по умолчанию.
|
| Включено
|
Логическое значение
|
Нет
|
Состояние пользователя—Д=включено, Н=отключено
|
| Папка
|
Строка
|
Да
|
Папка и путь к корневой папке (Люди) в которой будет создан пользователь или агент (например, Компания/Отдел/Команда)
|
Связанные столбцы
Кроме свойств и папок, в каждом ряду могут быть представлены связи между пользователем или агентом и другими объектами конфигурации, в частности, коммутаторами, группами агентов, навыками и группами доступа. В исходном файле для каждого объекта коммутатора, группы агентов, группы доступа или навыка будет предусмотрен отдельный столбец. Например, для 10 групп агентов, 1 коммутатора, 15 навыков и 4 групп доступа в исходном файле появится 30 дополнительных столбцов — по одному для каждого объекта конфигурации. Все связанные столбцы являются необязательными.
Каждый заголовок связанного столбца состоит из типа и имени объекта, которые образуют уникальное имя столбца. Следовательно, не может быть, например, двух навыков с одинаковым именем, но имя объекта «Навык» может совпадать с именем объекта «Коммутатор».
В таблице ниже перечислены правила указания имен и значений для связанных столбцов.
| Тип
|
Имя столбца
|
Допустимые значения
|
Связанные столбцы
| Коммутатор
|
Коммутатор:<switch name>
|
Д — создать имя для входа агента для этого агента на этом коммутаторе
Н — удалить имя для входа агента для этого агента из этого коммутатора
<empty> — действие отсутствует
|
| Группа агентов
|
AgentG:<agent group name>
|
Д — добавить этого агента в эту группу агентов
Н — удалить этого агента из этой группы агентов
<empty> — действие отсутствует
|
| Группа доступа
|
AccessG:<access group name>
|
Д — добавить этого пользователя или агента в эту группу доступа
Н — удалить этого агента из этой группы доступа
<empty> — действие отсутствует
Important При групповой выгрузке Группа доступа по умолчанию, указанная в системных предпочтениях, не применяется, так как группа доступа указана для агента в CSV-файле. |
| Навык
|
Skill:<skill name>
|
<number> — назначить этот навык агенту с этим уровнем навыка
Н — удалить этот навык из агента
<empty> — действие отсутствует
|
При выгрузке файла интерфейс GAX автоматически добавляет в начале каждой записи новый столбец с заголовком «Действие». Для каждой записи будет назначено одно из перечисленных ниже значений.
Чтобы создать трех агентов, в среду GAX необходимо выгрузить указанные ниже данные.
Sarah,Lee,223344,sarahl@acme.com,N,,,,,,,Y,ADD,Acme/Branch/Team 1
John,Doyle,223465,johnd@acme.com,Y,,2233,1,Y,N,Y,,ADD,Acme/Branch/Team 2
Robert,Cook,244456,bobc@acme.com,Y,,2356,5,Y,,Y,,ADD,Acme/Branch/Team 3
