Skip to content

Commit 69a6c59

Browse files
committed
typo fixes
1 parent 6ae7385 commit 69a6c59

File tree

1 file changed

+10
-10
lines changed

1 file changed

+10
-10
lines changed

guide/13-managing-arcgis-applications/cloning-complex-apps.ipynb

Lines changed: 10 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -17,7 +17,7 @@
1717
"\n",
1818
"We're going to look at a few things in this guide:\n",
1919
"\n",
20-
"- New clonable item types in 2.2.0\n",
20+
"- New cloneable item types in 2.2.0\n",
2121
"- How to dive into an item's structure\n",
2222
"- Strategies for remapping data"
2323
]
@@ -38,9 +38,9 @@
3838
"\n",
3939
"### 'Complex Items' and `search_existing_items`\n",
4040
"\n",
41-
"What do we mean when we say \"complex items?\" In this context, we're referring to items that may contain other items within them. One of the most important facets of cloning these complex items is making sure that all of their internal items are properly accounted for in the target GIS organisation. That can mean making sure those items are also cloned, replaced with other items that already exist in the new GIS, or come from sources accessible by any GIS (such as Living Atlas items). Regardless of the method, the underlying structure of the newly cloned item must refer to items that can be used in the new GIS. This guide will cover a handful of strategies for cloning item dependencies and confirming they're being incorporated properly.\n",
41+
"What do we mean when we say \"complex items?\" In this context, we're referring to items that may contain other items within them. One of the most important facets of cloning these complex items is making sure that all of their internal items are properly accounted for in the target GIS organization. That can mean making sure those items are also cloned, replaced with other items that already exist in the new GIS, or come from sources accessible by any GIS (such as Living Atlas items). Regardless of the method, the underlying structure of the newly cloned item must refer to items that can be used in the new GIS. This guide will cover a handful of strategies for cloning item dependencies and confirming they're being incorporated properly.\n",
4242
"\n",
43-
"One of the most critical tools when cloning these items is the `clone_items()` function's `search_existing_arguments` argument. When this is set to `True` (which it is by default), the function searches to see if all of the items set to be cloned (this includes all items in the `items` argument and their internal data sources) already exist in the target GIS organisation. When an item is cloned, it gets given a specific `typeKeyword` indicating its source item, so the function searches for items with those matching keywords. This means that items with matching names and data types will not get used if they aren't a clone of the item in question. When `search_existing_items` is set to `False`, all items will get cloned (even if clones of them already exist in the target), unless they're not clonable or covered in a dictionary passed in as the `item_mapping` argument (more on this later)."
43+
"One of the most critical tools when cloning these items is the `clone_items()` function's `search_existing_items` argument. When this is set to `True` (which it is by default), the function searches to see if all of the items set to be cloned (this includes all items in the `items` argument and their internal data sources) already exist in the target GIS organization. When an item is cloned, it gets given a specific `typeKeyword` indicating its source item, so the function searches for items with those matching keywords. This means that items with matching names and data types will not get used if they aren't a clone of the item in question. When `search_existing_items` is set to `False`, all items will get cloned (even if clones of them already exist in the target), unless they're not cloneable or covered in a dictionary passed in as the `item_mapping` argument (more on this later)."
4444
]
4545
},
4646
{
@@ -499,7 +499,7 @@
499499
"source": [
500500
"## StoryMaps, Web Scenes, and Item Remapping\n",
501501
"\n",
502-
"Version 2.2.0 also smoothes over cloning for another popular item type- [ArcGIS StoryMaps](https://www.esri.com/en-us/arcgis/products/arcgis-storymaps/overview). StoryMaps can contain numerous media types and different types of ArcGIS items, which `clone_items()` should cover- we're going to show how users can examine the items in their StoryMap and confirm that both the StoryMap and all of the internal items were cloned properly.\n",
502+
"Version 2.2.0 also smoothes over cloning for another popular item type- [ArcGIS StoryMaps](/python/api-reference/arcgis.apps.storymap.html#storymap). StoryMaps can contain numerous media types and different types of ArcGIS items, which `clone_items()` should cover- we're going to show how users can examine the items in their StoryMap and confirm that both the StoryMap and all of the internal items were cloned properly.\n",
503503
"\n",
504504
"We'll start by grabbing a StoryMap using the portal item ID, and then use a couple methods to examine the content within the item: using the ArcGIS API for Python's StoryMap class, and accessing the item's internal JSON structure."
505505
]
@@ -551,7 +551,7 @@
551551
"id": "e803e217",
552552
"metadata": {},
553553
"source": [
554-
"Using the Python API's `StoryMap` module, we can get a general overview of what's in the StoryMap with the `content_list` property."
554+
"Using the Python API's `StoryMap` module, we can get a general overview of what's in the StoryMap with the [content list](/python/api-reference/arcgis.apps.storymap.html#arcgis.apps.storymap.story.StoryMap.content_list) property."
555555
]
556556
},
557557
{
@@ -694,7 +694,7 @@
694694
"id": "3f074c4b",
695695
"metadata": {},
696696
"source": [
697-
"Above you'll see all of the info about what's contained within the StoryMap. All that's in there currently is a Web Scene, which simplifies things; we just know that Web Scene needs to be cloned across. The draft JSON of the cloned StoryMap should match this, except with a select few things adjusted to the new organisation, such as `itemId`.\n",
697+
"Above you'll see all of the info about what's contained within the StoryMap. All that's in there currently is a Web Scene, which simplifies things; we just know that Web Scene needs to be cloned across. The draft JSON of the cloned StoryMap should match this, except with a select few things adjusted to the new organization, such as `itemId`.\n",
698698
"\n",
699699
"We're going to assign the output of the `clone_items()` call to a variable called `clone_list`. This will be a list of the ArcGIS items that got cloned over."
700700
]
@@ -870,7 +870,7 @@
870870
"id": "d9ab635a",
871871
"metadata": {},
872872
"source": [
873-
"As we can see, the results are essentially the same, minus one difference: the key of the resource and the `itemId` are different. The Web Scene got cloned over to the new organisation, and our cloned StoryMap properly points to the new one."
873+
"As we can see, the results are essentially the same, minus one difference: the key of the resource and the `itemId` are different. The Web Scene got cloned over to the new organization, and our cloned StoryMap properly points to the new one."
874874
]
875875
},
876876
{
@@ -1097,9 +1097,9 @@
10971097
"id": "40cca7d6",
10981098
"metadata": {},
10991099
"source": [
1100-
"Using the `itemId` key in there, we can see exactly which item is being used in there. Say we already have an item in the target org we want to replace that particular item with; we would construct an `item_mapping` dictionary with the original item's ID as the key and the target item's ID as the value. This dictionary can be contructed with as many appropriate item ID's as necessary.\n",
1100+
"Using the `itemId` key in there, we can see exactly which item is being used in there. Say we already have an item in the target organization we want to replace that particular item with; we would construct an `item_mapping` dictionary with the original item's ID as the key and the target item's ID as the value. This dictionary can be contructed with as many appropriate item ID's as necessary.\n",
11011101
"\n",
1102-
"Let's say we already have another Everest Web Scene in our target organisation that we want to use instead; we would just have to find the item ID of that item, which is '502c4f1454d34766807e1268c09acf34'. If we we were to clone this StoryMap again, we could make our cloned StoryMap use this target item. We just pass in an `item_mapping` dictionary, and set the item ID of the source item we want to replace as the key, and set the item ID of the desired item in the target GIS as the value."
1102+
"Let's say we already have another Everest Web Scene in our target organization that we want to use instead; we would just have to find the item ID of that item, which is '502c4f1454d34766807e1268c09acf34'. If we we were to clone this StoryMap again, we could make our cloned StoryMap use this target item. We just pass in an `item_mapping` dictionary, and set the item ID of the source item we want to replace as the key, and set the item ID of the desired item in the target GIS as the value."
11031103
]
11041104
},
11051105
{
@@ -1260,7 +1260,7 @@
12601260
"As you've just seen, accessing an item's data gives you great insight into what's going on. Having direct access to the structure of the item's data also gives you a great tool to troubleshoot when something doesn't quite go right with your cloning. \n",
12611261
"\n",
12621262
"\n",
1263-
"ArcGIS Dashboards aren't actively supported with their own module in the Python API, but they're still cloneable. There are a couple caveats, such as `item_mapping` not being usable, but using the tricks we've covered in this guide, users can still move them across organisations and remap their data. This makes them the perfect example of how to troubleshoot something by hand using methods found in the `gis.item` module."
1263+
"ArcGIS Dashboards aren't actively supported with their own module in the Python API, but they're still cloneable. There are a couple caveats, such as `item_mapping` not being usable, but using the tricks we've covered in this guide, users can still move them across organizations and remap their data. This makes them the perfect example of how to troubleshoot something by hand using methods found in the `gis.item` module."
12641264
]
12651265
},
12661266
{

0 commit comments

Comments
 (0)