Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Akeneo PIM app configuration in Alumio #2296

Merged
merged 13 commits into from
Nov 10, 2023
Merged

Akeneo PIM app configuration in Alumio #2296

Show file tree
Hide file tree
Changes from 4 commits
Commits
Show all changes
13 commits
Select commit Hold shift + click to select a range
64f71d3
Akeneo PIM app configuration in Alumio
lenadoc Nov 2, 2023
3b72218
Adding the missing guides
lenadoc Nov 3, 2023
78a6826
Adding one more step for the scheduler configuration
lenadoc Nov 3, 2023
f40b737
fixing the typos
lenadoc Nov 7, 2023
88ca429
Apply suggestions from code review
lenadoc Nov 10, 2023
0d6358e
Apply suggestions from code review
lenadoc Nov 10, 2023
33d25cb
Apply suggestions from code review
lenadoc Nov 10, 2023
bb88c99
Apply suggestions from code review
lenadoc Nov 10, 2023
6560c65
Adding the docs to the sidebar
lenadoc Nov 10, 2023
f56691b
fixing the sidebar
lenadoc Nov 10, 2023
b1e2080
Merge branch 'master' into configure-akeneo-pim-integration-app
lenadoc Nov 10, 2023
0904f17
fixing the sidebar
lenadoc Nov 10, 2023
766db12
fixing the sidebar
lenadoc Nov 10, 2023
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
14 changes: 14 additions & 0 deletions ...re-the-akeneo-pim-integration-app/1-configure-the-akeneo-pim-integration-app.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,14 @@
---
title: Configure the Akeneo PIM integration app
lenadoc marked this conversation as resolved.
Show resolved Hide resolved
description: Learn how you can configure the Akeneo PIM in the Spryker Middleware powered by Alumio
lenadoc marked this conversation as resolved.
Show resolved Hide resolved
template: concept-topic-template
---

This section describes how to configure the Akeneo PIM integration app to import data from there to a Spryker project via the Spryker Middleware powered by Alumio.
lenadoc marked this conversation as resolved.
Show resolved Hide resolved

To import data from Akeneo PIM to your Spryker project, you need to do the following:
lenadoc marked this conversation as resolved.
Show resolved Hide resolved

1. [Connect the Spryker Middleware Powered by Alumio with Akeneo PIM and Spryker](docs/pbc/all/data-exchange/{{page.version}}/spryker-middleware-powered-by-alumio/integration-apps/akeneo-pim-integration-app/configure-the-akeneo-pim-integration-app/connect-the-spryker-middleware-powered-by-alumio-with-akeneo-pim-and-spryker.html).
2. [Configure the data integration path of the Akeneo PIM integration app](docs/pbc/all/data-exchange/{{page.version}}/spryker-middleware-powered-by-alumio/integration-apps/akeneo-pim-integration-app/configure-the-akeneo-pim-integration-app/configure-data-mapping-between-akeneo-and-sccos.html).
3. [Configure data mapping between Akeneo and Spryker](docs/pbc/all/data-exchange/{{page.version}}/spryker-middleware-powered-by-alumio/integration-apps/akeneo-pim-integration-app/configure-the-akeneo-pim-integration-app/configure-the-data-integration-path-between-akeneo-and-sccos.html).
4. [Create tasks and import products from Akeneo to SCCOS](docs/pbc/all/data-exchange/{{page.version}}/spryker-middleware-powered-by-alumio/integration-apps/akeneo-pim-integration-app/configure-the-akeneo-pim-integration-app/5create-tasks-and-import-products-from-akeneo-to-sccos.html).
66 changes: 66 additions & 0 deletions ...connect-the-spryker-middleware-powered-by-alumio-with-akeneo-pim-and-spryker.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,66 @@
---
title: Configure the Spryker Middleware Powered by Alumio with Akeneo PIM and Spryker
lenadoc marked this conversation as resolved.
Show resolved Hide resolved
description: Create clients for Akeneo and Spryker in the Spryker Middleware Powered by Alumio
template: howto-guide-template
---
To start importing products from Akeneo to your Spryker project using the Spryker Middleware powered by Alumio, you need to connect Spryker Middleware powered by Alumio with Akeneo and SCCOS.

You can establish this connection directly in the Spryker Middleware Powered by Alumio platform by following these guidelines.

## Prerequisite

Before you can connect the Spryker Middleware powered by Alumio with Akeneo, you need to establish a connection to Spryker in Akeneo. The connection to Spryker should use the *Data destination* flow type. For step-by-step instructions on how to set up this connection in Akeneo, refer to the [Akeneo documentation](https://help.akeneo.com/serenity-connect-your-pim/serenity-manage-your-connections).
lenadoc marked this conversation as resolved.
Show resolved Hide resolved

## Connect Akeneo with Spryker Middleware Powered by Alumio

To connect Akeneo with Spryker Middleware powered by Alumio, you need to create an HTTP client. To create the client, do the following.
lenadoc marked this conversation as resolved.
Show resolved Hide resolved

1. In the Spryker Middleware powered by Alumio platform, go to **Clients -> HTTP client** and click the + sign.
![create-http-client](https://spryker.s3.eu-central-1.amazonaws.com/docs/pbc/all/data-exchange/spryker-middleware-powered-by-alumio/integration-apps/akeneo-pim-integration-app/configure-the-akeneo-pim-integration-app/2-connect-the-spryker-middleware-powered-by-alumio-with-akeneo-pim-and-spryker/create-http-client.png)
2. In the platform selection field, start typing "Akeneo" and select *Akeneo HTTP Client*.
![akeneo-http-client](https://spryker.s3.eu-central-1.amazonaws.com/docs/pbc/all/data-exchange/spryker-middleware-powered-by-alumio/integration-apps/akeneo-pim-integration-app/configure-the-akeneo-pim-integration-appfiled/2-connect-the-spryker-middleware-powered-by-alumio-with-akeneo-pim-and-spryker/akeneo-http-client.png)
3. Click **Next step**.
4. In *Base URL*, enter the URL to your Akeneo PIM environment. For example, `https://test.cloud.akeneo.com`
5. Go to your Akeneo PIM environment, to **Connections -> Connection settings**, and copy the following information from there to the *Create Client* page of the Spryker Middleware Powered by Alumio platform:
- Client ID
- Client Secret
- Username
- Password: Keep in mind that the password is hidden in Akeneo. If you don't remember it, you have to generate a new one.

![connection-credentials](https://spryker.s3.eu-central-1.amazonaws.com/docs/pbc/all/data-exchange/spryker-middleware-powered-by-alumio/integration-apps/akeneo-pim-integration-app/configure-the-akeneo-pim-integration-app/2-connect-the-spryker-middleware-powered-by-alumio-with-akeneo-pim-and-spryker/connection-credentials.png)

6. Optional: Check the *Enable logging of requests* checkbox.
7. Click **Grant access to Alumio** and proceed to the next step.
8. Enter the name of your client. As you are entering the name, the identifier will be populated automatically based on the name.
9. Click **Save**.

The client should now be on the list of the *HTTP clients* page.

## Connect SCCOS with Spryker Middleware Powered by Alumio
lenadoc marked this conversation as resolved.
Show resolved Hide resolved

To connect SCCOS to Spryker Middleware powered by Alumio, you also need to create an HTTP client. To create the client, do the following.
lenadoc marked this conversation as resolved.
Show resolved Hide resolved

1. In the Spryker Middleware Powered by Alumio platform, go to **Clients -> HTTP client** and click the + sign.
lenadoc marked this conversation as resolved.
Show resolved Hide resolved
2. In the platform selection field, start typing "Spryker" and select *Spryker Dynamic Data Exchange HTTP Client*.
3. Click **Next step**.
4. In *Base URL*, enter the URL to your Spryker Glue API environment with the Dynamic Data Exchange. For example, `https://glue-backend.de.alumio.mysprykershop.com/dynamic-entity`.
lenadoc marked this conversation as resolved.
Show resolved Hide resolved
5. Enter the username and password from your Spryker Glue API environment.
6. Optional: Check the *Enable caching of the token* checkbox.
7. Optional: Check the *Enable logging of requests* checkbox.
8. Click **Grant access to Alumio** and proceed to the next step.
9. Enter the name of your client. As you are entering the name, the identifier will be populated automatically based on the name.
10. Click **Save**.

The client should now be on the list of the *HTTP clients* page.

Now that the client is created, you can test if it works. To test the client, do the following:

1. Find the client on the *HTTP clients* page and click it. The client details page opens.
2. In *Request Method*, enter select *GET*.
3. In *Test URL*, enter `/product-abstracts`.
![sccos-to-middleware-client](https://spryker.s3.eu-central-1.amazonaws.com/docs/pbc/all/data-exchange/spryker-middleware-powered-by-alumio/integration-apps/akeneo-pim-integration-app/configure-the-akeneo-pim-integration-app/2-connect-the-spryker-middleware-powered-by-alumio-with-akeneo-pim-and-spryker/sccos-to-middleware-client.png)
4. Click **Run test**. If the configuration is successful, the response field should return a list of abstract products available in your project.
![sccos-to-middleware-response](https://spryker.s3.eu-central-1.amazonaws.com/docs/pbc/all/data-exchange/spryker-middleware-powered-by-alumio/integration-apps/akeneo-pim-integration-app/configure-the-akeneo-pim-integration-app/2-connect-the-spryker-middleware-powered-by-alumio-with-akeneo-pim-and-spryker/sccos-to-middleware-response.png)

## Next step
[Configure data mapping between Akeneo and SCCOS](/docs/pbc/all/data-exchange/{{page.version}}/spryker-middleware-powered-by-alumio/integration-apps/akeneo-pim-integration-app/configure-the-akeneo-pim-integration-app/3-configure-data-mapping-between-akeneo-and-sccos.html)
Loading
Loading