Интеграции Resource Management и API

С помощью API Resource Management можно получать данные и импортировать их в базу данных Resource Management.

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

Нужна техническая информация? Ознакомьтесь с документацией по API.

Дополнительные сведения о других способах импорта и экспорта данных см. ниже.

• Zapier
• Экспорт в QuickBooks
• Подписки на календари

API реализует стандартные операции HTTP REST, которые вы можете вызывать для создания, чтения, обновления и удаления ресурсов управления ресурсами.

Документация по API документациивключает в себя следующую документацию и многое другое.

• Статьи по началу работы.

• Руководства, которые подробно описывают использование ресурсов продукта и интеграций.

• Документация справочника операций, указанная с использованием OpenAPI. Вы можете дополнительно скачать документацию справочника в виде файла спецификации OpenAPI (OAS) в формате JSON (.json) или YAML (.yaml). 

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

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

Если вы являетесь Администратором ресурсов и не видите токен на вкладке API разработчика,  обратитесь к владельцу вашей учетной записи. Владелец учетной записи контролирует доступ к токену.

Подписки на календари синхронизируются только в одном направлении: данные передаются из Resource Management в календарь. Изменения, внесённые в календарь, не будут отражены в Resource Management.

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

Назначения будут добавляться в календарь как частные мероприятия, занимающие весь день и не блокирующие время в календаре. Мероприятия, создаваемые в календаре, включают в себя следующую информацию из Resource Management:

• название проекта;
• название этапа проекта;
• название назначения (рабочего элемента);
• даты назначения;
• имя или название клиента;
• распределение;
• описание назначения;
• количество подзадач в назначении (выполненных и оставшихся + общее количество).

Включение подписок на календари

At the account level:

1. Параметры учётной записи
   1. В правом верхнем углу Resource Management выберите Параметры > Параметры учётной записи.
   2. Откройте Resource Management. Выберите Параметры > Параметры учётной записи.
2. Scroll to the bottom to find the option to activate or deactivate calendar subscriptions. 

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

At the individual level:

1. Выберите пункт Параметры.

2. В раскрывающемся списке выберите пункт Мои настройки. 
3. Select Enable to generate a calendar subscription URL.

Участники команды могут использовать этот URL-адрес для автоматической синхронизации назначений Resource Management с приложениями календарей, такими как Google Календарь, Outlook.com или Apple iCloud. 

URL-адрес является общедоступным. Если вы поделитесь этой ссылкой с другим пользователем, он сможет просмотреть ваши назначения в Resource Management. 

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

Добавление подписки на календарь в приложение календаря

Чтобы добавить подписку на календарь Resource Management в личный календарь, скопируйте URL-адрес подписки и выполните описанные ниже действия в приложении календаря.

• Календарь Google (примечание: на отображение изменений в Календаре Google может потребоваться до 12 часов);
• iCloud (Календарь Apple);
• Outlook

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

Эта процедура предназначена только для настольного ПК.

Создание отчёта

Создайте отчёт с данными, которые нужно экспортировать. Например, можно создать отчет под названием «Выставление счетов за октябрь». При необходимости настройте параметры. Вы можете создавать и экспортировать отчёты по проектам, этапам, времени отпусков и другим данным, которые хотите использовать в QuickBooks.

1. В верхней панели навигации выберите Отчеты. 
2. В правом верхнем углу выберите «Новый отчет».
3. На левой панели примените следующие настройки:
   • Смотреть: Время и тарифы > Часы работы
   • Временной интервал: настраиваемый диапазон дат
     • Дата начала: 1 октября 
     • Дата окончания: 31 октября
   • Первая группа по: Проект (показывает все проекты за этот период)
   • Затем сгруппируйте по: члену команды (показывает все часы, отработанные всеми сотрудниками вашей компании за этот период)
4. Выберите «Запустить отчет».

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

Экспорт данных

1. Открыв отчет, в правом верхнем углу выберите Экспорт в > Экспорт записей времени для QuickBooks. 
   При этом сохраняется файл.IIF, специфичный для Quickbooks, содержащий все ваши данные управления ресурсами. 
2. Загрузите файл из раздела Управление ресурсами и сохраните его там, где его можно найти.

Запуск QuickBooks

1. Убедитесь, что ваши сотрудники с прилагаемыми ставками счетов зарегистрированы в QuickBooks. Скорее всего, это уже настроено, если вы используете QuickBooks для бухгалтерского учета и расчета заработной платы.
2. Запустите QuickBooks. 
3. Перейдите в меню «Файл» > «Утилиты» > «Импорт» > «Импорт IIF-файла» и найдите сохраненный файл.IIF.
4. Выберите проект, для которого хотите выставить счета. Выберите «Создать счет-фактуру» в нижней части страницы. 

В вашем счете-фактуре следует указать ставки счетов, установленные в QuickBooks, и привести их в соответствие с часами, зарегистрированными в разделе «Управление ресурсами».

Сопоставление данных QuickBooks

Вам не нужно форматировать IFF-файл, загруженный из раздела Управление ресурсами, для импорта в QuickBooks. Однако убедитесь, что данные QuickBooks совпадают с данными QuickBooks и Resource Management, и вы понимаете, что такое сопоставление.

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

Данные QuickBooks соответствуют управлению ресурсами следующим образом:

• QuickBooks: клиент = Управление ресурсами: клиент
• QuickBooks: задание = управление ресурсами: проект
• QuickBooks: сотрудник = Управление ресурсами: люди
• QuickBooks: сервисный товар или товар = Управление ресурсами: категория задач
• QuickBooks: примечания или описание = Управление ресурсами: заметки
• QuickBooks: ставка = управление ресурсами: ставка счета

Существует множество решений для интеграции. Ниже приведены возможности каждого метода, сложности внедрения и стоимость.

Администраторы ресурсов могут настроить интеграцию с API управления ресурсами.

Экспорт

Используйте этот параметр, когда хотите извлечь данные из Resource Management. Экспортируйте данные в CSV, чтобы перенести их в Excel или другую программу для работы с электронными таблицами.

Узнайте, как экспортировать данные из отчетов.

Zapier

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

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

API

Это самое надёжное и гибкое решение, однако его внедрение связано с некоторыми сложностями. Этот вариант предоставляет наибольшие возможности для интеграции, но требует навыков веб-разработки для эффективной реализации.

Сравнение методов интеграции

В этой таблице приведен краткий обзор и сравнение возможностей каждого метода интеграции с веб-сайтом.

• Полный: Доступны все функции и возможности
• Частичный: Предлагает подмножество полных функций. Подробности см. в полной документации.
• Только для чтения: Можно только просматривать записи