Adding Custom Tabs to myFileGateway
System Administrators can create new tabs for additional functionality in myFileGateway. This sample is meant to serve as a starting point for the creation of your own custom tabs. Please do not make your changes directly in the <install>/samples directory, as these may be overwritten in a future patch. Instead, you may maintain the WAR file in a directory entirely separate from the <install> directory, as long as the HTTP Server Adapter is configured to find it.
About this task
With this change, every HTTP Server Adapter that hosts myfilegateway.war will also have to host sampletab.war. In particular, visiting http://<host>:<baseport>/myfilegateway will fail unless sampletab.war is copied to <install>/noapp/deploy. If this condition hasn't been met, a request to /myfilegateway will fail to load the login page. Use the browser to visit http://<host>:<baseport>/sampletab/welcomepage.js and verify that the content of that file is shown.
- Modify the <install>/properties/customer_overrides.properties
and add this line:
- Create a permission named "Custom myFileGateway Sample
Tab" with the ID "CUSTOM_MYFG_WELCOME" and an HTTP Server Adapter
instance named "myFileGatewayWithSampleTab" by selecting Tools > B2B
Console > Deployment >Resources Manager >Import/Export and importing
The password for the import file is "password" without the quotes. Import all three assets within the import file.
- Modify the HTTP Server Adapter Instance by selecting
the HTTP Server Adapter that you created in the previous step. Make
- On the first page, set the Group to None.
- On the second page, change the port to one that doesn't conflict with any other port on the instance.
- Enable the adapter instance by clicking the "Enable Service for Business Processes" box on the confirmation page.
- Select and verify that the "File Gateway Partner Users" group includes the permission named "Custom myFileGateway Sample Tab". Custom permissions relating to the custom tabs must be of the "File Gateway" type.
- Restart the server:
- Login to myFileGateway using the port specified in Step 3 to verify that the new tab named "Custom Welcome Page" is visible. The custom tab web application may need to know the name of the user that is logged into myFileGateway. You can determine this by retrieving the HTTP Session attributes "dlssoAuthenticated" and "autho". If the visitor to the custom tab web application authenticated to myFileGateway, the value of the "dlssoAuthenticated" attribute will be the string "true" and the value of the "autho" attribute will be the name of the logged in user as a string.