Office 365
- With this feature, HOD Hex Client users can send green screen content to Office 365 applications like Excel, OneNote, and Mail.
- Users must register the application by creating an application registration in Azure Active Directory (Azure AD).
- Select Overview, After the application is successfully registered.
- Copy the Application (client) ID and save the values in web.xml under web-content in the HOD Hex Client application.
<context-param>
<param-name>clientid</param-name>
<param-value> xxxx-xxxx-xxxxx </param-value>
</context-param>- After placing the ID, the user can send green screen data or some part of the screen (by providing row and column values) to Office365 applications like Excel, OneNote, and Mail.
- After giving the user credentials in the authentication popup, the user can send the green screen data via Excel, OneNote, and Mail.
- For Excel,
- The user must give the Workbook name, Sheet name, and Starting point of the cell (EX: B3). By default, it is A1. Users can also create a chart.
- The user must enter the file name to create a file. Then the file will get listed in the filename table. Users can click the open icon in the table to view the selected file. By selecting the file in the table and clicking the Add sheet+, the user can create a sheet in the respective file. The user must give the sheet name and click the Add button to add the sheet to the file. If the user selects a file from the table, then the corresponding sheets of that file are listed in the sheets section of the table. By selecting the sheet, the user can click Add chart+ to create the chart in the respective sheet. The user can select the respective file or sheet and click the delete button to delete the file or sheet.
- For OneNote, the user must give a Unique Notebook name for each document. The Section name and Page name are optional. After creating a file in OneNote, the file will be listed in the filename table. The user can view the respective file with the data by clicking the open icon in the table.
- For Mail, the user must give the complete recipient address. The Subject line and Comment section are optional for this application. The recipient address can be a single or multiple addresses. The user can send the green screen data by clicking the send button.
Config Server-based model log-in with Microsoft Authentication:
In HOD, users have an option “Automatically log users on to Host On-Demand using their Windows username” for the Configuration server-based model to enable the login option with Windows credentials. By enabling the same option in HOD Hex Client, users can log in to the configuration server-based model page with Microsoft credentials.
Create Configuration server-based model in DW for HOD Hex Client:
In the deployment wizard, select the Configuration server-based model and enable the “Automatically log users on to Host On-Demand using their Windows username” option.
- Users are from the Windows domain: It is optional. If needed, enter the dummy value
- Create a User ID if does not exist?
- Yes - Enter the group name where the user needs to be created.
- No - Choose this option if the user already exists.
Follow the below steps to set up the HOD Hex Client:
- Register the HOD Hex Client application in Microsoft Azure AD using Microsoft credentials.
- After registration, get the ClientID & RedirectURL and configure it in HOD Hex Client build (EAR/WAR – need to update Client ID and RedirectURL in web.xml file).
- After configuration, launch the Config server-based model in HOD Hex Client.
- While launching the Config server-based model, Microsoft Authentication will pop up. Here, users need to provide MS credentials to log in.
- Once login is successful, the Config server-based model page will be launched.
- For the first time log-in, the user will be created with the name of MS mail ID’s first half under the mentioned group.
- If the mail id name part contains other than a dot(.) and a hyphen (-), the special characters are replaced with a hyphen (-).
- If the user does not configure the application with ClientID and RedirectURL, then the MS authentication fails, and a warning message pops up like Configuration not done properly/wrong credentials.
- While launching HOD Hex Client, check the user in the mentioned group. If the user already exists, the page will be launched.
- If the user does not exist in the mentioned groups, it will create a new user in the mentioned groups.
- While creating a user, check in the HOD user/group window whether the ‘Allow users to create accounts’ checkbox is selected.
- If Allow users to create accounts checked, users will be created in the mentioned groups.
- If Allow users create accounts checkbox is clear, the HOD Hex Client page and a warning message for authentication exception will go through.
- If the mentioned groups do not exist in the HOD user/group, the HOD Hex Client page will through a warning message for the group does not exist exception.
- Go with this option only when the user exists in any group.
- If a user exists, the HOD Hex Client page will be launched, or else the page pops up a warning message for the user does not exist exception.