Projects enable you to manage your work more effectively and is aligned with the way your business works. You can organize your sites in layers, quickly filter and find content organized in the project panel, and easily move and share sites between projects.
Content within projects, such as: your Sites, Reports, and Custom Data are included and available in a centralized location. This data can be accessed via Business Analyst apps —from Mobile to Web to Desktop or as individual Item types in ArcGIS Online or ArcGIS Enterprise.
When you sign in to ArcGIS Business Analyst Web App for the first time and go to the Maps tab, the My Projects tab will be empty. To begin working you must first click Create Project to create a project. Alternatively, if another user has shared a project with you, you can access it under Projects shared with me.
In subsequent sessions, when you sign in and go to the Maps tab, you will see a list of your previously created projects. To work on a project, move the pointer over the project thumbnail and click Open. You may also click Create Project to create a new one.
When you click Open, the project is opened in the Maps tab, on the left.
The project you chose will be opened. To switch to a different project, return to the Projects view by clicking All Projects.
The items in your selected project are displayed. Expand any of the sections (Point Locations, Polygons, …) to view the layers.
Click Edit to add a new layer to a section.
Expand any of the layers to view the sites contained within. Click on to view other options for a layer or an item.
To create a new project you will perform the following steps:
- From the All Projects view, click Create Project.
The Create Project dialog box opens.
- In the Project name field, enter a name for the project. You may optionally click Customize project attributes to customize, add, and remove attributes for the project.
- Click Add attribute to add more attributes for the project.
- Move the pointer over an attribute to see more options:
- Click Edit to edit the attribute name.
- Click Remove to remove that attribute from the project
Move the pointer over any of the More information icons for more information. Expand any of the drop-down menus to see options. The Number drop-down has the following options:
- Double (Default)—The default format. Supports large numbers with fractional values. Suitable for attributes representing area—for example, sq. miles.
- Float—Supports smaller numbers with fractional values. Suitable for attributes representing ratios.
- Long—Supports large whole numbers—for example, building square footage or property record ID numbers.
- Short—Supports small whole numbers—for example, number of floors in a building.
The Set Validation drop-down has the following options:
- Range Allows you to set a minimum and maximum value for the attribute. Values outside this range will not be allowed. Only one value from the Minimum and Maximum fields need be specified—for example, the minimum number of parking spaces acceptable is 100. The Minimum field could be set to 100 and the Maximum field left blank.
- Preset values Allows you to list the permitted values for the attribute. Any value, not explicitly listed, will not be allowed—for example, you add an Historically significant attribute which has only two permitted values: Yes, No. You can set the attribute format to Text and Length to 1 (maximum allowed length is 254) and the Preset values to Y, N. You can enter descriptive information for each preset value in the corresponding Name field. Click Add value to specify additional values.
- When finished customizing attributes, click Create.
A project will be created and a thumbnail for the new project will appear in the All Projects view.
After a project has been created, you can still customize, add or remove attributes for any layer in the project. See Layer options below.
When sites are created in this project, you can only enter values for the attributes that satisfy the validations you had set when the project was created. An invalid value will not be accepted and an error message will be returned. You can modify validations for any layer in the project.
When you have more than one layer within the Point Locations, Polygons, or Geographies sections, you may change the target layer at any time by clicking Edit next to it, and clicking Make target. The target layer is where any new site you create will get saved by default. You will also see additional options.
- Zoom to layer—Zoom to the layer on the map
- Rename item—Rename the layer
- Delete item—Delete the layer
- Show attribute table—Open the attribute table for the layer
- Edit attributes: Edit the attributes and validation rules for the layer. Click Edit to edit the attribute name and Remove to delete it. Click Add attribute to add a new attribute. For detailed information on validation rules, see Create Project above.
Editing the validation for an attribute may cause invalid values for existing sites, which may cause issues for items you created using this project, such as custom infographic templates and custom reports. For example, assume that you already have a site with a value of 250000 for the Building Area attribute. If you edit the validation to lower the Maximum to 230000, then that site will now have an invalid value for the Building Area value.
- Filter by attributes—Filter the items in the layer based on the attributes values—for example, you want to filter a site layer to show sites that are > 15,000 and have more than 50 parking spaces. You choose those attributes in the drop-down (Image 1) and then adjust the filters accordingly (Image 2).
When using a text field to filter, you can press the space key to quickly see up to 20 unique values. If you entered a search string, it will be highlighted in available options as shown below, with the option to select all returned results.
When a filter is enabled on a layer, the filtered version of the layer will be applied when it is used in a workflow—for example, in Suitability Analysis as a competitor layer. To use the original layer, you must first disable the filter.
To continue without saving, click Done. In the project content on the left, a red dot against the layer name will indicate that a filter has been applied to it. Click Options to open layer options—the Filter by attributes toggle will be enabled. Use this toggle to quickly disable/enable the filters. To modify or clear the filters, click Filter by attributes.
To save the filtered version of the layer, click Save as new layer. For site layers, just specify a name for the new layer, and click Save.
When filters are applied to a points layer—for example, points returned by a business and facilities search, you will have the option to save only the points or create and save sites for the filtered points.
If the filtered layer has greater than 1000 points, sites will only be created for the first 1000.
- Setup Layer—This option enables you to setup a layer for use in analysis and reports. Web maps are listed in the Web Maps and Layers section. Territories are listed under the Territories section. Layers created from business search results and imported files are available under the Other Layers section. Click Options next to the point or polygon layer that you want to setup and click Setup layer. You may need to expand a Web Map or Territory listed here to view the layers in it.
- Expand all— This option is only available for the Other Layers section.
Click Options for the section and then click Expand all. Any layers with symbology will be expanded and you won't need to expand each individually. For example, in the above screen capture there are two business search result layers. They are expanded when you click Expand all, to show the symbology for the layers.
Click on the black arrow next to a layer name to expand and view the items contained within. Click Options to view other options for a layer or an item contained within.
- Show details—Open the site details in edit mode.
- Zoom to site—Zoom to the site on the map.
- Run reports—Run a report for a site.
- Run infographics—Run infographics for a site.
- Rename item—Rename a site.
- Edit site—Edit the results of a site by choosing another location, editing a polygon, adding rings, drive times or bands and getting reports.
- Move item—Move sites to different layers within the same section.
- Delete item—Delete a layer or a site.
Clicking on Show details will open the site details in editable mode:
- Move the pointer over the site name and click Edit to rename the site.
- Click Add photo > Browse to upload a photo for the site from your device.
The added photo will be displayed under the site name at the top. Panoramic and 360 degree photos are also supported and indicated by icons in the top left. Move the pointer over the photo for more options:
- Scroll through the photos by clicking the arrow buttons on either side.
- Click to remove the photo.
- Click in the bottom right to view a gallery of all the photos for the site—here, you can add captions for photos, and click Image order to change the order of the photos.
Click on a photo to view it in the Photo Viewer. In that mode, you can pan a 360 degree photo and view the full extent. For panoramic photos, you can zoom in and then pan.
- Move the pointer over any of the Attributes (Building Area, Frontage, and so on) and click Enter value to modify the value.
- Notes—Click Add to enter notes for the site.
- Attachments— An attachment is a document or image with additional relevant information about the site-for example, a PDF floorplan of a building at the site location, or an image of the building. Click on any attachment in the list to open it. To add a new attachment, click Add. The Add attachment dialog box opens. In the Choose File drop-down menu, select Browse to upload a document or image from your device.
Images will be added to the photo gallery.
- Under the Reports section, you will see a list of reports previously run for the site.
You can run a report for a site.
- Click the Run reports button option. The Reports view is launched.
- Click Add to select a report .
- Click Run Now.
You can run infographics for a site.
- Click the Run infographics button option. The infographics template is launched.
- You may edit, share, export, or print the infographic.
You can rename a site.
- Click the Rename item button option. The name is highlighted.
- Type a new name.
You can edit the results of a site by choosing another location, editing a polygon, adding rings, drive times or bands and getting reports.
- Click the Edit site option. The dialog box appears for you to make the edits.
You can move sites to different layers within the same section.
- Click the Move item option. The Move dialog box appears.
- Click on the layer to where you wish to move the site. Click Move.
When deleting a layer, you delete the layer and the sites in it.
- Click the Delete item option.
- Click OK in the Confirm Delete dialog box.
- To delete multiple sites at once, use Shift + click to highlight multiple sites. Then click on next to any one of the selected sites, and click Delete items.
Deleting a layer or site is permanent. The deleted content is also removed from your Project Data in ArcGIS Online (see Your content in ArcGIS Online).
You can manage your projects within the All Projects view. You can move items between layers, rename items, layers and projects, launch ArcGIS Online to share your projects with other users.
Click All Projects to open the All Projects dialog box.
You can perform several operations from the All Projects screen:
- Click the project in the Change current project drop-down to view the list of projects, and open a different project.
If you have any items on the map, the Clear Map dialog box will appear. Click Yes to clear the map of those items. You may select the check box to save this choice under Preferences > General > Projects, and not see this dialog again.
- Click the Projects shared with me tab to view the projects shared with you. See Shared projects.
- Click Edit to rename a project.
- Click Delete to delete a project. You may not delete the current project. To delete the current project, you must first select a different project in the Change current project drop-down menu.
- Click Share to share a project with other users.
- Move the pointer over a project thumbnail and click Manage Items to organize the items in the project.
Click Edit to view options. Click Add to the map to add the items contained within the layer to the map. Click Rename item to rename the layer.
Click Expand to expand it and view the items contained within it.
Click the next to an item name to view options.
- Clicking Remove from the map will take you to the map view and add the item to the map.
- Clicking Zoom to site will allow you to zoom to the site on the map.
- Clicking Rename item will allow you to rename it.
- Clicking Edit site (when applicable and available) will open the item in Edit mode.
- Clicking Move item will open the Move dialog box, and you can select a different layer to move the item to—for example, in the following screen capture the layer Point Locations B is selected.
Since a Point Location was selected, you can only choose to move it to another Point location layer.
- Clicking Delete item will prompt for confirmation to delete the item.
You may also move it to a Point location layer in another project. Click Browse to browse and select a point location layer in another project.
Select the Keep a copy check box to move the item, but still retain the item in its current layer.
The project-based structure allows you to share your projects with other users, and enables other users to share their projects with you, thus facilitating easy collaboration.
Click Share in the project thumbnail, to share a project from the All Projects view.
The Share the Project with Other Users dialog box appears.
- Add entire organization is selected by default, which allows you to share the project with all other users in your organization.
- To share with specific user(s), choose Add individual users from your organization, and select the users by clicking the check box. You may select the Select all check box to select all users, which would be the same as using the Add entire organization option.
If you need to share a project with all users except for a few, use the following shortcut: click Select all to select all users, and then deselect just those specific users.
- To search for specific users, click Search icon and enter the search term.
In this example, one user is selected. Click Apply.
The project is shared with the selected user(s). The new state of the icon in the project thumbnail indicates that the project is shared.
You may click the shared icon to reopen the Share the Project with Other Users dialog box. You may then review or modify the list of users the project is shared with, by selecting additional users or deselecting a currently selected user.
To modify the list of users the currently open project is shared with, you may click the share icon in the project panel.
Projects shared with you
Other users may invite you to their projects. Click Projects shared with me to view a list of projects other users have shared with you.
To work with the items contained within a shared project, move the pointer over the thumbnail and click Manage Items. You can add an item—for example, a site from this project to the map, move items between layers, rename an item, and so on. To open a shared project, click Switch to this Project.
To make sure the projects most recently shared with you are listed, click Refresh to refresh the list. Use the options in the Sort by: drop-down to choose a different way to order the list of projects.
In this step-by-step guide, you will learn how to get started using the Projects structure to create and store your content.
Step-by-step guide to creating a Project.
Your content in ArcGIS Online
You can access the content in your projects in ArcGIS Online and share it with other users in your organization or with all users of ArcGIS Online. You will use this page to organize, access, and work with your content.
After signing in to ArcGIS Online, go to Content.
The Groups that you belong to are listed under the Groups tab. Projects in ArcGIS Business Analyst Web App are listed under the Groups tab. The list of groups here will include the Projects you created, and those other users shared with you. You may invite other users to a Group you own (see Shared Projects).
Your page should look similar to what is shown below.
While Business Analyst content is directly accessible through projects and its Project Manager feature, the content is also available as Items within ArcGIS Online or ArcGIS Enterprise. Learn more about Items here: http://doc.arcgis.com/en/arcgis-online/share-maps/add-items.htm.
Learn more about the ArcGIS geoinformation model here: https://doc.arcgis.com/en/arcgis-online/share-maps/item-details.htm.
Business Analyst creates folders in the ArcGIS My Content page so that your analyses are automatically saved. These layers and items can be added to Business Analyst apps (Web, Desktop, etc). More information about these Business Analyst specific folder are listed below:
- your_username (Home)—This is the default folder when publishing hosted services from any ArcGIS application, including Business Analyst Web App and ArcGIS Online.
- BA - Application Data—This folder contains all your Business Analyst configurations, preferences, saved variables including Color-Coded Maps, Smart Map Searches, Comparison Reports Data, and Project preferences.
- BA - My Maps—This folder contains items that you share from Business Analyst Web App to ArcGIS Online using the ArcGIS Web Map workflow and story maps created using the Story Map workflow.
- BA - My Reports - Ordered Reports—This folder contains PDFs that are created using the PDF or Image workflow, and reports in PDF, All-In-One PDF, and Excel formats created using the Run Reports workflow.
Some users will also see these folders:
- BA - My Reports - Custom PDF Map Reports—folder contains previously created PDFs using the Create PDF or Image workflow. These PDFs created now are saved under BA - My Reports - Ordered Reports.
- BA - My Reports - All-in-One Reports—This folder contains previously created All-In-One reports using the Run Reports workflow. All-In-One reports created now are saved under BA - My Reports - Ordered Reports.
- BA - Project Data—This folder contains the data (feature service) that stores your sites and additional layers from Projects created in Business Analyst Web App or from Business Analyst Desktop.
- BA - Report Themes—This folder contains custom infographic themes saved using the Build Infographics workflow.
- Custom Data—This folder contains the Custom Data that you created using the Custom Data Setup workflow in Business Analyst Web App or from Business Analyst Desktop.
- Report Templates—This folder contains report templates you created in Business Analyst Web App, including templates using Build Reports, Build Infographics, and Comparison Reports workflows. It also contains custom report templates created using Business Analyst Desktop.