Autodesk 15606-011408-9300 Developer Guide - Page 87

The Request, Launching the Report

Page 87 highlights

The Request Autodesk MapGuide® Author will use the report settings defined in the Map Window Properties dialog box to construct the URL that is sent to the server. For example, after all of the settings are specified, the URL code might look like this: http://www.myserver.com/reports/ report.cfm&OBJ_TYPE=landuse&OBJ_KEYS='01235639','01235640','01235641' This URL code is a request to launch a ColdFusion template called report.cfm. The template file and the two parameters OBJ_TYPE and OBJ_KEYS are passed to the ColdFusion engine by the Web server. The parameters will serve as arguments or variables that can be used by the ColdFusion template file. Note By default, Autodesk MapGuide Author sends map feature key values to the URL as characters. However, if you specify another data type for the key column, Autodesk MapGuide will send the keys as that type instead. You set the key column type by selecting it from the Type list box on the Data Sources tab of the Map Layer Properties dialog box in Autodesk MapGuide Author. Launching the Report You can launch the View Reports dialog box from Autodesk MapGuide Viewer by right-clicking the map and choosing View ➤ Reports, or by clicking the Report button on the Autodesk MapGuide® Viewer toolbar. Both methods will display a dialog box that shows a list of available reports defined for the map. Using the Autodesk MapGuide Viewer API, you can also launch reports programmatically; you call the View Reports dialog box using viewReportsDlg and launch the report directly using viewReport. Note Autodesk MapGuide Viewer ActiveX Control cannot open reports whose names contain double quotation marks, such as "Server Report". Therefore, if you are developing for Autodesk MapGuide Viewer ActiveX Control, do not use double quotation marks in your report names. Autodesk MapGuide Viewer ActiveX Control can open reports whose names contain single quotation marks, such as 'Server Report'. Overview | 87

  • 1
  • 2
  • 3
  • 4
  • 5
  • 6
  • 7
  • 8
  • 9
  • 10
  • 11
  • 12
  • 13
  • 14
  • 15
  • 16
  • 17
  • 18
  • 19
  • 20
  • 21
  • 22
  • 23
  • 24
  • 25
  • 26
  • 27
  • 28
  • 29
  • 30
  • 31
  • 32
  • 33
  • 34
  • 35
  • 36
  • 37
  • 38
  • 39
  • 40
  • 41
  • 42
  • 43
  • 44
  • 45
  • 46
  • 47
  • 48
  • 49
  • 50
  • 51
  • 52
  • 53
  • 54
  • 55
  • 56
  • 57
  • 58
  • 59
  • 60
  • 61
  • 62
  • 63
  • 64
  • 65
  • 66
  • 67
  • 68
  • 69
  • 70
  • 71
  • 72
  • 73
  • 74
  • 75
  • 76
  • 77
  • 78
  • 79
  • 80
  • 81
  • 82
  • 83
  • 84
  • 85
  • 86
  • 87
  • 88
  • 89
  • 90
  • 91
  • 92
  • 93
  • 94
  • 95
  • 96
  • 97
  • 98
  • 99
  • 100
  • 101
  • 102
  • 103
  • 104
  • 105
  • 106
  • 107
  • 108
  • 109
  • 110
  • 111
  • 112
  • 113
  • 114
  • 115
  • 116
  • 117
  • 118
  • 119
  • 120
  • 121
  • 122
  • 123
  • 124
  • 125
  • 126
  • 127
  • 128
  • 129
  • 130
  • 131
  • 132
  • 133
  • 134
  • 135
  • 136
  • 137
  • 138
  • 139
  • 140
  • 141
  • 142
  • 143
  • 144
  • 145
  • 146
  • 147
  • 148
  • 149
  • 150
  • 151
  • 152
  • 153
  • 154
  • 155
  • 156
  • 157
  • 158
  • 159
  • 160
  • 161
  • 162
  • 163
  • 164
  • 165
  • 166
  • 167
  • 168
  • 169
  • 170
  • 171
  • 172
  • 173
  • 174
  • 175
  • 176
  • 177
  • 178
  • 179
  • 180
  • 181
  • 182
  • 183
  • 184
  • 185
  • 186
  • 187
  • 188
  • 189
  • 190
  • 191
  • 192
  • 193
  • 194
  • 195
  • 196
  • 197
  • 198
  • 199
  • 200
  • 201
  • 202
  • 203
  • 204
  • 205
  • 206
  • 207
  • 208

Overview
|
87
The Request
Autodesk MapGuide
®
Author will use the report settings defined in the Map
Window Properties dialog box to construct the URL that is sent to the server.
For example, after all of the settings are specified, the URL code might look
like this:
report.cfm&OBJ_TYPE=landuse&OBJ_KEYS='01235639','01235640','01235641'
This URL code is a request to launch a ColdFusion template called
report.cfm
.
The template file and the two parameters
OBJ_TYPE
and
OBJ_KEYS
are
passed to the ColdFusion engine by the Web server. The parameters will serve
as arguments or variables that can be used by the ColdFusion template file.
Note
By default, Autodesk MapGuide Author sends map feature key values to
the URL as characters. However, if you specify another data type for the key col-
umn, Autodesk MapGuide will send the keys as that type instead. You set the key
column type by selecting it from the Type list box on the Data Sources tab of the
Map Layer Properties dialog box in Autodesk MapGuide Author.
Launching the Report
You can launch the View Reports dialog box from Autodesk MapGuide
Viewer by right-clicking the map and choosing View
Reports, or by
clicking the Report button on the Autodesk MapGuide
®
Viewer toolbar. Both
methods will display a dialog box that shows a list of available reports
defined for the map. Using the Autodesk MapGuide Viewer API, you can also
launch reports programmatically; you call the View Reports dialog box using
viewReportsDlg
and launch the report directly using
viewReport
.
Note
Autodesk MapGuide Viewer ActiveX Control cannot open reports whose
names contain double quotation marks, such as
Server Report
. Therefore, if
you are developing for Autodesk MapGuide Viewer ActiveX Control, do not use
double quotation marks in your report names. Autodesk MapGuide Viewer
ActiveX Control can open reports whose names contain single quotation marks,
such as
Server Report
.