Haruno Knowledge base

Integrations

See which version of each connector the Windows app is offered, and hold a connector on an older version.

  • Operator consoleAvailable

In the Windows app each connector, such as Gmail or Slack, is installed and updated on its own. Integrations shows which version of each one this environment offers. A super admin can hold a connector on an older version.

The Integrations page: a table of made-up connectors with the version being served and a version menu, one of them marked Pinned

This page is for the Windows app only. The page calls a connector a module.

What you see

One row for each connector:

  • Module is the connector's name. A Pinned badge means it is held on a chosen version.
  • Serving now is the version the Windows app is offered.
  • Version is a menu. Latest (x) follows every new release. Any other entry holds the connector on that version.

Under the table the page says who changed the versions last and when.

Hold a connector on an older version

  1. In the connector's Version menu, choose the version.
  2. Press Save changes. Discard drops your choices.
  3. To let it follow new releases again, choose Latest and save.

You can change several connectors and save once.

Windows apps move within minutes

Choosing an older version makes Windows apps install it within minutes. An older version may not be able to read data a newer one wrote. Hold a connector back only when you have to.

If someone else saved first, the page reloads their choices and asks you to make yours again.

Suspend a connector

A super admin can suspend a connector for every customer on this environment, for example when it misbehaves and must stop at once. The console has no button for it, and this page does not show it. A suspended connector keeps its row, its version and Serving now, so the page can look normal.

In the Windows app the connector's card says "Haruno has paused this integration for now. Your settings are kept." It cannot be switched on, and it cannot be used in chats. What was installed and the person's settings stay on the computer. When the suspension is lifted the connector comes back without a new install.

  • The reason a super admin gives is recorded. The customer is never told it.
  • A suspension covers every organization on the environment. It cannot be set for one organization.
  • A version held with Pinned stays held. It applies again when the connector is back.

See Connectors in the Windows app for what customers see.

Notes the page can show

  • This server can't load the version list right now. Until it is back you can only choose Latest, or pin a connector to its latest version. When this server holds the catalog back, apps keep what they already have installed.
  • No version list is set up for this server. The same limit applies. A pinned connector is served its latest version.
  • This module is no longer in the catalog. A pin on it has no effect. Choose Latest and save to clear it.
  • Pinned version X is unavailable on this server. It serves the latest version instead.

Who can use it

Every operator can read the page. Changing versions is for super admins. A viewer sees "Only super administrators can change integration versions."

What a person in support or sales can ask an operator

  • "Which Gmail connector version do Windows customers have?" Read Serving now.
  • "A connector broke after an update. Can we go back?" An operator pins the older version. Customers' apps take it within minutes.
  • "Is the connector held back on purpose?" Look for the Pinned badge.
  • "A connector disappeared for our customers, and this page looks normal." Ask a super admin whether it was suspended. The page does not show that.

Last updated · PR #2944 · View this version on GitHub

History (1 version)
  1. Internal knowledge base for staff: site, reader keys, assistant, 197 pages and the PR rule (#2944)
    What changed
    @@ -0,0 +1,69 @@
    +---
    +title: Integrations
    +summary: See which version of each connector the Windows app is offered, and hold a connector on an older version.
    +feature: ops-integrations
    +covers:
    +  - web/monitoring/components/IntegrationVersionsPage.tsx
    +  - server-dotnet/src/Haruno.Server/Controllers/AdminIntegrationVersionsController.cs
    +  - docs/integration-catalog-operations.md
    +---
    +
    +In the Windows app each connector, such as Gmail or Slack, is installed and updated on its own. **Integrations** shows which version of each one this environment offers. A super admin can hold a connector on an older version.
    +
    +<Shot src="/m/fe3224b52864-ops-integrations-dark.png" alt="The Integrations page: a table of made-up connectors with the version being served and a version menu, one of them marked Pinned" />
    +
    +This page is for the Windows app only. The page calls a connector a module.
    +
    +## What you see
    +
    +One row for each connector:
    +
    +- **Module** is the connector's name. A **Pinned** badge means it is held on a chosen version.
    +- **Serving now** is the version the Windows app is offered.
    +- **Version** is a menu. **Latest (x)** follows every new release. Any other entry holds the connector on that version.
    +
    +Under the table the page says who changed the versions last and when.
    +
    +## Hold a connector on an older version
    +
    +1. In the connector's **Version** menu, choose the version.
    +2. Press **Save changes**. **Discard** drops your choices.
    +3. To let it follow new releases again, choose **Latest** and save.
    +
    +You can change several connectors and save once.
    +
    +<Callout variant="warning" title="Windows apps move within minutes">
    +Choosing an older version makes Windows apps install it within minutes. An older version may not be able to read data a newer one wrote. Hold a connector back only when you have to.
    +</Callout>
    +
    +If someone else saved first, the page reloads their choices and asks you to make yours again.
    +
    +## Suspend a connector
    +
    +A super admin can suspend a connector for every customer on this environment, for example when it misbehaves and must stop at once. The console has no button for it, and this page does not show it. A suspended connector keeps its row, its version and **Serving now**, so the page can look normal.
    +
    +In the Windows app the connector's card says "Haruno has paused this integration for now. Your settings are kept." It cannot be switched on, and it cannot be used in chats. What was installed and the person's settings stay on the computer. When the suspension is lifted the connector comes back without a new install.
    +
    +- The reason a super admin gives is recorded. The customer is never told it.
    +- A suspension covers every organization on the environment. It cannot be set for one organization.
    +- A version held with **Pinned** stays held. It applies again when the connector is back.
    +
    +See [Connectors in the Windows app](/windows/connectors/overview/) for what customers see.
    +
    +## Notes the page can show
    +
    +- **This server can't load the version list right now.** Until it is back you can only choose **Latest**, or pin a connector to its latest version. When this server holds the catalog back, apps keep what they already have installed.
    +- **No version list is set up for this server.** The same limit applies. A pinned connector is served its latest version.
    +- **This module is no longer in the catalog.** A pin on it has no effect. Choose **Latest** and save to clear it.
    +- **Pinned version X is unavailable on this server.** It serves the latest version instead.
    +
    +## Who can use it
    +
    +Every operator can read the page. Changing versions is for super admins. A viewer sees "Only super administrators can change integration versions."
    +
    +## What a person in support or sales can ask an operator
    +
    +- "Which Gmail connector version do Windows customers have?" Read **Serving now**.
    +- "A connector broke after an update. Can we go back?" An operator pins the older version. Customers' apps take it within minutes.
    +- "Is the connector held back on purpose?" Look for the **Pinned** badge.
    +- "A connector disappeared for our customers, and this page looks normal." Ask a super admin whether it was suspended. The page does not show that.