Haruno Knowledge base

Cloud files

Connect Google Drive, OneDrive, SharePoint or Dropbox, choose which folders Haruno may use, and link Drive files to a project. Haruno never deletes anything in your cloud storage.

  • Mac appAvailableOnly Google Drive files can be linked to a project as a source.
  • Windows appAvailableDescribed on the Cloud storage page. Only Google Drive files can be linked to a project.

Cloud files let Haruno work with files that live in your cloud storage. You connect an account, you choose the folders Haruno may use, and Haruno keeps a copy of those folders on your Mac in step with the cloud.

The accounts you can connect

AccountWhere it is in Connectors
Google DriveUnder Google, next to Gmail and Google Calendar
OneDrive, SharePoint, DropboxUnder Cloud storage

Open Connectors with Connectors… in the sidebar's account menu. See Connectors window.

  1. Click Connect

    Find the account in Connectors and click Connect. The Add cloud connection window opens. Under Before you connect, it says what the account will ask for.

  2. Sign in

    Click the button that starts with Continue to. Your browser opens the service's own sign-in. OneDrive has an optional Tenant field. SharePoint has optional Site ID and Drive ID fields.

  3. Save

    When the window says Connected, check the Name and click Save.

  4. Choose folders

    The Folders Haruno can use window opens by itself. Tick the folders Haruno may use. Each tick shares the folder and everything in it. Share everything shares the whole account. Click Save.

A connected account shows its name and what it shares. The line under it says Sharing and the folder's name, Sharing everything in this account, or No folders shared yet. While nothing is shared, the row has a Choose folders… button.

Who sees what

Only the folders you choose can be read, copied or changed by Haruno. Everything else in the account stays out of reach.

Google Drive and Haruno's own folder

With Haruno's own Google connection, Haruno uses a folder it creates in your Drive, called Haruno. It cannot see your other files. If your organization set up its own Google connection, Google may ask which access to give. Keep the full Drive choice selected to use your whole Drive. If you leave it off, Haruno uses only its own folder.

OneDrive, SharePoint and Dropbox ask for access to the whole account. That is the only level they offer an app that keeps a folder in step. Haruno still uses only the folders you choose.

The row's menu

The ⋯ button on a connected account has these items:

  • Shared folders… changes the folders.
  • Re-check tests that the sign-in still works.
  • Edit… changes the connection's name or signs in again.
  • Add another account… adds a second account of the same service.
  • Sign out… disconnects it.

Sign out… asks first. Sign out and delete downloads also removes the copy kept on your Mac. Sign out, keep downloads keeps it. Your files in the cloud are not changed either way.

If you stop sharing a folder that Haruno already copied, Haruno asks the same question: Stop sharing and delete downloads or Stop sharing, keep downloads.

A project can link Google Drive files and folders as sources.

  1. Open the project's Sources tab

    Click the plus button and choose Google Drive….

  2. Pick the account and the item

    Choose the account, open folders, and click Link source beside a file or folder. Link this folder links the folder you are in. The list shows only the folders you chose to share. With Haruno's own Google connection, those folders sit inside the Haruno folder.

Linked Drive sources are always read-only. Only Google Drive can be linked to a project this way. See Project sources.

What a chat can do

Once an account is connected, a chat can list and search the folders you shared, read a file from them, and open a folder as a working copy on your Mac. Opening a working copy, syncing it and uploading a file are the steps that ask for permission first. Files larger than about 100 MB are listed but not copied.

A copy and the cloud are kept in step. Haruno follows these rules:

  • Haruno never deletes anything in your cloud storage. A file you delete from the copy on your Mac stays in the cloud.
  • A file deleted in the cloud moves to your Trash on the Mac. If you changed it on your Mac meanwhile, Haruno keeps your version and uploads it again.
  • If a file changed in both places, both survive. The cloud's version is saved beside yours with "(conflicted copy)" in its name.
  • If two items in one folder share a name, Haruno leaves both alone. Rename one of them in your cloud storage.
  • A Google Docs file is kept on your Mac as a read-only copy. Edits to it stay on your Mac. Edit the original in Google.
  • If most of the files in a folder suddenly disappear from the Mac or from the cloud, syncing pauses and says so. Nothing is changed.

A scheduled task never uploads by itself. Its cloud changes wait in the Waiting queue until you approve them. See Waiting queue.

Who has it

Everyone, in the normal view and the advanced view.

What to tell a customer

Connect the cloud account, then choose the folders Haruno may use. Haruno reads and copies only those. It never deletes anything in the cloud. To use a Drive file in a project, link it from the project's Sources tab.

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)
    PR #2944Commit a2a7836The page at this version
    What changed
    @@ -0,0 +1,98 @@
+---
+title: Cloud files
+summary: Connect Google Drive, OneDrive, SharePoint or Dropbox, choose which folders Haruno may use, and link Drive files to a project. Haruno never deletes anything in your cloud storage.
+feature: cloud-files
+covers:
+  - apple/Sources/CloudFeature/**
+  - apple/Sources/CloudSync/**
+---
+
+Cloud files let Haruno work with files that live in your cloud storage. You connect an account, you choose the folders Haruno may use, and Haruno keeps a copy of those folders on your Mac in step with the cloud.
+
+## The accounts you can connect
+
+| Account | Where it is in Connectors |
+|---|---|
+| Google Drive | Under **Google**, next to Gmail and Google Calendar |
+| OneDrive, SharePoint, Dropbox | Under **Cloud storage** |
+
+Open Connectors with **Connectors…** in the sidebar's account menu. See [Connectors window](/macos/connectors/connectors-window/).
+
+<Steps>
+<Step title="Click Connect">
+Find the account in Connectors and click **Connect**. The **Add cloud connection** window opens. Under **Before you connect**, it says what the account will ask for.
+</Step>
+<Step title="Sign in">
+Click the button that starts with **Continue to**. Your browser opens the service's own sign-in. OneDrive has an optional **Tenant** field. SharePoint has optional **Site ID** and **Drive ID** fields.
+</Step>
+<Step title="Save">
+When the window says **Connected**, check the **Name** and click **Save**.
+</Step>
+<Step title="Choose folders">
+The **Folders Haruno can use** window opens by itself. Tick the folders Haruno may use. Each tick shares the folder and everything in it. **Share everything** shares the whole account. Click **Save**.
+</Step>
+</Steps>
+
+A connected account shows its name and what it shares. The line under it says **Sharing** and the folder's name, **Sharing everything in this account**, or **No folders shared yet**. While nothing is shared, the row has a **Choose folders…** button.
+
+## Who sees what
+
+Only the folders you choose can be read, copied or changed by Haruno. Everything else in the account stays out of reach.
+
+<Callout variant="info" title="Google Drive and Haruno's own folder">
+With Haruno's own Google connection, Haruno uses a folder it creates in your Drive, called **Haruno**. It cannot see your other files. If your organization set up its own Google connection, Google may ask which access to give. Keep the full Drive choice selected to use your whole Drive. If you leave it off, Haruno uses only its own folder.
+</Callout>
+
+OneDrive, SharePoint and Dropbox ask for access to the whole account. That is the only level they offer an app that keeps a folder in step. Haruno still uses only the folders you choose.
+
+## The row's menu
+
+The **⋯** button on a connected account has these items:
+
+- **Shared folders…** changes the folders.
+- **Re-check** tests that the sign-in still works.
+- **Edit…** changes the connection's name or signs in again.
+- **Add another account…** adds a second account of the same service.
+- **Sign out…** disconnects it.
+
+**Sign out…** asks first. **Sign out and delete downloads** also removes the copy kept on your Mac. **Sign out, keep downloads** keeps it. Your files in the cloud are not changed either way.
+
+If you stop sharing a folder that Haruno already copied, Haruno asks the same question: **Stop sharing and delete downloads** or **Stop sharing, keep downloads**.
+
+## Link a Drive file to a project
+
+A project can link Google Drive files and folders as sources.
+
+<Steps>
+<Step title="Open the project's Sources tab">
+Click the plus button and choose **Google Drive…**.
+</Step>
+<Step title="Pick the account and the item">
+Choose the account, open folders, and click **Link source** beside a file or folder. **Link this folder** links the folder you are in. The list shows only the folders you chose to share. With Haruno's own Google connection, those folders sit inside the **Haruno** folder.
+</Step>
+</Steps>
+
+Linked Drive sources are always read-only. Only Google Drive can be linked to a project this way. See [Project sources](/macos/chat/project-sources/).
+
+## What a chat can do
+
+Once an account is connected, a chat can list and search the folders you shared, read a file from them, and open a folder as a working copy on your Mac. Opening a working copy, syncing it and uploading a file are the steps that ask for permission first. Files larger than about 100 MB are listed but not copied.
+
+A copy and the cloud are kept in step. Haruno follows these rules:
+
+- **Haruno never deletes anything in your cloud storage.** A file you delete from the copy on your Mac stays in the cloud.
+- A file deleted in the cloud moves to your Trash on the Mac. If you changed it on your Mac meanwhile, Haruno keeps your version and uploads it again.
+- If a file changed in both places, both survive. The cloud's version is saved beside yours with "(conflicted copy)" in its name.
+- If two items in one folder share a name, Haruno leaves both alone. Rename one of them in your cloud storage.
+- A Google Docs file is kept on your Mac as a read-only copy. Edits to it stay on your Mac. Edit the original in Google.
+- If most of the files in a folder suddenly disappear from the Mac or from the cloud, syncing pauses and says so. Nothing is changed.
+
+A scheduled task never uploads by itself. Its cloud changes wait in the Waiting queue until you approve them. See [Waiting queue](/macos/automation/waiting-queue/).
+
+## Who has it
+
+Everyone, in the normal view and the advanced view.
+
+## What to tell a customer
+
+Connect the cloud account, then choose the folders Haruno may use. Haruno reads and copies only those. It never deletes anything in the cloud. To use a Drive file in a project, link it from the project's Sources tab.