Haruno Knowledge base

Cloud storage

Connect Google Drive, Dropbox, OneDrive or SharePoint so Haruno can read a file, work in a folder kept in step with your account, or upload a file.

  • Mac appAvailable
  • Windows appAvailable

Cloud storage connectors let Haruno reach the files you keep online. There are four: Google Drive, Dropbox, OneDrive and SharePoint. Each has its own card in Settings ▸ Connectors. The Storage & files button shows them together.

The four cloud storage cards, with Office files beside them.
The Connectors tab filtered to Storage and files. It lists Office files, Google Drive, Dropbox, OneDrive and SharePoint with their states.The Connectors tab filtered to Storage and files. It lists Office files, Google Drive, Dropbox, OneDrive and SharePoint with their states.

Each card can hold several accounts. Each account keeps its own name, sign-in and folders. Signing in works like any connector. See Signing in to a connector.

Three ways Haruno uses your files

WayWhat happens
Read one fileHaruno downloads a copy of that one file and reads it. It does not copy the rest of the account.
Work in a folderHaruno copies a whole folder to this PC and keeps it in step with the account. It can then edit the files with its ordinary file tools. A big folder takes a while to copy.
Upload one fileHaruno puts a file from your PC into the account. It creates the file, or replaces one with the same name.

Choose which folders Haruno may use

Every account has a setting called Folders Haruno can use. It has three answers.

  • Only the folders I list below shows a Shared folders box. Type one folder path per line, such as Work/Reports. Everything inside a listed folder is included.
  • Nothing for now lets Haruno reach no folder.
  • Everything in this connection lets Haruno reach the whole account.

You must choose before the first Connect. If you do not know the folder names yet, pick Nothing for now. Once the account is connected, List subfolders shows what it holds.

A path outside your choice is refused.

This limits Haruno, not the account

The choice limits what Haruno does. It cannot change what you allowed at sign-in. Google Drive can be given two kinds of access.

What sync does

While a folder is open, Haruno checks the account about every 30 seconds. A change made on this PC goes up a moment after it is made. The status bar shows Syncing… with a file count while files move, Cloud folder incomplete with a reason when some files could not be fetched, and Sync error when a pass fails.

Deleting works both ways

If you remove a file from the folder on this PC, the next sync removes it from the account too. A file removed in the account is removed from this PC. Nothing asks first. One exception: a file you changed here after it was removed in the account is kept and sent back up.

If a file changed in both places, the account's version is saved next to yours as a file marked "(conflicted copy)". Your own version stays in place.

What needs your approval

Haruno asks before it uploads a file, and before it shares a file on Google Drive. The card shows the file's path, so you see which file on your PC is about to leave it. Reading a file, listing folders and syncing an open folder do not ask.

The approval card offers Allow once and Deny, and often Allow for this session. In the advanced view you can set any of these tools to On, Confirm or Off under Tools. In a scheduled task, a tool set to Confirm is refused, because nobody is there to answer.

Removing a connection

Remove connection removes one account and its saved sign-in. Your other accounts stay connected. Files it downloaded to this PC are deleted too. Disconnect does the same for every account of that connector.

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,59 @@
    +---
    +title: Cloud storage
    +summary: Connect Google Drive, Dropbox, OneDrive or SharePoint so Haruno can read a file, work in a folder kept in step with your account, or upload a file.
    +feature: cloud-storage
    +covers:
    +  - windows-client/docs/cloud-storage.md
    +  - Integrations/cloud/**
    +  - IntegrationPlatform/CloudRuntime/**
    +---
    +
    +Cloud storage connectors let Haruno reach the files you keep online. There are four: [Google Drive](/windows/connectors/google-drive/), [Dropbox](/windows/connectors/dropbox/), [OneDrive](/windows/connectors/onedrive/) and [SharePoint](/windows/connectors/sharepoint/). Each has its own card in <Ui>Settings ▸ Connectors</Ui>. The <Ui>Storage & files</Ui> button shows them together.
    +
    +<Shot src="/m/cffa79fc9d3a-windows-connectors-storage-light.png" dark="/m/e82ac60b456e-windows-connectors-storage-dark.png" alt="The Connectors tab filtered to Storage and files. It lists Office files, Google Drive, Dropbox, OneDrive and SharePoint with their states." caption="The four cloud storage cards, with Office files beside them." />
    +
    +Each card can hold several accounts. Each account keeps its own name, sign-in and folders. Signing in works like any connector. See [Signing in to a connector](/windows/connectors/signing-in/).
    +
    +## Three ways Haruno uses your files
    +
    +| Way | What happens |
    +|---|---|
    +| Read one file | Haruno downloads a copy of that one file and reads it. It does not copy the rest of the account. |
    +| Work in a folder | Haruno copies a whole folder to this PC and keeps it in step with the account. It can then edit the files with its ordinary file tools. A big folder takes a while to copy. |
    +| Upload one file | Haruno puts a file from your PC into the account. It creates the file, or replaces one with the same name. |
    +
    +## Choose which folders Haruno may use
    +
    +Every account has a setting called <Ui>Folders Haruno can use</Ui>. It has three answers.
    +
    +- <Ui>Only the folders I list below</Ui> shows a <Ui>Shared folders</Ui> box. Type one folder path per line, such as `Work/Reports`. Everything inside a listed folder is included.
    +- <Ui>Nothing for now</Ui> lets Haruno reach no folder.
    +- <Ui>Everything in this connection</Ui> lets Haruno reach the whole account.
    +
    +You must choose before the first Connect. If you do not know the folder names yet, pick Nothing for now. Once the account is connected, <Ui>List subfolders</Ui> shows what it holds.
    +
    +A path outside your choice is refused.
    +
    +<Callout variant="info" title="This limits Haruno, not the account">
    +The choice limits what Haruno does. It cannot change what you allowed at sign-in. [Google Drive](/windows/connectors/google-drive/) can be given two kinds of access.
    +</Callout>
    +
    +## What sync does
    +
    +While a folder is open, Haruno checks the account about every 30 seconds. A change made on this PC goes up a moment after it is made. The status bar shows <Ui>Syncing…</Ui> with a file count while files move, <Ui>Cloud folder incomplete</Ui> with a reason when some files could not be fetched, and <Ui>Sync error</Ui> when a pass fails.
    +
    +<Callout variant="warning" title="Deleting works both ways">
    +If you remove a file from the folder on this PC, the next sync removes it from the account too. A file removed in the account is removed from this PC. Nothing asks first. One exception: a file you changed here after it was removed in the account is kept and sent back up.
    +</Callout>
    +
    +If a file changed in both places, the account's version is saved next to yours as a file marked "(conflicted copy)". Your own version stays in place.
    +
    +## What needs your approval
    +
    +Haruno asks before it uploads a file, and before it shares a file on Google Drive. The card shows the file's path, so you see which file on your PC is about to leave it. Reading a file, listing folders and syncing an open folder do not ask.
    +
    +The approval card offers <Ui>Allow once</Ui> and <Ui>Deny</Ui>, and often <Ui>Allow for this session</Ui>. In the advanced view you can set any of these tools to **On**, **Confirm** or **Off** under <Ui>Tools</Ui>. In a scheduled task, a tool set to Confirm is refused, because nobody is there to answer.
    +
    +## Removing a connection
    +
    +<Ui>Remove connection</Ui> removes one account and its saved sign-in. Your other accounts stay connected. Files it downloaded to this PC are deleted too. <Ui>Disconnect</Ui> does the same for every account of that connector.