This release holds improvements and new features that mainly seek to improve the stability, performance, and usability of Activator. Some of these changes are therefore not immediately visible to the end-user. The release also contains numerous bug fixes.

New Features

Import Document

Ensures an AOM document is created or updated whenever a connector imports a document from a DAM. Generates a 'connector-document-imported' event after importing from the client, and maintains the relationship between the client document and AOM document in the documents collection entry using externalId, externalVersion, connector, and metadata. Metadata contains fields imported from the client API, as defined in the client connector configuration.

Client Configuration

Clients can now configure the WebApp and connectors, including features and color schemes, using a new module that reads configuration from ArangoDB. The global setup ensures that deployments can be destroyed and created without losing configuration. Configurations are stored in the "rosalind-configurations" collection within the "_system" database. Each configuration entry is identified by a combination of orgId and connector and retrieves the relevant configuration details based on these properties.

Editor App Connector

The editor script has been moved into its own feature, and a new connector between Activator and the Editor App has been established via the postMessage API. The logic for this connector has been consolidated from the monarch repository and integrated into the Editor Domain of Rosalind. This enhancement includes the essential setup for the connection and message communication with the Editor App, laying the groundwork for more modular features such as undo/redo and notes to be developed separately.

Connector Configuration

Setup of client connector configuration in ArangoDB has been simplified to support convenient implementation in Lambdas that need to consume client configurations for obtaining relevant document metadata fields. A new module was created to read configurations from the global ArangoDB collection, ensuring configurations remain persistent across deployments. The collection is stored in the _system database under rosalind-configurations, and entries can be retrieved using the automatically generated name from orgId and connector properties.

Drag and Drop

Drag and drop functionality has been implemented, allowing users to drag components from the component/media panel into the document viewer/editor, facilitating quicker content creation. This feature, developed as a stand-alone module for future reusability, enhances efficiency by enabling precise placement of elements such as components and assets into desired locations within the canvas.

Activator DNS

Introduced domain creation for solutions, defaulting to a domain derived from the account and deployment environment specified in solution.json, e.g., rosalind-dev, rosalind-qa, and rosalind-prod. Users can also specify custom domain names within deployments. Sub-domains, like login.<namespace>.activator.cloud and api.<namespace>.activator.cloud, have been set up to support integrations.

Database Integration

Implemented ArangoDb integration using Terraform, providing a streamlined and efficient setup process for Activator environments. Integration details can be referenced in the official documentation: https://registry.terraform.io/providers/arangodb-managed/oasis/latest/docs.

Improve and Rewrite Blackburn Components

Significant improvements and rewrites have been made to various Blackburn components, enhancing overall functionality and user experience. Updated components include AlertBar, Avatar, Button, ButtonDropdown, Carousel, Checkbox, Custom Input, DashboardCard, DatePicker, DatepickerDropdown, Editable Text, Infinitescroll, Icon, Image, Input, Label, LayoutCard, Link, List, Menu, MultiOptionButtons, Popover, Popup, RadioButtons, ResizableContainer, Scroll, SelectList, SkeletonLoader, Slider, SrCard, Switch, Tabs, Textarea, ToastMessage (snackbar), Toggle, Tooltip, and Treeview.

Aprimo Domain Integration Enhancement

Enhanced the Aprimo connector to ensure more reliable events and operations. This update resolves previous inconsistencies and improves the overall integration experience with Aprimo domains, making event processing more seamless and efficient.

Editor Domain

The editor app now handles events and operations more efficiently, ensuring improved performance and stability. The source code has been optimized for better maintainability and scalability.

Users Domain

The events and operations within the users domain have been enhanced for improved performance and reliability.

App Domain

The events and operations of the application have been improved to enhance performance and stability, addressing previous inconsistencies and ensuring smoother interactions across various components.

Documents Domain Enhancements

Improved events and operations handling in the documents domain. This includes better performance for document-related events and seamless execution of various document operations, ensuring a smoother user experience.

Open-in-Activator Aprimo Pagehook

Users can now open documents directly in Activator from Aprimo through the 3-dots menu on records. Documentation and configuration guides are available to assist with setting up and using this feature. The URL for the PageHook is also adjustable within Aprimo settings.

Publish Aprimo Document

When publishing a document, AOM now sends the document-published event, prompting connectors to react appropriately. In Aprimo, the process involves uploading the mjml.html file, editing the document record, fetching the masterfilelatestversion field, and extracting the externalVersion via the versionNumber field from the record data. This ensures accurate version control, even if manual updates occur in Aprimo. The feature is triggered by the 'document-published' event with a 'connector':'aprimo' detail, resulting in the output of the 'connector-document-published' event, which includes the AOM document ID, Aprimo document ID, and Aprimo masterfile version number.

Retrieve Aprimo Record

Retrieve metadata about a document in Aprimo using the specified record ID, with the response limited to client-configured data fields. This ensures only the necessary metadata fields are returned, aligning with those used for document creation.

Import Aprimo Document

Users can now import documents from Aprimo using either a general method (by ID only) or a specific method (by ID and document version). The general import will check if any version of the document is available and return the latest one while performing an asynchronous check for newer versions. The specific method will import or return the specified version only. Temporarily stored files are managed by the AOM import document feature.

Aprimo API Integration

Integration with Aprimo API has been enhanced to efficiently manage rate limits, thereby ensuring that the system handles "429 Too Many Requests" responses appropriately. This update facilitates calling Aprimo’s API with the logged-in user's token, improving authentication and user interaction experience.

Auth0 / Aprimo Integration

We've implemented improved integration with Auth0, enhancing the seamless experience between Auth0 and Aprimo for better authorization workflows. For detailed documentation, refer to the Aprimo API Authorization Guide.

Edit Document

Implemented the ability to update various aspects of an HTML document using the anthill-html-updater NPM module. Users can now add, remove, and update elements and their attributes, contents, and styles. The feature processes the document from the S3 ‘documents’ bucket, applies the specified updates, and writes the modified HTML back to the same location. The system returns a 'SUCCESS' message or an error with the document ID upon completion. Relevant event triggers include 'edit-document' for requests and 'document-edited' for responses.

AOM AppConfig

Implemented AWS AppConfig for the internal AOM system using Terraform, which facilitates the creation of necessary AWS resources such as applications and permissions. Additionally, a Lambda function was set up to utilize the configuration for testing purposes, providing a reference implementation for other Lambdas requiring configuration.

WebApp AppConfig Integration

AWS AppConfig has been integrated to manage the configuration of features and user roles within the Activator/Rosalind web app through a JSON document. This setup ensures that the authentication feature retrieves the configuration upon user authentication, enabling or disabling features accordingly. Relevant AWS and Terraform documentation links have been provided for further reference.

Document Designer View

This update enhances the importing functionalities required for the entire designer view including the editor menu, document viewer, and side panels into the Editor Wireframe slots, providing a more integrated and seamless design experience.

Editor Menu

The left side now displays the document icon type, name, and version. The right side includes a Publish button that triggers the 'publish-document' operation in the Documents domain. Separate components can be placed into the editor wireframe slots for better flexibility and customization.

Document Components Panel

The Content Components Panel now integrates with the Fusion library using postMessage API, managed by the editor app for seamless communication. This update includes enhancements to the 'Add' tab and the 'Element' switch. Other tabs and items will be added later. Users can now explore the feature within the document editor, experiencing improved content management and component interaction.

WebApp Frontend

Unified all other frontend features into a fully functional single-page application (SPA) setup, including the establishment of an S3 bucket for seamless deployment by uploading the compiled frontend files.

UI Routing

Resolved issues with setting up paths and URLs for rendering different views more effectively, ensuring smoother navigation throughout the application.

Auth0 Integration

Implemented Auth0 integration using Terraform to enhance authentication capabilities and streamline identity management. Documentation and configuration details can be found here.

User Authentication

Implemented a new user authentication flow ensuring seamless access and integration. Users access the application, which sends a request to the API. The authentication process verifies a valid Auth0 token and authenticates Ably, pulling configurations from AWS for successful user authentication and presence registration. This streamlined integration enhances security and functionality for the client application.

WebApp API

Implemented an API featuring Authentication (Auth0, including Aprimo, Vault, Internal; Ably), AWS AppConfig integration, and hosting services support. An API Gateway resource has been set up, providing endpoints for lambdas that execute separate functionalities. A local server can now be run mocking the API for development purposes. Adhered to established conventions including feature-driven development and Terraform/Terragrunt deployment.

Improvements

Frontend Bundling

Improved frontend bundling to enhance loading times and performance. Updated the build process to include optimized chunk splitting and lazy loading for more efficient resource utilization.

Login

The user interface for the login screen now features a 50/50 split design. For customization details, refer to the documentation at Auth0 Universal Login Page Customization.

Editor Enhancements

Improved the wireframe for the Editor, organizing the interface into distinct slots for the top bar, left panel, document viewer, and right panel. This reorganization enhances usability and facilitates a more streamlined editing experience.

Drag and Drop Enhancements

Users can now easily drag and drop elements such as components and assets into precise locations within the canvas to efficiently build content. This enhancement also allows users to drag elements from outside the platform and drop them into the dashboard, binder, or a document to upload new files seamlessly.

Enable Deleting Elements from Document

Overwritten the “confirm delete” popup, allowing elements to be deleted within Rosalind. This change will be active until the deletion confirmation popup is re-implemented.

Document Viewer Centered

The document viewer is now centered within the application. This enhancement ensures a more visually appealing and user-friendly interface, improving the overall user experience when viewing documents.

Bugfixes

Drag-Data Not Updating

Resolved an issue where drag-data was not updating correctly when elements were moved. This fix ensures that the data associated with draggable items is accurately refreshed upon drag and drop actions.