Petroglif

Job-Server

Настройка серверных задач

Диалог администрирования серверных задач доступен посредством пункта меню Админ→ Серверные задачи.

Вид списка задач показан на рис. link.Следует обратить внимание на переключатель ✓Показывать задачи для всех баз данных. По умолчанию, в списке отображаются только те задачи, которые были созданы из текущей базы данных. Если же включить указанный флаг, то в списке будут показаны так же задачи, относящиеся ко всем базам данных.

Диалог редактирования серверной задачи

Диалог, применяемый для создания или изменения серверной задачи показан на рис. link. Он содержит следующие управляющие элементы:

Наименование

Наименование задачи. Система следит за тем, чтобы не существовало двух задач с одинаковым наименованием.

ИД

Справочное поле, отображающее идентификатор задачи. Для новой задачи его значение - ноль.

Символ

Символьное обозначение задачи, используемое для ссылок на нее из формул или из других программ.

Если символ не пустой, то он должен быть уникальным среди всех серверных задач.

▼Команда

Комбо-бокс выбора команды, которая должна быть выполнена сервером при наступлении времени запуска задачи.

База данных

Справочное поле, отображающее символ базы данных, которой принадлежит задача. При создании новой задачи она автоматически получает принадлежность той базе данных, в которой авторизован текущий сеанс.

▼Следующая задача

Здесь может быть выбрана задача, которая должна быть выполнена сразу после завершения работы данной (редактируемой) задачи.

✓Посылать e-mail уведомление

Установка этого флага предписывает серверу отправлять уведомления на электронную почту. Настройка этих уведомлений описана ниже.

✓Пассивная

Если этот флаг установлен, то задача не будет выполняться.

✓Запускать при старте сервера

Задача будет запускаться на выполнение сразу после старта сервера. Опция необходима только в специальных случаях (например, для отладки, либо для одноразового запуска каких-либо сервисных процедур).

✓Постоянное выполнение

Не применяется.

✓Без расписания

Сервер игнорирует расписание этой задачи. Опция может быть полезна в комбинации с флагом ✓Запускать при старте сервера.

✓Не отсылать пустые уведомления

Флаг действует вместе с опцией ✓Посылать e-mail уведомление. Если флаг ✓Не отсылать пустые уведомления включен и нет ничего, что следовало бы отправить, ничего отправлено и не будет.

[Расписание]

По этой кнопке доступен диалог редактирования расписания запусков задачи.

Не выполнять после

В этом поле можно ввести время суток, после которого задача выполняться не будет, несмотря на регулярное расписание, которое предписывает это делать. Собственно, поле и нужно для того, чтобы переопределить данный аспект регулярного расписания.

[Параметры]

Эта кнопка открывает диалог редактирования параметров задачи. Содержимого этого диалога определяется командой, выбранной в одноименном комбо-боксе (см. выше). Например для команды Процессинг должников эта кнопка откроет диалог запуска процессинга должников (см. стр. link).

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

Для того, чтобы отослать уведомление о выполнении задачи Job-сервер должен иметь следующую информацию:

Список адресов, по которым необходимо отправить уведомления

Этот список сервер извлекает из параметра jobserver_notify, находящегося в зоне config файла BIN/PP.INI Если необходимо отправить сообщения более чем на один адрес, то все адреса должны быть перечислены этим параметров, разделенные символом ; (точка с запятой).

Например:


	jobserver_notify=admin@suncity.ru;mgr1@sunsity.ru

Данные почтовой учетной записи

Параметры почтовой учетной записи сервер извлекает из файла BIN/MAILACC.TXT. Параметры в этом файле должны храниться в формате обмена CHARRY.

Нет смысла здесь вдаваться в особенности этого формата поскольку файл может быть сформирован автоматически из списка почтовых учетных записей, хранящегося в базе данных. В рабочем сеансе Papyrus выберите пункт меню Справочники→ Админ→ Почтовые учетные записи. Если в списке нет ни одной учетной записи, то создайте ее. Если же есть, то экспортируйте список кнопкой [Передать Charry]. В каталоге OUT появится файл, содержащий все записи списка. Переименуйте его в BIN/MAILACC.TXT.

Если в этом файле описано более одной учетной записи, то Job-сервер будет использовать для отсылки сообщений самую первую. Так как формат CHARRY является текстовым, то вы можете отредактировать файл в любом текстовом редакторе (только не изменяйте строку пароля - он хранится в зашифрованном виде и любое изменение этой строки приведет к тому, что сервер не сможет авторизоваться на почтовом сервере).

Почему сервер не может взять все эти данные непосредственно из базы данных?

Ответ заключается в том, что для выполнения некоторых задач сервер не авторизуется в базе данных, следовательно в общем случае, информация, хранящаяся в ней, серверу не доступна. Кроме того, если на вашем предприятии используется несколько баз данных, то может получиться, что при выполнении задач для разных баз сервер будет отсылать сообщения на разные адреса.

Задачи Job-Server

Job-Server может по расписанию выполнять те или иные регулярные задания.Вот список типов задач Job-Server'а:

Прием данных из других разделов БД

символ: ObjRecv

Резервное копирование nologin

символ: Backup

Осуществляет резервное копирование базы данных.

Обслуживание базы данных

символ: DBMaintain

Обслуживание задач noparam

символ: MaintainPrjTask

Загрузка данных на кассовый узел

символ: LoadAsyncPOS

Загрузка данных на весы

символ: LoadScale

Пересчет скидок по дисконтным картам

символ: SCardDiscRecalc

Импорт/экспорт palm

символ: PalmImpExp

Передача изменений в другой раздел

символ: TransmitModif

Закрытие кассовых сессий

символ: CSessClose

Заполнение таблицы продаж

символ: FillSalesTable

Прием объектов charry

символ: CharryImport

Удаление временных файлов

символ: RemoveTempFiles

Тест создания файлов

символ: TestCreateFiles

Запустить приложение

символ: LaunchApp

Создание драфт-документов по кассовым сессиям

символ: CSessCrDraft

Процессинг должников

символ: DebtRate

Расчет бизнес-показателей

символ: BizScore

Экспорт данных Балтика

символ: ExportBaltika

Передача документов с фильтрацией

100: Обмен прошел успешно.
0: Ошибка. Сообщение об ошибке можно получить вызовом команды GETLASTERR.

GETBIZSCORES

Получение названий и значений бизнес-показателей.

Параметры

UserName: глобальное имя пользователя (PPOBJ_GLOBALUSERACC)
Password: пароль (в открытом виде)

Возвращаемые значения

100: текст с наименованиями и значениями показателей] Функция отработала успешно.
0: Ошибка. Сообщение об ошибке можно получить вызовом команды GETLASTERR.

CHECKGLOBALCREDENTIAL

Проверяет правильность имени глобальной учетной записи и соответствующего ей пароля.

Параметры

UserName: глобальное имя пользователя (PPOBJ_GLOBALUSERACC)
Password: пароль (в открытом виде)

Возвращаемые значения

1: Существует учетная запись с заданным именем и переданный пароль правилен.
0: Ошибка. Сообщение об ошибке можно получить вызовом команды GETLASTERR.

GETBBOARD

Возвращает список запущенных задач Job Server.

Параметры

Отсутствуют.

Возвращаемые значения

Если есть хоть одна запущенная задача, то возвращает все запущенные задачи в виде: 1 Запущенная задача в формате: 1 Дата Время Описание задачи [(Ход выполнения)] Затем возвращает 100.

Если не запущено ни одной задачи, то возвращает строку: 0 There are no started tasks

GETTDDO

Возвращает текст, построенный по шаблону заданного tddo-файла.

Параметры

FileName: Имя tddo-файла.
ArgList: Список дополнительных аргументов, передаваемых обработчику tddo-файла. Этот список может содержать ноль или более аргументов.

GETTDDO ppgoodsdetail 3401 "еще один аргумент" Здесь:

ppgoodsdetail: Имя tddo-файла
3401: Первый аргумент обработчика (будет подставлен в ответ на переменную ${1})
"еще один аргумент": Второй аргумент обработчика (будет подставлен в ответ на переменную ${2})

GETTDDO greeting Вызов обработчика шаблона greeting.tddo без дополнительных аргументов.

TEST

Тестирование обмена данных с сервером.

Параметры

Отсутствуют.

Возвращаемые значения

100: Тест прошел успешно.
0: Ошибка. Сообщение об ошибке можно получить вызовом команды GETLASTERR.

GETIMAGE

Возвращает файл с изображением, ассоциированным с выбранным объектом данных.

Параметры

ObjType

Символ типа объекта данных. Команда поддерживает следующие символы:

GOODS

Товары

PERSON

Персоналии

ObjID

Идентификатор объекта, по которого необходимо извлечь изображение.

GETIMAGE goods 12029 Возвращает изображение товара с идентификатором 12029.

EXECVIEW

Запускает расчет отчета по именованному фильтру и возвращает XML-файл с результатами.

Параметры

NamedFiltSymb: Символ именованного фильтра.
DL600DataName: Не обязательный. Наименование структуры DL600, которую следует использовать для формирования файла отчета. Если этот параметр опущен, то сервер попытается использовать структуру данных, ассоциированную с отчетом по умолчанию (не все КАД'ы определяют такой отчет).

EXECVIEW goodsrest02 Возвращает файл результата расчета по фильтру с символом goodsrest02.

SELECT

Команда со сложным синтаксисом, предназначенная для извлечения данных из системы.

Формат возвращаемого значения

Сервер возвращает запрошенные данные в формате XML. Для большинства типов объектов формат одной записи следующий:

Id: Идентификатор объекта.
ParentId: Идентификатор родительского объекта (может быть 0).
Name: Наименование объекта.

Для некоторых типов объектов формат представления иной. В таких случаях ниже мы опишем соответствующие форматы.

Синтаксис команды SELECT

Общий принцип состоит в том, что клиентское приложение формирует запрос, содержащий тип объекта, записи которого следует извлечь, и список критериев, которым должны удовлетворять извлекаемые записи.Критерии задаются следующей конструкцией:

criterion-clause ::= criterion subcriterion-clause criterion-value-clause subcriterion-clause ::= nothing | .subcriterion criterion-value-clause ::= nothing | ( criterion-value )

То есть, каждый критерий состоит из трех частей (некоторые из которых могут отсутствовать): наименование критерия (criterion), подкритерий (subcriterion), значение критерия (criterion-value).Наименования критериев и подкритериев будут описаны подробно для каждого типа объектов. Значение критерия заключается в скобки. Внутри скобок значения, даже текстовые, не должны обрамляться кавычками.

SELECT GOODS BY PARENT.NAME(Сигареты) Приведенная конструкция извлекает список товаров, принадлежащих группе с именем “Сигареты”.

Далее приводится список возможных наименований объектов и соответствующие им критерии.

DL600

Запись в формате структуры DL600. После символа DL600 должно следовать наименование структуры и лишь за тем - критерии. Критерии:

ID

Идентификатор данных, которые должны быть извлечены. Подкритерии отсутствуют.

SELECT DL600 UhttPerson by id(21319) Извлекает данные о персоналии (в формате UhttPerson) с идентификатором 21319.

GOODS

Товары. Критерии:

Идентификатор товара.

Множественное представление обрабатывается: в выборке будут присутствовать товары для каждого из перечисленных идентификаторов. Подкритерии отсутствуют.

NAME

Наименование товара. Подкритерии отсутствуют.

SUBNAME

Строка, которую должны содержать наименования извлекаемых товаров.

PARENT

BRAND

MANUF

CODE

BARCODE

TAGEXIST

Критерий, позволяющий выбрать товары, для которых определен (не зависимо от значения) заданный критерием тег.

Множественное представление обрабатывается по условию ИЛИ. То есть, несколько таких критериев обеспечивают выборку товаров, которые имеют значение хотя бы для одного из перечисленных тегов. Подкритерии:

(default) Идентификатор типа тега.

CODE

Символ типа тега.

NAME

Наименование типа тега.

GOODSARCODE

Товары с кодами, привязанными к контрагентам. Структура записей, возвращаемых вызовом SELECT GOODSARCODE определяется структурой данных DL600 UhttGoodsArCode (см. файл ppexp.dl6, распространяемый с дистрибутивом системы).

Критерии:

SELLER

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

(default) Идентификатор персоналии.

CODE

Номер поискового регистра вида персоналии (не путать с поисковым регистром таблицы аналитических статей).

NAME

Наименование персоналии (поиск по точному соответствию имени без учета регистров символов).

Идентификатор товара. Множественное представление обрабатывается. Подкритерии отсутствуют.

NAME

Наименование товара. Подкритерии отсутствуют.

SUBNAME

Строка, которую должны содержать наименования извлекаемых товаров.

PARENT

BRAND

MANUF

CODE

BARCODE

GOODSGROUP

Товарные группы.

Идентификатор группы. Множественное представление обрабатывается. Подкритерии отсутствуют.

NAME

Наименование группы. Подкритерии отсутствуют.

SUBNAME

PARENT

CODE

BRAND

Торговые марки.

Идентификатор брэнда. Множественное представление обрабатывается. Подкритерии отсутствуют.

NAME

Наименование группы. Подкритерии отсутствуют.

SUBNAME

OWNER

PERSONKIND

Виды персоналий.

Идентификатор вида персоналии. Множественное представление обрабатывается. Подкритерии отсутствуют.

NAME

Наименование вида. Подкритерии отсутствуют.

CODE

Символ вида персоналии.

PERSON

Персоналии.

Идентификатор персоналии. Множественное представление обрабатывается. Подкритерии отсутствуют.

NAME

Наименование персоналии. Подкритерии отсутствуют.

SUBNAME

Подстрока, содержащаяся в имени персоналии.

KIND

Вид персоналии.

LOCATION

Локации (склады, адреса, автономные адреса).

Идентификатор локации. Множественное представление обрабатывается. Подкритерии отсутствуют.

CODE

Код локации. Множественное представление обрабатывается. Подкритерии отсутствуют.

OWNER

Персоналия-владелец адреса. Подкритерии:

(default) Идентификатор персоналии.

CODE

Номер поискового регистра вида персоналии (не путать с поисковым реги?тром таблицы аналитических статей).

NAME

Наименование персоналии (поиск по точному соответствию имени без учета регистров символов).

PHONE

Номер телефона для поиска автономных адресов. Запрос может вернуть более одного адреса. Для эффективной работы этого критерия необходимо, чтобы была включена индексация телефонов в системных параметрах общих настроек (см. стр. link).

CITY

Города.

Идентификатор города. Множественное представление обрабатывается. Подкритерии отсутствуют.

NAME

Наименование группы. Подкритерии отсутствуют.

CODE

PARENT

COUNTRY

Государства.

Идентификатор государства. Множественное представление обрабатывается. Подкритерии отсутствуют.

NAME

Наименование группы. Подкритерии отсутствуют.

CODE

PARENT

QUOT

Котировки.

Здесь речь идет о втором поколении котировок, реализованном в Papyrus . Общая инфраструктура котировок на момент написания этого раздела не переведена на второе поколение. Таким образом, котировки, которыми можно манипулировать в стандартном сеансе системы не могут быть (пока) извлечены вызовом этой команды.

Выборка котировок не предусматривает множественных критериев. Таким образом, если одни и тот же критерий указан несколько раз, то в рассмотрение берется только последнее значение этого критерия.

Структура записей, возвращаемых вызовом SELECT QUOT определяется структурой данных DL600 UhttQuot (см. файл ppexp.dl6, распространяемый с дистрибутивом системы).

ACTUAL

Критерий без параметров, означающий, что необходимо извлечь только актуальные котировки. Если это критерий не указан, то извлекаются все значения подходящих котировок. Если указан, то извлекаются только актуальные (текущие) значения подходящих котировок.

Подкритерии отсутствуют.

KIND

Вид котировки.

Подкритерии:

(default) Идентификатор вида котировки.

CODE

Символ вида котировки.

SELLER

Продавец (публикатор котировки). Персоналия (транслируется в аналитическую статью таблицы GetSupplAccSheet()).

Подкритерии:

(default) Идентификатор персоналии.

CODE

Номер поискового регистра вида персоналии (не путать с поисковым регистром таблицы аналитических статей).

NAME

Наименование персоналии (поиск по точному соответствию имени без учета регистров символов).

BUYER

Покупатель. Персоналия (транслируется в аналитическую статью таблицы GetSupplAccSheet()).

Подкритерии:

(default) Идентификатор персоналии.

CODE

Номер поискового регистра вида персоналии (не путать с поисковым регистром таблицы аналитических статей).

NAME

Наименование персоналии (поиск по точному соответствию имени без учета регистров символов).

ARTICLE

Аналитическая статья, с которой ассоциированы котировки. Этот критерий, дублируя критерии SELLER и BUYER, введен для того, чтобы можно было явно определить критерий зависимости котировок от статьи, заданной идентификатором (например, для случаев, когда статья не ассоциирована с персоналией и пр).

Подкритерии:

(default) Идентификатор статьи.

LOCATION

Адрес продавца. Имеется в виду либо склад, либо любой адрес персоналии (юридический, фактический, либо адрес доставки).

Подкритерии:

(default) Идентификатор адреса.

CODE

Код адреса. Сначала ищется код склада, в случае неудачи - код адреса.

LOCWORLD

Географический объект, которому должен принадлежать адрес продавца.

Подкритерии:

(default) Идентификатор географического объекта.

CODE

Символ географического объекта.

GOODS

Товар, к которому относятся котировки.

Подкритерии:

(default) Идентификатор товара.

CODE

Код товара (без привязки к контрагенту).

GOODSGROUP

Товарная группа, для товаров которой необходимо извлечь котировки. Отменяется критерием GOODS.

Подкритерии:

(default) Идентификатор товарной группы.

CODE

Код группы.

NAME

Наименование группы (поиск по точному соответствию имени без учета регистров символов).

BRAND

Торговая марка, для товаров которой необходимо извлечь котировки. Отменяется критерием GOODS.

Подкритерии:

(default) Идентификатор брэнда.

NAME

Наименование брэнда (поиск по точному соответствию имени без учета регистров символов).

CURRENCY

Валюта значения котировки. Если не указана, то извлекаются котировки без ограничения по валюте, в которой они определены.

Подкритерии:

(default) Идентификатор валюты.

CODE

Символ валюты (не путать с цифровым кодом валюты).

Примеры

Приведем несколько примеров использования команды SELECT:SELECT goods BY goodsgroup.code(33)

SELECT goods BY brand(10014) goodsgroup(14)SELECT goods BY barcode(4607089460013)

SELECT person BY kind.symb(BANK)SELECT person BY register.def(10022, 5550005)

SELECT PERSON BY ID(19) ID(2301) ID(1429)SELECT personkind by id(1002) id(1003)

SELECT DL600 UhttPerson by id(21319)SELECT QUOT BY KIND(1) GOODS.CODE(4602666140609)

SELECT QUOT BY ACTUAL KIND(1) LOCATION.CODE(1400000001)

CREATE

Эта команда позволяет создать некоторые объекты данных с ограниченным набором атрибутов.

PERSON

Создает запись персоналии.

Name

Наименование персоналии. Обязательный параметр.

Status

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

Если статус не указан, то персоналия получает принадлежность статусу по первому встретившемуся виду (в порядке следования идентификаторов), для которого задан статус персоналий по умолчанию, если такой вид отсутствует, то персоналия получает зарезервированный статус Юридическое лицо. Подкритерии:

ID

(default) Идентификатор статуса.

CODE

Символ юридического статуса.

NAME

Наименование статуса (поиск по точному соответствию имени без учета регистров символов).

Kind

Вид персоналии. Может быть указано более одного вида, которым должна принадлежать новая персоналия.

Если не указано ни одного вида, то новая персоналия получает принадлежность к виду Неизвестные. Подкритерии:

(default) Идентификатор вида.

CODE

Символ вида персоналии.

NAME

Наименование вида (поиск по точному соответствию имени без учета регистров символов).

SET

Команда SET позволяет установить некоторые атрибуты для ряда объектов данных.

Синтаксис этой команды аналогичен синтаксису команды SELECT, однако здесь отсутствует ключевое слово BY.

GOODSARCODE

Устанавливает код товара, связанного с заданным контрагентом.

SELLER

Обязательный параметр. Персоналия, с которой должен быть связан код товара. Подкритерии:

ID

(default) Идентификатор персоналии.

CODE

Номер поискового регистра вида персоналии (не путать с поисковым регистром таблицы аналитических статей).

NAME

Наименование персоналии (поиск по точному соответсвию имени без учета регистров символов).

GOODS

Обязательный параметр. Товар, для которого задается код. Подкритерии:

(default) Идентификатор товара.

CODE

Код товара (без привязки к контрагенту).

VALUE

Строка кода, который должен быть присвоен товар. Если эта строка пустая, то у товара будет отозван код, связанный с заданным контрагентом.

QUOT

Устанавливает значение котировки в соответствии с набором критериев. Далее приведен список допустимых критериев и подкритериев для этого типа объектов.

KIND

Вид котировки. Этот критерий обязателен.

Подкритерии:

(default) Идентификатор вида котировки.

CODE

Символ вида котировки.

SELLER

Продавец (публикатор котировки). Персоналия (транслируется в аналитическую статью таблицы GetSupplAccSheet()).

Подкритерии:

(default) Идентификатор персоналии.

CODE

Номер поискового регистра вида персоналии (не путать с поисковым регистром таблицы аналитических статей).

NAME

Наименование персоналии (поиск по точному соответсвию имени без учета регистров символов).

BUYER

Покупатель. Персоналия (транслируется в аналитическую статью таблицы GetSupplAccSheet()).

Подкритерии:

(default) Идентификатор персоналии.

CODE

Номер поискового регистра вида персоналии (не путать с поисковым регистром таблицы аналитических статей).

NAME

Наименование персоналии (поиск по точному соответсвию имени без учета регистров символов).

LOCATION

Подкритерии:

(default) Идентификатор адреса.

CODE

Код адреса. Сначала ищется код склада, в случае неудачи - код адреса.

GOODS

Товар, к которому относятся котировки.

Подкритерии:

(default) Идентификатор товара.

CODE

Код товара (без привязки к контрагенту).

CURRENCY

Валюта значения котировки. Если не указана, то устанавливается значение котировки с неопределенной валютой.

Подкритерии:

(default) Идентификатор валюты.

CODE

Символ валюты (не путать с цифровым кодом валюты).

VALUE

Собственно, значение котировки.

Примеры

Приведем примеры использования команды SET:set quot kind(1) goods.code(4602666140609) location.code(1400000001) value(65.90)

set goodsarcode goods.code(46072740) seller.code(tobacco-world) value(33001)

SETGLOBALUSER

Устанавливает значение глобальной учетной записи для текущего потока сервера.

Параметры

GlobalUser: Наименование или идентификатор устанавливаемой глобальной учетной записи. Если этот параметры может быть интерпретирован системой как число и существует идентификатор глобальной учетной записи, равный этому числу, то текущей устанавливается эта запись. В противном случае система ищет запись по имен, соответствующем этому параметру и, если находит, то устанавливает такую запись текущей. Если идентифицировать запись по параметру не удалось, то возвращается ошибка.

Возвращаемые значения

1: Удалось установить текущую глобальную учетную запись.
0: Ошибка. Сообщение об ошибке можно получить вызовом команды GETLASTERR.

GETGLOBALUSER

Возвращает идентификатор текущей глобальной учетной записи.

Параметры

Отсутствуют.

CCHECKCREATE

Инициирующая команда для создания распределенного кассового чека.

Параметры

Синтаксис параметров этой команды аналогичен синтаксису параметров команды SELECT. То есть, в произвольном порядке перечисляются критерии запроса. Вот список допустимый критериев:

POSNODE: Определяет кассовый узел, которому должен принадлежать чек. Этот узел обязательно должен иметь тип распределенного кассового узла.
LOCATION
SCARD
AMOUNT
DISCOUNT

CCHECKADDLINE

Не реализована. Команда добавления в распределенный кассовый чек новой строки.

CCHECKFINISH

Завершающая команда создания распределенного кассового чека.

SCARDREST

Возвращает остаток стредств на кредитной либо бонусной карте.

SCARDWITHDRAW

Выполняет операцию списания заданной суммы с кредитной либо бонусной карты.

SETPERSONREL

Создает отношение заданного типа между персоналиями.Критерии:

PRIMARY

Обязательный параметр. Первичная персоналия в отношении. Подкритерии:

ID

(default) Идентификатор персоналии.

CODE

Номер поискового регистра вида персоналии (не путать с поисковым регистром таблицы аналитических статей).

NAME

Наименование персоналии (поиск по точному соответствию имени без учета регистров символов).

SECONDARY

Обязательный параметр. Вторичная персоналия в отношении. Подкритерии те же, что и у первичной персоналии.

PERSONRELTYPE

Обязательный параметр. Тип персонального отношения. Подкритерии:

(default) Идентификатор типа персонального отношения.

CODE

Символ типа персонального отношения.

NAME

Наименование типа персонального отношения (поиск по точному соответствию имени без учета регистров символов).

GETPERSONREL

Возвращает список персоналий, связанных с заданной отношениями.Критерии:

PRIMARY

Первичная персоналия в отношении. Подкритерии аналогичны используемым в команде SETPERSONREL.

Если этот параметр указан, то команда возвращает список персоналий, с которыми связана эта персоналия.

SECONDARY

Вторичная персоналия в отношении. Подкритерии аналогичны используемым в команде SETPERSONREL.

Если этот параметр указан, но PRIMARY не определен, то команда возвращает список персоналий, которые связаны с этой персоналией (обратные отношения). Если определены и PRIMARY и SECONDARY, то возвращается SECONDARY, если она связана с PRIMARY либо отношением PERSONRELTYPE, либо любым отношением при отсутствии критерия PERSONRELTYPE.

PERSONRELTYPE

Тип персонального отношения. Подкритерии аналогичны используемым в команде SETPERSONREL.

Критерий ограничивает список возвращаемых персоналий только теми, которые имеют данный тип отношения.

SETOBJECTTAG

Устанавливает значение тега для объекта данных.Критерии:

TAG

Обязательный параметр. Может присутствовать в команде один и только один раз. Тип тега, значение которого должно быть установлено. Подкритерии:

ID

(default) Идентификатор типа тега.

CODE

Символ типа тега.

NAME

Наименование типа тега.

PERSON

Если тег относится к персоналиям, то этот критерий определяет персоналию, для которой должно быть установлено значение тега. Критерий может присутствовать в команде более одного раза: в этом случае значение тега будет установлено для каждой из идентифицированных этим критерием персоналии.

Если до этого критерия в команде уже встречались критерии GOODS или GLOBALUSER, то сервер вернет ошибку смешения типов объектов. Если тег, заданный критерием TAG не относится к типу объектов Персоналии, то сервер вернет ошибку несоответствия тега объекту, к которому он применяется.

GOODS

Если тег относится к товару, то этот критерий определяет товар, для которого должно быть установлено значение тега. Критерий может присутствовать в команде более одного раза: в этом случае значение тега будет установлено для каждого из идентифицированных этим критерием товаров.

Если до этого критерия в команде уже встречались критерии PERSON или GLOBALUSER, то сервер вернет ошибку смешения типов объектов. Если тег, заданный критерием TAG не относится к типу объектов Товары, то сервер вернет ошибку несоответствия тега объекту, к которому он применяется.

GLOBALUSER

Если тег относится к глобальной учетной записи, то этот критерий определяет учетную запись, для которой должно быть установлено значение тега. Критерий может присутствовать в команде более одного раза: в этом случае значение тега будет установлено для каждой из идентифицированных этим критерием глобальных учетных записей.

Если до этого критерия в команде уже встречались критерии PERSON или GOODS, то сервер вернет ошибку смешения типов объектов. Если тег, заданный критерием TAG не относится к типу объектов Глобальные учетные записи, то сервер вернет ошибку несоответствия тега объекту, к которому он применяется.

VALUE

Значение, которое должно быть установлено у тега. Если критерий пустой или отсутствует, то значение тега для выбранных объектов будет удалено.

Примеры

Приведем примеры использования команды SETOBJECTTAG:setobjecttag tag{key} goods.code(4602666140609) value(коврик) setobjecttag tag{vip} person.code(51207) person.code(14018) value(1)

INCOBJECTTAG

Увеличивает значение тега для объекта данных.Критерии аналогичны тем, что применяются для команды SETOBJECTTAG. Несколько меняется смысл критерия VALUE: если критерий пуст или отсутствует, то значение тега увеличивается на единицу.

Если значение критерия VALUE не пустое и не может быть преобразовано к положительному числу, то сервер возвращает ошибку.Если тип тега не числовой, то сервер возвращает ошибку.

DECOBJECTTAG

Уменьшает значение тега для объекта данных.Команда полностью аналогична INCOBJECTTAG с той лишь разницей, что значение тега уменьшается.

GETOBJECTTAG

Возвращает значение тега объекта данных.Критерии:

TAG

Обязательный параметр. Может присутствовать в команде один и только один раз. Тип тега, значение которого должно быть возвращено. Подкритерии:

ID

(default) Идентификатор типа тега.

CODE

Символ типа тега.

NAME

Наименование типа тега.

PERSON

Если тег относится к персоналиям, то этот критерий определяет персоналию, для которой должно быть возвращено значение тега. Критерий может присутствовать в команде более одного раза: в этом случае будет возвращено значение тега для каждой из идентифицированных этим критерием персоналии.

GOODS

Если тег относится к товарам, то этот критерий определяет товар, для которого должно быть возвращено значение тега. Критерий может присутствовать в команде более одного раза: в этом случае будет возвращено значение тега для каждого из идентифицированных этим критерием товаров.

GLOBALUSER

Если тег относится к глобальным учетным записям, то этот критерий определяет учетную запись, для которой должно быть возвращено значение тега. Критерий может присутствовать в команде более одного раза: в этом случае будет возвращено значение тега для каждой из идентифицированных этим критерием глобальных учетных записей.