Работа со сложными фильтрами аналитик

Возможности конфигурации

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

Инструкция по подключению

Мы решили опубликовать заметку о работе сложных фильтров аналитик через REST API по единственной причине — видим c вашей стороны недостаточное понимание того, как работать с этим инструментом. Ещё сразу отметим, заметка посвящена опытным пользователям. Она точно будет полезна разработчикам, которые используют REST API ПланФикса. Если вы не используете REST в своей работе, ничего страшного — это нормально. Солнце не перестанет светить, а земля крутиться 🙂

Далее на примере покажем работу со сложными фильтрами аналитик и как передавать данные по аналитикам Фактическое и Планируемое время работы из ПланФикса в другие системы.

Руководство поставило перед Сергеем интересную задачу — передать из ПланФикса данные по аналитикам Фактическое и Планируемое время работы во внутреннюю систему расчета зарплаты на базе 1С.

— И как мне это провернуть? — сказал Сергей, попутно открывая  справку ПланФикса. После продолжительного изучения документации он решил всё сделать через REST API.

Первый шаг

Для начала Сергей создал токен авторизации с уровнем доступа на чтение аналитик:

Прежде чем писать код на стороне 1С, Сергей перешел по ссылке в спецификацию и авторизовался с помощью токена, чтобы сразу протестировать и отладить работу:

Первым делом необходимо узнать идентификаторы нужных аналитик и их полей, чтобы понимать, что запрашивать у API. 
Сергей воспользовался методом получения списка всех аналитик /datatag/list и выполнил запрос с параметрами:

{ "offset": 0, "pageSize": 100, "fields": "id,name,group,fields"
}

В ответ Сергей получил идентификаторы нужных аналитик и их полей:

{ "result": "success", "dataTags": [{ "id": 4, "name": "Планируемое время работы", "group": { "id": 1, "name": "Управление временем" }, "fields": [{ "id": 6, "name": "Дата", "type": 3, "objectType": 4 }, { "id": 7, "name": "Планируемое время работы", "type": 6, "objectType": 4 }, { "id": 17, "name": "Сотрудник", "type": 14, "objectType": 4 } ] }, { "id": 12, "name": "Фактическое время работы", "group": { "id": 1, "name": "Управление временем" }, "fields": [{ "id": 52, "name": "Дата", "type": 3, "objectType": 4, "directoryId": 10 }, { "id": 54, "name": "Время работы", "type": 6, "objectType": 4, "directoryId": 10 }, { "id": 56, "name": "Тип времени", "type": 9, "objectType": 4, "directoryId": 8 }, { "id": 58, "name": "Вид работы", "type": 9, "objectType": 4, "directoryId": 10 }, { "id": 60, "name": "Сотрудник", "type": 14, "objectType": 4 } ] } ]
}

Как получить все записи по аналитике?

{ "offset": 0, "pageSize": 100, "fields": "key,6,7,17"
}

В поле fields Сергей передал идентификаторы полей аналитики, которые он хотел бы получить в ответ и поле key — это идентификатор записи аналитики. В ответ он получил все необходимые данные:

{ "result": "success", "dataTagEntries": [{ "key": 40, "customFieldData": [{ "field": { "id": 6, "name": "Дата", "type": 3, "objectType": 4 }, "value": { "datetime": "2023-09-15T00:00Z", "date": "15-09-2023", "time": "00:00" }, "stringValue": "15-09-2023" }, { "field": { "id": 7, "name": "Планируемое время работы", "type": 6, "objectType": 4 }, "value": { "from": { "time": "09:00" }, "to": { "time": "17:00" } }, "stringValue": "09:00 - 17:00" }, { "field": { "id": 17, "name": "Сотрудник", "type": 14, "objectType": 4 }, "value": [{ "id": "user:10", "name": "Иван Иванов" } ], "stringValue": "Иван Иванов" } ] }, { "key": 41, "customFieldData": [{ "field": { "id": 6, "name": "Дата", "type": 3, "objectType": 4 }, "value": { "datetime": "2023-09-18T00:00Z", "date": "18-09-2023", "time": "00:00" }, "stringValue": "18-09-2023" }, { "field": { "id": 7, "name": "Планируемое время работы", "type": 6, "objectType": 4 }, "value": { "from": { "time": "09:00" }, "to": { "time": "14:00" } }, "stringValue": "09:00 - 14:00" }, { "field": { "id": 17, "name": "Сотрудник", "type": 14, "objectType": 4 }, "value": [{ "id": "user:10", "name": "Иван Иванов" } ], "stringValue": "Иван Иванов" } ] } ]
}

Как отфильтровать данные аналитики?

Теперь полученные данные было бы неплохо отфильтровать по полю типа «Дата», чтобы получить записи только за определенный период.

Для этого Сергей обратился в раздел справки Сложные фильтры аналитик  и нашел там необходимый фильтр – 3101. В спецификации был уже пример такого фильтра, Сергей воспользовался им и отправил запрос:

{ "offset": 0, "pageSize": 100, "fields": "key,6,7,17", "filters": [{ "type": 3101, "field": 6, "operator": "equal", "value": { "dateType": "otherRange", "dateFrom": "18-09-2023", "dateTo": "18-09-2023" } }

В ответ он получил записи данной аналитики за 18 число:

{ "result": "success", "dataTagEntries": [ { "key": 41, "customFieldData": [ { "field": { "id": 6, "name": "Дата", "type": 3, "objectType": 4 }, "value": { "datetime": "2023-09-18T00:00Z", "date": "18-09-2023", "time": "00:00" }, "stringValue": "18-09-2023" }, { "field": { "id": 7, "name": "Планируемое время работы", "type": 6, "objectType": 4 }, "value": { "from": { "time": "09:00" }, "to": { "time": "14:00" } }, "stringValue": "09:00 - 14:00" }, { "field": { "id": 17, "name": "Сотрудник", "type": 14, "objectType": 4 }, "value": [ { "id": "user:10", "name": "Иван Иванов" } ], "stringValue": "Иван Иванов" } ] } ]
}

Обработка ответов в 1С

— Готово! Теперь можно переключиться на 1С, — продолжал бубнить себе под нос наш герой.

Сергею осталось реализовать выполнение запросов и обработку ответов с записью получаемых данных в базу 1С.

Аналогичным образом он поступил и с аналитикой Фактическое время работы — передал в запрос идентификатор этой аналитики «12» и тело с необходимыми параметрами:

{ "offset": 0, "pageSize": 100, "fields": "key,52,54,56,58,60", "filters": [ { "type": 3101, "field": 52, "operator": "equal", "value": { "dateType": "otherRange", "dateFrom": "18-09-2023", "dateTo": "18-09-2023" } } ]
}

В ответ получил также данные за 18 число:

{ "result": "success", "dataTagEntries": [{ "key": 43, "customFieldData": [{ "field": { "id": 52, "name": "Дата", "type": 3, "objectType": 4, "directoryId": 10 }, "value": { "datetime": "2023-09-18T00:00Z", "date": "18-09-2023", "time": "00:00" }, "stringValue": "18-09-2023" }, { "field": { "id": 54, "name": "Время работы", "type": 6, "objectType": 4, "directoryId": 10 }, "value": { "from": { "time": "13:00" }, "to": { "time": "19:00" } }, "stringValue": "13:00 - 19:00" }, { "field": { "id": 56, "name": "Тип времени", "type": 9, "objectType": 4, "directoryId": 8 }, "value": { "id": 1, "value": "Рабочее время" }, "stringValue": "1" }, { "field": { "id": 58, "name": "Вид работы", "type": 9, "objectType": 4, "directoryId": 10 }, "value": { "id": 10, "value": "Доработка дизайн-макета" }, "stringValue": "10" }, { "field": { "id": 60, "name": "Сотрудник", "type": 14, "objectType": 4 }, "value": [{ "id": "user:10", "name": "Иван Иванов" } ], "stringValue": "Иван Иванов" } ] } ]
}

— Ну вот и всё!  — радостно, потирая руки, произнёс Сергей, после тестирования настройки. 

Так можно работать со сложными фильтрами в REST API и передавать данные по аналитикам Фактическое и Планируемое время работы из ПланФикса в другие системы. Если какие-то моменты вызывают вопросы и непонимание — пишите в Службу поддержки,  поможем разобраться.

Учёт рабочего времени

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

Таймер

Отслеживайте фактическое рабочее время прямо в ПланФикс без использования сторонних приложений.

Аналитика задач

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

Отслеживание доходов и расходов

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

Вычисляемые поля

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

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

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

Аналитика контактов

Одна из причин добавить аналитику к тегу клиента — это отслеживание финансовых договоренностей.

Отслеживание всего, что вам нужно

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

Task and project management, comments, interface setup, creating reports, working with contacts, documents, and data tags, access management, integrations, ready-made solutions and much more.

Пользуйтесь 14 дней всеми возможностями ПланФикса абсолютно бесплатно

Не просим телефон и кредитку

Материал из ПланФикс

Шаблон документа — это файл в формате Microsoft Excel или Microsoft Word, в котором вы можете использовать поля из задач и аналитик ПланФикса. Для этого в шаблон документа вставляются специальные переменные.

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

Создание шаблона документа

Важно: использование других редакторов, например онлайн-редакторов Google, не гарантирует работоспособность получившегося шаблона.

• Список переменных, содержащих данные задач, аналитик и других сущностей ПланФикса, которые можно использовать в шаблонах, доступен в разделе Документы — Шаблоны документов:

• Для начала использования готовый шаблон необходимо загрузить в ПланФикс. Это можно сделать в разделе Документы — Шаблоны документов — Новый шаблон:

Работа с шаблонами документов

• По готовому шаблону можно создать документ, который будет содержать данные из задачи и сразу прикрепится к ней. Создание документа по шаблону происходит в интерфейсе добавления файла к задаче:

или же в интерфейсе автоматического сценария:

При создании документа по шаблону есть возможность:

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

Задание имени документа, созданного по шаблону

• В имени создаваемого по шаблону документа можно использовать различные переменные, их список можно открыть кликом по значку:

• С их помощью составляется имя файла любой степени сложности:

• При создании документа в название создаваемого файла подставятся реальные значения указанных переменных:

Указание типа файла

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

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

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

Матрица Эйзенхауэра — это метод тайм-менеджмента, который помогает расставлять приоритеты. Матрица состоит из четырех квадратов: Важные и Срочные, Важные и Несрочные, Неважные и Срочные, Неважные и Несрочные.

«Важные и Срочные» (квадрат кризисов) — это очень важные задачи, которые либо вышли из-под контроля, либо возникли внезапно, их следует выполнить незамедлительно, чтобы избежать последствий. Несвоевременное выполнение подобных задач может негативно повлиять на достижение наших целей, стать причиной негативных событий.

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

«Неважные и Срочные» (квадрат иллюзий\суеты) — задачи, которые срочно нужно выполнять, но которые почти никак не влияют на наши ценности. Однако важно понимать, что время, потраченное на эти задачи, — это время, отнятое у наших целей.

«Неважные и Несрочные» (убийцы времени) — малозначительные и необязательные спонтанные желания или даже вредные, но любимые, которые почти никак не влияют на наши ценности и не требуют незамедлительных действий. Это самые легкие и приятные дела в нашем списке, из-за этого некоторые люди начинают свой день именно с этих задач, тратя на них свои самые продуктивные часы. В идеале, желательно, чтобы этот квадрант остался пустым. За этими занятиями мы проводим часы, но не получаем от них практической пользы в долгосрочной перспективе.

Инструкция к конфигурации

https://youtube.com/watch?v=zAnZPw_AD2A%3Frel%3D0