仅适用于

Available to Enterprise administrators only; grant or remove access to Cloud storage integrations and integration users, and set up Collaboration integrations, such as Slack.

您可以在此页面设置公司/企业范围的集成。有关设置用户帐户集成的信息，请参见我的帐户 - 集成。

若要在 Onshape 中导航到您的“集成”设置，请单击您位于 Onshape 窗口的右上角的帐户用户图标 (帐户用户图标)。这将打开一个下拉菜单。单击“公司/教室/企业设置”。

在页面左侧的列表中单击“集成”：

企业设置：集成

选择相应的单选按钮：

  • Allow all integrations - Allows storage integrations with Dropbox, Google Drive, and Microsoft OneDrive.
  • 允许使用选定的集成 - 从可用服务列表中选择您想要的集成。
  • 不允许使用集成 - 不要与任何可用服务集成。

选择相应的单选按钮：

  • 所有用户 - 允许所有用户与上述指定的服务集成。
  • 选定的用户和团队 - 仅允许指定的用户和/或团队与上述指定的服务集成。

Slack integration

Integration between Onshape and Slack allows users to share Comments, Tasks, and Releases between the two apps, as well as view the top 20 most recent documents and top 10 most recent task lists directly from Slack.

  1. Navigate to the Enterprise settings > Integrations page and click the Add to Slack button:

    Collaboration integrations - Slack

  2. Enter the Onshape API access key and Onshape API secret key. Then click the Connect button under the Slack connection tile at the top:

    Entering API keys to connect to Slack

  3. Next, install the Onshape app in Slack. If you have multiple instances of Slack, click the Workspace dropdown and select the Slack Workspace you would like connected to Onshape.

  4. Review the app permissions. When done, click the Install Onshape button.

    Install the Onshape app in Slack

  5. If authorization was successful, the following image is displayed briefly on-screen:

    Slack Authorization successful

  6. The image closes and the Slack connection screen is displayed with a green icon indicating a successful connection. Click the Finish button to complete the connection:

    Successful connection between Onshape and Slack

  7. On the Enterprise settings > Integrations page, the Slack integration shows the date when the connection was created, along with a Remove button should you want to remove the connection.

    Slack connection on Integrations page

User OAuth Connection

When you first connect to Slack, each user must explicitly connect their account to Onshape:

  1. In the Slack Onshape Workspace, enter  /onshape connect:

    Connecting to Onshape

  2. The User OAuth Connection screen opens. Click the Connect button:

    User OAuth Connection

  3. The Authorize application screen opens. Click the Authorize application button:

    Authorize application screen

  4. The User OAuth Connection screen opens. Click the Finish button:

    User OAuth Connection screen

  5. You are now connected to Onshape in the Slack Workspace. To disconnect, enter /onshape disconnect.

Slack user commands

Once connected, you can use the following commands in Slack:

Slack help command

  • /onshape list - Lists your 20 most recent Onshape documents.

    Documents list

  • /onshape tasks - Lists your 10 most recent Onshape tasks (Action items).

    Task (Action items) list

  • /onshape help - Shows this help information.

  • /onshape connect - Connect your Onshape account to Slack.

  • /onshape disconnect - Disconnect your Onshape account from Slack.

Slack notifications

Notifications are provided in Slack when the following is updated by a user in Onshape:

  • Comments - If a user is mentioned or assigned to a comment, this user receives a notification in Slack:

    Comment mention notification in Slack

    The user also receives a notification after their comment is replied to by another user:

    After a comment reply in Slack

  • Releases - When an Observer or Approver is added to a Release, and when the release status is updated, those users receive a release notification in slack:

    New Release notification in slack

After the Administrator sets up Slack integration, users are notified on Slack if they are mentioned or assigned to a comment, or added to a Release as an Observer or Approver, even if that user has not yet set up their OAuth connection (or even after they have disconnected from the OAuth connection).

To reply to these comments directly from Slack, users must connect their Onshape account to Slack using the /onshape connect command.