## Accessing Visual Analysis via URL

All the parameters are encapsulated as JSON (JavaScript Object Notation) objects. It will help if you obtain some knowledge on JSON to understand the syntax more clearly.

### Definition

ResourceDef: {
"name":"/SampleReports/myVA.va", // Required. The resource file name with its full path. The path could be a disk path or a server resource tree path. For the latter, it could be either in the My Reports folder (/USERFOLDERPATH/admin/) or in the Public Reports folder (/).
"ver":" -1", // Optional. The version number of the resource.
"real":"false" // Optional. Value: true/false. true means the resource path is a real disk path and false means a server resource tree path. When it is a real path, "real":"true" must be specified.
}

// catDef: It's a ResourceDef object to describe a catalog resource.
ResourceDef catDef = {name:"/SampleReports/Sampl.cat"}
jrd_catalog=$catDef
jrd_catalog={
"name":"xxx", // Required. The full path of the catalog.
"ver":"-1", // Optional.
"real":"false" // Optional.
}

// vaDef: It's a ResourceDef object to describe a Visual Analysis resource.
ResourceDef vaDef = {name:"/SampleReports/VisualComponent 1.va"}
jrd_vcres=$vaDef
jrd_vcres={
"name":"xxx", // Required. The full path of the Visual Analysis resource.
"ver":"-1", // Optional.
"real":"false" // Optional.
}

DataSource: {
"catalog":"$catDef", // Catalog.
"ds:"Data Source 1", // Data source name.
"query":"Query1", // Query name.
"bv":"WorldWideSalesBV" // Business view name.
}

// dsDef: It's a DataSource object to describe a Visual Analysis data source.
jrd_datasource=$dsDef
jrd_datasource={
"catalog":"$catDef", // Catalog.
"ds:"Data Source 1", // Data source name.
"query":"Query1", // Query name.
"bv":"WorldWideSalesBV" // Business view name.
}

For the usage of jrd_resext, refer to Running dashboards via URL.

### Examples for creating a new Visual Analysis session

- Create a new session with specified business view information. The data source selection panel will not pop up.

  `http://localhost:8888/webos/app/designer/run.jsp?jrd_datasource=$dsDef`

  `http://localhost:8888/webos/app/designer/run.jsp?jrd_datasource={"catalog":{"name":"/SampleReports/SampleReports.cat"},"ds":"Data Source 1","query":"WorldWideSales","bv":"WorldWideSalesBV"}`

- Create a new session with specified catalog. This entry will pop data source panel and only include business views which belong to the specified catalog.

  `http://localhost:8888/webos/app/designer/run.jsp?jrd_catalog=$catDef`

  `http://localhost:8888/webos/app/designer/run.jsp?jrd_catalog={"name":"/SampleReports/SampleReports.cat","ver":"-1","real":"false"}`

- Create a new session with specified catalog path. This entry will pop data source panel and include all catalogs and business views in them which are under the specified catalog path and its sub folders.

  `http://localhost:8888/webos/app/designer/run.jsp?jrd_catpath={"name":"/SampleReports"`}

- Create a new session without any data source information:

  `http://localhost:8888/webos/app/designer/run.jsp`

  It is equal to the following:

  `http://localhost:8888/webos/app/designer/run.jsp?jrd_catpath={"name":"/"`}

### Examples for opening an existing Visual Analysis template

- `http://localhost:8888/webos/app/designer/run.jsp?jrd_vcres=$vaDef`
- `http://localhost:8888/webos/app/designer/run.jsp?jrd_resext={"reslst":[{"name":"/SampleReports/VisualComponent 1.va",ver:-1,real:false}],active:0}`