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 the Business Analyst Web application 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 on 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 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 to edit the attribute name.
- Click to remove that attribute from the project
Move the pointer over any of the 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 the 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 to edit the attribute name and 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 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—For use in analysis and reports. This option is only available under the Web Maps and Layers section (for web map layers), and under the Other Layers section, for imported file layers and business search results layers. For a web map, you will need to first expand it, then click for the layer and select this option.
The Setup Layer panel opens. Here you will finalize the selection of items from the layer.You can use the check boxes to select or deselect items in the list. You can also use the following controls:
- Select a field in the Use field as item name drop-down menu to use it as the item name.
- Click the filter icon to filter the items in the layer by attributes.
- Check the Filter by map extent check box to select only those items that are within the current map extent.
If the Owner of the web map has already enabled it, this checkbox will already be selected, and you will not be able to change this setting.
For point layers, use the Create buffers around selected points options to modify the buffers to be applied around the selected points – the default is rings. This is not available for polygon layers. When done, click Setup Layer. The layer is now setup for analysis and reports.
No sites are created or saved in your project. The setup layer is only available in your current session. If you remove it from the map, you will need to setup the layer again.
You can then immediately launch one of the workflows to use the setup layer. For Suitability Analysis , the items from the layer will already be selected. For Run Reports and Comparison Reports, the Add Sites dialog will open, with the newly setup layer loaded under the From layers tab, but you will need to select the items to run reports or comparisons.
- Expand all— This option is only available for the Other Layers section.
Click 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 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:
- Click the Edit button to rename the site.
- Click Add photo > Browse to upload a photo for the site from your device, or click From URL to provide a URL for an image you want to use.
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. You can scroll through the photos by clicking the arrows on either side of the photo. Click the gallery button in the bottom right to view a gallery of all the photos for the site—here, you can add captions for photos and delete photos.
Click on a photo to view it in the Image 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 video with additional relevant information about the site-for example, a PDF floorplan of a building at the site location, or a video walkthrough of the building. Click on any attachment in the list to open it. A video attachment will be played in the multimedia player within the application. To add a new attachment, click Add. The Add attachment dialog opens. In the Choose File drop-down menu, select Browse to upload a document or image from your device, or From URL to enter the URL of a video or image to add.
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.
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 will appear. Click Yes to clear the map of those items. You may select the checkbox 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 to rename a project.
- Click 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 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 the next to a layer name 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 next to a layer name 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 to browse and select a point location layer in another project.
Select the Keep a copy checkbox 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.
To share a project from the All Projects view, click the Share icon in the project thumbnail.
The Share the Project with Other Users dialog 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 checkbox. You may select the Select all checkbox 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 the 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. 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 to refresh the list. Use the options in the Sort by: drop-down to choose a different way to order the list of projects.
The following is an illustrated walkthrough that guides you on how to get started using the Projects structure to create and store your content. When you first open the application and click on the Maps tab, you will be see the Projects opening page that walks you through setting up your project.
- Click the Create Project button to add your first project.
- Enter a name for your Project and Click Save. To customize the set of attributes for point locations in this project, click Add custom attribute fields for point locations.
- Once your project is created, you will see the following confirmation message. Click OK.
The newly created project will become the current project.
- Place your mouse over the project and click Manage Items.
- The Maps page will open, with the Project panel open on the left. Click on the project name at the to collapse and expand this Project view. You may click on or the All Projects link to open the All Projects view, where you can organize your content. See All Projects. Click on View Full Table to view the expanded view of the table.
- To add a location site to the Project go to Define Areas for Reports > Find Location. Add an address in the Enter an address field and add a name in the optional Name your location field. and click Apply.
- Click Organize Sites to return to the Project View.
You will see the newly added site under the My Point Locations layer.
- To add additional content you will perform the following tasks:
- Create a new point locations layer Candidate Neighborhoods and added a few sites to it that represent neighborhoods for an analysis.
- Use the Import file workflow to import an Excel file of addresses representing coffee shops, apply rings to them and save as a new layer.
- Create a Color-Coded map, Smart Map, or Suitability Analysis layer. These will be under the section Other Layers. Add a web map from ArcGIS Online. It will be under the section Web Maps and Layers.
- Create a new PDF or Excel report. Reports that have been run will appear under the section Previously Run Reports.
Here, the View Full Table link has been clicked to view the expanded table. The Description column tells us the type of an item, and the Details column provides additional details such as ring sizes (for a site).
- You can filter project items by clicking the Filter icon.
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 the BA 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.