AnsweredAssumed Answered

Python 3.x syntax for refreshing a map series (formerly DDP)

Question asked by aroust on Jan 23, 2019
Latest reply on Jan 24, 2019 by aroust

Like • Show 0 Likes0
Comment • 6

I'm rewriting a Python 2.x script so that it can be used in Pro. I am struggling to figure out the syntax for refreshing a map series in Python. I found this page: MapSeries—ArcPy | ArcGIS Desktop, and I know there is a refresh() method, but I cannot figure out how to use it. I tried

lyt = aprx.listLayouts("AgLayout")[0]

for lyr in m.listLayers("Parcel*"):
    lyr.definitionQuery = "JOINPIN = '201-02-0-00-00-012.03-0'"

lyt.refresh()

Line 6 throws an error that says "AttributeError: 'Layout' object has no attribute 'refresh'

Cimejes Jan 23, 2019 2:19 PM

Correct Answer

You need to access the mapSeries property of the Layout object, since refresh() is a method of the mapSeries object. Something like lyt.mapSeries.refresh().

See the reply in context

No one else had this question

Outcomes

Dan_Patterson

Jan 23, 2019 1:59 PM

MapSeries—ArcPy | ArcGIS Desktop

with limitations

refresh ()
Use the refresh method if any of the following occurs:
Features are added to or deleted from your index layer.
Updates are made to the index field values.
The map frame extent is changed due to zooming, panning, or change to map scale.

Actions

aroust @ Dan_Patterson on Jan 23, 2019 2:04 PM

Once the script is completely rewritten, the user will input a PIN number for the parcel being mapped. When that PIN number changes, it will meet the criteria for using the refresh method. I just can't figure out how to tell it to refresh.

Actions

Cimejes Jan 23, 2019 2:19 PM

You need to access the mapSeries property of the Layout object, since refresh() is a method of the mapSeries object. Something like lyt.mapSeries.refresh().

1 person found this helpful

Actions

aroust @ Cimejes on Jan 23, 2019 2:34 PM

That worked! Well, OK, it refreshed the dynamic text that I had on the page, but it did not refresh the map's extent to go to the new PIN. Maybe that's a bug?

Actions

Cimejes @ aroust on Jan 23, 2019 5:00 PM

Yeah, based on the documentation it sounds like it might be a bug (maybe related to the inability to set the map extent in a map view using arcpy.mp). Are you using the PIN to update the layer's definition query? I notice that in ArcMap refreshing the data driven pages zooms to the visible features, but as you say, refreshing the map series doesn't change the map's extent in Pro.

If you're using definition queries, the zoomToAllLayers() method of the MapFrame class might provide what you're looking for. Something like lyt.mapSeries.mapFrame.zoomToAllLayers().

Actions

aroust @ Cimejes on Jan 24, 2019 1:38 PM

Well, this is very frustrating! Refresh does not do what the ArcGIS documentation on Map Series for Pro says it should do. Even if I click the Refresh button in the ribbon, the dynamic labels update, but the map does not update its extent to the location specified by the index layer's updated definition query. I get the same results with the Python code. And, as you point out, Stephen, arcpy.mp doesn't have a zoom to selected features option. I tried zoomToAllLayers(), but it did exactly that -- zoomed to the full extent of every layer in the map.

Does anyone know how to look up bug reports to see if anyone has reported this to Esri?

Actions

6 Replies

Dan_Patterson Jan 23, 2019 1:59 PM
Mark Correct
Correct Answer
MapSeries—ArcPy | ArcGIS Desktop
with limitations
refresh ()
Use the refresh method if any of the following occurs:
Features are added to or deleted from your index layer.
Updates are made to the index field values.
The map frame extent is changed due to zooming, panning, or change to map scale.
Like • Show 0 Likes0
Actions
- aroust @ Dan_Patterson on Jan 23, 2019 2:04 PM
  Mark Correct
  Correct Answer
  Once the script is completely rewritten, the user will input a PIN number for the parcel being mapped. When that PIN number changes, it will meet the criteria for using the refresh method. I just can't figure out how to tell it to refresh.
  Like • Show 0 Likes0
  Actions
Cimejes Jan 23, 2019 2:19 PM
Unmark Correct
Correct Answer
You need to access the mapSeries property of the Layout object, since refresh() is a method of the mapSeries object. Something like lyt.mapSeries.refresh().
1 person found this helpful
Like • Show 0 Likes0
Actions
- aroust @ Cimejes on Jan 23, 2019 2:34 PM
  Mark Correct
  Correct Answer
  That worked! Well, OK, it refreshed the dynamic text that I had on the page, but it did not refresh the map's extent to go to the new PIN. Maybe that's a bug?
  Like • Show 0 Likes0
  Actions
  - Cimejes @ aroust on Jan 23, 2019 5:00 PM
    Mark Correct
    Correct Answer
    Yeah, based on the documentation it sounds like it might be a bug (maybe related to the inability to set the map extent in a map view using arcpy.mp). Are you using the PIN to update the layer's definition query? I notice that in ArcMap refreshing the data driven pages zooms to the visible features, but as you say, refreshing the map series doesn't change the map's extent in Pro.
    
    If you're using definition queries, the zoomToAllLayers() method of the MapFrame class might provide what you're looking for. Something like lyt.mapSeries.mapFrame.zoomToAllLayers().
    Like • Show 0 Likes0
    Actions
    - aroust @ Cimejes on Jan 24, 2019 1:38 PM
      Mark Correct
      Correct Answer
      Well, this is very frustrating! Refresh does not do what the ArcGIS documentation on Map Series for Pro says it should do. Even if I click the Refresh button in the ribbon, the dynamic labels update, but the map does not update its extent to the location specified by the index layer's updated definition query. I get the same results with the Python code. And, as you point out, Stephen, arcpy.mp doesn't have a zoom to selected features option. I tried zoomToAllLayers(), but it did exactly that -- zoomed to the full extent of every layer in the map.
      
      Does anyone know how to look up bug reports to see if anyone has reported this to Esri?
      Like • Show 0 Likes0
      Actions

GeoNet

The Esri Community

Python 3.x syntax for refreshing a map series (formerly DDP)

Outcomes

Related Content

Recommended Content