Home → Using LincDoc 3.1+ → Reference Information → Manually Specifying a URL
27.2. Manually Specifying a URL
At times, it may be useful or necessary to identify items in your repository using a full URL. Typically, this scenario does not occur, and LincDoc provides simple means for selecting repository files. However, when needed, defining an item using a URL can be used. Since it is a somewhat complicated process, it is highly recommended that you review this entire section before attempting such a task.
Important: If this method of file selection must be used, it will be specified in the online help topic for that particular task, and this topic will be cross-referenced.
Proceed to one of the following sections below for more information:
- Determining the Necessary URL Information
- Building Your URL
- Example: Specifying a Repository File Via a URL
Determining the Necessary URL Information
In order to use a URL to identify an item in one of your repositories, you need to known the following information:
- The name of your LincDoc application context (in most cases, this name will be lincdoc). You can find this application context by examining the URL that is displayed when LincDoc is being used. The application context appears at the end of the URL, as highlighted below.
- Your client ID
- The name of the repository that is storing the file you want to use (in most cases, the resources repository is used).
- The path within the repository that must be followed to access the file. This information is only necessary if you have stored the item in a folder or series of nested folders and subfolders. You can view the path by opening the repository, browsing to the file you want to use, and then examining the path near the top of the repository's dialog box.
In the example below, several images files have been stored in a subfolder called images. - The file's name and extension (such as .jpg, .gif, or .png).
Building Your URL
To build your URL, you need to specify the information described in Determining the Necessary URL Information above in the following order:
/<application_context>/resources/<client_id>/<repository_name>/<repository_path_to_file>/<file_name>.<file_extension>
Example: Specifying a Repository File Via a URL
In this example, let's assume that the following information is known:
- A file has been uploaded to the resources repository called med_symbol_thumb.png.
- The path to the file contains a main folder (images) and one subfolder (thumbnails). The file itself is located in the thumbnails subfolder.
- The name of the application context being used is lincdoc.
- The client ID is users.
Using this information, the URL that would be used to specify this file would be:
/lincdoc/resources/users/resources/images/thumbnails/med_symbol_thumb.png