Client Actions Upload
Configuration
The namespace for the upload parameters is urn:com.cohga.spatial.upload#1.0
, so the following should be added to the list of namespaces at the top of the config file:xmlns:upload="urn:com.cohga.spatial.upload#1.0"
Then you can create a new top level configuration item to contain the customisation to the upload parameters.
The following upload parameter examples are each showing examples of changing one part of the upload configuration, when creating for your configuration for the upload there should only be a single <upload:parameters/>
item
<upload:parameters> <cleaning maximumFileAgeInHours="96" checkDelayInHours="6" /> <projections label="Projection"/> <csv xlabel="X Field Column" ylabel="Y Field Column"/> <drawing timeout="60"/> </upload:parameters>
<upload:parameters> <projections> <entry value="EPSG:4326">Geographic (WGS84)</entry> <entry value="EPSG:4283">Geographic (GDA94)</entry> <entry value="EPSG:20254">MGA Zone 54 (AGD66)</entry> <entry value="EPSG:20255">MGA Zone 55 (AGD66)</entry> <entry value="EPSG:28354">MGA Zone 54 (GDA94)</entry> <entry value="EPSG:28355" default="true">MGA Zone 55 (GDA94)</entry> <entry value="EPSG:3111">VicGrid94 (GDA94)</entry> </projections> </upload:parameters>
<item action="com.cohga.spatial.upload.uploadFile" text="Upload"/>
<item action="com.cohga.spatial.upload.uploadFile"> <maxFileCount>5</maxFileCount> <windowTitle>Upload File</windowTitle> <windowWidth>400</windowWidth> <windowHeight>300</windowHeight> <addText>Add</addText> <addTooltip>Add local files</addTooltip> <clearAllText>Clear</clearAllText> <clearAllTooltip>Clear all uploading files</clearAllTooltip> <uploadText>Upload</uploadText> <uploadTooltip>Upload All Files</uploadTooltip> <stopText>Stop</stopText> <stopTooltip>Stop uploading</stopTooltip> <step1PromtText>Please select files</step1PromtText> <supportedFormats><![CDATA[ Supported formats are:<p> <ol> <li>- Keyhole Markup (.kml or .kmz)</li> <li>- Shapefile (.shp, .shx, .dbf)<li> <li>- Comma Separated (.csv or .txt)</li> </ol> You can also include <ol> <li>- Style Layer Description file (.sld)</li> <li>- Projection file (.prj)</li> </ol> for shapefiles and comma separated files ]]></supportedFormats> <tocGroupLabel>Upload</tocGroupLabel> <tocGroupDescription>Uploaded Layers</tocGroupDescription> <pointsLabel>Points</pointsLabel> <linesLabel>Lines</linesLabel> <polygonsLabel>Polygons</polygonsLabel> <markLabel>Mark</markLabel> <fillLabel>Fill</fillLabel> <strokeLabel>Stroke</strokeLabel> </item>
Note that you only need to include any of the above setting if they're different from what's listed above.
The actual default for maxFileCount is 1, but you should probably set it to 5.
Uploading a point shapefile
Uploading a polygon shapefile
Uploading a .csv file
Upload a shapefile with a style layer description
Upload a shapefile with a style layer description and a projection
Changes from older version
- No dummy map engine required.
- This version does not require that you create a dummy
mapengine.upload
map engine, and if you have one it must be removed. - The map engine is created and registered automatically.
- The client does not need to reference the
mapengine.upload
map engine.- If the client map view does not reference the
mapengine.upload
map engine it will automatically added on top of the map, which may obscure selections and redlines, so you may want to add themapengine.upload
map engine to the client map view configuration anyway.
- If the client map view does not reference the
- This version does not require that you create a dummy
- Layer names are automatically generated.
- The name of the layer to include in the table of contents is generated based on information in the uploaded file or the base filename.
- Multiple file upload.
- On browsers that support it, basically anything except Internet Explorer, you can select multiple files to be uploaded at once, using the Control and Shift keys which choosing files in the file selector dialog box.
- .kml improvements.
- .kml files compressed in a .kmz file are now supported.
- Improved style support for .kml files.
- Polygon, line and point (including graphic markers) styles embedded in the .kml file are now used.
- Point markers that reference external graphics that are hosted on third party web sites will require that the Weave server has internet access to download the images.
- Graphic markers embedded in .kmz file and referenced from point styles in the .kml file are now supported.
- .csv improvements.
- .prj file support.
- If you also upload a .prj file the projection of the data will be based on the projection information in the .prj file, so you don't have to choose the projection from a list.
- .sld file support.
- If you also upload a .sld file the rendering of the data will be based on the style layer description contained in the .sld file.
- The .sld file can reference attributes contained in the .csv file.
- .prj file support.
- .shp improvements.
- .prj file support.
- If you also upload a .prj file the projection of the data will be based on the projection information in the .prj file, so you don't have to choose the projection from a list.
- .sld file support.
- If you also upload a .sld file the rendering of the data will be based on the style layer description contained in the .sld file.
- This requires that a .shx and .dbf file are also uploaded if the style contains references to feature attributes.
- .prj file support.
- Style improvements.
- The user has more control over the style that uploaded data is drawn.
- If the uploaded data does not contain a .sld file, or does not have any embedded style information, then the user is asked to provide suitable fill/stroke/marker information, not just a single colour.
- The user has more control over the style that uploaded data is drawn.
- Simplified configuration.
- No configuration of upload parameters is required.
- You can provide configuration of upload parameters to change the projections available to the user.
- You no longer can configure the colours or markers.
- .gml not currently supported.
- The existing gml implementation has not been migrated to the new version.