Skip to main content

Manage workspaces as a host

As a distributed collaboration host, you can manage the workspaces associated with the collaboration. You can add, edit, and delete workspaces, configure their properties, and view their synchronization history. For information on managing collaborations, see Manage collaborations as a host.

View collaboration workspaces

To view a list of collaboration workspaces, complete the following steps:

  1. Sign in to your organization as a member of the default administrator role or a custom role with administrative privileges to manage the organization's collaborations.

  2. At the top of the site, click Organization and click the Settings tab.

  3. Click Collaborations on the side of the page.

  4. Under the Distributed section, find and select the collaboration whose workspaces you want to view. Optionally, do any of the following to help you find the collaboration:

    • Type search terms in the search box.

    • Click Status and select a sort type and direction.

    The collaboration window appears.

  5. In the Workspaces section, view the table that displays the collaboration workspaces, including the following information for each workspace:

    • Workspace—The workspace name.

    • Group—The group linked to the workspace.

    • Permission—Your organization's workspace access mode.

    • Sharing type—How your organization shares feature layers and views to the workspace.

    • Last sync status—The status of the synchronization, which can be either of the following:

      • Healthy—All items were successfully synchronized.

      • Sync failure—Some or all items failed to be synchronized. Click the status to open the Sync details window, which displays various information about the synchronization. To learn more, see View synchronization history and details.

    • Organizations—The list of participating organizations that have linked a group to the workspace. The list includes your organization.

Edit a collaboration workspace

To edit a collaboration workspace, complete the following steps:

  1. Sign in to your organization as a member of the default administrator role or a custom role with administrative privileges to manage the organization's collaborations.

  2. At the top of the site, click Organization and click the Settings tab.

  3. Click Collaborations on the side of the page.

  4. Under the Distributed section, find and select the collaboration that contains the workspace you want to edit. Optionally, do any of the following to help you find the collaboration:

    • Type search terms in the search box.

    • Click Status and select a sort type and direction.

    The collaboration window appears.

  5. In the Workspaces section, find the workspace you want to edit. Optionally, do any of the following to help you find the workspace:

    • Type search terms in the search box.

    • Click Status and select a sort type and direction.

  6. Click More options More options and click Edit workspace Edit workspace.

    The Edit workspace window appears.

  7. In the Edit workspace window, do any of the following:

    • Edit the workspace name and description.

      Note:

      Members of groups linked to a collaboration workspace can view collaboration details on the Overview tab of the group page, including the collaboration name. Therefore, when naming the workspace, you can avoid including the collaboration settings in the name.

    The Workspace name text box can contain up to 100 characters, and the Workspace description text box can contain up to 250 characters.

    • Choose a different existing group or create a new group to link to the workspace. A group can only be associated with one collaboration workspace.

      Note:

      Members of groups linked to a collaboration workspace can view collaboration details on the Overview tab of the group page, including the collaboration name. Therefore, when naming a new group, you can avoid including the collaboration settings in the name.

    • Edit how feature layers and views are shared in the workspace.

      Note:

      If you select One-way copies or Two-way copies, optionally turn on the If unable to share as copies, share as references toggle button to share feature layers and views as references if an error occurs while sharing them as copies.

    • Allow or disallow collaboration participants to access services shared as references without signing in to your organization.

  8. Click Save.

Add a collaboration workspace

To add a new workspace to a collaboration, complete the following steps:

  1. Sign in to your organization as a member of the default administrator role or a custom role with administrative privileges to manage the organization's collaborations.

  2. At the top of the site, click Organization and click the Settings tab.

  3. Click Collaborations on the side of the page.

  4. Under the Distributed section, find and select the collaboration to which you want to add a workspace. Optionally, do any of the following to help you find the collaboration:

    • Type search terms in the search box.

    • Click Status and select a sort type and direction.

    The collaboration window appears.

  5. In the Workspaces section, click Create workspace.

  6. Provide a workspace name and description.

    Note:

    The Workspace name text box can contain up to 100 characters, and the Workspace description text box can contain up to 250 characters.

  7. Choose an existing group or create a new group that will be linked to the collaboration workspace. A group can only be associated with one collaboration workspace. To learn more about groups and workspaces, see Understand distributed collaboration.

    Note:

    Members of groups linked to a collaboration workspace can view collaboration details on the Overview tab of the group page, including the collaboration name. Therefore, when naming a new group, you can avoid including the collaboration settings in the name.

  8. Choose one of the following options to specify how feature layers and views are shared to the collaboration workspace:

    • References—Collaboration participants receive new layer items that reference the source feature layers or views. Data edits are accessible in real time. If an item is secured, users must sign in to the source organization to access it.

    • One-way copies—Collaboration participants receive new hosted feature layers that they own. Only edits from your organization are synchronized at a scheduled interval defined by the guest.

    • Two-way copies—Collaboration participants receive new hosted feature layers that they own. Edits from your organization and participating organizations are synchronized at a scheduled interval defined by the guest.

  9. If you chose One-way copies or Two-way copies in the previous step, optionally turn on the If unable to share as copies, share as references toggle button to share feature layers and views as references if an error occurs while sharing them as copies.

  10. Optionally, turn on the Allow participants to view services without signing into this organization toggle button to allow collaboration participants to access services shared as references without signing in to your organization. If you turn on this option, find and select a built-in account with Viewer privileges in the Viewer account search box and provide its password in the Viewer password field. All services shared as references by your organization will be updated to use the credentials of this Viewer account, allowing collaboration participants to access the services without signing in.

  11. Click Next.

  12. Choose one of the following workspace access modes from the drop-down menu for each guest organization:

    • Guest can send content to this workspace—The guest organization can send to but not receive content from the collaboration workspace.

    • Guest can receive content from this workspace—The guest organization can receive from but not send content to the collaboration workspace.

    • Guest can send and receive content from this workspace—The guest organization can send and receive content from the collaboration workspace.

  13. Click Create workspace.

Administrators of the guest organizations will be notified that a new collaboration workspace has been added.

Delete a collaboration workspace

To delete a collaboration workspace, complete the following steps:

  1. Sign in to your organization as a member of the default administrator role or a custom role with administrative privileges to manage the organization's collaborations.

  2. At the top of the site, click Organization and click the Settings tab.

  3. Click Collaborations on the side of the page.

  4. Under the Distributed section, find and select the collaboration that contains the workspace you want to delete. Optionally, do any of the following to help you find the collaboration:

    • Type search terms in the search box.

    • Click Status and select a sort type and direction.

    The collaboration window appears.

  5. In the Workspaces section, find the workspace you want to delete. Optionally, do any of the following to help you find the workspace:

    • Type search terms in the search box.

    • Click Status and select a sort type and direction.

  6. Click More options More options and click Delete workspace Delete workspace.

    The Delete workspace window appears, which displays a summary of the collaboration's item retention policy.

  7. Optionally, click Edit item retention policy and specify what happens to collaboration items when the workspace is deleted.

    • For Items sent from my organization, select one of the following options:

      • Remove from participants—Items sent from your organization are removed from all collaboration participants.

      • Let participants decide—Collaboration participants decide whether to keep the items sent from your organization.

    • For Items received by my organization, select one of the following options:

      • Remove from my organization—Items received by your organization are removed.

      • Keep if permitted by contributing participants—You can keep the items received by your organization until the sending participants revoke permission to retain them.

  8. Click Delete workspace.

Add Viewer credentials to a workspace

You can allow collaboration participants to access services shared as references without signing in to your organization by adding the credentials of a built-in account with Viewer privileges to a workspace. All services your organization shares as references will be updated to use the credentials of this Viewer account at the next scheduled workspace synchronization.

Note:

Viewer credentials will not be added to ArcGIS Server services added as items with stored credentials.

To add Viewer credentials to a workspace, complete the following steps:

Note:

This functionality is only available for ArcGIS Enterprise-to-ArcGIS Enterprise collaborations. Recipients must add the source ArcGIS Server hostname to their organization's list of allowed proxy hosts to access the service.

  1. Sign in to your organization as a member of the default administrator role or a custom role with administrative privileges to manage the organization's collaborations.

  2. At the top of the site, click Organization and click the Settings tab.

  3. Click Collaborations on the side of the page.

  4. Under the Distributed section, find and select the collaboration that contains the workspace to which you want to add Viewer credentials. Optionally, do any of the following to help you find the collaboration:

    • Type search terms in the search box.

    • Click Status and select a sort type and direction.

    The collaboration window appears.

  5. In the Workspaces section, find the workspace to which you want to add Viewer credentials. Optionally, do any of the following to help you find the workspace:

    • Type search terms in the search box.

    • Click Status and select a sort type and direction.

  6. Click More options More options and click Edit workspace Edit workspace.

    The Edit workspace window appears.

  7. Turn on the Allow participants to view services without signing into this organization toggle button.

  8. In the Viewer account search box, find and select a built-in account with Viewer privileges and provide its password in the Viewer password field.

  9. Click Save.

View synchronization history and details

Synchronization history shows you a list of past synchronization events within a workspace, while synchronization details help you understand each synchronization event and troubleshoot failures. You can view synchronization history and details by completing the following steps:

Note:

Scheduled times are displayed in the client's local time zone and are automatically converted to Coordinated Universal Time (UTC) for the specified environment. For more information, see Synchronizing workspaces using a scheduled interval.

To view the synchronization history for a workspace, complete the following steps:

  1. Sign in to your organization as a member of the default administrator role or a custom role with administrative privileges to manage the organization's collaborations.

  2. At the top of the site, click Organization and click the Settings tab.

  3. Click Collaborations on the side of the page.

  4. Under the Distributed section, find and select the collaboration that contains the workspace whose synchronization history you want to view. Optionally, do any of the following to help you find the collaboration:

    • Type search terms in the search box.

    • Click Status and select a sort type and direction.

    The collaboration window appears.

  5. In the Workspaces section, find the workspace whose synchronization history you want to view. Optionally, do any of the following to help you find the workspace:

    • Type search terms in the search box.

    • Click Status and select a sort type and direction.

    Note:

    Synchronization failures are listed in the Last sync status column for each workspace. Click the failure message to access the Sync details window for the failed events.

  6. Click More options More options and click View sync history View sync history.

    The Sync history window appears, where a table displays past synchronization events for the workspace, including the following information for each event:

    • Sync ID—The synchronization ID.

    • Sync type—The synchronization type, either scheduled or immediate.

    • Participants—The organizations involved in the synchronization.

    • Status—The status of the synchronization, which can be any of the following:

      • Succeeded—All items were successfully synchronized.

      • Succeeded with failures—The synchronization is complete, but some items failed to be shared.

      • Failed—No items were synchronized.

    • Start time—The time synchronization began.

    • End time—The time synchronization ended.

    • Items synced—The number of items successfully synchronized.

      Note:

      To view the number of successfully synchronized items, the guest organization must be using ArcGIS Enterprise version 12.2 or later.

    Optionally, do any of the following:

    • Click Refresh list Refresh list to update the list of synchronizations.

    • Use the Sync ID search box to search for a synchronization by its ID.

    • Use filters on the side of the window to filter the list of synchronizations. You can filter by synchronization type, participant, status, and start time.

    • Click Filters Filters to show or hide the Sync ID search box and the filters.

  7. Optionally, click a sync ID to view additional details about a synchronization event.

    The Sync details window appears and displays the synchronization information described in the previous step, along with the date and time of the last successful scheduled synchronization, a synchronization summary, and a diagram to help troubleshoot failures. The diagram shows the following tasks.

    • Reachability—Indicates whether the organization initiating the synchronization can access the other organization.

      Note:

      The arrow points from the organization initiating the synchronization to the other organization.

    • Export—Indicates how the host or guest sent the content.

      • Check mark—Content was successfully sent.

      • Empty—No content was sent.

      • Exclamation mark—Some content was successfully sent.

      • x—Content was not successfully sent.

    • Import - Indicates how the host or guest received the content.

      • Check mark—Content was successfully received.

      • Empty—No content was received.

      • Exclamation mark—Some content was successfully received.

      • x—Content was not successfully received.

  8. Optionally, do any of the following:

    • Click the Successfully synced tab to view a list of successfully synchronized items. Click Open to access the item in a new tab.

      Note:

      To view the list of successfully synchronized items, the guest organization must be using ArcGIS Enterprise version 12.2 or later.

    • Click the Guest failures tab to view a list of items that failed to synchronize due to errors in the guest organization. Click Open to access the item in a new tab if the item exists in your organization.

    • Click the Host failures tab to view a list of items that failed to synchronize due to errors in your organization. Click Open to access the item in a new tab if the item exists in your organization.