You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: content/apps/catalogs.md
+16-9Lines changed: 16 additions & 9 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -2,35 +2,42 @@
2
2
3
3
## Overview
4
4
5
-
<!-- TODO -->
6
-
7
-
This guide introduces the catalog feature, which avoids you to add a filtering interface to your app as Akeneo PXM Studio already does it.
5
+
This guide introduces the catalog feature and explains why using catalogs to retrieve Akeneo data.
8
6
9
7
### What's a catalog?
10
8
11
9
With catalogs, Akeneo users can configure which products they want to share with your app thanks to a **product selection** composed of one or several criteria that allow you to filter products.
12
10
13
11
When your app uses catalogs to retrieve product data, it automatically enables the Catalogs tab and creates catalogs in Akeneo.
14
12
15
-
<!-- image catalog list -->
13
+

14
+
15
+
### Why use catalogs to retrieve product data?
16
+
17
+
Using Catalogs helps you better manage the product information you get from the Akeneo PXM Studio.
18
+
19
+
Most of the time, developers must design, develop and maintain a filter interface to allow users to configure their product selection: which products must be taken into account and which don't.
20
+
Using catalogs for apps prevents you from adding this filtering interface to your app. When you retrieve product information related to a catalog, you only retrieve the data your app needs to process.
21
+
22
+
Moreover, with catalogs, you don't have to master the entire PIM structure anymore to deliver a relevant filtering interface, as the Akeneo PXM Studio already provides it to your users.
16
23
17
24
### Next steps
18
25
19
26
- Learn [how to create and use catalogs](/apps/catalogs.html#getting-started-with-catalogs)
20
-
- Discover how users configure catalogs in the Akeneo PXM Studio<!-- TODO Add link -->
27
+
- Discover [how users configure catalogs](https://help.akeneo.com/pim/serenity/articles/how-to-connect-my-pim-with-apps.html#how-to-configure-catalogs-for-apps) in the Akeneo PXM Studio
21
28
22
29
## Getting started with catalogs
23
30
24
-
<!-- `Add an introduction` -->
31
+
This guide describes how to use the catalog features with your app.
25
32
26
33
### What you'll learn
27
34
28
-
After you've completed this tutorial, you'll be able to create and use catalogs to retrieve product data.
35
+
After completing this tutorial, you'll be able to create and use catalogs to retrieve product data.
29
36
30
37
### Requirements
31
38
32
39
- You have a Partner account and a developer sandbox.
33
-
- Your app already manages the authentication step
40
+
- Your app already manages the authorization step
34
41
35
42
### Step 1: Ask for catalog scopes
36
43
@@ -40,7 +47,7 @@ After you've completed this tutorial, you'll be able to create and use catalogs
40
47
41
48
<!-- TODO -->
42
49
43
-
By default, when you create a catalog in the Akeneo PXM Studio, the catalog is disabled. It means that, until a user hasn't enabled it, you won't be able to retrieve products for this catalog. Note that only users can enable a catalog.
50
+
By default, when you create a catalog in the Akeneo PXM Studio, the catalog is disabled. It means that until a user hasn't enabled it, you won't be able to retrieve products for this catalog. Note that only users can enable a catalog.
0 commit comments