Compose View URLs

By default, the Meridian Explorer website opens to the Welcome page, where the user can begin browsing and searching the repository. The default URL of the site is: http://<ServerName>/bcenterprise or http://<ServerName>/bcenterprise/home.aspx. Under some circumstances or for some users, you might want the website to open to a specific view with a specific document or tag filter, optionally disable other navigation, and show the items as thumbnails. You can achieve these and similar results by composing a URL that specifies the view to open and other parameters. You can then place the URL in a hyperlink on a different site or in a shortcut on the user's desktop.

The URL is similar for the Meridian Explorer mobile website. The website can be opened by a URL with the schema name bluecielo and the username and password:

bluecielo:<ServerName>/<UserName>/<Password>?

The maximum number of results that appear for a filter URL is 1,000.

ClosedURL Parameters

The Meridian Explorer URL accepts the optional parameters described in the following table. The view and filter IDs can be found in Meridian Enterprise ServerAdministration Console as the names that are automatically assigned to them.

Meridian Explorer URL parameters

Parameter

Description

COMMENTS

If set to True, shows the Comments page of the document or tag. This parameter is intended to be used in the URL of a custom external page in Meridian Enterprise PowerUser. The page can be useful for Meridian Enterprise users to see the comments entered in Meridian Explorer.

Use the following VBScript expression to calculate a URL that specifies an external property page in Meridian Enterprise. Replace <ServerName> with your web server name and modify the ViewID parameter to specify the view definition. Then Meridian Enterprise users can view the comments entered by Meridian Explorer users. For more information about configuring an external property page for Meridian Enterprise, see Configure External Pages.

“http://<ServerName>/BCEnterprise/Home.aspx?ViewID=DOC_E91E5&
GLOBALID=” & Cstr(Document.ID)& “&COMMENTS=True”
  • If the URL will be shown as an external property page in Meridian Enterprise and the specified view is configured to show renditions and the Enable PDFTron viewer for PDF documents option is enabled as described in Configure the Viewer Options, the rendition may not appear in PowerUser unless the following registry values are set:

    For 32-bit, set the DWORD value PowerUserU.exe to 0000270f at:

    HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\
    Microsoft\Internet Explorer\Main\FeatureControl\
    FEATURE_BROWSER_EMULATION

    For 64-bit, set the DWORD value PowerUser.exe to 0000270f at:

    HKEY_LOCAL_MACHINE\SOFTWARE\
    Microsoft\Internet Explorer\Main\FeatureControl\
    FEATURE_BROWSER_EMULATION

DEFVIEW

Optional display mode in which to show the results pane. May only be used with VIEWID. If this parameter is set to THUMBNAIL, items in the view pane appear as thumbnail images. If this parameter is set to any other or no value, the items appear in a grid view.

DOCFILTER

Optional ID of an item filter to apply to the specified view. The filter specifies which documents are included using property matching. If the filter specifies property value criteria, the property values must be specified in placeholders in the URL. The criterion operator in the filter definition will be used and should not be specified in the URL. If no value is specified in the URL for the property value criteria of a filter, the filter always evaluates to True. For information about creating item filters, see Create And Edit Item Filters.

GLOBALID

Optional value of the Meridian Enterprise Document ID property of the document or tag for which to show comments. This parameter is intended to be with the COMMENTS parameter in the URL of a custom external page in Meridian Enterprise PowerUser.

HIDEVIEWBAR

When missing (default) or set to TRUE, hides the views bar at the bottom of the page. This parameter is intended for use when Meridian Explorer is integrated with another system and only the Documents view is relevant. The views bar can be hidden entirely as described in Customize the User Interface.

HOME

When missing (default) or set to YES, shows links to the home page. When set to NO, hides the home page links. This parameter is intended for use with the MOD parameter to show a substitute view.

ID

One or more document IDs to show in a view specified by the VIEWID parameter. Separate multiple IDs with the semicolon (;) character. For example:

http://MyServer/bcenterprise/Home.aspx?VIEWID=DOC_E91E5&ID=100;101;102

ISOLATION=TRUE

Hides the views bar and the HOME tab in the ribbon menu bar when one document or a list of documents is previewed in a new browser window, such as from within a maintenance management system.

MOD

When set to one of the shortcuts listed in Meridian Enterprise Server URL Shortcuts, shows that view instead of the home page.

MRU

When missing (default) or set to YES, shows a group of the most recently used view names on the home page. When set to NO, it shows the welcome text instead of the view names.

NAVSTATE

Optional display state of the navigation pane in the browser. May only be used with VIEWID. If this parameter is set to HIDE, the pane is collapsed and the results pane expands to full window width. If this parameter is set to any other or no value, the navigation pane is visible.

PACKAGEID

Export package ID to show on the Collections page by the VIEWCAT parameter as in the following example.

http://MyServer/bcenterprise/home.aspx?RN=MyRepository&ViewCat=MyPackage&PACKAGEID=10

Also used for the ID of a package to show on the Import Packages page by the import URL shortcut described in Meridian Enterprise Server URL Shortcuts. For example:

http://MyServer/bcenterprise/import?PACKAGEID=10

RN

The repository name to open. The asterisk (*) wildcard character may be specified to open the first available repository.

TAGFILTER

Optional ID of an item filter to apply to the specified view. Typically, this filter is used to specify which assets are included using indirect linking. If the filter specifies property value criteria, the property values must be specified in placeholders in the URL. The criterion operator in the filter definition will be used and should not be specified in the URL. If no value is specified in the URL for the property value criteria of a filter, the filter always evaluates to True. For information about creating item filters, see Create And Edit Item Filters.

TagNumber Optional value of the Tag Number property of the tag for which to show its related documents.

UPLOAD

When set to 1, the Upload button will be available in the toolbar of the Related Documents page. When set to 0 (default), the button is not shown. This parameter is intended for use when the view is shown from within a maintenance management system.

Users can click the button to upload files to the Meridian Enterprise source vault of the repository. The files will be uploaded to the first vault that is a source of the synchronization job of the repository. You cannot specify one vault from among multiple sources. If no source vault is configured for the synchronization job, an error will occur.

The Meridian Portal web application web.config file should also be modified to configure the maximum acceptable file size (in KB) to upload, similar to the following. Files larger than this will fail to upload. The default is 4096:

<httpRuntime maxRequestLength="1048576" />

The AIMS_Attach_Intialize event procedure must also be implemented (to assign a document type to the uploaded documents, for example) as described in Asset Management Events. The optional AIMS_Attach_Before and AIMS_Attach_After events may also be implemented.

VIEWCAT

The item type view to open. The supported types are DOC, TAG, Project, and Package.

VIEWID

The ID of the view to open. When a document view is specified, all documents will be listed that match the filter specified by DOCFILTER or are related to a tag that matches the filter specified for TAGFILTER. When a tag view is specified, all tags will be listed that match the filter specified by TAGFILTER or are related to a document that matches the filter specified for DOCFILTER. Required for use with the Meridian Asset Management Module.

VIEWMODE

Optional display mode of the detail pane. If this parameter is set to DETAILS, the details page of the first item in the result set will be shown.

ClosedExamples

Following are some examples of using the client URL parameters.

  • Open the default documents view for the repository MyRepos:

    http://<ServerName>/BCEnterprise/Home.aspx?RN=MyRepos&VIEWCAT=DOC
  • Open the view named DOC_E915 of the default repository:

    http://<ServerName>/BCEnterprise/Home.aspx?VIEWID=DOC_E91E5
  • Open the view named DOC_E915 of the default repository and apply the document filter named 123456.

    http://<ServerName>/BCEnterprise/Home.aspx?VIEWID=DOC_E91E5&DOCFILTER=123456
  • Open the view named DOC_E915 of the default repository and apply the tag filter named 222222:

    http://<ServerName>/BCEnterprise/Home.aspx?VIEWID=DOC_E91E5&TAGFILTER=222222
  • Open the view named DOC_E915 of the default repository, apply the document filter named 123456, and apply the tag filter named 222222:

    http://<ServerName>/BCEnterprise/Home.aspx?VIEWID=DOC_E91E5&DOCFILTER=123456&TAGFILTER=222222
  • Open the view named DOC_E915 of the default repository, apply the document filter named 123456, and pass the value ABC for the filter criterion with property SITEID:

    http://<ServerName>/BCEnterprise/Home.aspx?VIEWID=DOC_E91E5&DOCFILTER=123456&SITEID=ABC
  • Open the view named DOC_E915 of the default repository, apply the document filter named 123456, pass the value ABC for the filter criterion with property SITEID, hide the navigation pane, and display the results pane in thumbnail mode:

    http://<ServerName>/BCEnterprise/Home.aspx?VIEWID=DOC_E91E5&DOCFILTER=123456&SITEID=ABC&NAVSTATE=HIDE&DEFVIEW=THUMBNAIL
  • Open the view named DOC_E915 of the default repository and show the Comments page for the current document.

    Use the following VBScript expression to calculate a URL that specifies an external property page in Meridian Enterprise PowerUser. Replace <ServerName> with your web server name and modify the ViewID parameter to specify your view definition. Then Meridian Enterprise users can view the comments entered by Meridian Explorer users.

    “http://<ServerName>/BCEnterprise/Home.aspx?ViewID=DOC_E91E5&GLOBALID=” & Cstr
    (Document.ID)& “&COMMENTS=True”
  • Open the Meridian Explorer mobile website, apply the document filter named 123456 and the tag filter named 654321, pass the filter template criteria WO=123 and FUNCLOC=ABC, and title the results Related Documents.

    bluecielo:<ServerName>/<UserName>/<Password>?DOCFILTER=123456&TAGFILTER=654321&WO=123&FUNCLOC=ABC&TITLE=Related Documents
  • Open the view named DOC_MASTERS of the default repository in list mode, hide the navigation pane, apply the tag filter named F00001, and show the documents related to tag ABC123 in a list.

    https://<ServerName>/BCEnterprise/Home.aspx?VIEWID=DOC_MASTERS&TAGFILTER=F00001&DEFVIEW=LIST&NAVSTATE=HIDE&VIEWMODE=LIST&TAGNUMBER=ABC123

2024