Join a collaboration
Guest participants can share content with the collaboration, receive content from it, or do both, depending on the access mode assigned to them by the collaboration host. When creating the collaboration invitation, the collaboration host specifies how the guest can participate.
Note:
ArcGIS Enterprise on Kubernetes can participate as either the host or guest in collaborations with ArcGIS Enterprise on Windows and Linux. For more information, see Key concepts for collaboration.
Accept an invitation to collaborate
To accept an invitation to collaborate, complete the following steps:
Note:
To participate in an ArcGIS Online-to-ArcGIS Enterprise collaboration, the ArcGIS Enterprise organization must support outbound communication over port 443.
For ArcGIS Enterprise-to-ArcGIS Enterprise collaborations, guest organizations must be able to communicate with the host organization over port 443. This will allow scheduled and immediate syncs initiated by the guest. To support immediate syncs initiated by the host, the host must also be able to communicate with the guest over port 443.
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.
At the top of the site, click Organization and click the Settings tab.
Click Collaborations on the side of the page.
Under the Distributed section, click Accept invitation.
The Accept invitation window appears.
Click Choose file, select the invitation file you received from the host organization, and click Open.
Note:
If your organization does not trust the host organization’s SSL certificate, an error message appears. The certificate must be trusted before you can accept the invitation. See Configure the portal to trust certificates from your certifying authority for information on configuring certificate trust.
In the Item retention policy section, specify what happens to collaboration items when the collaboration or any of its workspaces 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.
In the Webtier authentication section, select Yes if the host organization requires web-tier authentication and choose one of the following authentication types:
Credentials—Provide the credentials for the host organization’s web-tier authentication.
Certificate—Upload the host organization’s PKI certificate and provide its password.
Note:
This setting is only available when the collaboration host is an ArcGIS Enterprise organization.
Click Prepare invitation response.
Click Download response file.
Share the invitation response file with an administrator of the host organization.
The collaboration card appears under the Distributed section and displays the Acceptance pending label. You cannot view the collaboration's workspaces or manage any of its settings until an administrator of the host organization imports your invitation response.
Link a group to the collaboration workspace
Once your organization has joined a collaboration, you can link groups to its collaboration workspaces.
Note:
A group can only be associated with one collaboration workspace.
To link a group to a collaboration workspace, complete the following steps:
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.
At the top of the site, click Organization and click the Settings tab.
Click Collaborations on the side of the page.
Under the Distributed section, find and select the collaboration that contains the workspace you want to link the group to. 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.
In the Workspaces section, find the workspace you want to link the group to. 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.
Click Join workspace.
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. Therefore, when naming a new group, you can avoid including the collaboration settings in the name.
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.
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.
Optionally, turn on the Allow participants to view services without signing into this portal 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.
In the Scheduled sync settings section, configure the collaboration workspace’s synchronization settings:
Click the Sync start time drop-down menu and specify the time when collaboration items will be synchronized to other collaboration participants.
Click the Repeat every drop-down menu and select how often the synchronization will occur.
Optionally, turn on the Enable immediate sync toggle button to immediately sync collaboration items to other collaboration participants. Data edits (for example, adding, deleting, or updating features in a layer) will be synchronized on schedule.
Click Join workspace.
When you link a group to a collaboration workspace, its content is synchronized according to the workspace’s access mode.
By default, when a group is linked to a collaboration workspace, the synchronization settings are applied immediately. You can change this behavior by editing the workspace.
The collaboration host’s administrator receives a notification when the guest organization becomes active in the collaboration workspace.
After completing this workflow, you can further configure the sync settings and other collaboration details. When content is shared with a participant, a folder is created within the participant administrator’s folder. This folder is used to import and store the shared items, which are then shared with the group associated with the collaboration workspace. The folder is named after the collaboration.
Note that when the collaboration host is an ArcGIS Enterprise organization, the host's workspace is configured to synchronize content immediately by default. This setting can only be changed through the ArcGIS Portal Directory sharing location.
When ArcGIS Online is the collaboration host, synchronization defaults to At scheduled intervals. In this configuration, the ArcGIS Enterprise participant controls the schedule for synchronizing group items and feature layer edits. The ArcGIS Online host does not control the synchronization schedule.