MultiMaps > Сбор данных >
Макроязык движка сбора данных
PreviousNext

Вы можете начать использовать макроязык без его изучения, с помощью Мастера макроязыка, который позволит вам быстро конструировать необходимые критерии сбора данных. И вы их просто копируете в примечания тем с критериями сбора.

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


Внимание! С версии MultiMaps 6.1 изменен синтаксис макроязыка!

Ранее двоеточие применялось для разделения как операторов, так и параметров. С таким синтаксисом макроязык не может далее развиваться. Сейчас операторы отделяются друг от друга переводом строки или символами ">>", а параметры - двоеточием.

Ранее: week:0:complete:100:resource:Иванов

Сейчас: weeks:0 >> complete:100 >> resource:Иванов

Кроме этого, изменен также синтаксис некоторых операторов. Например, ранее: requirestartdate, сейчас: require:startdate. Операторы с измененным синтаксисом обозначены ниже в таблице красным цветом. Теоретически они почти все будут продолжать работать, но через какое-то время перестанут.

Также добавлено довольно много новых операторов.

! В версии 7.x.x.x изменен синтаксис операторов дат. Добавлены новые операторы: сортировка собранных данных, управления ролями ресурсов, стоимость задачи, тарифная ставка ресурса, приоритет, ссылки и вложения. Для всех численных значений добавлены операторы сравнения: ">", ">=", "<", "<=".

Если в ваших картах применяются ключевые слова с операторами макроязыка, обязательно сверьте их с новой версией!

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

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

Таким образом, мы имеем совсем небольшой, но язык программирования.

Как и любой язык, он состоит из операторов (кодовые слова) и их параметров.

Можно употреблять один оператор для каждой темы, а можно конструировать кодовую фразу из нескольких операторов. Таким образом, можно даже в одной теме задать каскад фильтров.

С помощью этого макроязыка вы можете настроить критерии сбора чрезвычайно гибко.

Операторы отделяются друг от друга переводом строки (каждый оператор на новой строке), либо символами ">>". Параметры определяются через двоеточия.

Движок смотрит в примечания темы сбора - начинаются ли они с какого-то из знакомых ему операторов. Если да, то он начинает обработку операторов, пока не встретит один из знаков, сообщающих ему о том, что дальше операторов уже нет (дальше может быть просто любой текст пользователя, обычно - пояснение для темы сбора).

Знаками окончания блока операторов могут быть:

; (точка с запятой)

слово "comment"

Пример программирования ключевого слова через его примечания:

days:1
;
Собираются задачи, по своим датам попадающие под завтрашний день

или так:

weeks:0
complete:100
resource:Иванов

comment: Собираются завершенные задачи, по своим датам попадающие в эту неделю. Ответственный - Иванов.

предыдущий блок можно записать и так:

weeks:0 >> complete:100 >> resource:Иванов
;
Собираются завершенные на этой неделе задачи с ресурсом "Иванов".
(здесь операторы разделены символами ">>")

Больше примеров вы найдете в конфигурационной карте.

В каком точно порядке работает движок сбора данных смотрите здесь.

Для лучшего понимания действия операторов нужно понимать отличие стандартной темы карты от темы-задачи.

Задача - это тема, имеющая хотя бы один из атрибутов, заданных в настройках MultiMaps. Если ни один из этих атрибутов не присутствует на теме, это не задача.

Ниже таблица операторов, которым обучен движок сбора данных.

Даты                     Задачи              Текст темы                Регистр

Ресурсы                Теги                       Ссылки/Вложения      Свойства темы

Значки                  Сортировка       Управление копированием          

Прочие операторы

Оператор Значение
Даты ! Все операторы из этого раздела взаимоисключающие. Если определено больше одного, "победит" последний.
Если нужен сбор по нескольким диапазонам времени, определите нужные диапазоны в разных темах сбора.
days:N
weeks:N
months:N
собираются задачи, по датам попадающие под выполнение в заданный период времени.

можно задать день/неделю/месяц. N - смещение от текущего(0).

days:0 = сегодня, days:1 = , days:-2 = позавчера, и т.д.
weeks:0 = текущая неделя, weeks:1 = следующая неделя
months:0 = текущий месяц, months:-1 = прошлый месяц

Можно применять Операторы Сравнения: ">", ">=", "<" и "<=".
Например, days:<0 - все задачи в прошлом до сегодняшнего дня; months:>= 1 - все задачи в будущем с первого числа следующего месяца.
days:N-M
weeks:N-M
months:N-M
второй параметр расширяет диапазон дней/недель/месяцев.

days:0-6 = сегодня и следующие 6 дней

Отрицательные числа заключаются в скобки - без знака минус! Иначе получится конфликт между минусом и тире.

days:(3)-(1) = прошедшие три дня (от -3 до -1),
days:(5)-5 = прошлые 5 дней + следующие 5 дней
и т.д.

Аналогично для недель и месяцев.

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

Пример: ключевое слово Ближайшие три дня (days:0-2) в конфигурационной карте.
today синоним для day:0
tomorrow синоним для day:1
yesterday синоним для day:-1
Задачи Задачи это темы, имеющие хотя бы один из атрибутов задачи. Обычно это Ход выполнения, даты, трудозатраты или ресурcы.

В настройках MultiMaps вы можете указать, какие из этих атрибутов должна иметь тема, чтобы считаться задачей.

task

собирает темы- задачи

Тема-задача
- это тема, имеющая хотя бы один из атрибутов, заданных в настройках MultiMaps. Если ни один из этих атрибутов не присутствует на теме, это не задача.

project

собирает темы, на которых есть значок проекта

subproject

собирает темы, на которых есть значок подпроекта

require:startdate

require:duedate

require:startdateonly

require:duedateonly

require:anydate

require:bothdates

require:nodates

Собрать темы, у которых есть:

startdate - дата начала
duedate - дата окончания
startdateonly - только дата начала
duedateonly - только дата окончания
anydate - любая (одна) из дат
bothdates - обе даты

nodates - собрать темы, на которых нет дат. Осторожно! Без дополнительного фильтра могут быть собраны практически все темы из ваших карт!

Например, используйте подобную конструкцию:
task >> require:nodates - соберет задачи, у которых нет дат.

nodates
task:nodates
startdate, duedate
bothdates, anydate
requirestartdate
requireduedate

устаревшие! не применять!
Использовать операторы, указанные выше

match:startdate

match:duedate

match:bothdates

match:anydate

! Все операторы здесь взаимоисключающие. Если определено больше одного, "победит" последний.

собираются темы, у которых в диапазон попадают указанные даты. Например, на теме ключевое слово - Эта неделя, а в примечаниях темы стоит этот оператор. В этом случае будут собираться задачи, которые:

startdate: начинаются на этой неделе
duedate: заканчиваются на этой неделе
bothdates: начинаются И заканчиваются на этой неделе
anydate: либо начинаются, либо заканчиваются на этой неделе. Этот параметр применяется по умолчанию (если оператор match отсутствует).

overdue

собирает просроченные задачи: Прогресс менее 100% (либо нет значка Прогресса) И дата окончания ранее, чем сегодня.

Пример: ключевое слово Просроченные в конфигурационной карте надстройки.

duration:min:N[-M]

duration:hours:N[-M]

duration:days:N[-M]

duration:weeks:N[-M]

duration:months:N[-M]

собирает задачи, имеющие указанную в параметрах длительность задачи. N, M - количество единиц времени (или диапазон времени).

duration:hours:4 - собираются задачи, длительность которых составляет 4 часа
duration:weeks:1 - собираются задачи, длительность которых составляет 1 неделю
duration:days:1-3 - собираются задачи, длительность которых составляет от 1 до 3 дней

Можно применять следующие Операторы Сравнения: ">", ">=", "<" и "<=".
Например, duration:days:>2 - длительность задачи более двух дней.

effort:min:N[-M]

effort:hours:N[-M]

effort:days:N[-M]

effort:weeks:N[-M]

effort:months:N[-M]

собирает задачи, имеющие указанные трудозатраты.
N, M - количество единиц времени (или диапазон времени).

Примеры:
effort:min:15 - собираются задачи, на которых стоят трудозатраты 15 минут.
effort:min:15-30 - собираются задачи, на которых стоят трудозатраты от 15 до 30 минут
effort:hours:1-4 - собираются задачи, на которых стоят трудозатраты от 1 до 4 часов
effort:days:1 - собираются задачи, на которых стоят трудозатраты 1 день

Можно применять следующие Операторы Сравнения: ">", ">=", "<" и "<=".
Например, effort:min:<=30 - трудозатраты полчаса или меньше.

priority:N[-M]

собирает темы с приоритетом N или в диапазоне N-M

N и M могут быть от 0 до 9

prority:1

priority:1-3


Можно применять Операторы Сравнения: ">", ">=", "<" и "<=".
Например, prority:>2 - соберет темы с приоритетом выше 2.

priority:0 - собрать темы без приоритета. Осторожно! Без дополнительного фильтра могут быть собраны практически все темы из ваших карт!

Например, можно использовать подобную конструкцию:
weeks:0
priority:0
соберет задачи на эту неделю, у которых нет приоритета.

complete:N[-M]

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

Примеры:
complete:50 --- соберет все задачи c Прогрессом 50%.
complete:0-50 --- соберет все задачи с Прогрессом от 0 до 50%
complete:0-99 --- соберет все незавершенные задачи

Можно применять Операторы Сравнения: ">", ">=", "<" и "<=".
Например, complete:<=50 - Прогресс 50% или менее.

complete:-1 - собрать темы без Хода выполнения. Осторожно! Без дополнительного фильтра могут быть собраны практически все темы из ваших карт!

Например, используйте подобную конструкцию:

weeks:0
complete:-1

будут собраны задачи на эту неделю, у которых нет значка Хода выполнения.

Примечание: complete:(1)-99 соберет темы, у которых Ход выполнения менее 100%, а также темы, на которых нет значка Хода выполнения. (1) представляет значение -1 (правило ввода отрицательного числа в диапазоне чисел), которое сообщает, что Ход выполнения может быть -1, что означает отсутствие значка Хода выполнения - см. выше.

costs:general:N[-M]

costs:resources:N[-M]

costs:total:N[-M]

собирает темы, имеющие соответствующие:

general - общие расходы
resources - расходы на ресурсы
total - итоговые расходы

costs:general:15000 - соберет задачи, у которых общие расходы составляют 15 тысяч.
costs:resources:20000-30000 - задачи, у которых расходы на ресурсы составляют от 20 до 30 тысяч.

В случае, если указываются два значения (разделенные знаком "-") отрицательные числа заключаются в скобки - без знака минус! Иначе получится конфликт между минусом и тире.

costs:total:(30000)-0 - соберет задачи, у которых итоговые расходы от - 30000 до 0.

Можно применять следующие Операторы Сравнения): ">", ">=", "<" и "<=".
Например: costs:total:>= 30000- соберет задачи, у которых расходы 30 тысяч или более.

require:generalcosts

require:resourcescosts

require:generalcostsonly

require:resourcescostsonly

require:anycosts

require:bothcosts

require:nocosts

Собрать темы, у которых есть:

generalcosts - общие расходы
resourcescosts - расходы по ресурсам
generalcostsonly - только общие расходы
resourcescostsonly - только расходы по ресурсам
anycosts - любые расходы или оба
bothcosts - оба расхода

nocosts - собрать темы, на которых нет расходов. Осторожно! Без дополнительного фильтра могут быть собраны практически все темы из ваших карт!

Например, используйте подобную конструкцию:
task >> require:nocosts - соберет задачи, у которых нет расходов.
deadline устаревшее! не применять!
rollup собирает темы, для которых включен чекбокс "Комбинировать информацию о задании" (в панели задач "Информация о задании")
asap
(as soon as possible)
(при первой возможности)
собирает задачи, на которых стоит только одна дата, либо нет дат.

Такие задачи называются "Возможные". Срок их исполнения точно не определен (поскольку одна дата или нет дат). поэтому выполнять их следует либо начиная с даты начала, либо до даты окончания, в любое подходящее время.

Пример: на теме сбора указан период Эта неделя, и в примечаниях стоит этот оператор.

При сборе:
(1) если у задачи есть только дата начала, и она ранее или внутри текущей недели, возможно, ей уже следует заняться. Задача попадает в сбор;
(2) если у задачи есть только дата окончания, и она позже или внутри текущей недели, возможно, ей следует заняться. Задача попадает в сбор;
(3) если у задачи нет дат, задача также попадает в сбор. Когда-то ведь ей нужно заняться?

Этот оператор стоит в ключевом слове Возможные в конфигурационной карте надстройки.
advance собирает темы (вместе с их подтемами), на которых стоят значки и .

Эти значки означают, что это суммарная задача (состоит из подзадач), и она еще не до конца проработана (нужно определить ее подзадачи, определить шаги).

Если задача имеет дату начала, то она попадет в сбор, когда эта дата окажется ранее или внутри указанного в ключевом слове периода.

С этим оператором следует также использовать оператор branch, чтобы была собрана не только тема с этими значками, но и вся ее ветка. Т.е.: advance >> branch

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

topicname

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

См. пример в конфигурационной карте в ключевом слове Входящие.

topictext:ТЕКСТ

topictext:wholeword:ТЕКСТ

topictext:условие:ТЕКСТ

topictext:условие:wholeword:ТЕКСТ

 

topicnotestext:

 

topicornotestext:

topictext:завтра собрание - собирает темы, текст которых в точности равен "завтра собрание".

Также можно собирать темы, текст которых:

contains - содержит ТЕКСТ
startswith - начинается с ТЕКСТ
endswith - заканчивается на ТЕКСТ
equals - в точности совпадает с ТЕКСТ

topictext:contains:собрани
- собирает темы, текст которых содержит "собрани" (собрание, собрания, собранием и т.п.).

Также можно использовать параметр wholeword. В этом случае ищется ТЕКСТ как целое слово (то есть именно слово "текст", а не слова "текстовый", "текстура" и пр.).

topictext:startswith:wholeword:срочно - собирает темы, текст которых начинается с целого слова "срочно".

При поиске регистр текста по умолчанию не учитывается. Но если нужно учитывать, добавьте оператор casesensitive:topictext

topicnotestext: собирает темы, содержащие указанный текст в примечаниях темы. Синтаксис точно такой же, как у topictext

topicornotestext: собирает темы, содержащие указанный текст в тексте темы или в ее примечаниях. Синтаксис точно такой же, как у topictext

topicornotestext:contains:собрани - собирает темы, которые содержит текст "собрани" (собрание, собрания, собранием и т.п.) в тексте темы или в ее примечаниях.
Регистр Операторы, отвечающие за чувствительность регистра при поиске текста

casesensitive:topictext

casesensitive:resources

casesensitive:properties

casesensitive:tags

casesensitive:all

casesensitive

В MindManager имена ресурсов, тегов и Свойств темы чувствительны к регистру. Т.е. ресурс "Росс" и ресурс "росс" это разные ресурсы. Тег "Сделано" и тег "сделано" это разные теги. Свойство "Расходы" и свойство "расходы" это разные Свойства.

По умолчанию, при сборе данных регистр не учитывается: если на теме сбора указан ресурс "Росс", то будут собраны как темы с ресурсом "Росс", так и темы с ресурсом "росс".

Этот оператор позволяет учитывать регистр букв для следующих критериев:

topictext - текст темы и примечаний темы
resources - имя ресурса
properties - название и текстовое значение свойства темы
tags - название тега и название группы тегов

Например, если на теме сбора стоит ресурс "Росс", а в примечаниях оператор casesensitive:resources, то будут собраны темы с ресурсом "Росс", но не будут собраны темы с ресурсом "росс"!

casesensitive:all или casesensitive учитывает регистр для всех вышеуказанных критериев.
Ресурсы

Имя ресурса:

 

resource:имя1[, имя2, имя3...]

resource:me

собирает темы с указанными ресурсами

resource:Иванов
собирает темы с ресурсом "Иванов"

resource:Иванов, Петр Петров, Н.И. Кузнецов
собирает темы с указанными ресурсами

resource:me

Собирает темы, на которых ресурсом назначены вы. Перед тем, как использовать этот оператор, вы должны обязательно определить свое имя в настройках MultiMaps, в поле "resource:me".

Допустима конструкция:
resource:Иванов, me, Петр Петров

!
При поиске роль ресурса игнорируется. Например, Рогов имеет роль Заказчик и на теме выглядит как ЗКРогов. Это не помешает движку сбора данных найти его с помощью оператора resource:Рогов

Роль ресурса:

 

resource:hasrole

resource:hasrole:роль

resource:hasrole - собираются темы, у которых есть ресурс(ы) с ролью.

resource:hasrole:Заказчик - собираются темы, у которых есть ресурс(ы) с ролью Заказчик.

Также можно указать префикс роли:
resource:hasrole:ЗК

Имя и роль ресурса:

 

resource:имя:роль
resource:me:роль

resource:имя:norole

resource:Петров:заказчик - соберет задачи, на которых Петров имеет роль Заказчик (например, на теме выглядит как ЗКПетров).

resource:me:делегировал - соберет задачи, на которых я имею роль Делегировал.

Роль должна быть прописана в списке ролей.

Чтобы собрать только те ресурсы, которые не имеют роли, укажите norole:

resource:Петров:norole

соберет темы с ресурсом Петров, который не имеет никакой роли (ЗКПетров, @Петров будут проигнорированы).

Имя ресурса по условию:

 

resource:условие:ТЕКСТ

resource:условие:
ТЕКСТ:роль

resource:условие:
ТЕКСТ:norole

собираются темы, у которых есть ресурс, имя которого подпадает под условие:

contains - содержит ТЕКСТ
startswith - начинается с ТЕКСТ
endswith - заканчивается на ТЕКСТ
equals - в точности совпадает с ТЕКСТ

resource:contains:иван
соберет темы, у которых есть ресурс: Иванов или Иван Рогов или Поливанов.

!При поиске роль игнорируется. Например, Рогов имеет роль Заказчик, и на теме выглядит как ЗКРогов. Это не помешает движку сбора данных найти его с помощью оператора resource:startswith:Рогов.

Конструкция resource:startswith:ЗКРогов будет искать
ресурс ЗКРогов (т.е. роль не игнорируется).

Чтобы собрать только те ресурсы, которые не имеют роли, укажите norole:

resource:contains:иван:norole

Ставка ресурса:

 

resource:rate:hour:N[-M]

resource:rate:day:N[-M]

resource:rate:week:N[-M]

resource:rate:usage:N[-M]

собираются темы с ресурсами, у которых ставка ресурса находится в указанном диапазоне.

resource:rate:hour:500 - соберутся ресурсы, у которых ставка 500 в час.

resource:rate:day:2000-4000 - соберутся ресурсы, у которых ставка от 2000 до 4000 в день.

Можно применять следующие Операторы Сравнения): ">", ">=", "<" и "<=".
Например: resource:rate:hour>=300 - соберет задачи с ресурсами, у которых ставка в час 300 или больше.

Подробнее о ставках ресурса см. в Справке MindManager (Управление ресурсами).

resources:all

resources:any

resources:yes

resources:no

all - собирает темы, на которых есть все ресурсы, присутствующие на теме сбора и/или указанные операторами resource

any - собирает темы, на которых есть любой из ресурсов, присутствующий на теме сбора и/или указанный операторами resource. Этот оператор используется по умолчанию

yes - собирает темы, на которых есть ресурсы

no - собирает темы-задачи, на которых нет ресурсов
resources Устаревший! Исправить в своих картах! Использовать resources:yes.
resources_me Устаревший! Исправить в своих картах! Использовать resource:me.
no_resources Устаревший! Исправить в своих картах! Использовать resources:no.

ignoreresource:

при сборе данных темы с указанными ресурсами игнорируются.

Синтаксис оператора абсолютно такой же, как у оператора resource (см. выше).

ignoreresource:Иванов
тема с ресурсом Иванов будет проигнорирована при сборе

ignoreresource:Иванов, Петр Петров, Н.И. Кузнецов
при сборе будут проигнорированы темы с указанными ресурсами

ignoreresource:contains:иван
ignoreresource:contains:иван:norole


и т.д. См. выше оператор resource

ignoreresources:all

ignoreresources:any

all - при сборе игнорируются темы, на которых есть все ресурсы, указанные в операторах ignoreresource.

any - при сборе игнорируются темы, на которых есть любой из ресурсов, указанных в операторах ignoreresource. Этот оператор используется по умолчанию.
Теги

tag:ИмяГруппы

tag:ИмяГруппы:ИмяТега

tag:tagname:ИмяТега

 

 

Формат с условием:

tag:groupname|tagname:
условие:ТЕКСТ

собирает темы, на которых есть указанные теги

Упрощенный вариант: первый параметр всегда имя группы тегов, второй - имя тега:

tag:Контексты соберет темы, на которых есть любой из тегов группы Контексты.

tag:Контексты:Телефон соберет темы, на которых есть тег "Телефон" из группы тегов "Контексты".

Во всех остальных случаях обязательно указывается оператор имени группы тегов: groupname и оператор имени тега: tagname

tag:tagname:готово соберет темы с тегом "готово" из любой группы тегов.



Операторы с условием собирают темы, у которых имя группы тегов или имя тега:

contains - содержит ТЕКСТ
startswith - начинается с ТЕКСТ
endswith - заканчивается на ТЕКСТ
equals - в точности совпадает с ТЕКСТ

tag:groupname:contains:Стад - соберет темы, у которых группа тегов содержит текст "стад" (Стадии или Стадионы или Стада)

tag:groupname:contains:Стад:tagname:contains:обраб - соберет темы, у которых группа тегов содержит текст "стад" и имя тега содержит "обраб" (Обработано или Обработка или В обработке)

tag:tagname:contains:обраб - соберет темы, у имя тега содержит "обраб". Группа тегов (в данном случае) не важна.

Если нужно учитывать регистр букв, используйте оператор casesensetive:tags (см. выше).

Можно указать несколько тегов:

tag:Контексты:Телефон
tag:tagname:обработка
tag:groupname:contains:Стад:tagname:contains:обраб

и т.д.

Будут собраны темы, на которых есть любой из указанных тегов.

Оператором tags:all (см. ниже) можно указать, чтобы собирались темы, на которых есть все указанные теги.
tags:ГруппаТегов Устаревший! Исправить в своих картах!
Использовать tag:ГруппаТегов

tags:all

tags:any

tags:yes

tags:no

all - собирает темы, на которых есть все теги, присутствующие на теме сбора и/или указанные операторам tag.

any - собирает темы, на которых есть любой из тегов, присутствующий на теме сбора и/или указанный операторам tag. Этот оператор используется по умолчанию.

yes - собирает темы, на которых есть теги.

no - собирает темы, на которых нет тегов.

ignoretag:

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

Синтаксис оператора абсолютно такой же, как у оператора tag (см. выше).

ignoretag:Контексты:Телефон - темы с тегом Телефон из группы тегов Контексты будут исключены из сбора.

ignoretag:Контексты - темы, на которых есть любой тег из группы тегов Контексты, будут исключены из сбора.

ignoretag:tagname:Обработка - темы, на которых есть тег Обработка (из любой группа тегов), будут исключены из сбора.

Точно так же, как в операторе tag, можно применять условия.

Точно так же, как в операторе tag, возможна конструкция из нескольких операторов.

ignoretags:all

ignoretags:any

all - темы, на которых присутствует все теги, указанные в операторах ignoretag, исключаются из сбора

any - темы, на которых присутствует любой из тегов, указанный в операторах ignoretag, исключаются из сбора
Значки

icons:all

icons:any

all - собирает темы, на которых присутствуют все значки, имеющиеся на теме сбора

any - собирает темы, на которых присутствуют любой из значков, имеющихся на теме сбора. Этот оператор применяется по умолчанию

ignoreicons:all

ignoreicons:any

all - темы, на которых присутствуют все значки, имеющиеся в теме сбора, исключаются из сбора.

any - темы, на которых присутствует любой из значков, имеющихся в теме сбора, исключаются из сбора.

Важно! Если используются операторы ignoreIcons, значки на теме сбора не для того, чтобы собирать темы, на которых есть эти значки, а для того, чтобы игнорировать темы, на которых есть эти значки!
Ссылки/Вложения

hyperlink:map

hyperlink:cloudmap

hyperlink:web

hyperlink:word

hyperlink:excel

hyperlink:pdf

hyperlink:email

hyperlink:folder

hyperlink:topic

hyperlink:anyfile

hyperlink:anylink

 

attachment:map

attachment:word

attachment:excel

attachment:pdf

attachment:anyfile

 

tolinkswindow

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

hyperlink:word - ссылка на документ Word

hyperlink:web - ссылка на веб-страницу

hyperlink:email - ссылка на адрес email

hyperlink:cloudmap - ссылка на карту в облачном хранилище

attachment:map - прикреплена карта MindManager

attachment:anyfile - прикреплен любой файл

hyperlink:anylink - любая ссылка на теме (включая ссылки на веб-страницу, на папку, на email), кроме ссылки на тему карты. Ссылка на тему карты должна быть явно указана оператором hyperlink:topic.

hyperlink:anyfile - ссылка на любой файл (на карту, документ, текстовый файл и т.д.).
Темы со ссылками на веб-страницу, на папку, на email, на тему в карте будут проигнорированы

Также можно указать текст, который должен содержаться в имени файла ссылки/вложения (или в ссылке на веб-страницу):

hyperlink:word:contains:управлен - собирает темы, на которых есть ссылка на документ Word, и в имени файла есть текст "управлен"

hyperlink:web:contains:youtube - собирает темы, на которых есть веб-ссылка на ролик youtube

Возможна конструкция из нескольких операторов:

hyperlink:word
hyperlink:web:contains:youtube
attachment:map


Будут собраны темы, у которых есть любая из указанных ссылок или вложений.

tolinkswindow - собирать темы со ссылками в Окно ссылок.
Свойства темы

property:ИмяСвойства

property:ИмяСвойства:
Значение

property:ИмяСвойства:
Значение:ТипСвойства

 

 

 

Формат с условием:

property:name:условие:ТЕКСТ
value:условие:ТЕКСТ:
type:ТипСвойства

собирает темы, на присутствуют указанные Свойства.

Упрощенный вариант: первый параметр всегда имя свойства, второй - значение Свойства:

property:Город - ищет темы, которые имеют Свойство с названием "Город", значение и тип Свойства не важны.

property:Город:Сочи - ищет темы, которые имеют Свойство с названием "Город", значение Свойства - "Сочи", тип Свойства неважен.

property:Город:Сочи:text - ищет темы, которые имеют Свойство с названием "Город", значение Свойства - "Сочи", и имеют тип Свойства "Текст" (или "Многострочный текст", или "Список").

Тип Свойства может быть: text (Текст, Многострочный текст, Список), currrency или cur (Валюта), number (Число), integer (Целое число).

Если тип Свойства числовой, значением может быть также диапазон чисел, например:property:Расходы:0-20000:cur, будут собираться темы, в которых значение будет от 0 до 20000 и тип Свойства - валюта.

Во всех остальных случаях обязательно указываются операторы имени Свойства: name, значения Свойства: value и типа Свойства: type.

property:value:Сочи - ищет темы, которые имеют значение Свойства - "Сочи", название и тип Свойства неважен.

property:type:number - ищет темы, которые имеют тип Свойства - Число. Имя Свойства и значение неважны.

Возможна конструкция из нескольких операторов:

property:Расходы:0-10000
property:Город:Сочи

Будут собраны темы, в которых есть какое-либо из указанных Cвойств.

Вы можете указать, чтобы собирались темы, в которых есть все указанные Cвойства. Это делается с помощью оператора properies:all. См. ниже.

В случае, если указываются два значения (разделенные знаком "-") отрицательные числа заключаются в скобки - без знака минус! Иначе получится конфликт между минусом и тире.

property:Расходы:(10000)-0 - ищет темы, у которых значение свойства Расходы oт -10000 до 0.

Можно применять следующие Операторы Сравнения): ">", ">=", "<" и "<=".
Например: property:Расходы:>10000 - ищет темы, у которых значение свойства Расходы больше 10000.



Операторы с условием собирают темы, у которых имя Свойства (name) или значение Свойства (value) попадает под условие:

contains - содержит ТЕКСТ
startswith - начинается с ТЕКСТ
endswith - заканчивается на ТЕКСТ
equals - в точности совпадает с ТЕКСТ

Эти операторы работают только с именем Свойства и с текстовым значением Свойства.

property:name:contains:расход - соберет темы, у которых есть Свойство с именем Расходы или Расход или Расходовано.

Возможны конструкции:

property:name:ТЕКСТ1:value:contains:ТЕКСТ2
property:value:startswith:ТЕКСТ1:name:contains:ТЕКСТ2
property:ИмяСвойства:
Тип:Значение
Устаревший! Исправить в своих картах!
Использовать формат, описанный выше.

properties:all

properties:any

properties:yes

properties:no

all - собирает темы, на которых есть все Свойства, имеющиеся на теме сбора и/или указанные операторам property

any - собирает темы, на которых есть любое из Свойств, имеющихся на теме сбора и/или указанное операторам property. Этот оператор применяется по умолчанию

yes - собирает темы, на которых есть Свойства

no - собирает темы, на которых нет Свойств

ignoreproperty:

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

Синтаксис оператора абсолютно такой же, как у оператора property (см. выше).

Возможна конструкция из нескольких операторов:

ignoreproperty:Расходы:0-10000
ignoreproperty:Город:Сочи
...
в данном случае при сборе будут проигнорированы темы со Свойством "Расходы" и значением от 0 до 10000, а также со Свойством "Город" и значением "Сочи".

Синтаксис и варианты оператора такие же, как у оператора property (см. выше).

Точно так же, как в операторе property, можно применять условия и операторы сравнения.

ignoreproperties:all

ignoreproperties:any

all - темы, на которых присутствуют все Свойства, указанные в операторах ignoreproperty, исключаются из сбора.

any - темы, на которых присутствует любое из Свойств, указанное в операторах ignoreproperty, исключаются из сбора.
Сортировка Сортировка задач согласно заданным критериям сортировки

sortby:критерий

sortbydesc:критерий

thenby:критерий

thenbydesc:критерий

 

доп. критерии при сортировке по ресурсу:

resource0

resourceN

resourceN0

sortby - сортировать по указанному критерию
sortbydesc - сортировать по убыванию
thenby - затем сортировать по указанному критерию
thenbydesc - сортировать по убыванию

Критерии: resource, priority, progress, startdate, duedate, project, tag, duration, effort, cost.

*Пример: sortby:resource
Данные будут отсортированы по ресурсам (по алфавиту)

Пример: sortby:resource:thenbydesc:effort
Данные будут отсортированы сначала по ресурсам, затем для каждого ресурса по трудозатратам в убывающем порядке (от бОльших трудозатрат к меньшим).

*  project - сортировка по тегу из группа тегов "Проект". См. здесь.
   duration - длительность задачи
   effort - трудозатраты
   cost - расходы

Дополнительные критерии сортировки по ресурсам:

resource0 - при сортировке игнорировать роль ресурса. Например, на теме есть ресурс ЗКРогов. Т.е. ресурс Рогов, у которого роль Заказчик (ЗК). При сортировке префикс ЗК будет проигнорирован, ресурс сортируется по букве Р.

resource2 - сортировать по второму ресурсу
resource3 - сортировать по третьему ресурсу и т.д.

Число N должно быть от 1 до 9.

resource10 - сортировать по первому ресурсу, игнорировать роль ресурса.
resource20 - сортировать по второму ресурсу, игнорировать роль ресурса.

Например, на теме есть ресурсы: >Росс, Николаев.

означает, что Росс делегировал (символ ">" - это префикс роли Делегировал) задачу Николаеву.

Вы хотите собрать задачи, которые Росс делегировал другим, и чтобы собранные результаты отсортировались по ресурсам, которым Росс делегировал задачи, (это всегда второй ресурс на теме). Тогда ваш вариант кода:

resource:Росс:делегировал // собрать задачи, где Росс имеет роль Делегировал
sortby:resource2 // отсортировать их по второму ресурсу
Управление копированием Операторы, определяющие, каким образом данные копируются в карту сбора

branch

branch:hassubtopics

branch:subtopicsonly

branch: копируется целиком ветка найденной темы (вместе с самой темой)

branch:hassubtopics: если у найденной темы нет подтем, она копироваться не будет (исключается из сбора)

branch:subtopicsonly: копируются только подтемы найденной темы (сама тема не копируется).
subtopicsonly Устаревший! Использовать branch:subtopicsonly
hassubtopics Устаревший! Использовать branch:hassubtopics
centraltopictext перед копируемой темой добавляется тема с текстом Центральной темы карты ( = названием карты или проекта). На эту тему ставится ссылка на Центральную тему карты-оригинала
maintopictext перед копируемой темой добавляется тема с текстом Основной темы ветки, к которой принадлежит копируемая тема (например, название подпроекта). На эту тему ставится ссылка на упомянутую выше Основную тему карты-оригинала

filterdoubles_map

fd_map

после того, как сбор данных завершен, из ветки темы сбора, в которой стоит этот оператор, убираются все подтемы, дубли которых присутствуют во всей карте

fd_map: синоним оператора filterdoubles_map

filterdoubles_branch

fd_branch

после того, как сбор данных завершен, из ветки темы сбора, в которой стоит этот оператор, убираются все подтемы, дубли которых присутствуют в ветке ее родительской темы
 
fd_branch: синоним для filterdoubles_branch
Прочие операторы  

nocheckdates

игнорировать фильтры по датам

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

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

inherit

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

formula

собирает темы, на которых присутствуют формулы

neednextactions

собирает темы, на которых есть значок Проекта или Подпроекта и в ветке которых нет ни одной темы со значком Хода выполнения (нет открытых задач).

Это означает, что проект еще не запущен в работу (нет ни одной задачи).


Комбинируя операторы макроязыка, можно создавать новые критерии сбора.

Создайте тему с подходящим ключевым словом/фразой и поместите нужные операторы в ее примечания, например:

Возможное ключевое слово/фраза Операторы Что будет собираться
Мои задачи на сегодня today
resource:me
мои задачи (resource:me), попадающие под выполнение сегодня (today).
Контроль за графиком программистов overdue
recource:Иванов
recource:Петров
recource:Сидоров
просроченные (overdue) задачи, за которые отвечают Иванов, Петров и Сидоров.
Быстрые задачи day:0
resource:me
effort:min:5-30
у меня есть около получаса, хочу увидеть мои задачи (resource:me) на сегодня (day:0), выполнение которых занимает** от 5 до 30 минут (effort:min:5-30).

** "Трудозатраты" в панели задач "Информация о задании"


Copyright 2013-2023  PalmaRoss