创建打印任务

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

1. 访问 iServer 服务列表，选择 webprinting/rest 服务资源
2. 依次点击 webprinting -> jobs，进入打印任务列表资源页面
3. 点击创建打印任务，进入创建打印任务资源页面
4. 输入 POST 请求体，点击“创建打印任务”按钮即可开始执行任务。关于请求体如何编写请参见 webPrintingJobs 资源的 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-china400/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/../"

        }

    }

}

layoutOptions

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

• templateName（必选）：必选参数，布局模板文件夹的名称。
• title（必选）：如果在布局上存在地图主标题文本元素的文本，则该参数为必选，也可以传递空值。
• subTitle（必选）：如果在布局上存在地图副标题文本元素的文本，则该参数为必选，也可以传递空值。
• author（必选）：如果在布局上存在作者文本元素的文本，则该参数为必选，也可以传递空值。
• copyright（必选）：如果在布局上存在版权文本元素的文本，则该参数为必选，也可以传递空值。
• scaleBarOptions（可选）：用于更新比例尺，如果不传递该参数，则使用默认的比例尺条。
• scaleText（可选）：比例尺文本信息，例如：1:1000000。
• type（可选）：比例尺的样式，包括：LINE, BAR, BAR_SUB。
• intervals（可选）：比例尺条的段数。
• unit（可选）：比例尺的单位制，包括：METER, FOOT, DEGREES。
• northArrowOptions（可选）：用于更新指北针，如果不传递该参数，则使用默认的指北针。优先级：picAsBase64 > picAsUrl。
• picAsBase64（可选）：通过指定指北针的 base64 位图片信息，来更新布局中指北针的图片。
• picAsUrl（可选）：通过指定指北针的图片 url 地址，来更新布局中指北针的图片。
• littleMapOptions（必选）：如果布局中存在小地图，则该参数为必须参数。小地图可以是指定的主地图中的图层名称，也可以是一个 WebMap。优先级：layers>layerNames，两者必选其一。
• scale（必选）：小地图的比例尺。
• center（必选）：小地图的中心点。
• layerNames（可选）：指定 WebMap 中图层名称的列表，用于渲染小地图。
• layers（可选）：指定 WebMap 中的 layers 图层。如果您不使用主地图中的图层来渲染小地图，而是希望使用一个 WebMap 图层来渲染小地图，可以通过此参数设置。
• legendOptions（必选）：指定布局中图例元素的属性。优先级：picAsBase64 > picAsUrl > customItems，三者必选其一。
• picAsUrl（可选）：通过指定图例的图片 url 地址，来更新布局中图例的图片。图片中需包含图例名称。
• picAsBase64（可选）：通过指定图例的 base64 位图片信息，来更新布局中图例的图片。图片中需包含图例名称。
• title（可选）：图例的名称。不传递此参数将不显示图例名称。该参数是与 customItems 参数配合使用。
• customItems（可选）：自定义一组图例元素，用户可以传入一个 JSON 字符串。该 JSON 字符串由图例元素的名称和图片组成：name 指定图例元素的名称；picAsUrl 指定图例元素的图片 url 地址；picAsBase64 指定图例元素的 base64 位图片信息。

示例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

    }

}