Managing modules and their synchronization in Agile.Now

In Workspace Hub, modules are crucial components, representing individual applications within your product. Understanding how to manage and synchronize these modules is key to maintaining the functionality and security of your applications.

What are Product Modules?

• Nature of Product Modules:
  • Product modules are standalone applications or services that correspond to those defined within Agile.Now Access Management.
  • They serve as the foundational elements of your product, each designed to encapsulate and deliver a distinct set of features or capabilities.
  • Modules can qualify as end-user applications if they are configured to be accessible within Access Group user management through the "End-user application" option in module settings.
  • A module can also represent a cohesive category that amalgamates various features of your application into a single, visually coherent entity. For instance, a "Patient" module might encompass features like "Patient Laboratory Results" and "Patient History," forming a crucial part of an end-user application like a Patient Portal.
    

Importing and Managing Modules

• Importing Modules:

  • Modules are imported from the SaaS platform Access Management application provided tenant, which is the default tenant in the your SaaS environment.
  • The system automatically imports applications that are connected to your subscription or you have added applications via the REST interface.
  • During import, the module’s name, description, “End-user application” information, and a photo are captured from the platform.

• Module Information:

  • Once a module is created from SaaS platform, its name, description, and image do not update automatically to Workspace Hub. This allows for flexibility in updating these elements without affecting the module’s technical functionality.
  • Module status will be updated according application status.

Exporting and Managing Modules

• For exporting, modules are sent from the Workspace Hub application back to the provided tenant, which acts as the default environment in your SaaS platform. Only modules whose status is "Active" are synchronized.
• The export process involves capturing the module’s name, description, end-user application status, and activity status from the product management application. This step allows for the technical name and description to be updated according to business needs.
• Concurrently, the module's hierarchical structure is adjusted to align with business requirements, ensuring that the organizational and functional integrity of your product is maintained.

Synchronization of Modules

• Purpose of Synchronization:

  • Synchronization ensures that any changes in the module are reflected in the Agile.Now SaaS applications.
  • This means that with product management you can manage applications and roles that are used by end customers without application programming.

• How to Synchronize:

  • Use the ‘Synchronize’ function in the ‘Modules’ list of the product management application to update the module information.

Visibility and Access Control

• Managing Module Visibility:
  • The visibility of a module to end-users can be controlled. By deactivating the "End-user application" button, the module will not be visible in the application menu or on the home page for end-users.
  • However, it remains visible in the "Security" application, where it can be configured with login methods and other settings.
  • It is also visible in the "Access Management" application, allowing for the assignment of permissions.

Best Practices for Module Management

• Regular Review and Synchronization:

  • Periodically review and synchronize your modules to ensure consistency with the SaaS environment.

• Visibility and Access Considerations:

  • Carefully manage the visibility of each module based on its readiness and intended user audience.
  • Regularly update access permissions in the "Access Management" application to reflect changes in user roles or module functionalities.

Conclusion

Effectively managing modules in Agile.Now, including their synchronization and visibility, is critical for maintaining the integrity and effectiveness of your SaaS applications. By understanding these aspects, you can ensure that your product modules are up-to-date, secure, and accessible to the appropriate users. Remember, synchronization and access control are key to providing a seamless and secure user experience in Agile.Now.