Petroglif

Импорт и экспорт данных

Унифицированная конфигурация форматов импорта/экспорта

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

Товарные документы

Платежные поручения (при импорте - выписка банка)

Прайс-лист

Строки инвентаризации (только импорт)

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

DBF

Текстовый (предусмотрен целый ряд опций, позволяющих настроить систему на подавляющее большинство вариантов текстовых представлений данных)

XML

Общие принципы работы и структура унифицированных конфигураций импорта/экспорта

Конфигурация импорта/экспорта хранится в текстовом файле bin/impexp.ini. Структура конфигурации содержит следующие атрибуты:

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

Направление передачи данных (импорт или экспорт)

Путь к файлу импорта/экспорта

Тип формата файла

Параметры формата

Список соответствия полей

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

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

Ид документа

Номер документа

Дата

ИНН контрагента

Имя контрагента

Код контрагента

и т.д.

Вы можете установить соответствие каждому или некоторым из этих полей в полях входящего (исходящего) файла. Как правило, для каждой области использования конфигураций импорта/экспорта допускается ведение произвольного числа конфигураций, каждая из который отличается от остальных парой (наименование, направление передачи). То есть, можно создать одну конфигурация АБВ для экспорта и одну с таким же именем для импорта. В тоже время не допускается создание двух конфигураций с одинаковым именем для импорта (или же для экспорта).

Возможности обмена данными через текстовые файлы

Различные системы используют самый обширный набор форматов представления данных в текстовых файлах.

Настройка конфигурации импорта/экспорта

Общий список конфигураций импорта/экспорта

Доступ к большей части конфигураций импорта/экспорта объединен общим диалогом, показанном на рис. link. Здесь сгруппированы следующие наборы конфигураций:

Товаров

Заголовков и строк документов

Инвентаризации

Прайс-листов

Обращение к диалогу возможно через пункт меню Админ→ Конфигурации импорта/экспорта→ Конфигурации импорта/экспорта.

Заголовочный диалог конфигурации

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

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

Наименование конфигурации.

Формат внешних данных

Формат, в котором представлены входящие (исходящие) файлы. Доступны следующие варианты:

Текстовый

Данные представлены в виде текста. При этом детальные опции формата устанавливаются в дополнительном диалоге “Параметры текстового файла”.

DBF

Широко распространенный формат представления данных, используемый популярными системами семейства xBase (dBase, FoxPro, Clipper и др.)

XML

Текстовый файл в формате XML. На текущий момент поля могут быть определены только в виде тегов XML-файла, но не как атрибуты тегов.

Excel

Данные представлены в виде файла в формате Microsoft Excel^™.

Работа с такими файлами реализуется средствами COM-интерфейсов программы Microsoft Excel^™. Это означает, что она должна быть установлена на том компьютера, на котором запускается сеанс, выполняющий функции импорта/экспорта.

[Параметры текст файла]

Эта кнопка открывает диалог редактирования опций формата текстового файла (см. ниже).

✓OEM - кодировка

Если этот флаг установлен, то система предполагает, что строки во внешнем файле имеют национальную OEM-кодировку (для русского языка это - CP-866). Если флаг не установлен, то система считает, что текстовые строки в файле представлены в Windows-кодировке (для русского языка это - Windows-1251).

✓Удалять файлы после импорта

Экспорт/Импорт

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

[Соответствие полей]

При нажатии на эту кнопку открывается диалог редактирования списка соответствия полей. Подробно этот диалог рассмотрен ниже.

Имя файла

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

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

▼Учетная запись FTP-сервера

H:/PPY/OUT/F???-???.TXT будет последовательно замещаться на H:/PPY/OUT/F000-001.TXT
-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, по которой осуществляется экспорт

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

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

Строка идентификатора сессии.

RESUME

Восстанавливает прерванное до этого соединение.

Параметры

Идентификатор сессии: Строка идентификатора сессии, полученная перед прерыванием соединения командой HSH или SUSPEND.

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

ACK: В случае успешного восстановления соединения.
BUSY: Восстановить соединение не удалось так как сессия, с которой клиент пытается восстановить соединение занята и не ответила в течении заданного времени (по умолчанию 30 секунд).
ERR: Ошибка.

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

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

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

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

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

GOODS

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

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

GLOBALUSER

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

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