Dropbox Plug-in

Contents

Overview

This plug-in is a sample Kintone integration with "Dropbox", a file hosting service operated by Dropbox, Inc.
https://www.dropbox.com/ (External link)

Integration Screenshots

Record details page

Click the + button on the Record list page, enter your data, and click Save to save your contents (you will not yet be able to add files from your Dropbox account when on the Edit page).
After saving, you will be directed to the Record details page.
You will be able to add files from your Dropbox account on this page.

Record details page (choosing files)

Setting up the Dropbox Plug-in

Step 1: Set up Your Form

2 fields are needed to configure the Dropbox Plug-in.

  • A "Text" field or "Text Area" field
    The shared link for Dropbox files will be set into this field, and the field itself will be hidden from users. Dropbox files will be displayed on this field on the record list page (as the Blank space field cannot be displayed on the record list page).

  • A Blank space field
    This space will be used to display the Dropbox files on the record details page.
    An Element ID will need to be set through the field's settings for this field.

Once these fields are set, you can go ahead to place other fields of your choice onto the canvas. They will not affect the behavior of the plug-in.

Step 2: Add the Plug-in to Your App

Install the Dropbox Plug-in into your Kintone environment, and add it to your app.

  1. Download the Dropbox Plug-in file introduced later on this page
  2. Install the plug-in file into your Kintone environment. Refer to the following article on the Kintone Help site for steps to install the plug-in file:
    Adding plug-ins by importing plug-in files (External link)
  3. Add the Dropbox Plug-in to your app. Refer to the following article on the Kintone Help site for steps to add the plug-in:
    Adding plug-ins to an app (External link)

Step 3: Configure the App Plug-in Settings

Set up the configurations for the plug-in added to your app in STEP 2.

  1. On the apps settings page, click on "App Settings" -> "Plug-ins", and click on the cog wheel for the Dropbox for Kintone Plug-in.

  2. Set up each item in the settings:

    • Dropbox Shared Link Field
      The shared link for the Dropbox files will be set and saved in this field.
      The saved Dropbox files will be displayed in this field on the record list page.
    • Dropbox Files Display Field
      The saved Dropbox files will be displayed in this Space in the record details page.
      The user will be able to click the displayed files to download them.
    • Thumbnail
      Check this to display image files on the records as thumbnails.

  3. Click save.

  4. Click on "Settings" on the breadcrumbs, and on "Apply Changes" to apply the Plug-in settings.

STEP 4: Test Out the Dropbox Plug-in

  1. Add a new record.
  2. Click on the "Edit" button that appears on the record details page.
  3. Click on the "Choose from Dropbox" button. If you are not yet logged into Dropbox, you will be prompted to fill in your Dropbox credentials.
  4. Choose a file from your Dropbox account and click "Choose".
  5. Click on "Save". The shared link to the chosen file(s) will be displayed on the list.

*Deleting files from this record, or deleting the record itself will not result in the original file being deleted from your Dropbox account.

Plug-in Sample

Packaged Sample

SAMPLE_dropbox1_plugin_v1.2.1.zip (External link)

Updates

Date Update Notes
12th January 2024 ver. 1.2.1
  • Fixed homepage_url
12th September 2017 ver. 1.1
  • Fixed a bug where the "x" would not display next to the file name, when a file on Dropbox was selected.
  • Other minor updates were made
23rd July 2015 ver. 1.0

Limitations

  • This plug-in sample will not run on the smartphone.
  • The Dropbox Shared Link Field will not be displayed while adding or editing records.

Notes

  • We do not guarantee this sample to run.
  • We do not provide any technical support for this sample plug-in.
  • This plug-in uses APIs that are not made public on the Kintone Developer Program. Please refrain from developing and selling plug-ins that use these private APIs.
  • Some of the code in this plug-in alters the DOM structure of the app. These altered DOM structures may be affected by future Kintone updates. Be sure to note this if you are to use this plug-in sample as reference.

OSS Licenses

The following licenses are being used in this plug-in: