Add items

If your account has privileges to create content, you can add files from your computer, items from the web, apps, and data stores to your ArcGIS Enterprise portal. You can also save maps and publish apps. Your items are accessible only to you until you share them with others.

Add files from your computer

You can add supported files from your computer to the website and share the files so others can download and open the files in desktop applications. When you share comma separated values (CSV) files with everyone (public), you can use the URL that appears on the item page to add the CSV as a web layer. In addition, you can add image files and use the URL to show images in web apps and pop-ups. You need to share the CSV and image files with everyone (public) to see the URL on the item page.

If you have privileges to publish hosted feature layers, you can choose to publish a hosted feature layer when you upload a shapefile, CSV file, or file geodatabase.

Note:

Once published, data uploaded from a shapefile or file geodatabase will be converted to Web Mercator projection.

1. Verify that you are signed in and have privileges to create content.
2. From the My Content tab of the content page, click Add Item and click From your computer.
3. Click the Choose File button and choose the file on your computer.
4. If you uploaded a .zip file, choose the contents of the file, for example, map template or code sample.
5. If you uploaded a code sample (.zip), choose the language of the sample, for example, Java or C++.
6. Type a title.
7. If your portal administrator has configured content categories, click Assign Category and select up to 20 categories to help people find your item. You can also use the Filter categories box to narrow the list of categories.
8. Type tags that describe your item. Separate terms with commas (for example, Federal land is considered one tag; Federal, land is considered two tags). As you type, you can select any of the suggested tags that appear; suggestions are generated from tags you have added previously.
9. Click Add Item.

Once you've added your file, it appears in your content and you can edit the item details and share it (if you have sharing privileges).

Add items from the web

When you add an item from the web, you are referencing the REST endpoint (URL). The website does not store the item itself. You can reference ArcGIS Server web services, KML, and OGC WFS, WMS, and WMTS. You can also reference documents and images stored on the web.

1. Verify that you are signed in and have privileges to create content.
2. From the My Content tab of the content page, click Add Item and click From a URL.
3. Choose the type of item:
   • ArcGIS Server web service
   • KML
   • OGC WFS
   • OGC WMS
   • OGC WMTS
   • Document—Documents include spreadsheets, presentations, tables, images, and other documents stored on the web.
4. Type the REST URL of the service or document, for example, https://webadaptorhost.domain.com/webadaptorname/rest/services/folder/service/MapServer.

   Tip:

   If you need to access your services over HTTPS, be sure the URL you provide when you add the service starts with https.

   ArcGIS Server web service URLs are in the format https://<fully qualified web adaptor machine name>/<web adaptor name>/rest/services/<folder name>/<service name>/<service type>. If the service is in the root folder, you do not need to include the folder name in the URL. The URL format in that case is https://<fully qualified web adaptor machine name>/<web adaptor name>/rest/services/<service name>/<service type>.

   To find the REST URL of an ArcGIS Server service, open the ArcGIS Server Services Directory and browse to the service you want to share. You can then copy the URL from the browser's address bar. Do not append any parameters, such as a token, to the URL.

5. If you added a secure service that is available externally, enter a user name and password for an account that has access to the service, and select whether or not you want the credentials stored with the service item. If the credentials are not stored with the item, everyone who accesses the item will be prompted for credentials every time they access the service item. If the credentials are stored with the item, you will not be prompted for credentials.

   User names might be case sensitive depending on how your identity systems are managed. If you store the credentials and plan to share the service in a public app, you may want to enable rate limiting to limit use on the service.

   Note:

   If you do not see the user name and password fields, the options to store or not store credentials, or if you see an error when attempting to add the secure service, there may be an issue with your HTTPS configuration. The ArcGIS Server site providing the service for which you are attempting to store credentials must support HTTPS and have a valid certificate signed from a well-known certificate authority. For additional troubleshooting, contact Esri Support (In the USA) or your international distributor (outside the USA).

6. If you added an OGC WMS layer, choose the layers you want to be visible.
7. Type a title.
8. If your portal administrator has configured content categories, click Assign Category and select up to 20 categories to help people find your item. You can also use the Filter categories box to narrow the list of categories.
9. Type tags that describe your item. Separate terms with commas (for example, Federal land is considered one tag; Federal, land is considered two tags). As you type, you can select any of the suggested tags that appear; suggestions are generated from tags you have added previously.
10. If you added an OGC WFS or WMTS layer, select the layer that will be drawn when the item is added to a map. If you want to add multiple layers from a WFS or WMTS service, you must create individual items for each layer.

    If the WMTS service supports multiple projections, you must select a specific projection. By default, the first projection available is selected.

11. Click Add Item.

Once you've added your item from the web, it appears in your content and you can edit the item details and share it (if you have sharing privileges).

Add apps

You can add existing web apps as items to the portal so portal members can search and discover them. When you add an app as an item, you are sharing the URL to the app; the portal does not actually host the app files. Another way to share apps with members of your portal is to publish a web app you create from a map. For more information, see Create apps from maps.

1. Verify that you are signed in and have privileges to create content.
2. From the My Content tab of the content page, click Add Item and click An application.
3. Choose the type of app:
   • Web Mapping—A web app built with a web API, such as JavaScript.
   • Mobile—A downloadable app built for mobile devices with an SDK, such as iOS or Android.
   • Desktop—An app for desktops built on a desktop platform, such as Java or .NET (Microsoft Windows Desktop).
   • Application—A desktop application or any type of generic app where you don't have details about purpose, API/SDK, or URL address.
4. For web mapping, mobile, or desktop apps, choose the Purpose of the app:
   • Ready to Use—Fully functioning website or mobile app.
   • Configurable—Fully functioning app that can be deployed by configuring a file.
   • Self-configurable—Fully functioning app that can be deployed by using an internal app builder. This option enables the Configure App button in the item page.
   • Code Sample—Code for a specific piece of functionality, either as a live sample or a description of how to use the sample in an app.
5. For web mapping or mobile, choose the API (web mapping) or SDK (mobile) used to create the app.
6. For desktop apps, choose the Platform used to create the app.
7. For desktop apps, click Choose File and choose the .zip file that contains your app.
8. For web mapping or mobile, type the URL of the app, for example, http://<myServer>/myWebMapApp.
9. Type a title.
10. If your portal administrator has configured content categories, click Assign Category and select up to 20 categories to help people find your item. You can also use the Filter categories box to narrow the list of categories.
11. Type tags that describe your item. Separate terms with commas (for example, Federal land is considered one tag; Federal, land is considered two tags). As you type, you can select any of the suggested tags that appear; suggestions are generated from tags you have added previously.
12. Click Add Item.

Once you've added your app, it appears in your content and you can edit the item details (where you can attach code if you want) and share it (if you have sharing privileges).

Register your app

You can register the OAuth 2.0-based apps you develop. Registering your app with the portal provides you with an app ID. The app ID is the foundation for distributing apps and getting usage reports.

You must add your app to the portal before you register it. See the section above for details. After you've added it, follow the steps below to register your app and get an app ID and app secret.

1. Verify that you are signed in with an account that has privileges to create content.
2. From the My Content tab of the content page, click the title of the app you want to register to view its item page.
3. Click the Settings tab. Scroll down to the App Registration section and click Register.

   If you've added a generic type of app, the app is automatically registered and you see the Registered Info button instead of the Register button. You can view and update the registration information.

4. Select the type of app: browser, native, server, or multiple.
5. For each redirect URI, enter the address in the format ["https://<server>[:port]"] or ["http://<server>[:port]"]) and click Add.

   Redirect URIs are valid addresses that users of your app can be redirected to after they successfully log in.

6. To remove a URI you previously added, select it, click Delete, and click Register.

View and update app registration information

Once you've registered your app, you can view registration information—which includes an app ID and an app secret—and update the redirect URIs, reset the secret, and unregister the app.

Note:

Resetting the app secret will invalidate all existing user and app tokens issued for the app. Users will need to sign in to the app again, and apps configured with the secret may need to be updated.

1. Verify that you are signed in to the portal and click the My Content tab of the content page.
2. Click the title of the registered app.
3. On the item page, click the Settings tab.
4. Scroll down to the Application Settings section and click Registered Info.

   You can view the following details: app ID, app secret, app type, and redirect URIs.

5. To update the redirect URIs, click Update and follow these steps:
   1. To add a redirect URI, enter the address and click Add.
   2. To remove a redirect URl, select the URI address and click Delete.
   3. Click Update and click Save.
6. To reset the app secret, click Update and follow these steps:
   1. Click Reset Secret.

      Resetting the app secret will invalidate all existing user and app tokens issued for this app. Users will need to sign in to the app again, and apps configured with the secret may need to be updated.

   2. Click Yes if you are sure you want to reset the app secret.
   3. Click Update and click Save.
7. To unregister your app, click Unregister App.

   Your app is no longer registered. You do not need to save the item page.

Add a data store

Follow these steps to add a user-maintained data store item to the portal, thereby providing a registered data source for one or more federated servers.

Note:

Even though you add the data store to the portal, this process registers the data store with federated servers. Therefore, each federated ArcGIS Server site must be configured to access the database or folder location.

If your user-maintained data store is already registered with one or more of the portal's federated ArcGIS Server sites—for example, you registered the data store in ArcGIS Pro 2.4 or an earlier release or ArcGIS Server Manager—do not use these steps to add the data store item. Instead, talk to your portal administrator about creating a data store item from an existing registered data store.

1. Before you can add a data store item, the data source location must be accessible.
   • To add a folder as a data store, ensure the folder functions as a file share location.
   • To add a database data store, you must first create a database connection file (.sde file) connecting to a supported database. Ensure you connect as a database user who has access to the data you need and the required permissions on the data. You must save the credentials with the connection file. You cannot use a .odc file.
   • To add a cloud store, you must have an account with a supported cloud storage provider, and the cloud storage location must exist.

   For more information on making data sources accessible, see Controlling access to data published from data store items.

2. Open the portal and sign in.

   You must sign in as a member who has privileges to create content and register data stores.

3. From the My Content tab of the Content page, click Add Item and click A data store.
4. Type a title for the data store item. This is the name people will see when they look for the data store item.
5. Choose the type of data store item to create.
   • Folder—To publish imagery layers from image files in a shared folder, add a folder data store item.
   • Database—To bulk publish feature layers from a database or enterprise geodatabase, add a database data store item.
   • Cloud—To publish imagery layers from image files in a cloud storage location, add a cloud data store item.
6. Type tags that describe your item. Separate the terms with commas (for example, Federal land is considered one tag; Federal, land is considered two tags). As you type, you can select any of the suggested tags that appear; suggestions are generated from tags you have added previously.
7. If your portal administrator has configured content categories, click Assign Category and select up to 20 categories to help people find your item. You can also use the Filter categories box to narrow the list of categories.
8. Choose the folder in My Content where you want to store the data store item.
9. Click Next to configure the connection to the source data.
10. How you connect to the data source depends on the type of data store you're adding.
    • To connect to a folder data store item, type the path to the folder.
    • To connect to a database or enterprise geodatabase, click Choose File and browse to the database connection file (.sde) you want to register.
    • To connect to a cloud storage location, choose your cloud storage provider and credentials to connect. The information you need to provide varies by provider type.

      Note:

      To connect to a private cloud, choose Custom from the Region drop-down menu and type or paste the URL to access the private cloud into the Private URL field.

11. In most cases, the clients that people use to publish layers from this registered data store will use the same location as the ArcGIS Server site. However, if your ArcGIS client will access data in one folder or database but the federated ArcGIS Server sites need to access a copy of the data in a second folder or database, you must provide information for both data sources.
    • If your clients and the federated servers will access data in the same database or geodatabase, leave the default setting, Same as publisher database connection.
    • If you have duplicated the data in two geodatabases and want clients and the ArcGIS Server sites to reference different geodatabases, choose New connection under Server database connection (.sde file), and choose the database connection file that the federated ArcGIS Server sites will use to connect to the data in the other geodatabase.
    • If your clients and the federated servers will access data in the same shared folder, leave the default setting, Same as publisher folder path.
    • If you have duplicated the data in two different file shares and want clients and the ArcGIS Server sites to reference different file shares, choose New path under Server folder path, and type the path to the second file share.
12. Click Next to choose the ArcGIS Server sites with which this data store will be registered.
13. Select the ArcGIS GIS Server and ArcGIS Image Server sites with which you want to register this database. If you are unsure which sites fill these roles, contact your ArcGIS Server administrator.

    You can only select a site if the status is normal, which means the site can connect to the data source.

    If this data store is already registered with a federated server—for example, you registered with one of the federated servers in ArcGIS Server Manager—you cannot select that federated server from the list. If you do, you'll receive an error.

14. Click Add data store.

If you added a database data store item and chose a federated ArcGIS GIS Server site in step 13 to register it with, you can publish feature layers for all the feature classes and tables accessible through this data store item. If portal members will be publishing data from this database connection in ArcGIS Pro and ArcGIS Desktop, share the data store item with a group to which those portal members belong. This allows these portal members to publish data using the same database credentials to any of the federated servers you specified in step 13.

If you added a folder or cloud data store, share the data store item with groups whose members need to create imagery layers.