Підключення 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 введіть наступні деталі:

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

• Response Format: Виберіть JSON або CSV.

• Authentication: Виберіть Токен Bearer.

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

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

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

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

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

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

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