diff --git a/products/nexus/getting-started.md b/products/nexus/getting-started.md index 08a4ea249..aeea6d5e4 100644 --- a/products/nexus/getting-started.md +++ b/products/nexus/getting-started.md @@ -10,7 +10,7 @@ nav: - Shopware 6.7 or newer - Active Shopware subscription -- Beta access granted by Shopware +- Early Access granted by Shopware - Nexus service activated - Active Shopware services - Accept Shopware Service T&C's @@ -28,14 +28,14 @@ nav: Your shops are pulled from the Shopware Business Platform. :::warning -Beta Limitation - Only the first company linked to your user account is used. As such, only shops linked to that first company will be available in Nexus. +Early Access Limitation - Only the first company linked to your user account is used. As such, only shops linked to that first company will be available in Nexus. ::: ## Create workflow To create a workflow, follow the instructions in the [user documentation](https://docs.shopware.com/en/shopware-6-en/shopware-services/shopware-nexus?category=shopware-6-en/insider-previews). -## Known Limitations - Beta-Specific +## Known Limitations - Early Access | Limitation | Workaround | |------------|------------| diff --git a/products/nexus/index.md b/products/nexus/index.md index 6f186d1c3..7aa0f393e 100644 --- a/products/nexus/index.md +++ b/products/nexus/index.md @@ -7,9 +7,15 @@ nav: # Shopware Nexus Overview :::warning -**Beta Notice** +**Early Access Notice** -Shopware Nexus is currently in **beta** status. The range of functions is limited and may expand in future updates. Behaviour and scope may change. +Shopware Nexus is currently in **Early Access**. The range of functions is limited and may expand in future updates. Behaviour and scope may change. +::: + +:::info +**Questions or feedback?** + +Join the [Nexus club](https://hub.shopware.com/clubs/nexus) to ask questions, share feedback, and help shape where Nexus goes next. ::: Shopware Nexus is a unified platform for **event-driven automation and integration**. @@ -22,8 +28,9 @@ It empowers merchants to orchestrate systems visually using low-code simplicity, - Syncs data bidirectionally between Shopware and external systems (e.g., Microsoft Dynamics Business Central) - Enables conditional logic and data transformation without coding - Provides real-time execution monitoring +- Manages team access with role-based permissions -## Available in beta +## Available in Early Access | Feature | Description | |----------|------------| @@ -38,26 +45,28 @@ It empowers merchants to orchestrate systems visually using low-code simplicity, | S3 Storage | Store data on S3 | | Data Transformation | Map and filter data | | Expression Placeholders | Placeholders to insert event data into templates | -| Execution Monitoring | Track runs & metrics | +| Execution Monitoring | Track runs & metrics, including per-node timeline and payloads | | Delay Node | Add timed delays between steps | +| Workflow Versioning | Published version history with compare and restore | +| User Management & Roles | Admin, Builder, and Viewer roles per company | -## Limitations in beta +## Limitations in Early Access -The following capabilities are **not available during the beta phase**: +The following capabilities are **not available during Early Access**: - SLA guarantees - 24/7 support - Multi-region deployment (EU only) -- On-premise/self-hosted deployment - Workflow marketplace -## Coming after beta +Nexus is a managed cloud service. On-premise and self-hosted deployment are not being considered at this time. + +## Coming after Early Access | Feature | Planned For | Description | |----------|------------|------------| | AI-Assisted Authoring | GA | Intelligent suggestions | | Advanced Analytics | GA | Performance insights | | Per-Tenant Quotas | GA | Usage & billing | -| Workflow Versioning UI | GA | Rollback support | | Additional ERP Connectors | Post-GA | SAP, Oracle, etc. | | Custom Node Development | Post-GA | Custom workflow nodes | diff --git a/products/nexus/security.md b/products/nexus/security.md index 1af2da0de..2c567acdc 100644 --- a/products/nexus/security.md +++ b/products/nexus/security.md @@ -20,3 +20,13 @@ nav: | Missing event data | Inspect payload with Log node | | BC filter returns empty | Validate OData syntax | | Slack message not sent | Re-authorize Slack | + +### Activating the Nexus ingestion service + +If runtime extension management is disabled (common on composer-managed installations), the **Shopware Nexus Event Ingestion Service** cannot be activated from the Administration. Activate it from the CLI instead: + +```bash +bin/console app:activate ShopwareNexusIngestionService +``` + +Still stuck? Ask in the [Nexus club](https://hub.shopware.com/clubs/nexus). diff --git a/products/nexus/user-management.md b/products/nexus/user-management.md new file mode 100644 index 000000000..c80f7f1eb --- /dev/null +++ b/products/nexus/user-management.md @@ -0,0 +1,40 @@ +--- +nav: + title: User Management + position: 5 +--- + +# User Management + +Nexus access is scoped to your company. Every user who belongs to the company +is assigned a role that controls what they can see and do. + +## Roles + +| Role | Access | +|------|--------| +| Admin | Full access — can manage users, settings, and all workflows | +| Builder | Can create and edit workflows, but cannot manage users or settings | +| Viewer | Read-only access — can view workflows and execution results | + +## Managing users + +Admins manage users from the **User management** screen, which lists everyone +in the company with their role and status (Active, Inactive, Pending). + +From here, an Admin can: + +- **Invite** a new user by email and assign an initial role +- **Change permission** to move a user between roles +- **Remove** a user from the company + +:::info +To keep companies from being locked out, you cannot change your own role, and +the last remaining Admin cannot be demoted. +::: + +## Invitations + +Invited users appear as **Pending** until they accept. Admins can resend or +revoke a pending invitation at any time. Once accepted, the user becomes Active +with the role they were assigned. diff --git a/products/nexus/workflow.md b/products/nexus/workflow.md index d11bd7f5b..f0e9cfb28 100644 --- a/products/nexus/workflow.md +++ b/products/nexus/workflow.md @@ -31,9 +31,13 @@ Typical structure: | Canvas | Visual workspace | | Node Palette | Available nodes | | Node Configuration | Params, Credentials, Notes, Debug | -| Toolbar | Save, Publish, Execute, Undeploy | +| Config Templates | Save and reuse node configurations across workflows | +| Toolbar | Save, Publish, Run, Undeploy, Import/Export | | Execution Tab | Run history and metrics | +A workflow can also be run manually with an optional input payload, and +workflows can be exported to or imported from JSON for backup and sharing. + ## Workflow states | State | Description | Available Actions | @@ -54,13 +58,25 @@ Workflows move through these states from creation to active execution. - Execution duration - Messages processed per node - Error counts and latency +- Node timeline showing each node's step, label, status, and runtime +- Per-node payload inspection as formatted JSON ## Current Monitoring Limitations -- No per-node execution logs -- Limited payload inspection - Manual refresh required +## Versioning + +Each time you publish a workflow, Nexus stores an immutable version in its +history. From the **Versions** panel you can: + +- Review every published version with its author and publish time +- Compare two versions to see node, connector, and setting changes +- Restore an earlier version, which replaces the current draft (existing + published versions are untouched) + +A workflow must be deactivated before you can restore a version. + ## Node types ### Trigger nodes