Updating develop branch

package.json

@@ -6,7 +6,7 @@
     "url": "https://github.com/AdobeDocs/commerce-extensibility"
   },
   "dependencies": {
-    "@adobe/gatsby-theme-aio": "4.10.7",
+    "@adobe/gatsby-theme-aio": "^4.11.3",
     "gatsby": "4.22.0",
     "react": "^17.0.2",
     "react-dom": "^17.0.2"

src/data/navigation/sections/app-development.js

@@ -6,5 +6,9 @@ module.exports = [
     {
         title: "Extensibility examples",
         path: "/app-development/examples.md"   
+    },
+    {
+        title: "Learning path",
+        path: "/app-development/learning-path.md"   
     }
 ];

src/data/navigation/sections/events.js

@@ -27,6 +27,10 @@ module.exports = [
     title: "Add custom fields",
     path: "/events/custom-event-fields.md"
   },
+  {
+    title: "Convert payload field values",
+    path: "/events/convert-field-values.md"
+  },
   {
     title: "Command reference",
     path: "/events/commands.md",

src/data/navigation/sections/webhooks.js

@@ -27,6 +27,10 @@ module.exports = [
       title: "Configuration reference",
       path: "/webhooks/xml-schema.md"
     },
+    {
+      title: "Admin configuration",
+      path: "/webhooks/admin-configuration.md"
+    },
     {
       title: "Command reference",
       path: "/webhooks/commands.md",

src/pages/admin-ui-sdk/extension-points/order/mass-action.md

@@ -34,6 +34,7 @@ order: {
             {
                 actionId: `${extensionId}::another-first-mass-action`,
                 label: 'Another Mass Action',
+                title: 'Another Orders Mass Action',
                 type: `${extensionId}.another-mass-action`,
                 path: '#/another-mass-action'
             }
@@ -50,6 +51,7 @@ order: {
 | `confirm.message` | string | No | The message displayed on the confirmation dialog for a mass action. |
 | `confirm.title` | string | No | The title of a dialog that confirms the mass action. |
 | `label` | string | Yes | An Action label to display in the Mass Actions grid. |
+| `title` | string | No | An optional page title for the action. If not specified, the label is used.
 | `path` | string | Yes | The relative path in the application to redirect to the action. You might need to prepend `#/` to the path to ensure access to the correct page. |
 | `orderSelectLimit` | integer | No | Set the maximum number of orders that can be selected for a mass action. By default, the number is unlimited. |
 | `type` | string | Yes | A unique ID that identifies the type of action. |

src/pages/admin-ui-sdk/extension-points/order/view-button.md

@@ -45,8 +45,9 @@ order: {
 | Field | Type | Required | Description |
 | --- | --- | --- | --- |
 | `buttonId` | string | Yes | A unique ID to identify the button. We recommend using the format `<extensionId>::<buttonName>`. |
-| `label` | string | No | The label of the button. |
+| `label` | string | Yes | The label of the button. |
 | `confirm.message` | string | No | Confirmation message to display. |
 | `path` | string | Yes | The relative path to the button page in the App. The order ID will be sent as part of the query. |
-| `level` | integer | Yes |  The position in which a set of buttons are placed in the toolbar. The possible values are `-1` (left), `0` (center), and `1` (right). |
+| `level` | integer | No |  The position in which a set of buttons are placed in the toolbar. The possible values are `-1` (left), `0` (center), and `1` (right). |
 | `sortOrder` | integer | No | The order in which the button is placed inside the level. |
+| `class` | string | Yes  | The class of the button. Possible values are `save`, `edit`, `reset`, and `custom`. |

src/pages/admin-ui-sdk/extension-points/product/mass-action.md

@@ -35,6 +35,7 @@ product: {
                 actionId: `${extensionId}::another-first-mass-action`,
                 label: 'Another Mass Action',
                 type: `${extensionId}.another-mass-action`,
+                title: 'Another Products Mass Action',
                 path: '#/another-mass-action'
             }
         ]
@@ -50,6 +51,7 @@ product: {
 | `confirm.message` | string | No | The message displayed on the confirmation dialog for a mass action |
 | `confirm.title` | string | No | The title of a dialog that confirms the mass action |
 | `label` | string | Yes | An Action label to display in the Mass Actions grid |
+| `title` | string | No | An optional page title for the action. If not specified, the label is used. |
 | `path` | string | Yes | The relative path in the application to redirect to the action. You might need to prepend `#/` to the path to ensure access to the correct page. |
 | `productSelectLimit` | integer | No | Set the maximum number products that can be selected for a mass action. By default, the number is unlimited. |
 | `type` | string | Yes | A unique ID that identifies the type of the action. |

src/pages/admin-ui-sdk/release-notes.md

@@ -8,6 +8,36 @@ keywords:
 
 # Adobe Commerce Admin UI SDK release notes
 
+## Version 1.3.2
+
+### Release date
+
+March 4, 2024
+
+### Bug fixes
+
+* Corrected a condition that allowed administrators who did not have proper permissions to view data in grid columns.
+
+## Version 1.3.1
+
+### Release date
+
+January 25, 2024
+
+### Enhancements
+
+* Enhanced unit coverage by 150%. <!-- CEXT-2345, CEXT-2425, CEXT-2593, CEXT-2596, CEXT-2600, CEXT-2601, CEXT-2602, CEXT-2603, CEXT-2604 -->
+
+* Added the ability to optionally specify a page title for a mass action. <!-- CEXT-2598 -->
+
+* The Admin UI SDK cache is now flushed weekly instead of every 12 hours. <!-- CEXT-2643 -->
+
+* The Admin UI SDK now supports PHP 8.3. <!-- CEXT-2724 -->
+
+### Bug fixes
+
+* The Admin now displays extensions correctly when they are loaded from the extension manager registry. <!-- CEXT-2595 -->
+
 ## Version 1.3.0
 
 ### Release date

src/pages/amazon-sales-channel/best-practices/database-storage.md

@@ -32,11 +32,11 @@ The throttling controls of Amazon's Selling Partner APIs significantly impact ap
 
 The `lib-state` library has clear limitations both in practice and from the public documentation. A common misconception is that this library is a replacement for a traditional RDBMS/noSQL database. Instead, it has technical capabilities that are similar to Redis or other caching services. The library [README](https://github.com/adobe/aio-lib-state) lists these limitations:
 
-* Maximum state value size: 2MB
+* The namespace must be in the valid AppBuilder format: `amsorg-project(-workspace)`
+* Maximum state value size: 1MB
 * Maximum state key size: 1024 bytes
-* Maximum total state size: 10 GB
-* Token expiry (need to re-init after expiry): 1 hour
-* Non-supported characters for state keys are: '/', '\', '?', '#'
+* Alphanumeric characters are supported as well as `-` (dash), `_` (underbar), and `.` (period)
+* The default TTL value is one day. The maximum is 365 days.
 
 These additional limitations should also be considered:
 

src/pages/app-development/learning-path.md

@@ -0,0 +1,72 @@
+---
+title: Extensibility learning path
+description: Follow the learning path links to learn the basics about app builder setup and development.
+keywords:
+ - Extensibility
+ - App Builder
+ - API Mesh
+ - Events
+ - REST
+ - Tools
+---
+
+# Extensibility learning path
+
+Follow the learning path links to understand the basics about App Builder setup and development.
+
+The following resources will help you get to know the extensibility options offered by Adobe Commerce and start developing:
+
+## How does App Builder work?
+
+- [Introducing App Builder for Commerce](https://experienceleague.adobe.com/docs/commerce-learn/tutorials/adobe-developer-app-builder/introduction-to-app-builder.html) - A high-level business value proposition and ecosystem.
+- [Use Cases](https://www.youtube.com/watch?v=spm90jwC94A&t=1s) - a one-hour video on common App Builder use cases.
+- [Sample App](https://developer.adobe.com/commerce/extensibility/amazon-sales-channel/) - An internally developed sample app with best practices and references to an example GitHub repo.
+- [Demo](https://experienceleague.adobe.com/docs/commerce-learn/tutorials/adobe-developer-app-builder/app-builder-functional-demonstration.html) - A short video demonstrating a functional integration between Commerce and Amazon Marketplace.
+
+## How can I get set up?
+
+- [Getting access to App Builder](https://developer.adobe.com/app-builder/docs/overview/getting_access/) - Information on how to request trial access or purchase a license.
+- [Onboarding developers and admins](https://helpx.adobe.com/enterprise/using/manage-developers.html) - Information on how to set up your organization after getting access to App Builder.
+
+## How do I start developing?
+
+- Develop custom applications with Adobe Developer App Builder
+  - [App Builder overview](https://developer.adobe.com/app-builder/docs/overview/) - An overview of the App Builder ecosystem. The App Builder documentation applies to all Adobe products that integrate with App Builder, including Adobe Commerce.
+  - [Creating your first App Builder application](https://developer.adobe.com/app-builder/docs/getting_started/first_app/) - A generalized tutorial on creating your first App Builder app. If you are new to App Builder, Adobe recommends reviewing the App Builder overview before beginning this tutorial.
+- Orchestration with API Mesh for Adobe Developer App Builder
+  - [Getting started](https://developer.adobe.com/graphql-mesh-gateway/gateway/getting-started/) - Information on how to get started with API Mesh.
+  - [Creating a mesh](https://developer.adobe.com/graphql-mesh-gateway/gateway/create-mesh/) - Developer documentation on creating a mesh.
+  - [Create a mesh walkthrough](https://developer.adobe.com/graphql-mesh-gateway/gateway/mesh_walkthrough/) - Documentation that provides a guided walkthrough of basic API Mesh functionality.
+  - API Mesh video tutorials - A set of video tutorials that demonstrate basic API Mesh functionality:
+    - [Getting started with API Mesh](https://experienceleague.adobe.com/docs/commerce-learn/tutorials/adobe-developer-app-builder/api-mesh/getting-started-api-mesh.html)
+    - [Installing Adobe I/O Runtime CLI and the API Mesh plugin](https://experienceleague.adobe.com/docs/commerce-learn/tutorials/adobe-developer-app-builder/api-mesh/installing-aio-mesh-plugin.html)
+    - [Working with projects and workspaces](https://experienceleague.adobe.com/docs/commerce-learn/tutorials/adobe-developer-app-builder/api-mesh/aio-projects-workspaces.html)
+    - [Create a mesh with a single source](https://experienceleague.adobe.com/docs/commerce-learn/tutorials/adobe-developer-app-builder/api-mesh/graphql-single-source.html)
+    - [Create a mesh with multiple sources](https://experienceleague.adobe.com/docs/commerce-learn/tutorials/adobe-developer-app-builder/api-mesh/graphql-multiple-source.html?lang=en)
+- Build event-driven integrations with Adobe I/O Events for Adobe Commerce
+  - [Adobe I/O Events](https://developer.adobe.com/events/docs/) - Developer documentation for general Adobe I/O Events functionality, not specific to Adobe Commerce. View this documentation for information about consuming events in App Builder using journaling, runtime actions, retry mechanisms, and more.
+  - [Adobe I/O Events for Adobe Commerce](https://developer.adobe.com/commerce/extensibility/events/) - Developer documentation for Adobe I/O Events for Adobe Commerce.
+  - [Installation](https://developer.adobe.com/commerce/extensibility/events/installation/) - Developer docs for setting up the I/O Events for Adobe Commerce.
+  - Eventing video tutorials - A set of developer-facing video tutorials that demonstrate how to set up I/O Events for Adobe Commerce
+     - [Getting started](https://experienceleague.adobe.com/docs/commerce-learn/tutorials/adobe-developer-app-builder/io-events/getting-started-io-events.html) - A video tutorial on how to use I/O Events for Adobe Commerce.
+     - Adobe I/O Events installation - Learn how to install several new modules in Adobe Commerce using Composer for the corresponding version.
+       - [Adobe Commerce 2.4.6](https://experienceleague.adobe.com/docs/commerce-learn/tutorials/adobe-developer-app-builder/io-events/2-4-6-installation.html)
+       - [Adobe Commerce 2.4.5](https://experienceleague.adobe.com/docs/commerce-learn/tutorials/adobe-developer-app-builder/io-events/2-4-5-installation.html)
+     - [Configure I/O Events for Adobe Commerce](https://experienceleague.adobe.com/docs/commerce-learn/tutorials/adobe-developer-app-builder/io-events/configure-commerce.html) - A tutorial video on how to set up I/O Events for Adobe Commerce.
+     - [Create an App Builder project](https://experienceleague.adobe.com/docs/commerce-learn/tutorials/adobe-developer-app-builder/io-events/create-app-builder-project.html) - Learn how to create an Adobe Developer App Builder project to consume events from Adobe Commerce.
+- Extend the Admin UI with the Admin UI SDK
+  - [Admin UI SDK overview](https://developer.adobe.com/commerce/extensibility/admin-ui-sdk/) - Developer documentation on how to extend and customize the Commerce Admin to include custom menus and pages.
+  - [Installation](https://developer.adobe.com/commerce/extensibility/admin-ui-sdk/installation/) - Developer documentation on how to set up the Admin UI SDK.
+  - [Extension points](https://developer.adobe.com/commerce/extensibility/admin-ui-sdk/extension-points/) - Developer documentation on how to use existing extension points in any Adobe Developer App Builder application that customizes the Adobe Commerce Admin.
+- Extend native Commerce processes with webhooks
+  - [Overview](https://developer.adobe.com/commerce/extensibility/webhooks/) - An architectural overview of webhooks.
+  - [Setup and installation](https://developer.adobe.com/commerce/extensibility/webhooks/installation/) - Information on how to install Commerce modules necessary for implementing webhooks.
+  - [Configuration](https://developer.adobe.com/commerce/extensibility/webhooks/hooks/) - Developer documentation on how to configure hooks for Adobe Commerce.
+  - [Common use cases](https://developer.adobe.com/commerce/extensibility/webhooks/use-cases/) - Descriptions of common Adobe Commerce use cases for webhooks.
+  - [Webhooks](https://developer.adobe.com/commerce/extensibility/webhooks/admin-configuration/) - Learn how to extend, override, and create hooks using the Adobe Commerce Admin.
+
+## Troubleshooting
+
+- [Logging and troubleshooting in App Builder](https://developer.adobe.com/commerce/extensibility/amazon-sales-channel/best-practices/logging-troubleshooting/)
+- [Adobe I/O Events frequently asked questions](https://developer.adobe.com/events/docs/support/faq/)
+- [App Builder security overview](https://developer.adobe.com/app-builder/docs/guides/security/)

src/pages/events/commands.md

@@ -193,7 +193,7 @@ If you are implementing eventing in a performance testing environment, run the `
 
 ### Options
 
-`--fields=<field_name>` Required. An event field to transmit to the Adobe App Builder application. You can specify this option multiple times. Each instance can contain only one field name.
+`--fields='{"<name>":"<field-name>", "converter":"<path\to\converterclass>"}'` Required, but the `converter` argument is optional. Specifies an event field to transmit to the Adobe App Builder application. You can specify this option multiple times. Each instance can contain only one field name. The `converter` argument applies the [converter class](convert-field-values.md) to the specified field.
 
 `--force`, `-f` Forces subscription to the event, even if it hasn't been defined locally.
 
@@ -203,6 +203,10 @@ If you are implementing eventing in a performance testing environment, run the `
 
 `--rules=<field-name>|<operator>|<value>` Defines a rule that will be applied to the subscribed event. You can apply multiple rules to an event, but each rule must be defined separately. A rule definition must specify the field to be evaluated, an operator, and the value to be evaluated, in that order. The field name in a rule definition does not have to match a field specified with the `--fields` option.
 
+`--fields='{"<name>":"<field-name>", "converter":"<path\to\converterclass>"}'` Applies the converter class to the given field.
+
+`--destination`, `-d` A custom destination for the event. This argument is used for SaaS integrations.
+
 ### Example
 
 To subscribe to a native event:
@@ -379,7 +383,7 @@ If the depth value of `2` was specified, the response would also include details
 
 ## Generate a Commerce module based on a list of subscribed events
 
-The `events:generate:module` command generates a module with plugins based on your configuration and places it into the Commerce `app/code/Magento/AdobeCommerceEvents` directory.
+The `events:generate:module` command generates a module with plugins based on your configuration and places it into the Commerce `app/code/Magento/AdobeCommerceEvents` directory.  This command is applicable for on-premises deployments only.
 
 ### Usage
 

src/pages/events/configure-commerce.md

@@ -145,6 +145,10 @@ stage:
       consumers: []
 ```
 
+<InlineAlert variant="warning" slots="text" />
+
+The deployment process might become stuck if the consumer runs in the background. The [Troubleshooting](./troubleshooting.md#stuck-deployment-after-configuring-priority-events) topic describes how to resolve this condition.
+
 See [Global variables](https://experienceleague.adobe.com/docs/commerce-cloud-service/user-guide/configure/env/stage/variables-global.html) for more information about the `ENABLE_EVENTING` variable.
 
 Cloud infrastructure and on-premises instances require different cron management procedures as described here: