1.24 KDEV Создание клиентских файлов и управление ими

Задача этой AMO заключается в управлении записями и их добавлении в клиентский файл "PPCF". Пользователь может создавать, изменять или удалять файл в соответствии со своими индивидуальными потребностями.

Задача файла заключается в том, чтобы определить последовательность организационных единиц, абонентских номеров, персональных  номеров, их взаимоотношений, а также для  поддержания их в готовности на случай вызова данных.
Можно ввести до 3000 элементов, причем элементом считается организационное имя (напримерр 'EA'), абонентский номер или PIN-код.

Элемент всегда состоит из двух частей:

имя и

идентификатор имени.

Имя состоит из буквенно-цифровых знаков и может иметь максимальную длину 12 знаков. Максимальная длина абонентского номера составляет 6 знаков.
Идентификатор имени позволяет определить, идет речь об организационном имени, абонентском номере или персональном номере.

Общее обозначение для клиентского файла - имя PPCF, которое занимает самое высокое место в иерархии (см. также рис. 1). Он одинаков у каждого клиента.

PPCF имеет четыре иерархических уровня:

ORG1

ORG2

ORG3

T/P

T/P - это иерархический уровень для PP (абонент) или PIN-кода, который является самым низким уровнем.

При создании клиентского файла следует принять во внимание следующие моменты:

В рамках организационной единицы можно производить смешанное сохранение абонентов и PIN-кодов.

Абоненты, PIN-коды или организационные единицы, которые находятся на более низком иерархическом уровне, могут быть подчинены организационной единице.

Организационные единицы не могут быть подчинены уровню T/P.

Организационные имена, абонентские номера и PIN-коды могут встречаться в файле только один раз, то есть абонентский номер может использоваться, например, как номер PP, но в то же самое время то же обозначение может использоваться как PIN-код и/или единица ORG.

Единице ORG не обязательно должен быть назначен абонентский номер или PIN-код.

PPCF (общее обозначение для каждого файла) придан самый высокий иерархический уровень.
Ему напрямую подчинен отдел EA на уровне ORG 1.
Под отделом EA находятся отделы EA21, EA22 на уровне ORG 3 и отделы EA1, EA2 и  EA3 на уровне ORG 2.
EA21 имеет два подчиненных абонента 103 и 105 на уровне T/P.
EA22 не имеет подчиненных абонентов/PIN-кодов.
Отдел EA01 на уровне ORG 3 подчинен EA1.
EA01 имеет два подчиненных абонента 109 и 111 на уровне T/P.
EA2 не имеет подчиненных единиц.
PIN 117 на уровне T/P подчинен EA3.

С использованием команды DISPLAY-KDEV можно получить для этого примера следующий результат:

   ENTRIES FOR    ORG PPCF                           8 .7 .1999                 
                                                                                
   (1)  EA             (3)  EA21           (T)  103                             
   (1)  "              (3)   "             (T)  105                             
   (1)  "              (3)  EA22                                                
   (1)  "              (2)  EA1            (3)  EA01           (T)  109         
   (1)  "              (2)   "             (3)   "             (T)  111         
   (1)  "              (2)  EA2                                                 
   (1)  "              (2)  EA3            (P)  117                             
                                                                                
   12   ENTRIES IN CDR CUSTOMER FILE (PPCF)

Последовательность в файле идет слева направои сверху вниз. Цифры в скобках указывают уровни.

1.24.1 Взаимосвязи

Отсутствуют 

1.24.2 Функции AMO

ADD-KDEV	:	Создание PPCF или добавление новых записей
RENAME-KDEV	:	Переименование записей
CHANGE-KDEV	:	Изменение записей
DELETE-KDEV	:	Удаление PPCF или частей PPCF
DISPLAY-KDEV	:	Опрос PPCF или частей PPCF
REGENERATE-KDEV	:	Регенерирование PPCF или частей PPCF

1.24.2.1 ADD-KDEV

Командой ADD пользователь выбирает, что следует добавить в PPCF: "ORG", абонент или "PIN" .
В одном заказе можно создать цепочку максимум из 8 записей с одинаковым идентификатором имени, то есть используя команду создания организационной единице могут быть присвоены максимум 8 абонентов или "PIN" на одном уровне ORG.

Обзор процедуры

Код команды	Параметры
ADD-KDEV	POS=<параметр>,IDOLD=<параметр>,OLDNAME=<строка>
	,IDNEW=<параметр>,NEWNAME=<строка>;

Позиционные спецификации и последующие инструкции определяют, как сохраняются записи в соотстветствии с организацией "PPCF".

Пример

Создать названный выше клиентский файл

1.	На уровне ORG 1 первой записью должно быть организационное обозначение"EA" .

Ввод:

ADD-KDEV:U,ORG,PPCF,ORG1,EA; 

Под единицей ORG "EA" создается уровень ORG с орагнизационными обозначениями "EA21" и "EA22".

Ввод:

ADD-KDEV:U,ORG,EA,ORG3,EA21&EA22; 

2.	Добавить уровень ORG2 с организационными обозначениями "EA1", "EA2" и "EA3" под  единицей ORG "EA22".

Ввод:

ADD-KDEV:A,ORG,EA22,ORG2,EA1&EA2&EA3; 

3.	Добавить абонентов "103" и "105" под единицей ORG "EA21".

Ввод:

ADD-KDEV:U,ORG,EA21,STN,103&105; 

4.	Единице ORG "EA1" подчиняется уровень ORG3 с организационным обозначением "EA01".

Ввод:

ADD-KDEV:U,ORG,EA1,ORG3,EA01; 

5.	Добавить абонентов "109" и  "111" под единицей ORG "EA01".

Ввод:

ADD-KDEV:U,ORG,EA01,STN,109&111; 

6.	Добавить PIN 117 под единицей ORG "EA3".

Ввод:

ADD-KDEV:U,ORG,EA3,PIN,117; 

1.24.2.2 CHANGE-KDEV

Данная команда позволяет пользователю перемещать запись, будь то единица ORG, абонент или PIN-код, из существующей структурной колонки в другую. (Это возможно только с помощью REN-KDEV). Это значит, что когда работает функция CHANGE параметр IDNEW не производит дифференциации уровней ORG, чтобы предотвратить возможные ошибки. Просто введите "ORG" для IDNEW.

Обзор процедуры

Код команды	Параметрыs
CHANGE-KDEV	POS=<параметр>,IDOLD=<параметр>,OLDNAME=<строка>
	,IDNEW=<параметр>,NEWNAME=<строка>;

Примеры

Основанием служит представленный в начале клиентский файл.

1.	Уже существующая единица ORG "EA01" с назначенными абонентами добавляется под уже существующую единицу ORG "EA2".

Ввод:

CHANGE-KDEV:U,ORG,EA2,ORG,EA01; 

2.	Уже существующая единица ORG "EA22" добавляется под уже существующую единицуORG "EA2". Но так как единица ORG "EA01" уже добавлена в качестве подчиненной в результате предыдущего процесса,  "EA22" "цепляется" в конце. В этой ситуации возможны две альтернативные процедуры.

Либо ввести:

CHANGE-KDEV:U,ORG,EA2,ORG,EA22; 

Либо ввести:

CHANGE-KDEV:A,ORG,EA01,ORG,EA22; 

После выполнения процедур изменения 1 и 2:

Ввод:

DISPLAY-KDEV:ORG,PPCF; 

Структура клиентского файла в формате вывода

Вывод:

ENTRIES FOR    ORG PPCF                           8 .7 .1999                 
                                                                             
(1)  EA             (3)  EA21           (T)  103                             
(1)  "              (3)   "             (T)  105                             
(1)  "              (2)  EA1                                                 
(1)  "              (2)  EA2            (3)  EA01           (T)  109         
(1)  "              (2)   "             (3)   "             (T)  111         
(1)  "              (2)   "             (3)  EA22                            
(1)  "              (2)  EA3            (P)  117                             
                                                                                                                                                                

12   ENTRIES IN CDR CUSTOMER FILE (PPCF)

1.24.2.3 RENAME-KDEV

Изменение существующего имени и/или единицы ORG на новое, несуществующее имя или новый уровень ORG.

Обзор процедуры

Код команды	Параметры
RENAME-KDEV	IDOLD=<параметр>,OLDNAME=<строка>
	,{(min1)IDNEW=<параметр>,NEWNAME=<строка>};

Оба старых параметра могут быть переименованы одной командой, но изменить можно только IDOLD или толко OLDNAME.
Абонентов и PIN-коды переименовать нельзя.
По административно-управленческим причинам переименование PPCF не допускается.

Примеры

Основанием служит представленный в начале клиентский файл.

1.	Следует изменить имя. Следует указать, что групповой параметр не должен вводиться, но место под параметр следует оставить свободным (2 запятые). IDNEW можно ввести, но он должен соответствовать оригинальному идентификатору.

Изменить имя единицы ORG "EA21" на "EA11".

Ввод:

RENAME-KDEV:ORG,EA21,,EA11; 

2.	Изменить уровень ORG . Групповой параметр "NEWNAME" не следует указывать.

Изменить уровень ORG для единицы ORG "EA2" на "ORG3".

Ввод:

RENAME-KDEV:ORG,EA2,ORG3; 

3.	Переименовать уровень ORG и имя. Оба групповых параметра IDNEW and NEWNAME в этом случае необходимы.

Переименовать уровень ORG для единицы ORG "EA22" на "ORG2" и имя на "EA33".

Ввод:

RENAME-KDEV:ORG,EA22,ORG2,EA33; 

После выполнения процедур:

Структура клиентского файла в формате вывода

ENTRIES FOR    ORG PPCF                           8 .7 .1999                 
                                                                             
(1)  EA             (3)  EA11           (T)  103                             
(1)  "              (3)   "             (T)  105                             
(1)  "              (2)  EA33                                                
(1)  "              (2)  EA1            (3)  EA01           (T)  109         
(1)  "              (2)   "             (3)   "             (T)  111         
(1)  "              (3)  EA2                                                 
(1)  "              (2)  EA3            (P)  117                             
                                                                             
                                                                                  12   ENTRIES IN CDR CUSTOMER FILE (PPCF)

1.24.2.4 DELETE-KDEV

Этой командой пользователь может удалиить части клиентского файла или весь клиентский файл. Так как вместе с клиентским файлом на жестком диске имеется файл с данными трификации вызовов (CDB) по абонентам и/или PIN-кодам, следует указать, должен ли быть удален носитель затрат, несмотря на наличие данных тарификации вызовов.
Для уровня ORG, который должен быть удален, следует определить, следует удалить только запись этого уровня или все уровни, подчиненные этому уровню также длолжны быть удалены в ходе выполнения операции.
Во втором случае необходимо определить, нужно ли удалить данные тарификации вызовов для абонентов или PIN-кодов.

Обзор процедуры

Код команды	Параметры
DELETE-KDEV	IDOLD=ORG,SUBLEV=Y,DEL=<параметр>
	,OLDNAME=<строка>;
	|IDOLD=ORG,SUBLEV=N,OLDNAME=<строка>;
	|IDOLD=STN,DEL=<параметр>,OLDNAME=<строка>;
	|IDOLD=PIN,DEL=<параметр>,OLDNAME=<строка>;

Примеры

Основанием служит представленный в начале клиентский файл.

1.	Удалить единицу ORG, включая подединицы  и несмотря на наличие любых данных тарификации вызовов (см. единицу ORG "EA21" в качестве примера).

Ввод:

DELETE-KDEV:ORG,Y,Y,EA21; 

2.	Удалить абонента или PIN-код, только если данные тарификации (CDB) отсутствуют("PIN 117" в качестве примера)

Ввод:

DELETE-KDEV:PIN,N,117; 

3.	Удалить единицу ORG без подединиц (единица ORG "EA1" в качестве примера).

Ввод:

DELETE-KDEV:ORG,N,EA1; 

4.	Удалить весь клиентский файл, несмотря на на наличие данных тарификации

Ввод:

DELETE-KDEV:ORG,Y,Y,PPCF; 

После выполнения процедур удаления 1-3:

Структура клиентского файла в формате вывода

ENTRIES FOR    ORG PPCF                           8 .7 .1999
                                                                                
(1)  EA             (3)  EA22                                                
(1)  "              (3)  EA01           (T)  109                             
(1)  "              (3)   "             (T)  111                             
(1)  "              (2)  EA2                                                 
(1)  "              (2)  EA3                                                 
                                                                                                                                                                

7    ENTRIES IN CDR CUSTOMER FILE (PPCF)

1.24.2.5 DISPLAY-KDEV /REGENERATE-KDEV

У пользователя имеется возможность распечатать весь клиентский файл или части клиентского файла.

1.	Опросить клиентский файл с выводом в виде списка (DISPLAY)

2.	Опросить клиентский файл с выводом в виде позиционно-ориентированных команд для регенерации (REGENERATE)

Обзор процедуры

Код команды	Параметрыs
DISPLAY-KDEV	IDOLD=<параметр>,OLDNAME=<строка>;
|REGENERATE-KDEV	IDOLD=<параметр>,OLDNAME=<строка>;

Примеры

Основанием служит представленный в начале клиентский файл.

1.	Опросить клиентский файл с выводом в виде списка .

Ввод:

DISPLAY-KDEV:ORG,PPCF; 

Вывод:

ENTRIES FOR    ORG PPCF                           8 .7 .1999                 
                                                                             
(1)  EA             (3)  EA21           (T)  103                             
(1)  "              (3)   "             (T)  105                             
(1)  "              (3)  EA22                                                
(1)  "              (2)  EA1            (3)  EA01           (T)  109         
(1)  "              (2)   "             (3)   "             (T)  111         
(1)  "              (2)  EA2                                                 
(1)  "              (2)  EA3            (P)  117                             
                                                                                                                                                                

12   ENTRIES IN CDR CUSTOMER FILE (PPCF)

2.	Опросить клиентский файл для регенерации.

Ввод:

REGENERATE-KDEV:ORG,PPCF; 

Вывод:

ADD-KDEV:U,ORG,"PPCF",ORG1,"EA";
ADD-KDEV:U,ORG,"EA",ORG3,"EA21";
ADD-KDEV:U,ORG,"EA21",STN,"103";
ADD-KDEV:U,ORG,"EA21",STN,"105";
ADD-KDEV:U,ORG,"EA",ORG3,"EA22";
ADD-KDEV:U,ORG,"EA",ORG2,"EA1";
ADD-KDEV:U,ORG,"EA1",ORG3,"EA01";
ADD-KDEV:U,ORG,"EA01",STN,"109";
ADD-KDEV:U,ORG,"EA01",STN,"111";
ADD-KDEV:U,ORG,"EA",ORG2,"EA2";
ADD-KDEV:U,ORG,"EA",ORG2,"EA3";
ADD-KDEV:U,ORG,"EA3",PIN,"117";

1.24.3 Описание параметров

IDOLD	Идентификация позиционного параметра
	Тип ввода	:	одиночное значение, необходимо (ADD, DELETE, DISPLAY, REGENE-RATE, CHANGE, RENAME)
	Возможные значения	:	ORG	= Организация
			PIN	= Личный идентификационный номер
			STN	= Абонентский номер
IDNEW	Идентификация новой записи
	Тип ввода	:	одиночное значение, required (ADD,CHANGE) опционально, 1-й параметр мин. 1 группы (RENAME)
	Возможные значения	:	ORG1	= Организационный уровень 1
			ORG2	= Организационный уровень 2
			ORG3	= Организационный уровень 3
			PIN	= Личный идентификационный номер
			STN	= Абонентский номер
DEL	Удалить параметр, список
	Тип ввода	:	одиночное значение, необходимо (DELETE)
	Возможные значения	:	N	=  Нет
			Y	=  Да
OLDNAME	Имя позиционного параметра
	Тип ввода	:	одиночное значение, необходимо (ADD, DELETE, DISPLAY, REGENE-RATE, CHANGE, RENAME)
	Возможные значения	:	макс. 12 знаков
NEWNAME	Имя новой записи
	Тип ввода	:	одиночное значение, необходимо (ADD,CHANGE) опционально, 2-й параметр мин 1 группы  (RENAME)
	Возможные значения	:	макс. 12 знаков
POS	Позиционный параметр
	Тип ввода	:	одиночное значение, необходимо (ADD,CHANGE)
	Возможные значения	:	A	= Значение для позиции ПОСЛЕ
			B	= Значение для позиции ДО
			U	= Значение для позиции ПОД
SUBLEV	Подуровни также должны быть удалены
	Тип ввода	:	одиночное значение, необходимо (DELETE)
	Возможные значения	:	N	=  Нет
			Y	=  Да

1.24.4 Сообщения об ошибках и предупредительные сообщения

1.24.4.1 Сообщения об ошибках 

F01:

НЕ ЦИФРОВОЙ АБОНЕНТ !

1.24.4.2 Предупредительные сообщения

H01:	CDB'S ДЛЯ @@@ @@@@@@@@@@@@ ЕЩЕ В ФАЙЛЕ CDR
H02:	НЕТ МЕСТА В PPCF
H03:	ПОЗИЦИЯ В PPCF НЕ ОПРЕДЕЛЕНА
H04:	ПОЗИЦИОНИРОВАНИЕ НЕ РАЗРЕШЕНО
H05:	ОБЪЕКТ @@@@@@@@@@@@ УЖЕ В PPCF
H06:	ОБЪЕКТА @@@@@@@@@@@@ В PPCF НЕТ
H07:	ДОСТУП К PPCF НЕВОЗМОЖЕН
H08:	В PPCF НЕТ ЗАПИСЕЙ
H09:	ОБРАБОТКА ОБЪЕКТА НЕВОЗМОЖНА
H10:	ЗАПРЕЩЕННАЯ КОМАНДА НА УДАЛЕНИЕ
H11:	AMO KDEV УЖЕ АКТИВИЗИРОВАНА