Устаревшее |
---|
Актуальный раздел находится здесь |
---|
Поскольку приложение "Первая Форма" имеет веб-интерфейс и для работы с ним используется обычный браузер, в адресной строке можно задавать ссылки, которые указывают не только на главную страницу приложения, но и на различные представления и наборы данных, отфильтрованных определенным образом.
Пример адресной строки.
Ссылки имеют вид:
https://адрес_1Формы/{модуль}?{parameters}
или
https://адрес_1Формы/{XXX}?{parameters}
{модуль} — это название вызываемого модуля (например, MainTaskForm.aspx).
{XXX} — это описание конечной точки вместе с параметрами пути (например, /spa/tasks/{TaskID}).
{parameters} — это параметры строки запроса. Большая часть таких параметров — необязательные. Параметры задают условия отбора данных и отображения результатов. Если параметров несколько, они соединяются символом &.
Все основные параметры обязательны, т.е. если для какой-то настройки указаны два и более основных параметра, то значения должны быть заданы для всех (исключение — взаимоисключающие параметры TasksForExtParamID и TasksForLookupColumnId для lookup'а).
Дополнительные параметры необязательны, т.е. значения для них могут быть не заданы совсем или заданы выборочно.
Примеры:
~/MainTaskForm.aspx?TaskID=123456&TemplateID=555
~/spa/portal/123
Во всех примерах, приведенных в данном разделе, в адресной строке вместо символа ~ необходимо подставить https://адрес_1Формы или использовать относительные адреса. |
---|
В интерфейсе SPA вместо служебных символов нужно использовать коды:
Символ |
Код |
? |
%3F |
& |
%26 |
$ |
%24 |
/ |
%2F |
= |
%3D |
пробел |
%20 |
[ |
%5B |
] |
%5D |
Пример:
~/MainTaskForm.aspx%3FTaskID%3D123456%26TemplateID%3D555
Переадресация на API-метод
В "Первой форме" реализована поддержка относительных адресов вне интерфейса SPA в /spa/entry/signin?fromUrl= , что позволяет совершать переадресацию на API-метод.
Пример использования:
При экспорте списка задач категории в Excel ДП "Файл" экспортируется и отображается в колонке в виде кликабельной гиперссылки вида:
https://адрес_1Формы/api/files/download/{id файла}?redirect=1
При этом в API добавляется параметр URL ?auth=true, наличие которого совершает переадресацию на страницу авторизации в системе для ввода логина и пароля в случае возникновения ошибки доступа (error 401). В 257 версии страница логина указывается в ключе "AuthTokenLoginUrl" appsettings.json
Название |
Описание |
---|---|
~/spa/tasks/subcat/{subcatId}/grid ~/spa/tasks/category/{categoryId}/grid |
|
|
|
subcatId |
ID категории |
categoryId |
ID раздела |
Пример |
|
Просмотр списка задач в категории с ID=123: ~/spa/tasks/subcat/123/grid |
Название |
Описание |
---|---|
~NewCustomGrid.aspx |
|
Основной параметр |
|
subcatId |
ID категории |
Дополнительные параметры |
|
BlockId и SourceTaskID |
Задачи из конкретной задачи (SourceTaskId) и конкретного блока "Используется" (BlockId) |
SmartFilterID |
ID смарт-фильтра, который надо применить |
IsDefaultView |
Имеет значение 1. Показать задачи из категории без применения сделанных ранее пользовательских настроек. Может применяться к любому списку, который берет задачи из конкретной категории (например, для Lookup-а или БИ) |
IsReadOnly |
Имеет значение 1. Запрещает пользователю изменять настройки (например, ширину колонок), применять сортировку или фильтры. |
SortBy |
Задает поле сортировки (из тех колонок, что отображаются в списке) |
GroupBy |
Задает поле группировки (из тех колонок, что отображаются в списке) |
Примечание |
|
При использовании параметров SortBy и GroupBy пользовательские настройки сортировки и группировки имеют приоритет. Чтобы приоритет имели параметры SortBy и GroupBy, нужно вместе с ними использовать параметр IsDefaultView. Например, так: ~/NewCustomGrid.aspx?SubcatID=12&IsDefaultView&SortBy=Заказчик&GroupBy=Статус |
|
Пример |
|
Задачи в категории с ID=12. Список открывается в режиме "только для чтения": ~/NewCustomGrid.aspx?SubcatID=12&IsReadOnly=1 Задачи в категории с ID=12, отсортированные по заказчику и сгруппированные по статусу: ~/NewCustomGrid.aspx?SubcatID=12&SortBy=Заказчик&GroupBy=Статус Задачи в категории с ID=12: ~/spa/tasks/subcat/12/grid |
Название |
Описание |
---|---|
~NewCustomGrid.aspx |
|
Основной параметр |
|
CategoryID |
ID раздела |
Дополнительный параметр |
|
SmartFilterID |
ID общего смарт-фильтра с включенным признаком "Для смарт-поиска" |
Пример |
|
Задачи в разделе с ID=34: ~/NewCustomGrid.aspx?CategoryID=34 |
Название |
Описание |
|
---|---|---|
~NewCustomGrid.aspx |
||
Обязательные параметры |
||
Type |
Тип личной папки. Возможные значения: |
|
YouPerformerTasks |
Я исполнитель |
|
Repeated |
Повторяющиеся задачи. Доступно только для администраторов (+ должен быть передан параметр AdminView без значения) |
|
FromYou |
Я заказчик |
|
Deleted |
Отклоненные задачи |
|
Complainted |
Обжалованные задачи |
|
Overdue |
Просроченные задачи |
|
ToSign |
Задачи на подписи |
|
Signed |
Подписанные задачи |
|
Declined |
Задачи с отклоненной подписью |
|
Subscribed |
Я подписчик |
|
YourGroupsOverdue |
Просроченные задачи подчиненных по группам |
|
YourGroupsOverdueSigns |
Задачи с просроченными подписями подчиненных по группам |
|
YourGroupsActiveSigns |
Задачи подчиненных по группам на подписи |
|
YourGroupsSignSigns |
Подписанные задачи подчиненных по группам |
|
YourGroupsRefusedSigns |
Задачи с отклоненными подписями от твоих подчиненных |
|
YourRemindingTasks |
Задачи с установленными напоминаниями |
|
Active |
Активные |
|
Completed |
Неактивные |
|
Дополнительные параметры |
||
SubcatID |
ID категории |
|
CategoryID |
ID раздела |
|
DateStart |
Отбор по дате |
|
DateEnd |
||
Active |
Имеет значение 1. Только активные задачи (только для YouPerformerTasks) |
|
TodayOnly |
Имеет значение 1. Только активные задачи со сроком сегодня (только для YouPerformerTasks) |
|
StateID |
ID статуса задачи (только для YouPerformerTasks) |
|
Пример |
||
Активные задачи, где я исполнитель: ~/NewCustomGrid.aspx?Type=YouPerformerTasks&TodayOnly=1 |
Название |
Описание |
---|---|
~NewCustomGrid.aspx |
|
Основной параметр |
|
GroupID |
All или ID группы |
Дополнительные параметры |
|
SubcatID |
ID категории |
Пример |
|
Задачи в категории с ID=12, доступные пользователям из группы с ID=9: ~/NewCustomGrid.aspx?GroupID=9&SubcatID=12 |
Название |
Описание |
---|---|
~NewCustomGrid.aspx |
|
Основной параметр |
|
OrgUnitId |
All или ID орг. единицы |
Дополнительные параметры |
|
SubcatID |
ID категории |
Пример |
|
Задачи в категории с ID=12, доступные пользователям из орг. единицы с ID=9: ~/NewCustomGrid.aspx?OrgUnitID=9&SubcatID=12 |
Название |
Описание |
---|---|
~NewCustomGrid.aspx |
|
Основные параметры |
|
ExtParamID |
ID ДП |
ExtParamValue |
Значение ДП |
Дополнительные параметры |
|
DateStart |
Отбор по дате |
DateEnd |
|
Примечание |
|
Для ДП Lookup можно делать отбор только по тексту задачи, а не по ID |
|
Пример |
|
Задачи, в которых ДП "Деньги" с ID=2140 имеет значение 1,00 ~/NewCustomGrid.aspx?ExtParamID=2140&ExtParamValue=1,00 Задачи, в которых ДП Lookup с ID=2520 ссылается на задачу с текстом "принтеры" ~/NewCustomGrid.aspx?ExtParamID=2520&ExtParamValue=принтеры |
Название |
Описание |
~NewCustomGrid.aspx |
|
Основные параметры |
|
TasksForExtParamID |
Используется если lookup это отдельный ДП. По ссылке будет отображаться список задач, которые могут быть выбраны в данном ДП |
TasksForLookupColumnId |
Используется если lookup это колонка ДП "Таблица". По ссылке будет отображаться список задач, которые могут быть выбраны в данном ДП |
Дополнительные параметры |
|
MultiSelect |
Имеет значение 1. Используется для ДП "Выбор задач из категории" (multilookup) |
TaskSubcatID |
Используется в NTF и содержит ID категории, на которую ссылается ДП |
TaskID |
Используется в MTF и содержит ID задачи, на которую ссылается ДП |
ParentEpId, ParentEpId2, ParentVals, ParentVals2 |
ID и значения родительского ДП (или родительских, если они связанные) |
SelectedValuesInMultiEp |
Значения ДП "Выбор задач из категории" (multilookup) |
ReturnAllMultiSelectTasks |
Имеет значение 1. Должен передаваться для ДП "Выбор задач из категории" (multilookup) в NTF |
ShowToHierarchy |
Имеет значение 1. Показывает кнопку "Отобразить в виде иерархии" |
Пример |
|
Задачи, которые могут быть выбраны в ДП Lookup с ID=27 ~/NewCustomGrid.aspx?TasksForExtParamID=27 Задачи, которые могут быть выбраны в ДП Multilookup с ID=36 ~/NewCustomGrid.aspx?TasksForExtParamID=36?MultiSelect=1 |
Название |
Описание |
---|---|
~NewCustomGrid.aspx |
|
Основной параметр |
|
TagId |
ID тега |
Дополнительные параметры |
|
EpVals |
JSON с ключом ExtParamId и значением ExtParamValue |
Название |
Описание |
---|---|
~NewCustomGrid.aspx |
|
Основной параметр |
|
CreatedTask |
Имеет значение 1 |
Дополнительные параметры |
|
DateStart |
Отбор по дате |
DateEnd |
|
Пример |
|
Задачи, созданные в марте 2020 ~/NewCustomGrid.aspx?CreatedTask=1?DateStart=01.03.2020?DateEnd=31.03.2020 |
Название |
Описание |
---|---|
~NewCustomGrid.aspx |
|
Основной параметр |
|
EndTime |
Имеет значение 1 |
Дополнительные параметры |
|
DateStart |
Отбор по дате |
DateEnd |
|
Пример |
|
Задачи, завершенные в марте 2020 ~/NewCustomGrid.aspx?CreatedTask=1?DateStart=01.03.2020?DateEnd=31.03.2020 |
Название |
Описание |
---|---|
~NewCustomGrid.aspx |
|
Основной параметр |
|
StateID |
ID статуса |
Дополнительные параметры |
|
DateStart |
Отбор по дате |
DateEnd |
|
Пример |
|
Задачи в статусе Отложено (ID=33) ~/NewCustomGrid.aspx?StateID=33 |
Название |
Описание |
|
---|---|---|
~NewCustomGrid.aspx |
||
Основной параметр |
||
UserID |
ID пользователя |
|
UserType |
Тип пользователя. Возможные значения: |
|
customers |
Задачи, где пользователь является заказчиком |
|
performers |
Задачи, где пользователь является исполнителем |
|
coworkers |
Задачи, где пользователь является подписчиком |
|
Дополнительные параметры |
||
DateStart |
Отбор по дате |
|
DateEnd |
||
Пример |
||
Задачи, где пользователь с ID-55 является заказчиком: ~/NewCustomGrid.aspx?UserID=55&UserType=customers |
Название |
Описание |
---|---|
~NewCustomGrid.aspx |
|
Основной параметр |
|
SummaryID |
ID сводного раздела |
Дополнительный параметр |
|
SmartFilterID |
ID общего смарт-фильтра с включенным признаком "Для смарт-поиска" |
Пример |
|
Задачи из сводного раздела с ID=33: ~/NewCustomGrid.aspx?SummaryID=33 |
Название |
Описание |
---|---|
~NewCustomGrid.aspx |
|
Основной параметр |
|
FavsFolderId |
ID папки |
Пример |
|
Задачи из папки Избранное с ID=33: ~/NewCustomGrid.aspx?FavsFolderID=33 |
Название |
Описание |
---|---|
~NewCustomGrid.aspx |
|
Основной параметр |
|
SmartQueryId |
ID папки |
Пример |
|
Задачи из папки Избранное с ID=33: ~/NewCustomGrid.aspx?SmartQueryID=33 |
Название |
Описание |
---|---|
~NewCustomGrid.aspx |
|
Основной параметр |
|
TickerId |
ID настроенного индикатора |
Пример |
|
Задачи по индикатору с ID=22: ~/NewCustomGrid.aspx?TickerID=22 |
Название |
Описание |
---|---|
All |
Имеет значение true. По умолчанию показывать все задачи, а не только активные |
ExtOptions |
Имеет значение all. Отличается от параметра All тем, что не записывается в БД и на него не влияют настройки самого пользователя: если параметр передан в строке, то всегда показываются все задачи |
ResizeByContent |
Имеет значение 1. Таблица не показывает полосу прокрутки (скролл), а занимает все место, которое ему нужно |
DontOpenFirstTask |
Имеет значение true или false. При значении false автоматически открывается первая задача в таблице |
HideToolBarAndGroupPanel |
Скрывает панель группировки задач и верхнюю панель инструментов |
Название |
Описание |
---|---|
~/NewTask.aspx ~/spa/link?url=%2FNewTask.aspx (в таком формате при передаче значений параметров вместо служебных символов нужно использовать коды) |
|
Основной параметр |
|
SubcatID |
ID категории, в которой создается задача |
Дополнительные параметры |
|
OrderedTime |
Срок. Если указывается, то значение для него передается в формате dd.MM.yyyy%20HH:mm (служебный символ %20 заменяет пробел) |
TemplateID |
ID нестандартного (пользовательского) шаблона карточки новой задачи |
ExtParamString |
Значения ДП. Передаются в строке следующего формата: ExtParamString=$Ext{ID_ДП_1}${значение_ДП_1}$Ext{ID_ДП_2}${значение_ДП_2}... Для ДП Multilookup передается массив значений в формате: ExtParamString=$Ext{ID_ДП}$[ID_задачи_1,ID_задачи_2,...] |
ParentID |
Родительская задача |
CommentID |
Первый комментарий в задаче |
UserID |
От пользователя |
LinkedID |
Связанная задача |
TaskText |
Текст задачи |
Примеры |
|
Создание новой задачи в категории с ID=22, ДП с ID=38 будет присвоено значение 15, а ДП с ID=23 будет присвоено значение "Иванов Иван Иванович": ~/NewTask.aspx?SubcatID=22&ExtParamString=$Ext38$15$Ext23$Иванов%20Иван%20Иванович Cоздание новой задачи в категории с ID=22 со сроком 18.08.2018 15:00: ~/NewTask.aspx?SubcatID=22&OrderedTime=18.08.2018%2015:00 Cоздание новой задачи в категории с ID=42 с использованием пользовательского шаблона 10: ~/NewTask.aspx?SubcatID=42&TemplateID=10 Создание новой задачи в категории с ID=33, в ДП Multilookup с ID=44 будут переданы задачи с номерами 77 и 88: ~/NewTask.aspx?SubCatID=33&ExtParamString=$Ext44$[77,88] Создание новой задачи в категории с ID=22, ДП с ID=38 будет присвоено значение 15: ~/NewTask.aspx?SubCatID=22&ExtParamString=$Ext38$15 Создание новой задачи в категории с ID=22, ДП с ID=38 будет присвоено значение 15: ~/spa/link?url=%2FNewTask.aspx%3FSubCatID%3D22%26ExtParamString%3D$Ext38$15 В таком формате нужно заменять служебные символы на коды (выделены голубым цветом). |
Название |
Описание |
---|---|
MainTaskForm.aspx |
|
Основной параметр |
|
TaskID |
ID задачи |
Дополнительные параметры |
|
TemplateID |
ID нестандартного (пользовательского) шаблона карточки новой задачи |
Примеры |
|
Открыть задачу с ID=123456 ~/MainTaskForm.aspx?TaskID=123456 Открыть задачу с ID=123456 с использованием пользовательского шаблона 55 ~/MainTaskForm.aspx?TaskID=123456&TemplateID=55 |
Лента
Название |
Описание |
---|---|
~/1FMain.aspx ~/spa/feeds/{extp} |
|
Дополнительные параметры |
|
extp |
Для ленты комментариев можно использовать параметр CommentsMode: •unread — вкладка Новые •lenta — вкладка Лента •myquestions — вкладка Исходящие •questionstome — вкладка Входящие |
Для ленты задач можно использовать параметр TasksMode: •new — вкладка Новые •lenta — вкладка Задачи •owner — вкладка Заказчик •performer — вкладка Иполнитель |
|
режим. Если задано значение CommentsMode или TasksMode, то режим указывается после него через символ | Возможные значения: •HideComments — выводится только лента задач •HideTasks — выводится только лента комментариев |
|
extp (для SPA) |
•default - лента задач и комментариев •tasks — лента задач •comments — лента комментариев •unread — лента комментариев, вкладка Новые •lenta — лента комментариев, вкладка Лента •questions — лента комментариев, вкладка Входящие |
Примеры |
|
Вывод ленты задач и комментариев: ~/1FMain.aspx Вывод ленты комментариев, вкладка "Новые": ~/1FMain.aspx?extp=CommentsMode:unread|HideTasks ~/spa/feeds/unread |
Название |
Описание |
---|---|
~/spa/tasks/subcat/{SubcatId}/feeds ~/spa/tasks/category/{CategoryId}/feeds Для обратной совместимости сохраняется поддержка устаревшего написания: ~/spa/feeds/subcat/{SubcatId} ~/spa/feeds/category/{CategoryId} |
|
|
|
SubcatId |
ID категории |
CategoryId |
ID раздела |
Примеры |
|
Вывод ленты задач в категории с ID=123: ~spa/tasks/subcat/123/feeds |
Название |
Описание |
---|---|
~/spa/chat/new?with={UserID,UserID,...}&name={chat_name}&msg={chat_message} ~/spa/chat/new?with={UserID}&with={UserID}&with={UserID}&name={chat_name}&msg={chat_message} |
|
Основной параметр |
|
with |
Список ID пользователей — участников чата, перечисленных через запятую. Можно использовать несколько параметров with |
Дополнительные параметры |
|
name |
Название чата |
msg |
Первое сообщение, которое будет опубликовано в чате сразу после создания |
Пример |
|
Создать чат с пользователями с ID=11 и 22, с названием "our chat" и с сообщением "hello": ~/spa/chat/new?with=11,22&name=our%20chat&msg=hello |
Название |
Описание |
---|---|
~/spa/subcat/{subcatId}/chat |
|
|
|
subcatId |
ID категории |
Пример |
|
Задачи в категории с ID=123 в представлении чата: ~/spa/subcat/123/chat |
Название |
Описание |
|
---|---|---|
~/app/v1.2/api/files/eps/{TaskID}/{EpFileId} |
||
|
||
TaskID |
ID задачи |
|
EpFileId |
ID ДП "Файл" |
|
Примечание |
||
|
||
Примеры |
||
Загрузка файла, вложенного в ДП с ID=456 в задаче с ID=789 ~/app/v1.2/api/files/eps/789/456 |
Название |
Описание |
---|---|
~/GetAttachment.ashx |
|
Основной параметр |
|
ID |
ID файла |
Дополнительные параметры |
|
GetTrueMime |
Если значение 1, то файл открывается для просмотра (в соответствии с типом mime). Если значение равно 0 или параметр не указан, то файл открывается для скачивания |
Version |
Номер версии. Если значение равно 1, то всегда будет открываться самая первая версия файла (например, для сравнения с шаблоном). Если значение не указано, будет открываться последняя версия файла |
Примеры |
|
Загрузить файл с ID=123 ~/GetAttachment.ashx?ID=123 Открыть для просмотра файл с ID=123 ~/GetAttachment.ashx?ID=123&GetTrueMime=1 Открыть для просмотра исходную (первую) версию файла с ID=123 ~/GetAttachment.ashx?ID=123&Version=1&GetTrueMime=1 |
Название |
Описание |
---|---|
~/GetAttachment.ashx |
|
Основной параметр |
|
TaskID |
ID задачи |
Примеры |
|
Загрузить файлы из задачи с ID=123456 ~/GetAttachment.ashx?TaskID=123456 |
Название |
Описание |
---|---|
~/GetThumbnail.ashx?id={fileId}&Square={0|1}&MaxSize={size} |
|
Параметры |
|
fileId |
ID файла с изображением |
size |
максимальная ширина или высота изображения в пикселях |
Square |
1 если изображение квадратное (ширина и высота изображения одинаковые), 0 если ширина и высота могут быть разными (при указании ограничения для большего измерения второе рассчитывается автоматически с сохранением исходных пропорций) |
Примеры |
|
Просмотр файла ~/GetThumbnail.ashx?id=999&Square=0&MaxSize=300 |
Название |
Описание |
---|---|
~/spa/tasks/ToSign/grid |
|
Примеры |
|
Просмотр списка запрошенных подписей ~/spa/tasks/ToSign/grid |
Название |
Описание |
---|---|
~/spa/dev/resolutions |
|
Пример |
|
Просмотр списка запрошенных подписей ~/spa/dev/resolutions |
Название |
Описание |
---|---|
~/Emails/EmailList.aspx |
|
Основной параметр |
|
FolderID |
ID почтовой папки |
Примеры |
|
Просмотр почтовой папки с ID=123 ~/Emails/EmailList.aspx?FolderID=123 |
Название |
Описание |
---|---|
~/Emails/EmailView.aspx |
|
Основной параметр |
|
EmailID |
ID письма |
Примеры |
|
Просмотр письма с ID=1234567 ~/Emails/EmailView.aspx?EmailID=1234567 |
Название |
Описание |
|||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
для портала Flex: ~/spaex.aspx/portal/{portalID}?{filter_parameters} для портала Dashboard: ~/spa/portal/{portalID}?{filter_parameters} или ~/spa/norfame/portal/{portalID}?{filter_parameters}
|
||||||||||||||||||||||
|
||||||||||||||||||||||
portalID |
ID портала |
|||||||||||||||||||||
Параметры |
||||||||||||||||||||||
Если для какого-то блока на портале настроен фильтр, можно передать значения параметров этого фильтра. Каждый параметр передается в виде: f{paramID}_v={paramValue} Если параметров несколько, они перечисляются через &. Форматы передачи значений для разных типов параметров фильтра:
Посмотреть ID параметра можно в настройках фильтра: ID параметра фильтра Параметры фильтра можно сделать доступными только для чтения, для этого используется модификатор _r (значение 1 делает параметр доступным только для чтения, значение 0 — нет): f{paramID}_r=1 |
||||||||||||||||||||||
Примеры |
||||||||||||||||||||||
Просмотр портальной страницы Flex с ID=123: ~/spaex.aspx/portal/123 Просмотр портальной страницы Flex с ID=123, где значение параметра с ID=99 равно zzz и его нельзя изменить (read only): ~/spaex.aspx/portal/123?f99_v=zzz&f99_r=1 Просмотр портальной страницы Dashboard с ID=123, где значение параметра с ID=88 равно 100, а значение параметра с ID=99 равно zzz: ~/spa/portal/123?f88_v=100&f99_v=zzz |
Название |
Описание |
|||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
~/spa/portal/block/{BlockID} |
||||||||||||||||||||||
Обязательный параметр |
||||||||||||||||||||||
BlockID |
ID виджета |
|||||||||||||||||||||
Дополнительные параметры |
||||||||||||||||||||||
TaskID |
ID задачи, если виджет вызывается в контексте карточки задачи |
|||||||||||||||||||||
Если для какого-то виджета настроен фильтр, можно передать значения параметров этого фильтра. Каждый параметр передается в виде: f{paramID}_v={paramValue} Если параметров несколько, они перечисляются через &. Форматы передачи значений для разных типов параметров фильтра:
Посмотреть ID параметра можно в настройках фильтра: ID параметра фильтра Параметры фильтра можно сделать доступными только для чтения, для этого используется модификатор _r (значение 1 делает параметр доступным только для чтения, значение 0 — нет): f{paramID}_r=1 |
||||||||||||||||||||||
Примечание |
||||||||||||||||||||||
|
||||||||||||||||||||||
Примеры |
||||||||||||||||||||||
Просмотр виджета с ID=123 ~/SinglePortalBlock.aspx?BlockID=123 или ~/spa/portal/block/123 Просмотр виджета с ID=123 в контексте задачи с ID=123456 ~/SinglePortalBlock.aspx?BlockID=123&TaskID=123456 Просмотр виджета с ID=123, параметр фильтра с ID=99 имеет значение 2 ~/SinglePortalBlock.aspx?BlockID=123&f99_v=2 |
Название |
Описание |
---|---|
~/spa/tasks/{taskId}/news |
|
|
|
taskId |
ID задачи с новостью |
Примеры |
|
Просмотр новости из задачи с ID=123456 ~/spa/tasks/123456/news |
Повестка дня
Устаревшее. Больше не используется. |
---|
Название |
Описание |
---|---|
~/spaex.aspx/agenda |
|
Пример |
|
~/spaex.aspx/agenda |
Название |
Описание |
---|---|
~/spa/tasks/{taskId}/timeline Отображение без панели инструментов и меню: ~/spa/noframe/tasks/{taskId}/timeline |
|
|
|
taskId |
ID задачи, для которой строится лента времени по связанным событиям |
Пример |
|
Просмотр ленты времени для задачи 123456: ~/spa/tasks/123456/timeline |
Название |
Описание |
---|---|
~/spa/tasks/subcat/{subcatId}/gantt ~/spa/tasks/category/{categoryId}/gantt |
|
|
|
subcatId |
ID категории |
categoryId |
ID раздела |
Пример |
|
Просмотр диаграммы Ганта для категории с ID=123: ~/spa/tasks/subcat/123/gantt |
Название |
Описание |
---|---|
~/spa/tasks/subcat/{subcatId}/calendar ~/spa/tasks/category/{categoryId}/calendar Открыть в iframe (без шапки): ~/Syndicate.aspx?forceURL=Scheduler.aspx?SubcatId={subcatId}&HideHeader=true ~/Syndicate.aspx?forceURL=Scheduler.aspx?CategoryId={categoryId}&HideHeader=true |
|
|
|
subcatId |
ID категории |
categoryId |
ID раздела |
Пример |
|
Просмотр календарного представления категории с ID=123: ~/spa/tasks/subcat/123/calendar Просмотр календарного представления категории с ID=123 во фрейме: ~/Syndicate.aspx?forceURL=Scheduler.aspx?SubcatId=123&HideHeader=true |
Название |
Описание |
---|---|
~/spa/kanban/{publicationAlias} |
|
|
|
publicationAlias |
alias публикации, описывающей структуру данных Канбан-доски, см. здесь |
Пример |
|
Просмотр Канбан-доски, описываемой публикацией kanban-structure: ~/spa/kanban/kanban-structure |
Название |
Описание |
---|---|
~/spa/tasks/subcat/{subcatId}/kanban Для обратной совместимости сохраняется поддержка устаревшего написания: ~/spa/kanban/subcat/{subcatId} |
|
|
|
subcatId |
ID категории |
Пример |
|
Просмотр Канбан-доски для категории с ID=123: ~/spa/tasks/subcat/123/kanban |
Название |
Описание |
---|---|
~/spa/user/kanban/performer/{UserId} |
|
|
|
UserId |
ID пользователя |
Примечание |
|
На канбан-доске отображаются: •не более 100 задач на сегодня, •не более 100 задач на завтра, •не более 100 задач, ближайших по сроку. При определении срока учитывается срок самой задачи, срок запрошенной в задаче подписи и запланированные трудозатраты |
|
Пример |
|
Просмотр Канбан-доски задач, где исполнителем является пользователь с ID=123 ~/spa/user/kanban/performer/123 |
Название |
Описание |
||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
~/MVC/ReportView/{ReportID}?{filter_params} ~/spa/report/{ReportId} |
|||||||||||||||||||||||
|
|||||||||||||||||||||||
ReportID |
ID отчета |
||||||||||||||||||||||
Дополнительные параметры |
|||||||||||||||||||||||
Если для какого-то отчета настроен фильтр, можно передать значения параметров этого фильтра. Каждый параметр передается в виде: f{paramID}v={paramValue} Если параметров несколько, они перечисляются через &. Форматы передачи значений для разных типов параметров фильтра:
ID параметра фильтра Параметры фильтра можно сделать доступными только для чтения, для этого используется модификатор (значение 1 делает параметр доступным только для чтения, значение 0 — нет): f{paramID}_r=1 |
|||||||||||||||||||||||
Примеры |
|||||||||||||||||||||||
Просмотр отчета с ID=123: ~/MVC/ReportView/123 Просмотр отчета с ID=456 с параметрами Group (ID параметра = 11, в него передаются группы с ID 888 и 999) и Period (ID параметра = 22, в него передается период c 1 по 10 октября 2018): ~MVC/ReportView/456?f11_Group_v=[888,999]&f22_Period_v=from:01.10.2018;to:10.10.2018 |
Название |
Описание |
||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
~/MVC/ReportExport/{ReportID}?format={export_format}&{filter_params} |
|||||||||||||||||||||||
|
|||||||||||||||||||||||
ReportID |
ID отчета |
||||||||||||||||||||||
format |
Возможные форматы экспорта: pdf, html, csv, image (файл jpg), dbf, xml, json, mht, odf, ods, odt, xls, docx, rtf, pptx, xaml, txt, svg, ps, ppml |
||||||||||||||||||||||
Дополнительные параметры |
|||||||||||||||||||||||
Если для какого-то отчета настроен фильтр, можно передать значения параметров этого фильтра. Каждый параметр передается в виде: f{paramID}v={paramValue} Если параметров несколько, они перечисляются через &. Форматы передачи значений для разных типов параметров фильтра:
ID параметра фильтра Параметры фильтра можно сделать доступными только для чтения, для этого используется модификатор (значение 1 делает параметр доступным только для чтения, значение 0 — нет): f{paramID}_r=1 |
|||||||||||||||||||||||
Примеры |
|||||||||||||||||||||||
Экспорт отчета с ID=123 в формате pdf: ~MVC/ReportExport/123?format=pdf Экспорт отчета с ID=456 в формате jpg, с параметром Status (ID=99) со значением 2: ~MVC/ReportExport/456?format=image&f99_Status_v=2 |
Название |
Описание |
---|---|
~/spa/org/list/{publicationAlias} |
|
|
|
publicationAlias |
название публикации, возвращающей список сотрудников. В настоящее время используется публикация workers |
Пример |
|
Просмотр списка сотрудников: ~/spa/org/list/workers |
Название |
Описание |
---|---|
~/spa/user/profile/{userId} |
|
|
|
userId |
ID пользователя |
Пример |
|
Просмотр профиля пользователя с ID=99: ~/spa/user/profile/99 |
Оргструктура
Название |
Описание |
---|---|
~/spa/org/chart/ ~/spa/org/chart/{publicationAlias} |
|
|
|
publicationAlias |
Название публикации, которая возвращает данные по орг.структуре |
Пример |
|
Просмотр орг.структуры со стандартным набором данных: ~/spa/org/chart/ Просмотр орг.структуры с данными, формируемыми публикацией foreign_offices: ~/spa/org/chart/foreign_offices |
Иерархия
Название |
Описание |
---|---|
~/TaskHierarchies/TaskHierarchy.aspx |
|
Основной параметр |
|
ID |
ID иерархии |
Дополнительный параметр |
|
RootTaskId |
ID головной задачи |
Пример |
|
Просмотр иерархии с ID=123: ~/TaskHierarchies/TaskHierarchy.aspx?id=123 Просмотр иерархии с ID=123 с корневой задачей с ID=123456: ~/TaskHierarchies/TaskHierarchy.aspx?id=123&RootTaskId=123456 |
Название |
Описание |
---|---|
~spa.aspx/scheduler/{ID} |
|
Основной параметр |
|
ID |
ID планировщика |
Пример |
|
Просмотр планировщика с ID=123: ~spa.aspx/scheduler/123 |
Файловое хранилище
Название |
Описание |
|
---|---|---|
Просмотр начиная с корневой папки: ~/spaex.aspx/file-storage Просмотр начиная с выбранной папки, без дерева папок слева и без возможности подняться выше начального уровня: ~/spaex.aspx/file-storage/{FolderType}/{FolderId} Просмотр файлов в разделе, категории, задаче: ~/spaex.aspx/file-storage/Category/{CategoryID} ~/spaex.aspx/file-storage/Subcategory/{SubcatID} ~/spaex.aspx/file-storage/album/{TaskID} |
||
|
||
FolderType |
Возможные значения типа папки: |
|
Root |
корневая папка хранилища |
|
Folder |
папка в разделе "Общие файлы" |
|
UserRoot |
раздел "Мои файлы" |
|
UserFolder |
папки внутри раздела "Мои файлы" |
|
Shared |
раздел "Файлы пользователей" (доступен в том случае, если какой-либо пользователь предоставил вам доступ к своим личным файлам и папкам) |
|
TaskRoot |
раздел "Файлы в задачах" |
|
Category |
раздел |
|
Subcategory |
категория |
|
Task |
задача |
|
LinkedToTask |
папка, привязанная к задаче с помощью смарт-действия "Связать файловую папку с задачей |
|
FolderID |
ID папки, начиная с которой отображается структура файлового хранилища |
|
Category |
ID раздела, для которого отображается структура файлового хранилища |
|
Subcategory |
ID категории, для которой отображается структура файлового хранилища |
|
Дополнительные параметры |
||
View |
gallery — режим "Галерея" |
|
onlySpaStyles |
Имеет значение 1. Просмотр начиная с корневой папки |
|
showlefttree |
Имеет значение 1. Включает отображение левой панели с деревом папок и кнопкой поиска |
|
Пример |
||
Просмотр файлового хранилища с деревом папок и кнопкой поиска: ~/spaex.aspx/file-storage?showlefttree=1 Файлы в разделе с ID=555: ~/spaex.aspx/file-storage/Category/555?onlySpaStyles=1 Файлы в разделе с ID=555 в режиме "Галерея": ~/spaex.aspx/file-storage/Category/555?onlySpaStyles=1&view=gallery Файлы в категории с ID=777: ~/spaex.aspx/file-storage/Subcategory/777?onlySpaStyles=1 Просмотр файлов в задаче с ID=123456; ~/spaex.aspx/file-storage/album/123456?onlySpaStyles=1 |
Название |
Описание |
---|---|
~/spaex.aspx/file-storage/{FolderId} |
|
|
|
FolderID |
ID папки |
Пример |
|
Просмотр папки с ID=555: ~/spaex.aspx/file-storage/555 |
Название |
Описание |
---|---|
~/spaex.aspx/file-storage/{FolderId}?fileid={FileId} |
|
|
|
FolderId |
ID папки |
Параметр |
|
FileId |
ID файла |
Пример |
|
Просмотр файла с ID=123 из папки с ID=555: ~/spaex.aspx/file-storage/555?fileid=123 |