Добавил:
Опубликованный материал нарушает ваши авторские права? Сообщите нам.
Вуз: Предмет: Файл:

Saitistika 4.0.Руководство разработчика.2005

.pdf
Скачиваний:
12
Добавлен:
23.08.2013
Размер:
3.22 Mб
Скачать

5.SetParam(Name, Value) – см. описание класса CXMLDOM

6.Create(User, Name, Description, Template) – создание нового сценария. User – идентификатор пользователя, Name –

название сценария, Description – описание сценария, Template – идентификатор сценария, на основе которого будет создан новый сценарий. В случае, если значение параметра Template не равно 0, новый сценарий наследует все узлы и связи от сценария шаблона.

7.Delete – удаление текущего сценария

8.DeleteNode(Node, User) – удаление узла. Идентификатор узла задается параметром Node. User – идентификатор пользователя.

9.DeleteLink(Link, User) – удаление связи. Идентификатор связи задается параметром Node. User – идентификатор пользователя.

10.ExtractFormData() – обработка данных сценария. Установка порядка отображения узлов и связей сценария, признаков активности узлов и связей, признаков начального и конечного узла.

11.Save() – сохранение в БД данных текущего сценария.

12.Update – обновление данных сценария. Повторное чтение данных для текущего сценария.

13.Show(filename) – отображение информации о сценарии. Параметр filename – имя xsl-шаблона, используемого для отображения.

CWorkflowLink

Предназначен для работы со связями, которые связывают узлы сценария. Для подключения классов, используемых при работе со сценариями, следует воспользоваться директивой <!--#include virtual="/include/cworkflowclasses.asp"-->

Свойства

1.ID – идентификатор связи

2.Name – название связи

3.Description – описание связи

4.StartNode – идентификатор узла, в котором связь начинается

5.EndNode – идентификатор узла, в котором связь заканчивается

6.Status – идентификатор статуса, сопоставленного с данной связью

7.DefTaskTypeID – идентификатор типа задачи по умолчанию, которая должна создаваться при передаче задачи.

8.Active – признак активности связи

9.Workflow – идентификатор сценария, которому принадлежит связь

10.Valid – признак правильности связи

11.Error – признак ошибки

Методы

1.Load(Link, User) – загрузка из БД данных о связи. Link – идентификатор связи. User – идентификатор пользователя.

2.Save() – сохранение в БД данных о текущей связи

3.Create(Workflow, User) – создание новой связи. Workflow – идентификатор сценария, которому принадлежит создаваемая связь. User – идентификатор пользователя.

4.ExtractFormData – обработка данных о связи. Установка ролей, назначенных на связь

5.SetParam(Name, Value) – см. описание класса CXMLDOM

6.Show(filename) - отображение информации о связи. Параметр filename – имя xsl-шаблона, используемого для отображения.

CWorkflowNode

Предназначен для работы с узлами сценария. Для подключения классов, используемых при работе со сценариями, следует воспользоваться директивой <!--#include virtual="/include/cworkflowclasses.asp"-->

Свойства

1.ID – идентификатор узла

2.Name – название узла

3.Description – описание узла

4.NodeType – признак, определяющий, что узел является начальным/конечным/промежуточным.

5.System – признак, определяющий, что узел является системным.

6.Active – признак, определяющий, что узел является активным.

7.Workflow – идентификатор сценария, которому принадлежит текущий узел.

8.Valid – признак, определяющий, что для узла соблюдаются условия правильности.

9.Error – индикатор ошибки

Методы

1.SetParam(Name, Value) – см. описание класса CXMLDOM

Copyright © 2005 Individ company

Страница

Контакты: www.saitistika.ru | support@saitistika.ru | (0852) 321464

251 из 251

 

 

2.Load(Node, User) - загрузка из БД данных об узле. Node – идентификатор узла. User – идентификатор пользователя.

3.Create(Workflow, User) – создание нового узла. Workflow – идентификатор сценария, которому принадлежит создаваемый узел. User – идентификатор пользователя.

4.Save() - сохранение в БД данных о текущем узле

5.ExtractFormData()

6.Show(filename) - отображение информации об узле. Параметр filename – имя xsl-шаблона, используемого для отображения.

CXMLDOM

Обеспечивает работу с XML/XSL, позволяя не заботится о создании, загрузке и пр. объектов XMLDOM. Оптимизировано выполнение XSL-преобразований, есть возможность кеширования XSL-шаблонов. При подключении автоматически создается экземпляр класса объект OXML. Подключается директивой:

<!--#include virtual="/common/include/CXMLDOM.asp"-->

Свойства

1.mSQL – ссылка на объект класса CSQL, используемый при доставании данный из SQL-сервера в XML. По умолчанию устанавливается в SQLO, так что специально инициализировать нет необходимости

2.xml - возвращает ссылку на XMLDOMNODE - корневой элемент хранящего в объекте XML.

3.data(index) – индексируемое свойство, возвращает XMLDOMNODE элемента <rs:data>, дочернего для корневого, по его

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

Методы

1.Reset() – очищает хранящийся XML и создает пустой корневой элемент <xml/>.

2.AGetRS(SP, args) - достает данные из SQL-сервера в XML. Параметры как для SQLO.ARSOpen. Все возвращенные хранимой процедурой незакрытые RecordSet’ы последовательно сохраняются как дети корневого элемента (<xml>).

Каждый RecordSet сохраняется как элемент <rs:data /> с дочерними элементами <z:row field1=”value1” field2=”value2” … fieldN=”valueN” />, каждый из которых представляет собой одну запись из этого RecordSet’а, атрибутами и их значениями являются имена полей и их значенпия соответственно. Если в качестве значения какого-либо поля был возвращен NULL, соответствующий атрибут будет отсутстсвовать.

3.SetParam(имя, значение) – создает сына корневого элемента - <param name=”имя”>значение</param>. Для простой передачи параметров в XSL-stylesheet.

4.XSLTransform(xslfile) – применяет XSL-преобразование к хранящемуся в объекте XML. Параметр - имя файла (виртуальное, как в <!--#include file=”…”>), содержащего XSL. Результат преобразование сохраняется в объекте вместо исходного XML.

5.XSLOutput(xslfile) - – применяет XSL-преобразование к хранящемуся в объекте XML. Параметр - имя файла (виртуальное, как в <!--#include file=”…”>), содержащего XSL. Результат преобразование пишется напрямую в поток

Response.

6.Debug () – выводит в Response содержимое XML в относительно читабельном виде. Позволяет в любой момент проверить в окне браузера содержимое объекта.

Примеры использования

Использование на для отображения листов рассылки на бэкофисе:

<%

oxml.Reset

oxml.AGetRS "ListMailLists", Array(RI.UsrLogin, RI.UsrPwd) oxml.data(0).setAttribute "name", "maillists"

oxml.AGetRS "GetRightsForLeftMenu", Array(RI.UsrLogin, RI.UsrPwd) oxml.data(1).setAttribute "name", "LeftMenu"

set xlstMLists = oxml.xml.SelectNodes("/xml/rs:data/z:row")

...

oxml.setParam "user-title", RI.UsrTitle oxml.setParam "server-name", RI.UsrServer oxml.XSLTransform "custommail.xsl" oxml.XSLOutput "/scripts/format.xsl"

%>

Copyright © 2005 Individ company

Страница

Контакты: www.saitistika.ru | support@saitistika.ru | (0852) 321464

252 из 252

 

 

Справочник функций

Справочник содержит описания функций, сгруппированные по их назначению. Ниже описаны самые значимые или сложные функции.

Инициализация фронтофиса

Подключение директивой <!--#include virtual="/common/include/fo-init.asp" -->

Таблица функций

 

Имя и параметры

Описание

 

 

n12Br(field)

Заменяет перевод строки в тексте на <br>

 

 

TXS(field)

Экранирование поля для вывода в html

 

 

JXS(Field)

Экранирование поля для вывода в переменную JavaScript’a

 

 

FullTXS(Byref oxml)

Экранирование всего текста вxml

 

 

function UserInGroups(UserID , sGroups )

Проверяет принадлежность пользователя группе

 

 

function CheckFolders0(IFolderID)

Проверяются права для FolderInfo - текущего фолдера типа 0 (заполнение Icons,

 

 

или редирект на страницу авторизации) ; если IFolderID>0 заполняется обьект

 

 

IndexFolderInfo и проверяются для него права

 

 

function GetFolderPicture ( pType )

Возвращает обьект CImg вверх по дереву маленькая картинка для pType = 0,

 

 

большая картинка для pType = 1 для текущего фолдера

 

 

function CheckFormFields ( a )

Проверяет все ли поля в массиве А не пустые

 

 

function RusMonth(dat)

Вывод месяца во множественном числе

 

 

Function MarkCurrentPage (Struct)

Делает активной текущую страницу.

 

 

Function Halt(err)

Выводит сообщение об ошибке. err – текст ошибки.

 

 

function strSpacer(strMess , wordLen )

Разбивает длинные слова в строке

 

 

Function CheckPasswordFormat(Password)

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

 

 

только буквы или цифры).

 

 

ARowCount(ByRef a)

Возвращает к-во строк в 2-мерном массиве или 0 если аргумент - не массив

 

IIF(ByVal test,ByRef exp1, ByRef exp2)

exp1 если test – истина, exp2 иначе.

 

 

IfEmpty(ByVal exp1, ByVal exp2)

exp1 если exp1<>””, exp2 иначе.

 

 

LinkIF(ByVal test,ByRef URL, ByRef

Если test – истина, выводит <a href=”URL”>Label</a>, иначе - Label.

 

Label)

 

 

 

 

QSS(Fieldname)

Возвращает string – значение текстового поля, переданного по GET

 

QSC(FieldName)

Возвращает double numeric – значение числового поля с плавающей точкой или

 

 

запятой, переданного по GET. Если неверный формат числа возвращает 0.0

 

QSL(FieldName)

Возвращает long integer – значение целого числового поля, переданного по GET.

 

 

Если неверный формат числа возвращает 0.0

 

 

GetFormData (FieldName)

Возвращает данные из формы. Если FieldName <>”” возвращается значение

 

 

поля, в противном случае все данные.

 

 

FFL(FieldName)

Возвращает long integer – значение целого числового поля, переданного по

 

 

POST. Если неверный формат числа возвращает 0

 

 

FFS(FieldName)

Возвращает string – значение текстового поля, переданного по POST

 

FFC(FieldName)

Возвращает double numeric – значение числового поля с плавающей точкой или

 

 

запятой, переданного по POST. Если неверный формат числа возвращает 0

 

CheckEMail(EMail)

Истина если параметр соответствует формату E-Mail адреса.

 

 

ParseNotification(Text)

Вставляет в текст Email.

 

 

SendNotification(EMailTo, ByVal

Отправка письма по шаблону. Используемые переменные:

 

 

EMailSubj, ByVal EMailMessage)

%CONTACT_EMAIL%

 

 

 

%USER_LOGIN%

 

 

 

%USER_URL%

 

 

 

%SERVER_DOMAIN%

 

 

 

%SERVER_TITLE%

 

 

 

При отправке письма эти переменные заменяются соответствующими

 

 

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

 

 

TransformURL(URL)

Трансформирует урл, выдает урл с правильным протоколом или пустую строку

 

GetLeftBigImg(id)

Возвращает HTML левой большой картинки из свойств фолдера

 

 

GetFolderList(id,ftype)

2-мерный массив подфолдеров заданного фолдера заданного типа.

 

getParentFolderTitle(folderId,ByRef

Возвращает заголовок и ID родительского фолдера

 

 

ParentFolderId)

 

 

 

 

getFolderInfo(folderId)

Возвращает информацию о фолдере

 

 

 

 

 

 

 

Copyright © 2005 Individ company

 

Страница

 

Контакты: www.saitistika.ru | support@saitistika.ru | (0852) 321464

 

253 из 253

getFolderTitle(folderId)

Возвращает заголовок фолдера

GetMainNavigationFolders()

Список фолдеров основной навигации

function GetFileExt(FileName)

Возвращает расширение файла

Общая декорация страниц фронтофиса

Подключение директивой <!--#include file="common-decoration.asp" -->

Таблица функций

Имя и параметры

Описание

XMLDOMLeftMenu(ByRef XML,ByRef

Отрисовывает левое меню.

List1, url1, icon1, active1, ByRef List2, url2,

 

icon2, active2)

 

Function FullDateTime(dt, DateSep,

возвращает строку с отформатированной датой и временем. Первый параметр

DateTimeSep, TimeSep)

вырвжение подтипа vbDate, остальные разделители между частями даты

 

(днем, месяцем, годом), между датой и временем, между часами и минутами.

 

 

Function FullDate(dt, DateSep)

возвращает строку с отформатированной датой. Первый параметр вырвжение

 

подтипа vbDate, второй разделитель между частями даты (днем, месяцем,

 

годом).

Управление доступом

Подключение директивой <!--#include virtual="/common/include/access-functions.asp"-->

Таблица функций

Имя и параметры

Описание

Rtest (rights, setmask, resetmask)

Возвращает значение true, если аргумент rights содержит права, входящие в

 

аргумент setmask, и не содержит прав, входящих в аргумент resetmask. Иначе

 

функция возвращает false.

 

 

Журналирование

Подключение <!--#include virtual="/common/include/eventlog.asp"-->

Таблица функций

 

Имя и параметры

 

Описание

 

 

AddEvent ( EventType, ObjectID,

 

Это аналог хранимой процедуры Events_AddEvent. EventType - тип события,

 

ObjectType, UserID, FolderID,

 

Возвращаемое значение - Идентификатор добаленной записи или 0, если запись

 

AdditionalParams, StaticString, Status,

 

добавлена не была

 

 

Groups )

 

 

 

 

AddLinkedEvent ( MasterEventID,

 

Функция позволяет добавить связанное событие одним вызовом, вызывает

 

CopyAttributes, EventType, ObjectID,

 

AddEvent и LinkEvent с соответствующими параметрами. Возвращаемое

 

ObjectType, UserID, FolderID,

 

значение - Идентификатор добавленной записи или 0, если запись добавлена не

 

AdditionalParams, StaticString, Status,

 

была

 

 

Groups )

 

 

 

 

EventAddStructureParams ( StructureID,

 

Аналог хранимой процедуры Events_AddStructureParams. Возвращаемое

 

StructureType )

 

значение - Идентификатор добавленной записи или 0, если запись добавлена не

 

 

 

была.

 

 

LinkEvent ( EventID, MasterEventID,

 

Процедура полностью аналогична хранимой процедуре Events_LinkEvent

 

CopyAttributes )

 

 

 

 

Подключение <!--#include virtual="/aspscripts/eventlog/statistics/flash-functions.asp"-->

 

 

Таблица функций

 

 

 

 

Имя и параметры

 

Описание

 

 

AddBodyLoadScript

 

Добавление команд JavaScript для выполнения при загрузке страницы

 

FlashStr (text)

 

Экранирование текста для вывода в Flash-графике

 

 

ScriptBodyLoad

 

Вывод JavaScript-а из переменной BodyLoadScript для выполнения при загрузке

 

 

 

страницы

 

 

 

 

 

 

 

 

Copyright © 2005 Individ company

Страница

 

 

Контакты: www.saitistika.ru | support@saitistika.ru | (0852) 321464

254 из 254

Подключение <!--#include virtual="/aspscripts/eventlog/statistics/array-functions.asp"-->

Таблица функций

 

Имя и параметры

Описание

 

 

ArrayAvg (aRows, CalcCol)

Возвращает среднее значение для элементов колонки CalcCol двумерного

 

 

массива aRows

 

 

ArrayCompose2D (aID, a1, a2, a3, ByRef

Через параметр aResult возвращает двумерный массив из 4 колонок. Число

 

aResult)

строк массива aResult будет равным числу строк массива aIDs с уникальными

 

 

идентификаторами (значениями 0-го столбца). Значение нулевой колонки будет

 

 

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

 

 

сумме значений элементов второй колнки массива a1, у которых значение

 

 

нулевой колонки равно значению нулевой колонки aResult, значение второй

 

 

колонки такая же сумма для a2, значение третьей колонки такая же сумма

 

 

для a3.

 

 

 

Используется для получения таблицы из количества показов, переходов и CTR

 

 

для объектов с идентификаторами из массива aID, если данные о показах,

 

 

переходах и CTR находятся в трех разных массивах.

 

 

ArrayCompose3D (aDates, aID, a1, a2, a3,

Через параметр aResult возвращает трехмерный массив, также использующийся

 

ByRef aResult)

на страницах статистики для получения таблицы показов, переходов и CTR для

 

 

различных объектов по датам

 

 

ArrayComposeMax1DUsingFactor (aInput,

Возвращает одиномерный массив из Count-1 элементов. Каждый элемент

 

aFactor, Count)

массива равен максимуму среди элементов массива aInput с индексами,

 

 

равными индексу этого элемента по модулю Count. Параметр aFactor должен

 

 

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

 

 

от фактора)

 

 

ArrayComposeMin1DUsingFactor (aInput,

Возвращает одиномерный массив из Count-1 элементов. Каждый элемент

 

aFactor, Count)

массива равен минимуму среди элементов массива aInput с индексами, равными

 

 

индексу этого элемента по модулю Count, если aFactor с индексом, равным

 

 

индексу выходного элемента, отличен от нуля, иначе выходной элемент равен

 

 

нулю. Размер aFactor должен быть по крайней мере Count-1

 

 

ArrayComposeSum1D (aInput, Count)

Возвращает одномерный массив из Count-1 элементов, каждый элемент

 

 

которого равен сумме всех элементов из aInput с индексами, равными индексу

 

 

этого элмента по модулю Count.

 

 

ArrayCutFirst (ByRef aRows, Count,

Обрезает двумерный массив aRows до Count первых элементов с ненулевым

 

NotZeroCol)

значением колонки с индексом NotZeroCol

 

 

ArrayDistinctCountOf1D (aRows)

Возвращает количество различных элементов одномерного отсортированного

 

 

массива

 

 

ArrayDistinctCountOf2D (aRows, Col)

Возвращает количество различных элементов в колонке Col двумерного

 

 

отсортированного по этой колонке массива

 

 

ArrayDivide1D (aInput1, aInput2)

Возвращает одномерный массив, элементы которого равны результату

 

 

поэлементного деления массива aInput1 на aInput2. Массивы aInput1 и aInput2

 

 

должны быть одномерными и иметь одинаковый размер

 

 

ArrayGroupMax1D (aInput, Count)

Возвращает массив, число элементов которого равно результату

 

 

 

целочисленного деления числа элементов aInput на Count. Каждый элемент

 

 

выходного массива равен максимуму среди Count последовательных элементов

 

 

массива aInput

 

 

ArrayGroupMin1D (aInput, Count)

Возвращает массив, число элементов которого равно результату

 

 

 

целочисленного деления числа элементов aInput на Count. Каждый элемент

 

 

выходного массива равен минимуму среди Count последовательных элементов

 

 

массива aInput

 

 

ArrayGroupSum1D (aInput, Count)

Возвращает массив, число элементов которого равно результату

 

 

 

целочисленного деления числа элементов aInput на Count. Каждый элемент

 

 

выходного массива равен сумме Count последовательных элементов массива

 

 

aInput

 

 

ArrayInBounds(a1, a2, a3)

Возвращает одномерный массив из элементов массива a1, ограниченных снизу

 

 

элементами массива a2 и сверху элементами массива a3 с соответствующими

 

 

индексами. Массивы a1, a2 и a3 должны быть одномерными и иметь

 

 

одинаковый размер

 

 

ArrayMax1D (aRows)

Возвращает значение максимального элемента одномерного массива

 

ArrayMax2D (aRows, MaxCol)

Возвращает значение максимального элемента из колонки MaxCol двумерного

 

 

массива

 

 

ArrayMax3D (aRows, MaxCol)

Возвращает максимум среди всех элементов трехмерного массива, первое

 

 

измерение которых равно MaxCol

 

 

 

 

 

 

 

Copyright © 2005 Individ company

 

Страница

 

Контакты: www.saitistika.ru | support@saitistika.ru | (0852) 321464

 

255 из 255

ArrayMinMax (aRows, CalcCol, ByRef L,

Через параметры L (минимум) и U (максимум) возвращает минимум и

ByRef U)

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

ArrayMultiplyByVector1D (aInput, Vector)

Возвращает одномерный массив, элементы которого равны элементам массива

 

aInput, умноженным на значение Vector

ArrayRound1D (aInput, Digits)

Возвращает одномерный массив, элементы которого равны соответствующим

 

элементам массива aInput, округленным до Digits десятичных знаков

ArraySort (ByRef aRows, SortCol, Asc)

Сортировка элементов двумерного массива aRows по колонке SortCol по

 

возрвстанию, если Asc = True, или по убыванию, если Asc = False

ArraySort1DAsInt (ByRef aRows, Asc)

Сортировка элементов одномерного массива aRows по возрастанию (Asc = True)

 

или убыванию (Asc = False). При сравнении элементы массива приводятся к

 

числовым с помощью оператора Int

ArraySortAs (aID, aRows, ByRef aResult)

Через параметр aResult возвращает массив элементов aRows, упорядоченных

 

так, что порядок элементов нулевой колонки совпадает с порядком элементов

 

нулевой колонки массива aID (при этом число строк в массивах aID и aRows

 

может не совпадать). Все массивы двумерные

CalcCTR (aShow, aClick, aIDs, StatCol,

Подсчет CTR для двух массивов. Через параметр aCTR возвращает массив,

ByRef aCTR)

размерности которого совпадают с размерностями массива aShow. Значения

 

элементов выходного массива совпадают со значениями элементов массива

 

aClick за исключением колонки StatCol. Значениями этой колонки является

 

частное от деления элемента колонки StatCol строки, в которой поля массивов с

 

индексами из массива aIDs совпадают с полями массива aShow из

 

обрабатываемой строки с теми же индексами, массива aClick на элемент

 

колонки StatCol массива aClick. Массивы aShow и aClick должны быть

 

двумерными с одинаковым количеством столбцов, массив aIDs должкн быть

 

одномерным, каждый его элемент должен быть заключен между 0 и числом

 

столбцов массивов aShow и aClick. Значение StatCol должно быть из того же

 

диапазона.

DebugPrintArray1 (aRows)

Выводит на страницу элементы одномерного массива

DebugPrintArray2 (aRows)

Выводит на страницу элементы двумерного массива

GetDates (StartDate, EndDate, ByRef

Через параметр aDates возвращает двумерный массив дат со следующими

aDates)

значениями колонок:

 

0.

Дата начала периода

 

1.

Дата середины периода

 

2.

Дата окончания периода

 

3. Строка в формате «d,m», где d – день середины периода, m – месяц

 

 

середины периода

 

4. Цвет периода: «#000000», если начало периода это Пн, Вт, ...., Пт;

 

 

«#FF0000», если начало периода это Сб или Вс

 

Количество периодов (и строк массива) равно количеству дней между StartDate

 

и EndDate включительно, если это количество не более 30 (в этом случае даты

 

начала, середины и окончания периодов совпадают), иначе около 15 (в этом

 

случае даты начала, середины и конца периодов различаются). Данная функция

 

полезна на страницах отчетов для вывода отчетов по дням в Flash-графиках

 

(используйте столбцы 3 и 4) и таблицах.

GetFullDates (StartDate, EndDate)

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

 

StartDate до EndDate включительно с разницей в 1 день

Работа с пользователями

Подключение <!--#include virtual="/aspscripts/Users/Users-functions.asp"-->

Таблица функций

 

Имя и параметры

Описание

 

 

SetGroupSettings ( gId , gLabel , sRight , sSites ,

Установка свойств группы пользователей. Функция вызывает процедуру

 

sDelUsers , sAddUsers )

Users_SetGroupSettings

 

 

GetUserList ( login , email , sort , groups ,

Возвращает список пользователей, подпадающих под заданные условия

 

uIsnotgroup , uIsdisabled , dat_beg , dat_end ,l , u

 

 

 

, ByRef total , ByRef nListUser , sIgnoreGroups )

 

 

 

SetMailLists ( UserID , clientId , sMailList ,

Удаляет всех пользователей для которых есть права на запись и акцесс на

 

aClientMailList )

folder которых нет в sMailList для UserID

 

 

 

Добавляет пользователей которых нет в базе и есть в sMailList для которых

 

 

есть права на запись и акцесс на folder для UserID

 

 

 

 

 

 

Copyright © 2005 Individ company

Страница

 

Контакты: www.saitistika.ru | support@saitistika.ru | (0852) 321464

256 из 256

SaveFile ( FieldName , upl , clientId , ByRef

Сохранает файл, подгруженный в свойствах пользователя

adfFileName )

 

UploadPicture ( FieldName , upl )

Подгружает картинку - фотографию пользователя

Add2Clients ( login,passwd,email,Comment,uId )

Добавляет или изменяет свойства клиента (таблица Clients). Функция

 

вызывает процедуру Users_Add2Clients

Add2People (

Добавляет или изменяет свойства пользователя (таблица Clients). Функция

login,passwd,email,fname,lname,picture,Comment

вызывает процедуру Users_Add2People

, clientId ,uId, SMode , UCHSecSettings )

 

CheckFillSysRegField (name,upl)

Проверка заполненности обязательных полей формы регистрации

GetUserInfo (userId)

Возвращает свойства пользователя

GetGroupsIdString ( gId , bInGroup ,

Список групп пользователей через точку

bNotInGroup )

 

ShowAdditionalRegFields ( aAdditionalRegFields

Вывод поля формы регистрации

, i , bPOST , clientID)

 

CompareGroups( aGroups, upl, sName, userID,

Сравнение групп пользователей

MasterEvent, ss )

 

CompareUsers( aUsers, sAddUsers, sDelUsers,

Сравнение пользователей

groupID, MasterEvent )

 

GetRolesInfo( uID , ByRef UserRoles, ByRef

Список ролей пользователя

GroupsRoles)

 

AssignUserRoles( uId, sRoles, ByRef UserRoles )

Назначение пользователя на указанные роли

AssignGroupRoles( gId, sRoles, ByRef

Назначение группы пользователей на указанные роли

GroupRoles )

 

Права пользователей на объекты

Подключение <!--#include virtual="/common/include/access-functions.asp"-->

Таблица функций

Имя и параметры

Описание

RTest(rights, setmask, resetmask)

Функция возвращает значение true, если аргумент rights содержит права,

 

входящие в аргумент setmask, и не содержит прав, входящих в аргумент

 

resetmask. Иначе функция возвращает false.

GetFolderIcons(Rights, folderID, TypeID)

Получить HTML-код для вывода DirectEdit для раздлела фронтофиса в

 

зависимости от прав пользователя на раздел и типа раздела

GetUserObjectRights(userId, oId, oType)

Получить битовую маску прав пользователя на объект системы

ObjectExists(oType, oID)

Проверяет, есть ли таблице прав записи о правах на объект

Работа с тестами на фронтофисе

Подключение <!--#include file="test-functions.asp" -->

Таблица функций

Имя и параметры

Описание

logEvent(EventType,FolderID,UserID, login,

Логирует старт и окончание теста с учетом специфических требований

result, ErrorStr)

записи событий на разных пользователей. Используется в классах по

 

работе с тестми.

prepareTest(FolderID)

Подготавливает структуры данных в сессии, необходимые для

 

функционирования тестов.

doLogin(FolderID)

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

 

Используется классами по работе с тестами.

Функции для работы с формами

Подключение <!--#include file="form-functions.asp" -->

Таблица функций

 

Имя и параметры

 

Описание

 

 

GetFormsList(Folder)

 

Возвращает список форм, расположеных в разделе Folder.

 

 

GetFolderFormIcons (Rights, FolderID)

 

Возвращает HTML-код для вывода иконок DirectEdit у раздела с правами

 

 

 

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

 

 

GetFormID(Folder)

 

Возвращает идентификатор формы по идентификатору раздела Folder.

 

 

 

 

 

 

 

Copyright © 2005 Individ company

Страница

 

 

Контакты: www.saitistika.ru | support@saitistika.ru | (0852) 321464

257 из 257

Работа с голосованиями на фронтофисе

Подключение <!--#include file="voting-functions.asp" -->

Таблица функций

Имя и параметры

Описание

Add_Vote(VotingID,IP,Optns)

Добавляет голос по заданному голосованию

GetVotingsCount(folderId)

Возвращает количество голосований

GetVotingResults(id,l,u)

Возвращает результат голосования

Работа с новостями на фронтофисе

Подключение: <!--#include file="news-functions.asp" -->

Таблица функций

Имя и параметры

Описание

SQLD(dat)

Формирует строку запроса по дате

m(dat)

Выводит название месяца во множественном числе

mm(dat)

Выводит название месяца в единственном числе

w(dat)

Выводит день недели

GetPeriodString(period,datBeg,datEnd)

Формирует строку периода

GetPictureInfo(id)

Получение информации о картинке и заполнение параметров

GetNewsLenta(id)

Заполняет массив с лентой новостей

GetNewsList( FolderId , datBeg , datEnd )

Заполняет массив с леной новостей с даты=datBeg по дату=datEnd

GetNewsPeriods (folderId,ByRef period,ByRef

Возвращает период, за который выводятся новости

periodDays)

 

GetArchPeriods (folderId,year,ByRef

Возвращает период, за который выводится архив новостей

period,ByRef periodDays)

 

GetNewsBeginPeriod

Возвращает период начала новостей в днях, неделях или месяцах.

(newsDate,period,periodDays)

 

IsActive(name)

Проверяет является ли name названием текущего скрипта

GetNewsBounds(id,parentId,ByRef

Получение связанных с новостью материалов.

aNewsUBound,ByRef aNewsLBound)

 

GetNewsNears (newsId,folderId,ByRef

Возвращает список новостей

aNewsUNear,ByRef aNewsLNear)

 

SetLeftActive(aFolderList,FolderId,ByRef

Устанавливает активный раздел и активный период.

ActiveFolder,ByRef period,ByRef

 

periodDays,ByRef aPeriodList, _ ByRef

 

datBeg,ByRef datNews,ByRef datEnd,ByRef

 

ActivePeriodCnt,ByRef NewsList)

 

Функции по работе с объектами в бэкофисе

Подключение <!--#include file="object-functions.asp" -->

Таблица функций

Имя и параметры

Описание

GetObjectPropEx(aEditTypes, LinkType, ByVal

Возвращает свойства объекта вместе с директэдитами по его ID и типу. В

oID, ByVal oType, ByRef oName, ByRef oTitle,

aEditTypes передается массив с именами иконок, которые необходимо

ByRef oLink, ByRef DirectEdit )

вернуть. В LinkType также передается линка по которой будет

 

осуществлен переход при клике на свойства объекта. Функция учитывает

 

удаленные объекты и связана с логированием

GetObjectProp( ByVal oID, ByVal oType, ByRef

Аналогична вышеописанной процедуре , отличается тем, что выводит все

oName, ByRef oTitle, ByRef oLink, ByRef

возможные директэдиты и выводит ссылку по умолчанию

DirectEdit )

 

Функции по работе с настройками системы в бэкофисе

Подключение: <!--#include virtual="/include/settings-functions.asp" -->

Copyright © 2005 Individ company

Страница

Контакты: www.saitistika.ru | support@saitistika.ru | (0852) 321464

258 из 258

 

 

Имя и параметры

Описание

GetSystemSettings (sname, sDomen, sSmtp, nUID, sIPs,

Получение из БД данных об общих установках системы

aAdmins, tSmtp, tPubImm, tEnSavInt, cMaxMat, cMaxDays)

 

SetSystemSettings (sname, sDomen, sSmtp, nUID, sIPs, tSmtp,

Сохранение в БД данных об общих установках системы

tPubImm, tEnSavInt, cMaxMat, cMaxDays)

 

 

 

Функции по работе с типами и подтипами данных в бэкофисе

Имя и параметры

Описание

ShowDataTypeLabel (oID, rights )

отображение названия типа или подтипа данных

 

 

CheckTask(ByRef Reasons)

Проверяет правильность подтипа типа «Задачи». Возвращает

 

критерии, по которым подтип признан неправильным

CheckProject(ByRef Reasons)

Проверяет правильность подтипа типа «Проекты».

 

Возвращает критерии, по которым подтип признан

 

неправильным

Функции для работы с метаданными

Имя и параметры

Описание

ListFieldTypes

Отображение списка типов полей

ShowFormTitle(Folder)

Отображение заголовка формы. Folder – идентификатор

 

раздела, содержащего форму

Функции для работы с чатами на фронтофисе

Подключение: <!--#include file="chat-functions.asp" -->

Имя и параметры

Описание

CheckTimeout (ChatFolder)

Для всех пользователей, находящихся в чате ChatFolder,

 

проверяет, не наступил ли для них период таймаута. Если

 

этот период наступил для некоторых пользователей, то

 

производится их выход из чата

FrameRedirect (Location)

Очищает буфер Response, выводит html-страницу,

 

предназначенную для редиректа из фрейма в основное окно

 

броузера через JavaScript, и заканчивает обработку скриптов

 

на странице

Функции для работы с форумами на фронтофисе

Подключение: <!--#include file="forums-functions.asp" -->

Имя и параметры

Описание

ShowMyForumBlock

Вывод блока настройки вывода сообщений форума (полный

 

текст/только заголовки)

Функции для отображения баннеров на страницах фронтофиса

Подключение: <!--#include virtual="/common/include/br-functions.asp" -->

Имя и параметры

Описание

Banners_ShowBanner (ProfileID_or_Name)

Вывод баннера из профиля с указанным идентификатором

 

или именем. Вывод производится через шаблон профиля для

 

темы текущего раздела.

Функции подсистемы регистрации и авторизации

Подключение: <!--#include virtual="/common/include/auth.asp" -->

Copyright © 2005 Individ company

Страница

Контакты: www.saitistika.ru | support@saitistika.ru | (0852) 321464

259 из 259

 

 

Имя и параметры

Описание

AuthCheckIP (UserID, IP, CommonType, UserType, SiteID,

Проверка текущего IP пользователя на удовлетворение

Byref bUser)

ограничениям по IP для системы и для пользователя

AuthCheckNTUser (UserID, NTUserName, uType)

Проверка имени текущего Windows-пользователя на

 

удовлетворение ограничений на Windows-пользтвалей для

 

пользователя

AuthGetNTUser

Получение имени текущего Windows-пользователя, по

 

необходимости с привлечением компонента интеграции с

 

Active Directory

Функции подсистемы управления структурой

Подключение: <!--#include virtual="/aspscripts/directories/directories-functions.asp" -->

Имя и параметры

Описание

CommonTop (err_mes , rights ,Upl )

Выводит пользовательский интерфейс для редактирования

 

свойств раздела, общих для всех типов разделов.

 

Используется на страницах свойств разделов

CommonDeleteFolder (VFolder)

Удаляет раздел с идентификатором VFolder, делая

 

необходимые записи в журнале событий. Предназначена для

 

обработки команды удаления раздела на страницах свойств

 

разделов

Copyright © 2005 Individ company

Страница

Контакты: www.saitistika.ru | support@saitistika.ru | (0852) 321464

260 из 260