Вы можете начать использовать макроязык без его изучения, с помощью Мастера макроязыка, который позволит вам быстро конструировать необходимые критерии сбора данных. И вы их просто копируете в примечания тем с критериями сбора.
Но для составления сложных, специфических, очень гибких критериев сбора может все же понадобиться углубленное понимание макроязыка сбора данных. Тогда изучите все нижеизложенное.
Внимание! С версии MultiMaps 6.1 изменен синтаксис макроязыка!
Ранее двоеточие применялось для разделения как операторов, так и параметров. С таким синтаксисом макроязык не может далее развиваться. Сейчас операторы отделяются друг от друга переводом строки или символами ">>", а параметры - двоеточием.
Ранее: week:0:complete:100:resource:Иванов
Сейчас: weeks:0 >> complete:100 >> resource:Иванов
Кроме этого, изменен также синтаксис некоторых операторов. Например, ранее: requirestartdate, сейчас: require:startdate. Операторы с измененным синтаксисом обозначены ниже в таблице красным цветом. Теоретически они почти все будут продолжать работать, но через какое-то время перестанут.
Также добавлено довольно много новых операторов.
! В версии 7.x.x.x изменен синтаксис операторов дат. Добавлены новые операторы: сортировка собранных данных, управления ролями ресурсов, стоимость задачи, тарифная ставка ресурса, приоритет, ссылки и вложения. Для всех численных значений добавлены операторы сравнения: ">", ">=", "<", "<=".
Если в ваших картах применяются ключевые слова с операторами макроязыка, обязательно сверьте их с новой версией!
Движок сбора данных узнает, что и как нужно собирать для каждого ключевого слова, по кодовым словам, которые находятся в примечаниях темы с этим ключевым словом в конфигурационной карте.
Вы можете вставлять кодовые слова макроязыка в примечания любой темы, под которую хотите собрать данные. Движок сбора данных их "расшифрует" и соберет то, что вы хотите.
Таким образом, мы имеем совсем небольшой, но язык программирования.
Как и любой язык, он состоит из операторов (кодовые слова) и их параметров.
Можно употреблять один оператор для каждой темы, а можно конструировать кодовую фразу из нескольких операторов. Таким образом, можно даже в одной теме задать каскад фильтров.
С помощью этого макроязыка вы можете настроить критерии сбора чрезвычайно гибко.
Операторы отделяются друг от друга переводом строки (каждый оператор на новой строке), либо символами ">>". Параметры определяются через двоеточия.
Движок смотрит в примечания темы сбора - начинаются ли они с какого-то из знакомых ему операторов. Если да, то он начинает обработку операторов, пока не встретит один из знаков, сообщающих ему о том, что дальше операторов уже нет (дальше может быть просто любой текст пользователя, обычно - пояснение для темы сбора).
Знаками окончания блока операторов могут быть:
; (точка с запятой)
слово "comment"
Пример программирования ключевого слова через его примечания:
или так:
предыдущий блок можно записать и так:
Больше примеров вы найдете в конфигурационной карте.
В каком точно порядке работает движок сбора данных смотрите здесь.
Для лучшего понимания действия операторов нужно понимать отличие стандартной темы карты от темы-задачи.
Задача - это тема, имеющая хотя бы один из атрибутов, заданных в настройках 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 |
устаревшие! не применять! Использовать операторы, указанные выше | |
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:имя:norole |
resource:Петров:заказчик - соберет задачи, на которых Петров имеет роль Заказчик (например, на теме выглядит как ЗКПетров). resource:me:делегировал - соберет задачи, на которых я имею роль Делегировал. Роль должна быть прописана в списке ролей. Чтобы собрать только те ресурсы, которые не имеют роли, укажите norole: resource:Петров:norole соберет темы с ресурсом Петров, который не имеет никакой роли (ЗКПетров, @Петров будут проигнорированы). | |
Имя ресурса по условию:
resource:условие:ТЕКСТ resource:условие: resource:условие: |
собираются темы, у которых есть ресурс, имя которого подпадает под условие: 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] |
собираются темы с ресурсами, у которых ставка ресурса находится в указанном диапазоне. | |
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
|
собирает темы, на которых есть ссылка или вложение с указанным типом документа 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:условие:ТЕКСТ |
собирает темы, на присутствуют указанные Свойства. Упрощенный вариант: первый параметр всегда имя свойства, второй - значение Свойства: 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