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

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

символ: TransmitBillByFilt

Экспорт документов

символ: ExportBills

Создание документов заказов поставщикам

символ: AutoSupplOrder

Сервер RFID устройств

символ: RfidDevicePrcssr

Обработка выборки пластиковых карточек

символ: SCardSelectionPrcssr

Изменение котировок

символ: UpdateQuots

Вызывает функцию изменения котировок.

Параметры
Для редактирования параметров вызывается тот же диалог, что и при работе с интерактивной функцией изменения котировок (см. стр. link).

Экспорт отчета по именованному фильтру

символ: ExportViewЭкспортируе XML-файл с результатами расчета отчета, определенного заранее подготовленным именованным фильтром.

Параметры
  • Именованный фильтр
  • Символ структуры DL600, по которой осуществляется экспорт
  • Имя файла или просто каталог, в который будет выгружен результат
  • Пустое задание (отладка) noparam

    символ: Dummy

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

    Параметры
    Отсутствуют.

    Команды Job-Server

    Job-Server работает как TCP-сервер, принимая команды от клиентского приложения и возвращая ему ответы.

    TCP-порт сервера

    По умолчанию используется TCP-порт 28015, однако это значение может быть переопределено параметром [server] port в файле pp.ini.

    Формат и синтаксис команд

    Команды Job-Server'у посылаются в текстовом формате. Каждая команда завершается парой символов xD xA (бинарный перевод каретки).

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

    gray "gray hourse" "gray hourse with "quoted string " "

    Далее приводится список команд и их синтаксис.

    HELLO

    Получение информации от сервера.
    Параметры
    Отсутствуют.
    Возвращаемые значения
    1 Название программы

    LOGIN

    Авторизация в базе данных.
    Параметры
    Символ базы данных
    Имя пользователя
    Пароль пользователя
    Возвращаемые значения
    1
    Авторизация прошла успешно.
    0
    Ошибка. Сообщение об ошибке можно получить вызовом команды GETLASTERR.

    LOGIN normal_base valery gala02

    LOGOUT

    Выход из сеанса связи с базой данных.
    Параметры
    Отсутствуют.
    Возвращаемые значения
    100

    HSH

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

    Параметры
    Отсутствуют.
    Возвращаемые значения
    Строка идентификатора сессии.

    SUSPEND

    Прерывает соединение с сервером с возможностью последующего восстановления.

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

    RESUME

    Восстанавливает прерванное до этого соединение.
    Параметры
    Идентификатор сессии
    Строка идентификатора сессии, полученная перед прерыванием соединения командой HSH или SUSPEND.
    Возвращаемые значения
    ACK
    В случае успешного восстановления соединения.
    BUSY
    Восстановить соединение не удалось так как сессия, с которой клиент пытается восстановить соединение занята и не ответила в течении заданного времени (по умолчанию 30 секунд).
    ERR
    Ошибка.

    QUIT

    Конец сеанса связи с Job Server.
    Параметры
    Отсутствуют.
    Возвращаемые значения
    100 BUY

    GETLASTERR

    Возвращает строку сообщения о последней ошибке.
    Параметры
    Отсутствуют.
    Возвращаемые значения
    1 Сообщение об ошибке

    SPII

    Обмен данными с КПК на основе PalmOS или Windows Mobile и установленной программой StyloPalmII или StyloWCE.
    Параметры
    Отсутствуют.
    Возвращаемые значения
    100

    STYLOBHT

    Обмен данными с терминалом на основе Windows Mobile и установленной программой StyloBht.
    Параметры
    Отсутствуют.
    Возвращаемые значения
    100

    STYLOBHTII

    Обмен данными с терминалом на основе Windows Mobile и установленной программой StyloBhtII.
    Параметры
    DbSymb
    символ базы данных
    UserName
    имя пользователя
    Password
    пароль (в зашифрованном виде)
    Возвращаемые значения
    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
    Товары. Критерии:

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

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

    NAME
    Наименование товара. Подкритерии отсутствуют.
    SUBNAME
    Строка, которую должны содержать наименования извлекаемых товаров.
    PARENT
    BRAND
    MANUF
    CODE
    BARCODE
    TAGEXIST
    Критерий, позволяющий выбрать товары, для которых определен (не зависимо от значения) заданный критерием тег.

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

    ID
    (default) Идентификатор типа тега.
    CODE
    Символ типа тега.
    NAME
    Наименование типа тега.

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

    Критерии:

    SELLER
    Обязательный критерий, идентифицирующий контрагента, коды привязки к которому, возвращает сервер. Подкритерии:
    ID
    (default) Идентификатор персоналии.
    CODE
    Номер поискового регистра вида персоналии (не путать с поисковым регистром таблицы аналитических статей).
    NAME
    Наименование персоналии (поиск по точному соответствию имени без учета регистров символов).

    ID
    Идентификатор товара. Множественное представление обрабатывается. Подкритерии отсутствуют.
    NAME
    Наименование товара. Подкритерии отсутствуют.
    SUBNAME
    Строка, которую должны содержать наименования извлекаемых товаров.
    PARENT
    BRAND
    MANUF
    CODE
    BARCODE
    GOODSGROUP
    Товарные группы.

    ID
    Идентификатор группы. Множественное представление обрабатывается. Подкритерии отсутствуют.
    NAME
    Наименование группы. Подкритерии отсутствуют.
    SUBNAME
    PARENT
    CODE

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

    ID
    Идентификатор брэнда. Множественное представление обрабатывается. Подкритерии отсутствуют.
    NAME
    Наименование группы. Подкритерии отсутствуют.
    SUBNAME
    OWNER
    PERSONKIND
    Виды персоналий.
    ID
    Идентификатор вида персоналии. Множественное представление обрабатывается. Подкритерии отсутствуют.
    NAME
    Наименование вида. Подкритерии отсутствуют.
    CODE
    Символ вида персоналии.

    PERSON
    Персоналии.

    ID
    Идентификатор персоналии. Множественное представление обрабатывается. Подкритерии отсутствуют.
    NAME
    Наименование персоналии. Подкритерии отсутствуют.
    SUBNAME
    Подстрока, содержащаяся в имени персоналии.
    KIND
    Вид персоналии.
    REGISTER
    LOCATION
    Локации (склады, адреса, автономные адреса).
    ID
    Идентификатор локации. Множественное представление обрабатывается. Подкритерии отсутствуют.
    CODE
    Код локации. Множественное представление обрабатывается. Подкритерии отсутствуют.
    OWNER
    Персоналия-владелец адреса. Подкритерии:
    ID
    (default) Идентификатор персоналии.
    CODE
    Номер поискового регистра вида персоналии (не путать с поисковым реги?тром таблицы аналитических статей).
    NAME
    Наименование персоналии (поиск по точному соответствию имени без учета регистров символов).
    PHONE
    Номер телефона для поиска автономных адресов. Запрос может вернуть более одного адреса. Для эффективной работы этого критерия необходимо, чтобы была включена индексация телефонов в системных параметрах общих настроек (см. стр. link).

    CITY
    Города.

    ID
    Идентификатор города. Множественное представление обрабатывается. Подкритерии отсутствуют.
    NAME
    Наименование группы. Подкритерии отсутствуют.
    CODE
    PARENT
    COUNTRY
    Государства.
    ID
    Идентификатор государства. Множественное представление обрабатывается. Подкритерии отсутствуют.
    NAME
    Наименование группы. Подкритерии отсутствуют.
    CODE
    PARENT

    QUOT
    Котировки.

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

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

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

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

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

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

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

    ID
    (default) Идентификатор вида котировки.
    CODE
    Символ вида котировки.
    SELLER
    Продавец (публикатор котировки). Персоналия (транслируется в аналитическую статью таблицы GetSupplAccSheet()).

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

    ID
    (default) Идентификатор персоналии.
    CODE
    Номер поискового регистра вида персоналии (не путать с поисковым регистром таблицы аналитических статей).
    NAME
    Наименование персоналии (поиск по точному соответствию имени без учета регистров символов).
    BUYER
    Покупатель. Персоналия (транслируется в аналитическую статью таблицы GetSupplAccSheet()).

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

    ID
    (default) Идентификатор персоналии.
    CODE
    Номер поискового регистра вида персоналии (не путать с поисковым регистром таблицы аналитических статей).
    NAME
    Наименование персоналии (поиск по точному соответствию имени без учета регистров символов).
    ARTICLE
    Аналитическая статья, с которой ассоциированы котировки. Этот критерий, дублируя критерии SELLER и BUYER, введен для того, чтобы можно было явно определить критерий зависимости котировок от статьи, заданной идентификатором (например, для случаев, когда статья не ассоциирована с персоналией и пр).

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

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

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

    ID
    (default) Идентификатор адреса.
    CODE
    Код адреса. Сначала ищется код склада, в случае неудачи - код адреса.
    LOCWORLD
    Географический объект, которому должен принадлежать адрес продавца.

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

    ID
    (default) Идентификатор географического объекта.
    CODE
    Символ географического объекта.
    GOODS
    Товар, к которому относятся котировки.

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

    ID
    (default) Идентификатор товара.
    CODE
    Код товара (без привязки к контрагенту).
    GOODSGROUP
    Товарная группа, для товаров которой необходимо извлечь котировки. Отменяется критерием GOODS.

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

    ID
    (default) Идентификатор товарной группы.
    CODE
    Код группы.
    NAME
    Наименование группы (поиск по точному соответствию имени без учета регистров символов).
    BRAND
    Торговая марка, для товаров которой необходимо извлечь котировки. Отменяется критерием GOODS.

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

    ID
    (default) Идентификатор брэнда.
    NAME
    Наименование брэнда (поиск по точному соответствию имени без учета регистров символов).
    CURRENCY
    Валюта значения котировки. Если не указана, то извлекаются котировки без ограничения по валюте, в которой они определены.

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

    ID
    (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
    Вид персоналии. Может быть указано более одного вида, которым должна принадлежать новая персоналия.

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

    ID
    (default) Идентификатор вида.
    CODE
    Символ вида персоналии.
    NAME
    Наименование вида (поиск по точному соответствию имени без учета регистров символов).

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

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

    ID
    (default) Идентификатор категории.
    CODE
    Символ категории.
    NAME
    Наименование категории персоналий (поиск по точному соответствию имени без учета регистров символов).

    GLOBALACC
    Создает глобальную учетную запись.

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

    Password
    Пароль, сопоставленный с записью.
    Owner
    Персоналия, сопоставленная с учетной записью.

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

    ID
    (default) Идентификатор персоналии.
    CODE
    Номер поискового регистра вида персоналии (не путать с поисковым регистром таблицы аналитических статей).
    NAME
    Наименование персоналии (поиск по точному соответствию имени без учета регистров символов).
    Пример:

    create globalacc name(serg-admin) password(tea09..14)

    SET

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

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

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

    SELLER
    Обязательный параметр. Персоналия, с которой должен быть связан код товара. Подкритерии:
    ID
    (default) Идентификатор персоналии.
    CODE
    Номер поискового регистра вида персоналии (не путать с поисковым регистром таблицы аналитических статей).
    NAME
    Наименование персоналии (поиск по точному соответсвию имени без учета регистров символов).

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

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

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

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

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

    ID
    (default) Идентификатор вида котировки.
    CODE
    Символ вида котировки.
    SELLER
    Продавец (публикатор котировки). Персоналия (транслируется в аналитическую статью таблицы GetSupplAccSheet()).

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

    ID
    (default) Идентификатор персоналии.
    CODE
    Номер поискового регистра вида персоналии (не путать с поисковым регистром таблицы аналитических статей).
    NAME
    Наименование персоналии (поиск по точному соответсвию имени без учета регистров символов).
    BUYER
    Покупатель. Персоналия (транслируется в аналитическую статью таблицы GetSupplAccSheet()).

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

    ID
    (default) Идентификатор персоналии.
    CODE
    Номер поискового регистра вида персоналии (не путать с поисковым регистром таблицы аналитических статей).
    NAME
    Наименование персоналии (поиск по точному соответсвию имени без учета регистров символов).
    LOCATION
    Адрес продавца. Имеется в виду либо склад, либо любой адрес персоналии (юридический, фактический, либо адрес доставки).

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

    ID
    (default) Идентификатор адреса.
    CODE
    Код адреса. Сначала ищется код склада, в случае неудачи - код адреса.
    GOODS
    Товар, к которому относятся котировки.

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

    ID
    (default) Идентификатор товара.
    CODE
    Код товара (без привязки к контрагенту).
    CURRENCY
    Валюта значения котировки. Если не указана, то устанавливается значение котировки с неопределенной валютой.

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

    ID
    (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
    Обязательный параметр. Тип персонального отношения. Подкритерии:

    ID
    (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, то сервер вернет ошибку смешения типов объектов. Если тег, заданный критерием TAG не относится к типу объектов Персоналии, то сервер вернет ошибку несоответствия тега объекту, к которому он применяется.

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

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

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

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

    OOO "Петроглиф"
    Copyright © 2019