Skip to content

Docs01 Installing Swate

Kevin F edited this page Oct 19, 2022 · 10 revisions

⚠️ This wiki is deprecated, look here for the new wiki: https://nfdi4plants.github.io/Swate-docs/docs/UserDocs/Docs01-Installing-Swate.html

Installing Swate

  1. Quickstart in Browser
  2. Desktop Installation
  3. Using a shared folder as system admin

Quickstart

If you want to jump right into Swate and start testing the environment and features without much fuzz, we recommend using Swate in the Browser. This method uses the web version of Microsoft Excel which can be used for free with an free Microsoft account.

  1. Download the latest swate-b-quickstart.zip
  2. Unzip (Right clickExtract All..)
  3. Navigate to the web version of Excel and log in. Starting this up for the first time might take a minute.
  4. Click InsertOffice Add-ins/Add-insUpload My Add-in and upload the core_manifest.xml from swate-b-quickstart.zip.
  5. Go to Data and you should see the Swate Core add-in. If not you might need to click on the three dots on the right side to expand your available options.
  6. Done! 🎉

Desktop Installation

If you want to use Swate in your Excel desktop application, you can use the options below.

⚠️ If you have an older Swate version installed already, it might be necessary to clear the cache to apply the changes to Swate.

  • Download the Windows Installer. (MacOS-Installer coming soon™)
  • Close all Office instances (Excel, Powerpoint, Word, ...)
  • Unzip (Right clickExtract All..)
  • Double click the install.cmd. You will be asked to give administrative permissions and in the end to allow changes to the registry. Allow both and you are good to go!
  • Open Excel, go to InsertMy Add-insShared Folder. There you should see both Swate and Swate.Experts.
Alternative | Using the previous Swate installer

Swate installer

Alternative | Using the release archive

⚠️ This method might not be accessible anymore.

Using the release archive

  • Install node.js LTS (needed for office addin related tooling)
  • Download the latest test release archive and extract it
  • Execute the test.cmd (windows, as administrator) or test.sh (macOS, you will need to make it executable via chmod a+x) script.

Using a shared folder as system admin

If you have administrative access in your organization, you can create a network share folder and follow this guide to make the addin available without any further downloads from your users.