topic Re: How to filter layers in a legend: understanding PrintTemplate.layoutOptions.legendLayers in ArcGIS JavaScript Maps SDK Questions

How to filter layers in a legend: understanding PrintTemplate.layoutOptions.legendLayers

PitersonPaulgek — Tue, 29 Nov 2016 22:34:22 GMT

Hi,

I try to define the list of layers to be included in a legend in print task. It (marked with red color) has no impact on output printed image. It always only one layer - "address_points" (I tried ["address_points,streets,lakes"] or ["streets,"] or ["lakes"]). I see in debug mode that "map" object contains layerIds ("address_points,streets,lakes").

I tried to use PrintTemplate.layoutOptions.legendLayers

template2.layoutOptions = {
"titleText": title,
"authorText": author,
"copyrightText": "<Copyright info here>",
"legendLayers": ["address_points,streets,lakes"],
"scalebarUnit": "Miles",
};

Please explain how to make it working.

I also noticed the question (see the link below), but cannot understand it.

Javascript API print task legend with dynamically rendered layer

Re: How to filter layers in a legend: understanding PrintTemplate.layoutOptions.legendLayers

RobertScheitlin__GISP — Wed, 30 Nov 2016 01:03:08 GMT

Piterson,

The printTemplates.layoutOptions.legendLayers is expecting an array of

esri/tasks/LegendLayer

objects not just strings.

LegendLayer | API Reference | ArcGIS API for JavaScript 3.18

Re: How to filter layers in a legend: understanding PrintTemplate.layoutOptions.legendLayers

PitersonPaulgek — Wed, 30 Nov 2016 04:00:18 GMT

Robert,

Thank you for the response.

It works, thank you.

But it shows now number of layers I define plus one layer ("address_points" - that was before).

Example: I ask to include 3 layers "address_points,streets,lakes" - it includes 4 layers - "address_points,streets,lakes" + "address_points". How to remove it?

Additional question: How to include in a legend only symbols that actually on current extent?

Re: How to filter layers in a legend: understanding PrintTemplate.layoutOptions.legendLayers

RobertScheitlin__GISP — Wed, 30 Nov 2016 14:12:39 GMT

Piterson,

Why not just not add the address_points then? In ArcMap there is an option to limit the legend for a mxd but the only way (untested) that I can think of to have this happen in the print layout is to edit the ArcGIS Server default print layouts to enable that option (I don't have much more advice on this though as I have never attempted).

Re: How to filter layers in a legend: understanding PrintTemplate.layoutOptions.legendLayers

PitersonPaulgek — Wed, 30 Nov 2016 22:44:09 GMT

Just for information -

we use custom map layouts/templates.

Re: How to filter layers in a legend: understanding PrintTemplate.layoutOptions.legendLayers

RobertScheitlin__GISP — Wed, 30 Nov 2016 23:09:03 GMT

Piterson,

That should make it easy as you know where the templates are located on the file system and to make sure the mxd has the option checked to limit the legend then.

Re: How to filter layers in a legend: understanding PrintTemplate.layoutOptions.legendLayers

PitersonPaulgek — Thu, 01 Dec 2016 06:09:54 GMT

Currently, it works partly:

1) We created mxd with all layers

and set "Legend properties"->"General" check box on "Only display layers that are checked on in Table Of Contents" -

and set "Items" Only show classes visible in current extent

2) the code is now

template2.layoutOptions = {
"titleText": title,
"authorText": author,
"copyrightText": "Any copyright",
"legendLayers": [],
"scalebarUnit": "Miles",
};

it works partly:

1) OK - when change "display layers that are checked on in Table Of Contents" - it changes legend layers accordingly.

2) OK - it shows only visible (current extent) features symbology in the legend

3) NOT OK - it does not change visible sublayers: example:

"address_points" has 3 sublayers (the same source but different symbology):

- "show by population"

- "show by year"

- "show by update_time"
We expect when user change sublayer it will show in the legend (printed map) accordingly.

But it only takes first every time.

Re: How to filter layers in a legend: understanding PrintTemplate.layoutOptions.legendLayers

RobertScheitlin__GISP — Thu, 01 Dec 2016 14:05:12 GMT

Piterson,

If you want to change visible sub layer then you need to follow the documentation on LegendLayer and set the subLayerIds property of the LegendLayer.

Don't forget to mark this question as answered by clicking on the "Correct Answer" link on the reply that answered your question.

Re: How to filter layers in a legend: understanding PrintTemplate.layoutOptions.legendLayers

PitersonPaulgek — Thu, 01 Dec 2016 22:13:29 GMT

Robert,

Please see that we do not use LegendLayer object in the current code

template2.layoutOptions = {
"titleText": title,
"authorText": author,
"copyrightText": "Any copyright",
"legendLayers": [],
"scalebarUnit": "Miles",
};

Re: How to filter layers in a legend: understanding PrintTemplate.layoutOptions.legendLayers

RobertScheitlin__GISP — Fri, 02 Dec 2016 14:05:47 GMT

Piterson,

Here is the quote from the docs:

legendLayers: an array of LegendLayer containing the id's of the layers that will be included in the legend. If legendLayers is not specified, all operational layers (non-tiled layers) will be present in the legend. To specify that no layers will be included in the legend set legendLayer to an empty array.

So I am not sure what you are trying to do but you are confined to what API allows.

Re: How to filter layers in a legend: understanding PrintTemplate.layoutOptions.legendLayers

PitersonPaulgek — Mon, 05 Dec 2016 03:26:24 GMT

Robert,

Thank you.

I will do more testing. And publish the result.