Console for Web Apps

about console ui the console provides an easy to use, lightweight interface that allows end users of the os1 platform to access apps and solutions developed by multiple developers the user interface (ui) of the console (also known as the console ui) features a persistent and customizable header that allows them to navigate between each app, raise support requests, and manage user preferences os1 developers can provide this experience to their end users by integrating their apps and solutions with the console ui, eliminating the need for custom implementation of login, logout, user navigation functionality, and preference management learn more on how about integrating apps with the console using the console sdk stay stay up to date with the console library versions up to date with the console library versions it's important to ensure that all apps within a solution are using the same version of the console library this is required to maintain a cohesive user experience across all apps within a solution we also recommend using the latest version of the console library so that end customers can access new features login the console provides a single sign in where users are routed directly into their solution from a url that’s been created for their organization users do not have to sign in again when navigating between apps social login os1 platform has the social login enabled that allows users to access os1 applications seamlessly using your existing google or microsoft accounts this feature simplifies the login process by removing the need for multiple passwords or otps, enhancing overall login experience for your tenants/customers key features include enabled by default social login options are available for all tenants without any additional setup works with email and mobile logins your customers can continue to use login with google or microsoft along with email and mobile otp based logins same login experience everywhere you have a consistent and simple login process across all os1 applications, including dispatchone, which improves your workflow and efficiency customize login settings as an admin, you can easily enable or disable social login options to fit your business needs using social login social login is enabled by default for all tenants, allowing you to access os1 applications using your existing google or microsoft accounts default login navigate to the os1 sign in page via \<https www tenant/orgname getos1 com> 2\ both sign in with google and sign in with microsoft options are available by default 3\ upon selecting a social login option, you are redirected to the respective authentication page 4\ you enter your credentials on the chosen provider's page 5\ you’ll be redirected to your os1 dashboard after logging in if you are an authorized user note if you are not an authorized user, an error message stating “not a registered user” appears, along with options to retry or return to the login page configure default login options you can enable or disable the default login options in the console ui settings if you have admin access to customize the settings, follow the below steps sign in to the os1 platform 2\ go to the console navigation bar and click settings 3\ find sign in settings under the system apps section note that you’ll need business owner privileges to make changes 4\ click edit settings to modify the login page settings 5\ uncheck any sign in options you want to disable, and make sure at least one method remains active 6\ review your selections and click save changes to apply the updates 7\ after saving, look for a confirmation message log out and return to the sign in screen to ensure the login options reflect your changes solution selector when a tenant subscribes to multiple solutions, console provides the option for users to select a default solution to navigate to upon logging in users can confirm their selection by clicking save the default solution can be changed and saved in the user preferences in the profile drop down customizable header developers can customize the console ui header by adding different types of controls including a textbox, search box, auto complete, and more this allows developers to tailor the header controls to suit the specific needs of their application for detailed instructions on customizing your header, refer to the integration with console ui guide solution logo and name display solution developers can choose to display their logo in the header of the console the logo will appear next to the 'hamburger' menu in the console header to add a logo, developers can use the artifacts api and upload it as an icon with a size of 40x40px refer to the managing app and solution artifacts developer guide for detailed instructions in addition to the logo, the name of solution will also be displayed next to the logo the display name provided while registering the solution will be used as the solution name tenant logo display tenants can choose to display their logo in the console header, next to their user profile to upload their logo, tenants should contact the os1 support team using the contact us http //developers getos1 com/#/contact us option and provide their logo the logo should have a height and width of 24px each, as per the aspect ratio app navigation customers can use the side navigation menu in the console header to navigate between apps and explore sub menu options however, clicking on an app will only show its sub menu, not its landing page if an app has a landing page of its own then the developers must add the landing page as an option within the app's menu attribute refer to the registering your app guide on how to update the app menu user preferences customizing app navigation and default solution the console provides end users with an option to choose what happens when they click on an app in the side navigation menu upon opening an app for the first time, users will be prompted to select whether they would like to open it in a new tab or the current window additionally, users can update their default solution if applicable these preference can be saved and modified in user preferences in the profile drop down contact us page we provide a text area for users to describe their issues in detail and an option to upload screenshots to help clarify their concerns upon submission, a ticket is automatically created to track the support request a text area describing the user's issues in detail an option to upload a screenshot that may help clarify a user's issue this will then create a ticket to track the support request centralized settings the console provides a centralized settings panel that displays settings for system apps and apps in a solution to include apps in the centralized settings, developers can follow the instructions provided in the register your solution developer guide once these settings are configured, users can easily access them within the console's sidebar, located at the lower right centralized settings behavior centralized settings behavior the settings icon will not appear in the sidebar if there aren't any apps for a user to configure centralized settings options the centralized settings feature system apps, including predefined system apps such as payments, and apps associated with subscribed solutions the example below shows system apps if the payment gateways app was enabled timezone settings initially, the time zone is set to the end user’s preferences and they can personalize it as needed the updated timezone is stored in the browser’s local storage for future sessions integrating with console developers can use the console ui sdk to integrate console ui into their applications the integration facilitates authentication, authorization, and seamless navigation for app users for step by step instructions on integrating with the console ui, refer to the how to integrate your application with the console ui the example below shows the associated track tracker app associated with the last mile delivery v2 solution