创建打�任务

Web 打��务默认开�异步打�模�。创建一个打�任务的步骤如下：

访问 iServer �务列表，选择 webprinting/rest �务资�

�次点击 webprinting -> v1 -> jobs，进入打�任务列表资�页�

点击创建打�任务，进入创建打�任务资�页�

输入 POST 请求体，点击创建打�任务按钮��开始执行任务。关于请求体如何编写请�� 打�任务列表资�的 POST 请求。

创建打�任务输入的请求体由三个顶层对象构�：

{

    "content": {},

    "layoutOptions": {},

    "exportOptions": {}

}

content

content 对象是必选对象，用于定义待打�的 Web 内容。由以下�数组�：

type：必选，Web 打�内容支�的类型，目�支�的类型：WEBMAP。

url：�选，待打�的 SuperMap iPortal 数�上图 Web App 制作的 WebMap 的 url 地�。例如：http://supermapiportal:8190/iportal/web/maps/{mapid}/map.rjson。

token：�选，如果待打�的是 SuperMap iPortal 用户�有的 WebMap，需��供 SuperMap iPortal 用户的 token。

value（å�¯é€‰ï¼‰ï¼šä¼ 递的是一个符å�ˆ SuperMap WebMap 规范的 WebMap çš„ JSON 表达，也å�¯ä»¥æ˜¯ä¸€ä¸ªå®Œæ•´çš„ SuperMap iPortal æ•°æ�®ä¸Šå›¾åˆ¶ä½œçš„ WebMap çš„ json 表达。如果已填了 url å�‚数，此å�‚æ•°å�¯ä¸�ä¼ ã€‚

示例1ï¼šä¼ å…¥ä¸€ä¸ªSuperMap iPortal æ•°æ�®ä¸Šå›¾ Web App 制作的 WebMap çš„ url 地å�€

{

    "content": {

        "type": "WEBMAP",

        "url":"http://supermapiportal:8190/iportal/web/maps/{mapid}/map.rjson"

     }

}

示例2ï¼šä¼ å…¥ä¸€ä¸ªå®Œæ•´çš„ SuperMap iPortal æ•°æ�®ä¸Šå›¾åˆ¶ä½œçš„ WebMap çš„ json 表达

{

    "content": {

        "type": "WEBMAP",

        "value": {

            "extent": {

                "leftBottom": {

                    "x": -20037508.3427892,

                    "y": -20037508.3427891

                },

                "rightTop": {

                    "x": 20037508.3427892,

                    "y": 20037508.3427891

                }

            },

            "maxScale": "1:144447.927",

            "level": 4,

            "center": {

                "x": 11382417.9336122,

                "y": 4134167.44525748

            },

            "baseLayer": {

                "layerType": "TILE",

                "name": "ChinaDark",

                "url": "https://iserver.supermap.io/iserver/services/map-china/rest/maps/ChinaDark"

            },

            "layers": [

                {

                    "layerType": "VECTOR",

                    "visible": true,

                    "name": "中国历�6级以上地震记录",

                    "featureType": "POINT",

                    "xyField": {

                        "xField": "�度",

                        "yField": "纬度"

                    },

                    "style": {

                        "fillColor": "#EE4D5A",

                        "strokeWidth": 1,

                        "offsetX": 0,

                        "offsetY": 0,

                        "fillOpacity": 0.9,

                        "radius": 8,

                        "strokeColor": "#ffffff",

                        "type": "BASIC_POINT",

                        "strokeOpacity": 1

                    },

                    "projection": "EPSG:4326",

                    "enableFields": [

                        "年",

                        "月",

                        "日",

                        "时",

                        "分",

                        "秒",

                        "�度",

                        "纬度",

                        "深度",

                        "震级",

                        "震级类型",

                        "�考地�"

                    ],

                    "dataSource": {

                        "name": "ChinaRecordOfOver6Earthquakes",

                        "type": "SAMPLE_DATA"

                    }

                }

            ],

            "description": "",

            "projection": "EPSG:3857",

            "minScale": "1:591658710.909",

            "title": "testdizhen",

            "version": "2.2.1",

            "rootUrl": "https://iptl.supermap.io/iportal/services/../"

        }

    }

}

注�事项：

当以 WMTS �务方�打�天地图地图时，需�使用�务器端许�。

layoutOptions

layoutOptions 对象是必选对象，用于定义打�的布局信�。由以下�数组�：

templateName：必选�数，布局模�文件夹的�称。

title：å�¯é€‰å�‚æ•°ï¼Œå¦‚æžœåœ¨å¸ƒå±€ä¸Šå­˜åœ¨åœ°å›¾ä¸»æ ‡é¢˜æ–‡æœ¬å…ƒç´ çš„æ–‡æœ¬ï¼Œåˆ™è¯¥å�‚数为必选，也å�¯ä»¥ä¼ 递空值。当需è¦�输入多行文本时，å�¯åœ¨éœ€è¦�æ�¢è¡Œçš„文字å‰�输入æ�¢è¡Œç¬¦â€œ\nâ€�。

subTitle：å�¯é€‰å�‚æ•°ï¼Œå¦‚æžœåœ¨å¸ƒå±€ä¸Šå­˜åœ¨åœ°å›¾å‰¯æ ‡é¢˜æ–‡æœ¬å…ƒç´ çš„æ–‡æœ¬ï¼Œåˆ™è¯¥å�‚数为必选，也å�¯ä»¥ä¼ 递空值。当需è¦�输入多行文本时，å�¯åœ¨éœ€è¦�æ�¢è¡Œçš„文字å‰�输入æ�¢è¡Œç¬¦â€œ\nâ€�。

author：å�¯é€‰å�‚æ•°ï¼Œå¦‚æžœåœ¨å¸ƒå±€ä¸Šå­˜åœ¨ä½œè€…æ–‡æœ¬å…ƒç´ çš„æ–‡æœ¬ï¼Œåˆ™è¯¥å�‚数为必选，也å�¯ä»¥ä¼ 递空值。当需è¦�输入多行文本时，å�¯åœ¨éœ€è¦�æ�¢è¡Œçš„文字å‰�输入æ�¢è¡Œç¬¦â€œ\nâ€�。

copyright：å�¯é€‰å�‚数，如果在布局上存在版æ�ƒæ–‡æœ¬å…ƒç´ 的文本，则该å�‚数为必选，也å�¯ä»¥ä¼ 递空值。当需è¦�输入多行文本时，å�¯åœ¨éœ€è¦�æ�¢è¡Œçš„文字å‰�输入æ�¢è¡Œç¬¦â€œ\nâ€�。

scaleBarOptions：å�¯é€‰å�‚数，用于更新比例尺，如果ä¸�ä¼ é€’è¯¥å�‚数，则使用默认的比例尺æ�¡ã€‚

scaleText：�选�数，比例尺文本信�，例如：1:1000000。

type：å�¯é€‰å�‚æ•°ï¼Œæ¯”ä¾‹å°ºçš„æ ·å¼�，包括：LINE, BAR, BAR_SUB, GRID, LINE_CROSS_RAILWAY, RAILWAY_MID_SPLIT, RULER, BARRIER, GREATWALL, SAWTOOTH。

intervals：�选�数，比例尺�的段数。

unit：�选�数，比例尺的��制，包括：METER, FOOT, DEGREES。

scaleBarVisible：�选�数，比例尺�是�显示。

northArrowOptions：å�¯é€‰å�‚数，用于更新指北针，如果ä¸�ä¼ é€’è¯¥å�‚数，则使用默认的指北针。优先级：picAsBase64 > picAsUrl。

picAsBase64：�选�数，通过指定指北针的 base64 �图片信�，�更新布局中指北针的图片。

picAsUrl：�选�数，通过指定指北针的图片 url 地�，�更新布局中指北针的图片。

littleMapOptions：�选�数，如果布局中存在�地图，则该�数为必须�数。�地图�以是指定的主地图中的图层�称，也�以是一个 WebMap。优先级：layers>layerNames，两者必选其一。

scale：�选�数，�地图的比例尺。

center：�选�数，�地图的中心点。

layerNames：�选�数，指定 WebMap 中图层�称的列表，用于渲染�地图。

layers：�选�数，指定 WebMap 中的 layers 图层。如果您�使用主地图中的图层�渲染�地图，而是希望使用一个 WebMap 图层�渲染�地图，�以通过此�数设置。

legendOptions：å�¯é€‰å�‚æ•°ï¼ŒæŒ‡å®šå¸ƒå±€ä¸­å›¾ä¾‹å…ƒç´ çš„å±žæ€§ã€‚ä¼˜å…ˆçº§ï¼špicAsBase64 > picAsUrl > customItems > layersï¼Œå››è€…å¿…é€‰å…¶ä¸€ã€‚æ­¤å¤–ï¼Œå›¾ä¾‹å…ƒç´ æ”¯æŒ�自动排版，由 isAutoComposing å�‚数控制。

picAsUrl：�选�数，通过指定图例的图片 url 地�，�更新布局中图例的图片。图片中需包�图例�称。

picAsBase64：�选�数，通过指定图例的 base64 �图片信�，�更新布局中图例的图片。图片中需包�图例�称。

title：å�¯é€‰å�‚数，图例的å��称。ä¸�ä¼ é€’æ­¤å�‚æ•°å°†ä¸�显示图例å��称。该å�‚数是与 customItems å�‚æ•°é…�å�ˆä½¿ç”¨ã€‚

customItems：å�¯é€‰å�‚æ•°ï¼Œè‡ªå®šä¹‰ä¸€ç»„å›¾ä¾‹å…ƒç´ ï¼Œç”¨æˆ·å�¯ä»¥ä¼ 入一个 JSON 字符串。该 JSON å­—ç¬¦ä¸²ç”±å›¾ä¾‹å…ƒç´ çš„å��称和图片组æˆ�：name æŒ‡å®šå›¾ä¾‹å…ƒç´ çš„å��称；picAsUrl æŒ‡å®šå›¾ä¾‹å…ƒç´ çš„å›¾ç‰‡ url 地å�€ï¼›picAsBase64 æŒ‡å®šå›¾ä¾‹å…ƒç´ çš„ base64 ä½�图片信æ�¯ã€‚

layers：å�¯é€‰å�‚数，自定义用于获å�–图例å­�项的 iServer REST 地图æœ�务的指定图层，用户å�¯ä»¥ä¼ 入一个对象组。该对象组由 REST 地图æœ�务中一个图层 url 的字符串（必选）和表示å­�图层 name 的字符串数组（å�¯é€‰ï¼‰ç»„æˆ�：url 指定 REST 地图æœ�务或临时图层集中的æŸ�一临时图层（指定 ID），目å‰�å�ªæ”¯æŒ� TileLayer 图层类型；subLayerNames 指定å­�图层 name 的字符串数组，ä¸�设置该å�‚数将打å�°ä¸Šè¿° url 图层中的所有图例；useCaption 图例文本是å�¦ä½¿ç”¨å›¾å±‚æ ‡é¢˜ï¼Œå�¦ï¼Œåˆ™ä½¿ç”¨å›¾å±‚å��称。

isAutoComposition：å�¯é€‰å�‚数，是å�¦ä½¿ç”¨å›¾ä¾‹è‡ªåŠ¨æŽ’版功能。开å�¯å�Žç³»ç»Ÿå°†åº”ç”¨å›¾ä¾‹å…ƒç´ è‡ªåŠ¨æŽ’ç‰ˆè§„åˆ™ï¼Œæ‰“å�°ç»“æžœå°†æ ¹æ�®ç›¸åº”算法进行显示。默认为 true 自动排版算法请è§�ï¼šå›¾ä¾‹å…ƒç´ è‡ªåŠ¨æŽ’ç‰ˆè§„åˆ™ã€‚

itemsFont：�选�数，图例�项中的文字字体。isAutoComposition 为 true 时生效。

titleFont： å�¯é€‰å�‚æ•°ï¼Œå›¾ä¾‹æ ‡é¢˜çš„æ–‡å­—å­—ä½“ã€‚

titleFontSize：å�¯é€‰å�‚æ•°ï¼Œå›¾ä¾‹æ ‡é¢˜çš„æ–‡å­—å­—å�·ã€‚

standardMarginOptions：å�¯é€‰å�‚数，设置布局模æ�¿ä¸­ç”¨äºŽæ‰“å�°å›½å®¶æ ‡å‡†åˆ†å¹…地图的属性。包å�«è®¡ç®—å�‚数和整饰å�‚数两部分。计算å�‚数中优先级：mapNumber > scaleDenominator å’Œ coordinate，两ç§�å�‚数设置必选其一。

    计算�数：

scaleDenominator：�选�数，仅�设置为500�1000�2000�5000�10000�25000�50000�100000�250000�500000�1000000，其中500�1000�2000为大比例尺分�。注：此�数设置�，exportOptions 中的 scale �数将�生效。

coordinate：å�¯é€‰å�‚æ•°ï¼Œåˆ†å¹…ç›®æ ‡ç‚¹å��æ ‡ï¼Œå�³ç”¨æˆ·å¾…分幅区域内æŸ�ç›®æ ‡ç‚¹çš„åœ°ç�†å��æ ‡ã€‚ç»�纬度分幅为ç»�纬度å��æ ‡ï¼ŒçŸ©å½¢åˆ†å¹…ä¸ºå…¬é‡Œå��æ ‡ã€‚æ³¨ï¼šæ­¤å�‚数设置å�Žï¼ŒexportOptions 中的 center å�‚æ•°å°†ä¸�生效，需è¦�与 scaleDenominator é…�å�ˆä½¿ç”¨ã€‚

mapNumber：å�¯é€‰å�‚数，分幅图幅å�·ï¼Œéœ€è®¾ç½®ä¸ºæ–°æ ‡å‡†å›¾å¹…å�·ã€‚注：此å�‚数设置å�Žï¼ŒexportOptions中 çš„ scale å’Œ center å�‚æ•°å°†ä¸�生效。当å�Œæ—¶æœ‰ scaleDenominatorã€�coordinateã€�mapNumber时，scaleDenominator å’Œ coordinate ä¸�生效。

zoneNumber：å�¯é€‰å�‚数，大比例尺地图的国家å��æ ‡ç³»çš„æ�¡å¸¦å�·ï¼Œå½“且仅当比例尺为大比例尺且å��æ ‡ç³»ä¸ºå›½å®¶å��æ ‡ç³»ç»Ÿæ—¶å�¯é€‰ã€‚

largeScaleSheetType：�选�数，大比例尺图幅分幅类型（40x50�50x50），当且仅当比例尺为大比例尺时�选。

    整饰�数：

frameOptions：å�¯é€‰å�‚数，å�¯é€‰å�‚æ•°ï¼Œå›½å®¶æ ‡å‡†åˆ†å¹…åœ°å›¾ä¸­å›¾å¹…å›¾æ¡†æ•ˆæžœè®¾ç½®ã€‚

gridOptions：å�¯é€‰å�‚æ•°ï¼Œå›½å®¶æ ‡å‡†åˆ†å¹…åœ°å›¾ä¸­æ ¼ç½‘æ•ˆæžœè®¾ç½®ã€‚

informationOptions：å�¯é€‰å�‚æ•°ï¼Œå›½å®¶æ ‡å‡†åˆ†å¹…åœ°å›¾ä¸­å›¾å¹…ä¿¡æ�¯è®¾ç½®ã€‚

neighborTableOptions：å�¯é€‰å�‚æ•°ï¼Œå›½å®¶æ ‡å‡†åˆ†å¹…åœ°å›¾ä¸­é‚»æŽ¥å›¾è¡¨æ•ˆæžœè®¾ç½®ã€‚

annotationsOptions：å�¯é€‰å�‚æ•°ï¼Œå›½å®¶æ ‡å‡†åˆ†å¹…åœ°å›¾ä¸­é™„æ³¨ä¿¡æ�¯è®¾ç½®ã€‚

title：å�¯é€‰å�‚数，图幅å��ï¼Œé»˜è®¤å€¼ä¸ºâ€œå›½å®¶æ ‡å‡†åˆ†å¹…åœ°å›¾â€�。

publisher：�选�数，出版��，默认值为 null，��显示。

safeInfo：�选�数，出版密级，默认值为 null，��显示。

hasMapNumber：�选�数，是�显示图幅编�，默认值是 true，�显示。

hasScale：�选�数，是�显示比例尺，默认值是 false，��显示。

mapGridOptions：å�¯é€‰å�‚数，地图ç»�çº¬ç½‘æ ¼å�‚数。

originX：�选�数，左下角�度。

originY：�选�数，左下角纬度。

cellWidth：å�¯é€‰å�‚数，å�•å…ƒæ ¼å®½åº¦ã€‚

cellHeight：å�¯é€‰å�‚数，å�•å…ƒæ ¼é«˜åº¦ã€‚

markType：å�¯é€‰å�‚数，å��æ ‡æ ¼å¼�，支æŒ�的类型有 DMS（度分秒）ã€�DecimalDegree（å��进制），默认使用å��è¿›åˆ¶æ ¼å¼�。

示例1：更新布局模��更新布局中指北针的图片为 url 地��更新�地图为一个 WebMap 图层�更新图例为一个 JSON 字符串

{

    "layoutOptions": {

        "templateName": "A4_landscape",

        "title": "title",

        "author": "authorName",

        "copyright": "copyright",

        "subTitle": "subTitle",

        "legendOptions": {

            "title": "legend",

            "customItems": [

                {

                    "name": "Railway",

                    "picAsUrl":

                        "http://192.168.120.40:8090/iserver/services/map-China100/rest/maps/China/layers/Main_Railway_L@China@@China/legend"

                },

                {

                    "name": "River",

                    "picAsUrl":

                        "http://192.168.120.40:8090/iserver/services/map-China100/rest/maps/China/layers/River@China@@China/legend"

                },

                {

                    "name": "Mainroad",

                    "picAsUrl":

                        "http://192.168.120.40:8090/iserver/services/map-China100/rest/maps/China/layers/Main_Road_L@China@@China/legend"

                },

                {

                    "name": "Airport",

                    "picAsUrl":

                        "http://192.168.120.40:8090/iserver/services/map-China100/rest/maps/China/layers/Airport_pt@China.1@@China/legend"

                }

            ]

        },

        "northArrowOptions": {

            "picAsUrl": "file://NorthArrow.svg"

        },

        "littleMapOptions": {

            "center": {

                "x": 12024583.8595938,

                "y": 4101942.08146721

            },

            "scale": 5.4085234291297E-08,

            "layers": [

                {

                    "layerType": "TILE",

                    "name": "China",

                    "url": "http://192.168.120.40:8090/iserver/services/map-China100/rest/maps/China"

                }

            ]

        }

    }

}

exportOptions

exportOptions 对象是必选对象，用于定义打�的输出信�，由以下�数组�：

format：必选å�‚æ•°Web 打å�°è¾“å‡ºçš„æ ¼å¼�，目å‰�支æŒ�：PNGã€�PDF。

dpi：�选�数，Web 打�输出的分辨率，��为�英寸点数。默认值为 96 dpi，最大值为 400 dpi。

scale：�选�数，Web 打�输出的地图比例尺。

rotation：�选�数，Web 打�输出的地图角度。

center：�选�数，Web 打�输出的地图中心点。

示例：更新打å�°è¾“å‡ºçš„æ ¼å¼�为 PDFã€�打å�°çš„ dpi 为300dpi

{

    "exportOptions": {

        "format": "PDF",

        "dpi": 300,

        "center": {

            "x": 100,

            "y": -10

        },

        "scale": 0.0001

    }

}

å›¾ä¾‹å…ƒç´ è‡ªåŠ¨æŽ’ç‰ˆè§„åˆ™

iServer Web 打å�°æœ�务为用户æ��ä¾›äº†å›¾ä¾‹å…ƒç´ è‡ªåŠ¨æŽ’ç‰ˆè§„åˆ™ã€‚å½“ Web 打å�°å¸ƒå±€ä¸­çš„å›¾ä¾‹å…ƒç´ åŒ…å�«å¤šä¸ªå›¾ä¾‹å­�é¡¹æ—¶ï¼Œæ— éœ€æ‰‹åŠ¨è°ƒæ•´å›¾ä¾‹å­�项的字å�·ã€�è¾¹è·�ç­‰å�‚数，系统å�³å�¯è‡ªåŠ¨æŽ’版。

å›¾ä¾‹å…ƒç´ è‡ªåŠ¨æŽ’ç‰ˆåŠŸèƒ½å½“å‰�ä¾�照图例å­�项全部显示的规则，具体å�‚æ•°å�Šè®¾ç½®æ–¹æ³•å�‚è§�：layoutOptions，具体规则如下：

支æŒ�设置列数。图例框大å°�ä¸�å�˜æ—¶ï¼Œå›¾ä¾‹å­�é¡¹å’Œå›¾ä¾‹æ ‡é¢˜çš„å­—å�·ä¼šè‡ªåŠ¨éš�ç�€åˆ—æ•°çš„å¢žåŠ è€Œå�˜å°�。

支æŒ�è®¾ç½®å›¾ä¾‹æ ‡é¢˜çš„å­—ä½“å’Œå­—å�·ï¼Œå›¾ä¾‹å­�项的字体。

图例å­�项的边è·�æ ¹æ�®ç™¾åˆ†æ¯”进行自动调整，如下图所示：

â‘ å›¾ä¾‹æ ‡é¢˜ä¸Žå›¾ä¾‹å­�项的垂直è·�离为图例å­�项高度的10%。

②图例�项与图例�项的垂直�离为图例�项高度的20%。

③图例项列与列之间的水平�离为图例�项高度的20%。

④图例符�与图例文本之间的水平�离为图例�项高度的20%

�置�用Web打�访问白��

内网穿é€�是一ç§�能够让内网设备çª�ç ´å±€åŸŸç½‘é™�制实现从外网访问的技术，ä¸�当的使用å�¯èƒ½ä¼šå¼•å�‘æ•°æ�®æ³„露ã€�æ�¶æ„�攻击等安全问题。iServer Web打å�°æœ�务支æŒ�é…�置访问白å��å�•ï¼Œå½“å�¯ç”¨è¯¥é…�置时，仅设置中的地å�€å�¯ä»¥é€šè¿‡è¯·æ±‚访问，从而有效防止其他业务系统通过Web打å�°æœ�务被内网穿é€�的风险。

Web打�访问白���在�SuperMap iServer 安装目录】\webapps\iserver\WEB-INF\iserver-system.xml 文件中节点进行�置，示例如下：

        false

Â

            ^https://maptiles\.supermapol\.com/iserver/services/.*?

^https://iserver\.supermap\.io/iserver/services/.*?

       Â

其中，

：是�开�Web打�访问白��。默认为false，��开�。当您的业务系统对安全�求较高时，建议开�此�置。开��，若��在白��中的URL��请求获�地图图层�图例等信�，将请求失败�示报错。Web打�请求中�影�的�数节点如下：

content>url：打�的地图json�其中包�的地图�务地�

content>value>layers>url：打�的地图�务地�

layoutOptions>legendOptions>customItems>picAsUrl：打�的自定义图例地�

layoutOptions>legendOptions>layers>url：用于获�图例的业务图层

layoutOptions>littleMapOptions>layers>url：用于�地图打�的地图�务地�

：�通过Web打��务请求访问的URL。您�以在此节点中�置多个URL的正则表达�，�个在 节点中设置，有如下规则：

URLå‰�éœ€æ·»åŠ â€œ^â€�锚点，表示URL将以å�Žé�¢çš„字符串开头

正则表达�需能够表达完整的 URL 请求路径，包��议��域�（或IP�端�）�路径等

URL 中的 “.â€� 符å�·å‰�æ·»åŠ "\" æ�¥è½¬ä¹‰ï¼Œå�¦åˆ™å°†ä¼šå�‘生错误的字符串匹é…�

对于�固定值使用“ .*?��代替，例如�务组件� map-world

iServer�置文件中已默认�置了常用的公网地�，包括：

^https://maptiles\.supermapol\.com/iserver/services/.*?

^https://iserver\.supermap\.io/iserver/services/.*?

注�事项：

1�若您需��用Web打�访问白��，为使iPortal数�上图WebApp能够正常使用打�功能，您需��置iPortal的�务地�，例如：^http://localhost:8190/iportal/web/maps/.*?；若数�上图中还引用了第三方地图，也需�在此�置第三方�务地�。

2ã€�符å�ˆå¦‚下情况的URLæ— éœ€é…�ç½®å�³å�¯é€šè¿‡Web打å�°æŒ‰éœ€è¯·æ±‚：

URL中Host与Web打��务URL中Host一致

URL中包�本机地�（localhost/127.0.0.1/本机IP）且端�为iServer端��/8190

Â