DocumentInformation

DocumentType: TechNote

  

	AppliesTo
	Product(s):	ProjectWise Web Explorer Lite (WEL)
	Version(s):	All
	Environment:	N/A
	Area:	N/A
	Subarea:	N/A
	Original Author:	Bentley Technical Support Group LegacyDocumentNumber: 8360

 

 

 

 

 

 

 

 

Overview

ProjectWise Web Explorer Lite has added the ability to add logon credentials to any valid URL. This means that a customer can form a URL that will allow them to display folder contents, document properties or publish a file using Document Publisher or Bentley Publisher.

By default this feature is not enabled. To enable it, modify the web.xml file located in the <installdir>\projectwise\webserver\webapps\WEL\WEB-INF directory.

Change the Filter Mappings section

The user Id and Password are added to the URL or request package for a given document or folder action. In order to add some level of security to the process the password must be base64 encoded. This is the same password encryption that web browsers use for basic authentication. It is further recommend that the customer runs the server in SSL mode (HTTPS). Forming the URL A typical URL to view a document from Web Explorer Lite looks like: http://servername/WEL/servlet/LiteServlet?REQUEST_TYPE=VIEW&DSId=datasourceName&VaultId=61&DocId=50 In order to login from another system 3 pieces of information must be added to the URL. The users login id, base64 encoded password and the server name of the server the datasource is published on. Item Required URL Variable Comment Login Id Password Datasource Server Name Id Pw DSServer Plain text user login Base 64 encoded password Host name of the server in which the DSid datasource is running   ProjectWise Web Explorer Lite ships with 2 tools to make forming the URLs easier. A javascript file that can be used in the customers application to base64 encode the password for use in the URL. The javascript file is in: <installdir>\projectwise\webserver\webapps\WEL\gfx\styles\base64.js A sample HTML page that will assist in generating URLs. User is prompted for required information and URLs are generated for viewing a Document List, Document Properties and viewing a document. The URL page generation page is located in <installdir>\projectwise\webserver\webapps\WEL\ WELUrlGen.htm http://servername/WEL/ WELUrlGen.htm Please note that the parameter names and values are case sensitive. The following is a list of request type available. Datasources LiteServlet?REQUEST_TYPE=GetDSList Input &Parameters=refresh Output Retrieve all registered datasources in the ProjectWise Web Application Server machine Style Sheets DS.xsl Remarks None   LiteServlet?REQUEST_TYPE=LoginScreen Input &DSId=<datasource_name> &DSServer=<pw_app_server_hostname> Output Show ProjectWise login screen Style Sheets LoginScreen.xsl Remarks This screen is not mandatory as users are prompted for login when LiteServlet requests occur without an opened session.   LiteServlet?REQUEST_TYPE=Logout Input &DSId=<datasource_name> Output Close user session Style Sheets LoggedOut.xsl Remarks None   Vaults LiteServlet?REQUEST_TYPE=GetVaultList Input &DSId=<datasource_name> &VaultId=<vault_id> Output List sub-vaults for the selected vault Style Sheets DS.xsl Remarks &vaulted=0 would return all root vaults.   LiteServlet?REQUEST_TYPE=RemoveVaultList Input &DSId=<datasource_name> &VaultId=<vault_id> Output Collapse sub-vaults for the selected vault Style Sheets DS.xsl Remarks &vaulted=0 would collapse all root vaults.   LiteServlet?REQUEST_TYPE=GetDocList Input &DSId=<datasource_name> &VaultId=<vault_id> Output Retrieve all documents for the selected vault. Style Sheets Document.xsl Remarks Access control applies. Users would only see documents that they have access to.   Documents LiteServlet?REQUEST_TYPE=Properties Input &DSId=<datasource_name> &VaultId=<vault_id> &DocId=<document_id> Output Return attributes in "General" sheet. Style Sheets Properties.xsl Remarks This shows the "General" sheet in ProjectWise Explorer.   LiteServlet?REQUEST_TYPE=ShowGeneral Input &DSId=<datasource_name> &VaultId=<vault_id> &DocId=<document_id> Output Return attributes in "General" sheet. Style Sheets Properties_General.xsl Remarks If LiteServlet?REQUEST_TYPE=Properties is called, you can switch between property page without the above parameters.   LiteServlet?REQUEST_TYPE=ShowAttributes Input &DSId=<datasource_name> &VaultId=<vault_id> &DocId=<document_id> Output Return attributes in "Attribute" sheet. Style Sheets Properties_Attributes.xsl Remarks If LiteServlet?REQUEST_TYPE=Properties is called, you can switch between property page without the above parameters.   LiteServlet?REQUEST_TYPE=ShowMoreAttributes Input &DSId=<datasource_name> &VaultId=<vault_id> &DocId=<document_id> Output Return attributes in "More Attributes" sheet. Style Sheets Properties_MoreAttributes.xsl Remarks If LiteServlet?REQUEST_TYPE=Properties is called, you can switch between property page without the above parameters.   LiteServlet?REQUEST_TYPE=ReferenceFiles Input &DSId=<datasource_name> &Set=<set_id> Output Return a document list show all the reference files for the selected file. Style Sheets Document.xsl Remarks LiteServlet?REQUEST_TYPE=ReferenceFiles is also applicable to flatset.   LiteServlet?REQUEST_TYPE=View Input &DSId=<datasource_name> &VaultId=<vault_id> &DocId=<document_id> Output View the select file using an appropriate viewer defined in global.viewers.properties. Style Sheets vpr.xsl Bentley Publisher ActiveX viewer Publish.xsl Bentley Publisher Java viewer TextPage.xsl Document Publisher viewer Remarks If no viewer is associated to the select file type, WEL would perform the action defined in "noviewer.action" in "PWLiteServlet.properties". Default is "copyout".   LiteServlet?REQUEST_TYPE=CopyOut Input &DSId=<datasource_name> &VaultId=<vault_id> &DocId=<document_id> Output Copy ouy the select file. Style Sheets Download.xsl Remarks If no viewer is associated to the select file type, WEL would perform the action defined in "noviewer.action" in "PWLiteServlet.properties". Default is "copyout".   Queries LiteServlet?REQUEST_TYPE=OpenSearches Input &DSId=<datasource_name> &QueryId=<query_id> Output Expand "Searches" list in WEL. Style Sheets DS.xsl Remarks Use &QueryId=0 for root.   LiteServlet?REQUEST_TYPE=QueryByForm Input &DSId=<datasource_name> &Environment=<environment_id> Output Display ProjectWise default search form for the selected environment. Style Sheets QueryForm.xsl Remarks None   Examples for the various Request Types http://KMBPWWEB/WEL/servlet/LiteServlet?REQUEST_TYPE=Login&DSId=Kevin_Oracle9i&DSServer=matrix&Id=admin&Pw=YmVudGxleQ== http://KMBPWWEB/WEL/servlet/LiteServlet?REQUEST_TYPE=View&DSId=Kevin_Oracle9i&DSServer=matrix&Id=admin&Pw=YmVudGxleQ==&VaultId=137&DocId=1 http:// KMBPWWEB\WEL/servlet/LiteServlet?REQUEST_TYPE=Properties&DSId=Kevin_Oracle9i&DSServer=matrix&Id=admin&Pw=YmVudGxleQ==&VaultId=137&DocId=1 http://KMBPWWEB/WEL/servlet/LiteServlet?REQUEST_TYPE=ShowAttributes&DSId=Kevin_Oracle9i&DSServer=matrix&Id=admin&Pw=YmVudGxleQ==&VaultId=137&DocId=1 http://KMBPWWEB/WEL/servlet/LiteServlet?REQUEST_TYPE=CopyOut&DSId=Kevin_Oracle9i&DSServer=matrix&Id=admin&Pw=YmVudGxleQ==&VaultId=137&DocId=1 http://KMBPWWEB/WEL/servlet/LiteServlet?REQUEST_TYPE=OpenSearches&DSId=Kevin_Oracle9i&DSServer=matrix&Id=admin&Pw=YmVudGxleQ==&QueryId=0   See Also Product TechNotes and FAQs ProjectWise TechNotes And FAQs External Links Bentley Technical Support KnowledgeBase Bentley LEARN Server Comments or Corrections? Bentley's Technical Support Group requests that you please confine any comments you have on this Wiki entry to this "Comments or Corrections?" section. THANK YOU!