Show/Hide Toolbars

Методические рекомендации по настройке системы "Первая Форма"



Поскольку приложение "Первая Форма" имеет веб-интерфейс и для работы с ним используется обычный браузер, в его адресной строке можно задавать ссылки, которые указывают не только на главную страницу приложения, но и на различные представления и наборы данных, отфильтрованных определенным образом. Параметры отбора данных и отображения результатов передаются в виде подстроки, которая помещается после основной строки после знака вопроса "?". Если параметров несколько, между ними в строке помещается символ &.

Таким образом, ссылки имеют вид: https://адрес_1Формы/<название_файла_с_представлением>.aspx?подстрока_с_параметрами.

QueryString_for_newCustomGrid

Пример формирования адресной строки.

NewCustomGrid

Для табличного представления данных используется файл NewCustomGrid.aspx.

hmtoggle_arrow0Общие параметры

hmtoggle_arrow0Настройки для категорий

hmtoggle_arrow0Настройки для задач по разделу

hmtoggle_arrow0Настройки для личных папок

hmtoggle_arrow0Настройки для задач, подчиненных по группе (ролевое отношение)

hmtoggle_arrow0Настройки для задач, подчиненных по орг. единице

hmtoggle_arrow0Настройки для задач с lookup'ом

hmtoggle_arrow0Настройки для задач с тэгом

hmtoggle_arrow0Настройки для задач с главной страницы

hmtoggle_arrow0Настройки для задач с определенным значением ДП

hmtoggle_arrow0Настройки для задач с определенной датой создания

hmtoggle_arrow0Настройки для задач с определенной датой завершения

hmtoggle_arrow0Настройки для задач с определенным статусом

hmtoggle_arrow0Настройки для задач определенного пользователя

hmtoggle_arrow0Настройки для задач из сводных разделов по категориям

hmtoggle_arrow0Настройки для задач из папки Избранное

hmtoggle_arrow0Настройки для задач по смарт-запросу

 

!warning Все параметры настройки обязательны, т.е. если для какой-то настройки указаны два и более параметра, то значения должны быть заданы для всех этих параметров (исключение - взаимоисключающие параметры TasksForExtParamID и TasksForLookupColumnId для lookup'а).
Дополнительные фильтры необязательны, т.е. значения для них могут быть не заданы совсем или заданы выборочно.
Значения параметров и фильтров соединяются в строку символом &.    

Также можно передавать следующие параметры:

ParentID - родительская задача

CommentID - первый комментарий в задаче

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

LinkedID - связанная задача

TaskText - текст задачи

 

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

Описание

Адресная строка

Задачи, поставленные вам, активные, со статусом с ID равным 2

~/NewCustomGrid.aspx?Type=YouPerformerTasks&TodayOnly=1&StateID=2

Lookup как отдельный ДП, с поддержкой множественного выбора задач, для категории с ID=9 и для задачи с ID=1362

~/NewCustomGrid.aspx?MultiSelect=1&TasksForExtParamID=31&TaskSubcatID=9&TaskID=1362

Задачи, в которых ДП с ID=2140 имеет значение 1,00

~/NewCustomGrid.aspx?ExtParamID=2140&ExtParamValue=1,00

Обращения к различным объектам "Первой Формы" из адресной строки

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

Примеры обращения к объектам из адресной строки:

Описание

Адресная строка

Задачи

Создание новой задачи в категории с ID=2052, ДП с ID=3008 будет присвоено значение 15, а ДП с ID=2573 будет присвоено значение "Иванов Иван Иванович"

~/newTask.aspx?SubcatID=2052&ExtParamString=$Ext3008$15$Ext2573$Иванов%20Иван%20Иванович

Карточка задачи с ID=123456

~/MainTaskForm.aspx?TaskID=123456

Файлы

Загрузка файла с ID=123 (загружается последняя версия файла)

~/GetAttachment.ashx?ID=123

Загрузка файла, вложенного в ДП с ID=456 в задаче с ID=789

(используется метод веб-сервиса Valhalla)

~/app/v1.2/api/files/eps/789/456

Почта

Просмотр почтовой папки с ID=123

~/Emails/EmailList.aspx?FolderID=123

Портальные блоки и папки

Просмотр портала с ID=123

~/PortalGrid.aspx?PortalID=123

Просмотр портальной страницы с ID=123

~/spa.aspx/portal/123

Портальный блок с ID=123

~/SinglePortalBlock.aspx?BlockID=123

Портальный блок с ID=123 в контексте задачи с ID=123456

~/SinglePortalBlock.aspx?BlockID=123&TaskID=123456

Если для портального блока настроен фильтр, то в строке вызова могут быть переданы любые параметры фильтра (например, Status)

~/SinglePortalBlock.aspx?BlockID=123&Status=2

Повестка дня

Просмотр повестки

~/spaex.aspx/agenda

Отчеты

Просмотр отчета с ID=123 на отдельной странице

~MVC/ReportView/123

Иерархия

Просмотр иерархии с ID=123

~/TaskHierarchies/TaskHierarchy.aspx?id=123

Просмотр иерархии с ID=123 с корневой задачей с ID=123456

~/TaskHierarchies/TaskHierarchy.aspx?id=123&RootTaskId=123456

Файловое хранилище

при просмотре файлового хранилища к любым ключам, перечисленным ниже, можно добавить ключ ShowTree:

ShowTree=true  - отображать дерево папок слева, а содержимое папки справа;

ShowTree=false - не отображать дерево папок слева, отображать только содержимое папки.

Например: ~/FileStorage/?ShowFolder=UserFolder:456&ShowTree=false

Просмотр файлового хранилища

~/FileStorage/?ShowFolder=Root:

Просмотр файлового хранилища, корневой папки "Общие файлы"

~/FileStorage/?ShowFolder=Folder:

Просмотр файлового хранилища, папки с ID = 123 в папке "Общие файлы"

~/FileStorage/?ShowFolder=Folder:123

Просмотр файлового хранилища, корневой папки "Мои файлы"

~/FileStorage/?ShowFolder=UserRoot:

Просмотр файлового хранилища, папки с ID = 456 в папке "Мои файлы"

~/FileStorage/?ShowFolder=UserFolder:456

Просмотр файлового хранилища, корневой папки "Файлы в задачах"

~/FileStorage/?ShowFolder=TaskRoot:

Просмотр файлового хранилища, папки раздела с ID = 123 в папке "Файлы в задачах"

~/FileStorage/?ShowFolder=Category:123

Просмотр файлового хранилища, папки категории с ID = 456 в папке "Файлы в задачах"

~/FileStorage/?ShowFolder=Subcategory:456

Просмотр файлового хранилища, папки задачи с ID = 123456 в папке "Файлы в задачах"

~/FileStorage/?ShowFolder=Task:123456

Просмотр файлового хранилища, папки, привязанной к задаче с ID = 123456, в папке "Файлы в задачах"

~/FileStorage/?ShowFolder=LinkedToTask:123456

Просмотр файлового хранилища, корневой папки "Файлы пользователей" (личные файлы и папки, к которым предоставлен доступ другим пользователям)

~/FileStorage/?ShowFolder=Shared:

Просмотр файлового хранилища, папки пользователя с ID = 789 в разделе "Файлы пользователей" (личные файлы и папки, к которым предоставлен доступ другим пользователям)

~/FileStorage/?ShowFolder=Shared:789

Полезные ссылки