Перейти до вмісту
Blackbird API

Akeneo

View on Github

Рішення Akeneo PIM (Product Information Management) розроблене для збору, нормалізації, збагачення та централізації інформації про продукти. Воно забезпечує моделювання даних корпоративного рівня, керування та робочі процеси для забезпечення послідовного та якісного управління даними про продукти через різні канали.

Перед налаштуванням

Перш ніж підключитися, переконайтеся, що:

  • У вас є активний екземпляр Akeneo, і ви маєте достатні права для додавання додатків до нього.
  • Перейдіть до Connect -> App Store і натисніть Create an app у правому верхньому куті.
  • Назвіть свій додаток, наприклад “Blackbird”.
  • URL-адреса активації не має значення для Blackbird, ви можете вказати URL-адресу входу Blackbird, наприклад https://de-1.blackbird.io.
  • Для URL-адреси зворотного виклику вкажіть https://bridge.blackbird.io/api/AuthorizationCode.
  • Ви отримаєте Client ID та Client Secret. Скопіюйте та збережіть ці значення для наступних кроків.

1728308561748

Підключення

  1. Перейдіть до Додатків і знайдіть додаток Akeneo. Ви можете скористатися пошуком, щоб знайти його.
  2. Натисніть Add Connection.
  3. Назвіть своє підключення для подальшого використання, наприклад, ‘Моє підключення Akeneo’.
  4. Заповніть поле Instance URL URL-адресою вашого екземпляра Akeneo.
  5. Введіть Client ID та Client Secret, які ви скопіювали з Akeneo у попередньому розділі.
  6. Натисніть Authorize connection і пройдіть процес аутентифікації у спливаючому вікні.
  • Погодьтеся з політикою конфіденційності.
  • Виберіть рівень Own, Edit для локалей та Edit для груп атрибутів.
  • Підтвердіть підключення
  1. Коли повернетеся до Blackbird, переконайтеся, що з’явилося підключення і його статус Connected.

1728309237542

Actions

General

  • Get all locales повертає список кодів локалей, доступних у цьому екземплярі Akeneo. Примітка: Akeneo не має локалі за замовчуванням.

Products

  • Search products повертає список продуктів на основі критеріїв фільтрації, наприклад, назви продукту, категорій і дати оновлення.

  • Delete product видаляє конкретний продукт.

  • Get product info повертає деталі про конкретний продукт.

  • Update product info оновлює деталі конкретного продукту.

  • Download product content повертає всі локалізовані значення продукту для вказаної локалі у форматі HTML (за замовчуванням). Після перекладу цей файл можна використовувати дією Upload product content для завантаження перекладів в Akeneo. Додатково цей метод також може виводити необроблені json-файли структури продукту.

  • Upload product content оновлює значення вмісту продукту з перекладеного або іншим чином обробленого файлу, який походить від вищезгаданої дії. Також приймає json-файли.

Product models

  • Search product models повертає список моделей продуктів на основі критеріїв фільтрації, наприклад, коду, категорій і дати оновлення.

  • Delete product model видаляє конкретну модель продукту.

  • Get product model info повертає деталі про конкретну модель продукту.

  • Update product model info оновлює деталі конкретної моделі продукту.

  • Get product model as HTML повертає всі локалізовані значення моделі продукту для вказаної локалі у форматі HTML.

  • Update product model from HTML оновлює значення вмісту моделі продукту з наданого файлу HTML.

Усі продукти і моделі продуктів повертають інформацію про категорії. Ви можете використовувати це для прийняття детальних рішень щодо стратегій локалізації.

Events

Products

  • On products created or updated спрацьовує, коли створюються або оновлюються нові продукти. Ви можете фільтрувати за локаллю та категоріями.
  • On product models created or updated спрацьовує, коли створюються або оновлюються будь-які моделі продуктів. Ви можете фільтрувати за локаллю та категоріями.

Приклад

image

Вищенаведений приклад показує дуже простий вручну запущений bird, який перекладає певні продукти за допомогою DeepL.

1728312887298

У вищенаведеному прикладі ми реагуємо на нові оновлені або створені продукти, створюючи нові проекти memoQ для них і завантажуючи файли для перекладу до memoQ.

Відсутні функції

Akeneo — це величезний додаток з багатьма функціями. Якщо будь-які з цих функцій особливо цікавлять вас, повідомте нам!

Зокрема, ми можемо запропонувати можливості локалізації для інших аспектів Akeneo, таких як Категорії.

Зворотній зв’язок

Бажаєте використовувати цей додаток або маєте відгуки щодо нашої реалізації? Зв’яжіться з нами через встановлені канали або створіть проблему.