Утилиты

Downloads

Отчеты

Документация

GetFieldValue, функция возвращающая значение запрашиваемого поля любой записи указанного dbf файла в первом параметре и имя поля указывается вторым параметром, номер записи третий параметр. Если третий пареметр не указан, функция возвращает значение запрашиваемого поля первой зависи.

Способ вызова в скрипте:
{FUNCTION} <@WORKDIRECTORY@>\FieldSock.dll GetFieldValue <полный путь к файлу> <имя поля> [<номер записи в файле>] [ключи]

где

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

<имя поля> - название поля, значение которого требуется получить.

<номер записи в файле> - номер записи, в которой необходимо получить значение поля указанного в параметре <имя поля>.

Поддерживаемые ключи:
[ключи] - ключи позволяют указывать дополнительные параметры для функции, такие как:

• -sf "Путь к файлу источника" (от Source Folder). В случае наличия этого ключа, эта настройка считается более приоритетной, и перекрывает путь указанный в параметре <полный путь к файлу>.
  

Ключи могут располагаться в любом месте в параметрах, например в конце.

Пример использования:
{FUNCTION} <@WORKDIRECTORY@>\FieldSock.dll GetFieldValue "c:\arm_work\dcltovar.dbf" G31_1 "5" -sf c:\temp

После вызова функции в переменную :RETPARAM0 вернется значение запрашиваемого поля из указанной записи, в данном примере значение поля G31_1 таблицы dcltovar.dbf из записи 5

• -sf "Путь к файлу источника" (от Source Folder). В случае наличия этого ключа, эта настройка считается более приоритетной, и перекрывает путь указанный в параметре <полный путь к файлу>.

Ключи могут располагаться в любом месте в параметрах, например в конце.

Пример использования:
{FUNCTION} <@WORKDIRECTORY@>\FieldSock.dll GetRowCount "c:\arm_work\dclhead.dbf" -sf c:\temp.

После вызова функции в переменную :RETPARAM0 вернется значение кол-ва записей в таблице, в данном примере количество записей в таблице dclhead.dbf

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

Способ вызова в скрипте:
{FUNCTION} <@WORKDIRECTORY@>\FieldSock.dll SetFieldValueEx (<полный путь к файлу> | <маска для нескольких файлов> | @<имя текстового файла со списком файлов>) (<номер записи в файле> | 0) <имя поля> <значение поля> [<имя поля1> <значение поля1>... [<имя поляN> <значение поляN>]] [ключи]

где

<полный путь к файлу> = Путь к конкретной таблице DBF формата, в которой необходимо установить нужные значения

<маска для нескольких файлов> = Путь и маска для файлов, в которых нужно установить значения. Маска может содержать символы подстановки "*" и "?"

<имя текстового файла со списком файлов> = Используемый во многих функциях вид перечисления файлов. Полный путь к текстовому файлу, в каждой строке которого указанно какой файл будет обработан, в какой файл будут выставленны необходимые значения

<номер записи в файле> = Физической номер записи в таблице, для которого необходимо сделать изменения, при значении "0" изменения будут применены ко всем записям в файле.

<имя поля> = имя поля в таблице, значение которого необходимо изменить

<значение поля> = новое значение поля, задаваемое для конкретного поля имя которого указанно ранее.

Поддерживаемые ключи:
[ключи] - ключи позволяют указывать дополнительные параметры для функции, такие как:

• -sf "Путь к файлам источника" (от Source Folder). В случае наличия этого ключа, эта настройка считается более приоритетной, даже если в файле-списке прописаны пути к каждому dbf файлу-источнику, они будут заменены на значение этого ключа автоматически, даже если файл-источник указан непосредственно в параметрах.

Ключи могут располагаться в любом месте в параметрах, например в конце.

Пример использования:
{FUNCTION} <@WORKDIRECTORY@>\FieldSock.dll SetFieldValueEx c:\test\*.dbf 0 FIELDTEST1 12 FIELDTEST2 01.01.2002

{FUNCTION} <@WORKDIRECTORY@>\FieldSock.dll SetFieldValueEx @c:\test\listfiles.txt 0 FIELDTEST1 "ПРИМЕР СТРОКИ" FIELDTEST2 01.01.2002

Пример использования ключей:
{FUNCTION} <@WORKDIRECTORY@>\FieldSock.dll SetFieldValueEx @c:\test\listfiles.txt 0 FIELDTEST1 "ПРИМЕР СТРОКИ" FIELDTEST2 01.01.2003 -sf c:\arm_work

PackTable, функция предназначенная для упаковки таблиц. При упаковке таблиц происходит физическое удаление помеченных к удалению записей.

Способ вызова в скрипте:
{FUNCTION} <@WORKDIRECTORY@>\FieldSock.dll PackTable (<полный путь к файлу> | <маска для нескольких файлов>) [ключи]

где

<полный путь к файлу> = Путь к конкретной таблице DBF формата, которую необходимо упаковать.

<маска для нескольких файлов> = Путь и маска для файлов, которые нужно упаковать. Маска может содержать символы подстановки "*" и "?"

• -sf "Путь к файлам источника" (от Source Folder). В случае наличия этого ключа, эта настройка считается более приоритетной, даже если в файле-списке прописаны пути к каждому dbf файлу-источнику, они будут заменены на значение этого ключа автоматически, даже если файл-источник указан непосредственно в параметрах.
  
  
• -ttl "Количество попыток повторной записи, в случае блокировки файла-источника" (от Time To Live). Значение по-умолчанию равно 1.
  
  
• -time "Время (в секундах) между попытками повторной записи" (см. ключ ttl). Значение по умолчанию равно 10 сек.

Ключи могут располагаться в любом месте в параметрах, например в конце.

Пример использования:
{FUNCTION} <@WORKDIRECTORY@>\FieldSock.dll PackTable c:\test\*.dbf

{FUNCTION} <@WORKDIRECTORY@>\FieldSock.dll PackTable c:\test\table1.dbf

Пример использования ключей:
{FUNCTION} <@WORKDIRECTORY@>\FieldSock.dll PackTable c:\test\table1.dbf -sf c:\arm_work -ttl 20 -time 30

ZapTable, функция предназначенная для удаления всех записей в файле и упаковки. На выходе требуемый(ые) DBF файл(ы) становяться пустыми (без записей).

Способ вызова в скрипте:
{FUNCTION} <@WORKDIRECTORY@>\FieldSock.dll ZapTable (<полный путь к файлу> | <маска для нескольких файлов>) [ключи]

где
<полный путь к файлу> = Путь к конкретной таблице DBF формата, записи которой необходимо удалить.

<маска для нескольких файлов> = Путь и маска для файлов, записи в которых нужно удалить. Маска может содержать символы подстановки "*" и "?"

Поддерживаемые ключи:
[ключи] - ключи позволяют указывать дополнительные параметры для функции, такие как:

• -sf "Путь к файлам источника" (от Source Folder). В случае наличия этого ключа, эта настройка считается более приоритетной, даже если в файле-списке прописаны пути к каждому dbf файлу-источнику, они будут заменены на значение этого ключа автоматически, даже если файл-источник указан непосредственно в параметрах.
  
  
• -ttl "Количество попыток повторной записи, в случае блокировки файла-источника" (от Time To Live). Значение по-умолчанию равно 1.
  
  
• -time "Время (в секундах) между попытками повторной записи" (см. ключ ttl). Значение по умолчанию равно 10 сек.
  

Ключи могут располагаться в любом месте в параметрах, например в конце.

Пример использования:
{FUNCTION} <@WORKDIRECTORY@>\FieldSock.dll ZapTable c:\test\*.dbf

{FUNCTION} <@WORKDIRECTORY@>\FieldSock.dll ZapTable c:\test\table1.dbf

Пример использования ключей:
{FUNCTION} <@WORKDIRECTORY@>\FieldSock.dll ZapTable c:\test\table1.dbf -sf c:\arm_work -ttl 20 -time 30.

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

Способ вызова в скрипте:
{FUNCTION} <@WORKDIRECTORY@>\FieldSock.dll AddTableContent (<таблица источник> | @<имя текстового файла со списком файлов>) [<Таблица назначения>] (ON | OFF) [<ключевое поле1> [... <ключевое полеN>]] [ключи]

где

<таблица источник> = Путь к таблице источнику, откуда записи будут добавляться.

<таблица назначения> = Путь к файлу назначения, файл, куда будут добавленны данные из источника. При не существовании файла назначения, но существовании файла-источника, файл-источника будет скопирован в место, указанное в параметре <таблица назначения>.

<имя текстового файла со списком файлов> = Полный путь к текстовому файлу, в каждой строке которого указанны файл источник и отделенный от него пробелами или Tab файл назначения.
В файле-списке, который указывается в параметрах, через @, появилась возможность указывать для каждой пары свой набор ключевых полей, для этого достаточно через пробелы (или символ табуляции) указать последовательно все ключи для этой пары, в строке, после файла-назначения. Этот список ключевых полей будет считаться приоритетным перед теми, что передан в параметрах, и полностью его перекрывают. В случае, если в параметрах указаны ключевые поля, а в файле-списке ничего не указанно иного, то используются ключевые поля из параметров.

Параметр ON или OFF указывает будет ли произведена упаковка таблицы назначения, после выполенных операций. ON - задействует упаковку, OFF - нет. Рекомендуется использовать значение OFF, если используються несколько операций подряд, связанных с удалением в таблицах. Упаковку талбицы можно вызвать самостоятельно (см. функцию PackTable), это может ускорить обработку.

<ключевое поле> = Название ключевого поля, при равенстве значений которого в таблице источнике и таблице назначения, в таблице назначения удаляется соответствующая запись. Если в параметрах указанно несколько ключевых полей, то при нахождении равенства каждого из них значениям в противоположной таблице, будет выполненно удаление в таблице назначения. А параметр ON или OFF описанный выше позволит упаковать таблицу. Если ключевые поля не указаны, то в таблицу-назначения будут добавляться все записи без проверки на их уникальность.

Поддерживаемые ключи:
[ключи] - ключи позволяют указывать дополнительные параметры для функции, такие как: :

• -sf "Путь к файлам источника" (от Source Folder). В случае наличия этого ключа, эта настройка считается более приоритетной, даже если в файле-списке прописаны пути к каждому dbf файлу-источнику, они будут заменены на значение этого ключа автоматически, даже если файл-источник указан непосредственно в параметрах.
  
  
• -df "Путь к файлам назначения" (от Destination Folder). В случае наличия этого ключа, эта настройка считается более приоритетной, даже если в файле-списке прописаны пути к каждому dbf файлу-назначению, они будут заменены на значение этого ключа автоматически, даже если файл-назначение указан непосредственно в параметрах.
  
  
• -ttl "Количество попыток повторной записи, в случае блокировки файла-назначения" (от Time To Live). Значение по-умолчанию равно 1.
  
  
• -time "Время (в секундах) между попытками повторной записи" (см. ключ ttl). Значение по умолчанию равно 10 сек.
  
  
• -restructure CHECK|NOCHECK. Ключ, указывающий производить ли сопоставление формата таблицы назначения к таблице источнику (по структуре). Параметр ключа CHECK указывает на то, что необходимо произвести проверку на соответствие типов и если типы не соответствуют, то производить "сопоставление", если же параметром является NOCHECK, то сопоставление форматов (изменение в таблице назначения) будет происходить в любом случае без проверки, даже если структура идентична. Без указания этого ключа сопоставления структур не происходит.

Ключи могут располагаться в любом месте в параметрах, например в конце.

Пример использования:
{FUNCTION} <@WORKDIRECTORY@>\FieldSock.dll AddTableContent @c:\test\copylist.txt OFF Field1 Field2

{FUNCTION} <@WORKDIRECTORY@>\FieldSock.dll AddTableContent c:\test\a.dbf c:\test\b.dbf OFF Field1

Пример использования ключей:
{FUNCTION} <@WORKDIRECTORY@>\FieldSock.dll AddTableContent @<@WORKDIRECTORY@>\Filelist.txt OFF G073 -sf c:\arm_work -df c:\arm_out -ttl 20 -time 30 -restructure CHECK

Extract, функция для извлечения записей по условию в другой файл, при этом извлеченные записи из файла источника - удаляются. При осутствии файлов куда производиться выгрузка записей, создается пустой файл со структурой идентичной файлу-источнику.

Способ вызова в скрипте:
{FUNCTION} <@WORKDIRECTORY@>\FieldSock.dll Extract (<полный путь к файлу> | <маска для нескольких файлов> | @<имя текстового файла со списком файлов>) <каталог назначение> <ключевая таблица> <ключевое поле1> [... <ключевое полеN>] [ключи]

где

<полный путь к файлу> = Путь к конкретной таблице DBF формата, из которого будут извлечены записи

<маска для нескольких файлов> = Путь и маска для файлов, из которых будут извлечены записи. Маска может содержать символы подстановки "*" и "?"

<имя текстового файла со списком файлов> = Используемый во многих функциях вид перечисления файлов. Полный путь к текстовому файлу, в каждой строке которого указанно какой файл будет обработан, из каких файлов будут извлечены записи.

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

<ключевая таблица> = Таблица в списке таблиц, предназначенная как МАСТЕР таблица для остальных. Т.е. уникальные по ключевым полям записи найденные в этой таблице будут перенесены из этой таблицы в первую очередь, а в остальных указанных таблицах будут извлекаться записи, значения ключевых полей в которых будут равны первым найденным значениям ключевых полей в ключевой таблице. Ключевая таблица является направляющей к определению условия извлечения записей в остальных.

<ключевое поле> = Навзвание поля, которое определяет уникальность поиска в ключевой таблице, а так же во всех остальных. Значения ключевых полей получаются из первых значений ключевой таблицы. В параметрах может быть указанно несколько ключевых полей, в таком случае будет рассматриваться именно совокупность этих полей для условия.

Поддерживаемые ключи:
[ключи] - ключи позволяют указывать дополнительные параметры для функции, такие как:

• -sf "Путь к файлам источника" (от Source Folder). В случае наличия этого ключа, эта настройка считается более приоритетной, даже если в файле-списке прописаны пути к каждому dbf файлу-источнику, они будут заменены на значение этого ключа автоматически, даже если файл-источник указан непосредственно в параметрах.
  

Ключи могут располагаться в любом месте в параметрах, например в конце.

Пример использования:
{FUNCTION} <@WORKDIRECTORY@>\FieldSock.dll Extract c:\arm_in\*.dbf <@WORKDIRECTORY@>\temp dclhead.dbf g071 g072 g073

Пример использования ключей:
{FUNCTION} <@WORKDIRECTORY@>\FieldSock.dll Extract @<@WORKDIRECTORY@>\FileList.txt <@WORKDIRECTORY@>\temp dclhead.dbf g071 g072 g073 -sf c:\arm_in

• -sf "Путь к файлам источника" (от Source Folder). В случае наличия этого ключа, эта настройка считается более приоритетной, даже если в файле-списке прописаны пути к каждому dbf файлу-источнику, они будут заменены на значение этого ключа автоматически, даже если файл-источник указан непосредственно в параметрах.
  
  
• -df "Путь к файлам назначения" (от Destination Folder). В случае наличия этого ключа, эта настройка считается более приоритетной, даже если в файле-списке прописаны пути к каждому dbf файлу-назначению, они будут заменены на значение этого ключа автоматически, даже если файл-назначение указан непосредственно в параметрах.
  

Ключи могут располагаться в любом месте в параметрах, например в конце.

Пример использования:
{FUNCTION} <@WORKDIRECTORY@>\FieldSock.dll CopyStructure c:\test\pattern.dbf c:\test\modify.dbf

Пример использования ключей:
{FUNCTION} <@WORKDIRECTORY@>\FieldSock.dll CopyStructure @<@WORKDIRECTORY@>\Filelist.txt c:\test\modify.dbf -sf c:\test\

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

Способ вызова:
{FUNCTION} <@WORKDIRECTORY@>\FieldSock.dll Append (<таблица> | @<имя текстового файла со списком таблиц>) [<название поля1> <значение поля1> [... <название поляN> <значение поляN>]] [ключи]

где

<таблица> - полный путь к таблице, в которую добавляется запись.

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

<название поля1> - название поля, которому требуется присвоить значение.

<значение поля1> - значение которое будет присвоено полю указанному в параметре <название поля1>.

Поддерживаемые ключи:
[ключи] - ключи позволяют указывать дополнительные параметры для функции, такие как: :

• -sf "Путь к файлам источника" (от Source Folder). В случае наличия этого ключа, эта настройка считается более приоритетной, даже если в файле-списке прописаны пути к каждому dbf файлу-источнику, они будут заменены на значение этого ключа автоматически, даже если файл-источник указан непосредственно в параметрах.
  
  
• -ttl "Количество попыток повторной записи, в случае блокировки файла-источника" (от Time To Live). Значение по-умолчанию равно 1.
  
  
• -time "Время (в секундах) между попытками повторной записи" (см. ключ ttl). Значение по умолчанию равно 10 сек.
  
  

Ключи могут располагаться в любом месте в параметрах, например в конце.

Пример:
{FUNCTION} <@WORKDIRECTORY@>\FieldSock.dll Append @<@WORKDIRECTORY@>\Filelist.txt G073 :NUM G072 :D G071 "12131415"

Пример использования ключей:
{FUNCTION} <@WORKDIRECTORY@>\FieldSock.dll Append <@WORKDIRECTORY@>\test.dbf G073 :NUM G072 :D G071 "12131415" -sf c:\arm_work

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

Способ вызова:
{FUNCTION} <@WORKDIRECTORY@>\FieldSock.dll Delete (<таблица> | @<имя текстового файла со списком таблиц>) [<название поля1> <значение поля1> [... <название поляN> <значение поляN>]] [ключи]

где

<таблица> - полный путь к таблице, в которой удаляется запись.

<имя текстового файла со списком таблиц> - полный путь к текстовому файлу, в каждой строке которого указывается таблица, в которой требуется удалить запись.

<название поля1> - название поля, чье значение является условием для удаления записи.

<значение поля1> - значение поля, которое является условием для удаления записи.


Поддерживаемые ключи:
[ключи] - ключи позволяют указывать дополнительные параметры для функции, такие как: :

• -sf "Путь к файлам источника" (от Source Folder). В случае наличия этого ключа, эта настройка считается более приоритетной, даже если в файле-списке прописаны пути к каждому dbf файлу-источнику, они будут заменены на значение этого ключа автоматически, даже если файл-источник указан непосредственно в параметрах.
  
  
• -ttl "Количество попыток повторной записи, в случае блокировки файла-источника" (от Time To Live). Значение по-умолчанию равно 1.
  
  
• -time "Время (в секундах) между попытками повторной записи" (см. ключ ttl). Значение по умолчанию равно 10 сек.
  
  

Ключи могут располагаться в любом месте в параметрах, например в конце.

Пример:
{FUNCTION} <@WORKDIRECTORY@>\FieldSock.dll Delete @<@WORKDIRECTORY@>\Filelist.txt G073 :NUM G072 :D G071 "12131415"

Пример использования ключей:
{FUNCTION} <@WORKDIRECTORY@>\FieldSock.dll Delete <@WORKDIRECTORY@>\test.dbf G073 :NUM G072 :D G071 "12131415" -sf c:\arm_work

Find, функция возвращает значение одного или более полей записи dbf файла. Также, если используется условие поиска, то будет выведен номер записи, в которой найдено соответствие, или 0 во всех остальных случаях.

Способ вызова:
{FUNCTION} <@WORKDIRECTORY@>\FieldSock.dll Find <полный путь к файлу> <номер записи в файле> [<условие>] <имя поля1> [<имя поля2>... [<имя поляN>]] [<ключи>]

где,

<номер записи в файле> - номер записи начиная с которой будет производится поиск, если указано условие поиска. Если условие поиска не указанно, то функция работает аналогично GetFieldValue, возвращая значения запрашиваемых полей, указанной записи.

<условие> = <название поля><операция><значение> - необязательный параметр, задающий условие поиска. Задается как ОДИН! параметр, т.е. по правилам скрипта, в случае, если в задании условия присутствуют символы пробела, необходимо указывать этот параметр в кавычках.
Допустимые операции сравнения: <>,<=,>=,<,>,=,LIKE,NOTLIKE
Для того, чтобы задать строку нулевой длины или строку со значимыми пробелами, можно указывать значение в апострофах ' '. При операциях сравнения "<",">","<=",">=" значения должны быть цифровыми.

Возврат значений:
1 Номер записи. Только в случае существования условия и найденного соответствия, во всех остальных случаях это значение 0, как результат ПОИСКА "не найдено".
2 ... N Значения полей из списка параметров <имя поля> в той же последовательности.

Поддерживаемые ключи:
[ключи] - ключи позволяют указывать дополнительные параметры для функции, такие как:

• -sf "Путь к файлу источника" (от Source Folder). В случае наличия этого ключа, эта настройка считается более приоритетной, и перекрывает путь указанный в параметре <полный путь к файлу>.

Ключи могут располагаться в любом месте в параметрах, например в конце.

Пример:
{FUNCTION} <@WORKDIRECTORY@>\FieldSock.dll Find dclhead.dbf 1 "G073 NOTLIKE '2'" G071 -sf <@WORKDIRECTORY@>\arm_work\
(вернет 2 значения)
или
{FUNCTION} <@WORKDIRECTORY@>\FieldSock.dll Find dclhead.dbf 1 G071 G072
G073 -sf <@WORKDIRECTORY@>\arm_work\
(вернет 4 значения, первым будет 0, т.к. не указанно условие поиска)

webmaster