Підключення Tableau до ActivityInfo через конектор REST API

Вступ

Цей посібник демонструє, як використовувати конектор REST API Tableau для підключення Tableau до ActivityInfo та отримання ваших даних для аналізу.

Попередні вимоги

• Обліковий запис ActivityInfo з дозволами щонайменше для однієї бази даних та форми.
• Персональний токен API, згенерований у вашому профілі ActivityInfo.
• Tableau Desktop (версії 2023.3 або новішої), встановлений на macOS або Windows.

Крок 1: Згенеруйте ваш токен API ActivityInfo

• Увійдіть до свого облікового запису ActivityInfo.
• Натисніть на піктограму вашого профілю (у верхньому правому куті) та виберіть Налаштування облікового запису.

• Виберіть Токени API на панелі навігації та натисніть Додати.

• Дайте назву токену (наприклад, «Конектор Tableau»).
• Виберіть опцію Лише для читання (оскільки Tableau потрібно лише отримувати дані) та натисніть Згенерувати.

• Негайно скопіюйте токен і збережіть його в безпечному місці (наприклад, у менеджері паролів).

Примітка: З міркувань безпеки ви не зможете переглянути токен знову, як тільки вийдете з цієї сторінки. Якщо токен скомпрометовано, негайно відкличте | його та згенеруйте новий.

Крок 2: Знайдіть URL API для запиту вашої форми

Tableau підключається до ActivityInfo на рівні форми або підформи. Щоб продовжити, вам знадобиться конкретна URL API для запиту для вашої цільової форми або підформи.

• Перейдіть до вашої бази даних ActivityInfo.

• Відкрийте форму або підформу, яку ви хочете підключити, натисніть Експортувати та виберіть Запит як JSON.

• Виберіть, чи робити запит до всієї форми, чи до вибраних колонок, а потім натисніть Скопіювати URL-адресу.

Крок 3: Завантажте та встановіть конектор REST API

Завантажте конектор JDBC REST API (файл .jar) з Tableau Exchange. Після завантаження перемістіть файл у відповідну директорію для вашої операційної системи.

Windows

• Перейдіть до: C:\Program Files\Tableau\Drivers
• Якщо папка не існує, створіть її вручну.
• Скопіюйте файл .jar у цю папку.

MacOS

• Перейдіть до: /Users/<ваше-ім'я-користувача>/Library/Tableau/Drivers
• Якщо папка не існує, створіть її вручну.
• Скопіюйте файл .jar у цю папку.

Крок 4: Підключіть Tableau до ActivityInfo

• Перезапустіть Tableau, щоб переконатися, що новий драйвер розпізнано.
• У розділі Connect >> To a Server виберіть REST API або REST API Connector by Tableau.

• У вікні конфігурації REST API введіть наступні деталі:

• URL REST API: Вставте URL API для запиту з Кроку 2.

• Формат відповіді: Виберіть JSON або CSV.

• Автентифікація: Виберіть Токен Bearer.

• Пароль: Вставте токен API з Кроку 1.

• Натисніть Увійти.

• Тепер Tableau витягне дані з форми.

• Натисніть на назву аркуша в нижньому лівому куті та виберіть піктограму Переглянути дані (схожу на невелику таблицю/сітку), щоб побачити дані вашої форми ActivityInfo, організовані в таблицю.

• Ви можете підключати кілька форм, підформ та будувати зв'язки між таблицями в Tableau.

Усунення несправностей

Навіть за правильних налаштувань з'єднання між Tableau та ActivityInfo може не вдатися через помилки автентифікації або проблеми з драйвером. У таблиці нижче наведено деякі поширені проблеми, з якими ви можете зіткнутися, та способи їх вирішення.