PRING HelpUpdate to the latest plugin version
Plugin update, at the top of the Connection tab (接続設定), shows your version and the latest version, and a notice appears at the top of the screen when a newer one exists. Update in three ways: Update now (kintone system administrators only), Download ZIP (the link works once, for 7 days) or Send the link to the registered address. Then reload and check the version number.
Steps
1. Check the versions on the Connection tab
In kintone, open the app settings, Plugins, and press the settings (gear) icon on the PRING row. Press the Connection tab (接続設定). The Plugin update section at the top shows two version numbers, for example "Your version: 8 / Latest version: 9". If a newer one exists you see "A newer version (9) is available. Please update." If they match you see "You have the latest version."
2. Choose how to update
If you are a kintone system administrator, use Update now. If you are not, use Download ZIP to get the file and hand it to an administrator, or use "Send the link to the registered address" to receive the link by email.
3. Press Update now (system administrators)
Press Update now. The confirmation "Update the plugin" says "Updates the PRING plugin to 9. The settings of your apps stay. You need kintone system administrator rights. After the update, reload this page." Press Update. The screen shows "Getting the new version…", "Loading it into kintone…" and "Updating…" in turn, and then "Updated. Please reload this page." Press Reload.
4. With a ZIP: import it into kintone
Press Download ZIP. The screen shows "The download link is ready (works once, valid for 7 days)." Press "Open the link" and the ZIP download starts. A kintone system administrator opens System administration → Plugins → "読み込む" (Import) and selects that ZIP. The link in the email from "Send the link to the registered address" is used the same way.
5. Check that it worked
Reload the settings screen and open the Connection tab. When "Your version" shows the same number as "Latest version" and you see "You have the latest version.", you are done. The update notice at the top of the screen is gone too. Also check that the connected state is still shown.
Reading the versions
The PRING plugin has a version. A version is a whole number such as 8 or 9, and a bigger number is newer. You can see your version and the latest version under Plugin update at the top of the Connection tab (接続設定) in the settings screen.
| What the screen shows | Meaning |
|---|---|
| Your version: 8 / Latest version: 9 | The version installed now and the latest version PRING provides (the numbers are examples) |
| A newer version (9) is available. Please update. | A newer version exists. Update with the three buttons below |
| You have the latest version. | No update is needed |
| No version has been published yet. | The latest version could not be checked. The three buttons are disabled. It appears when no version is provided and also when PRING could not be reached |
| Your version: unknown | The plugin did not pass its version number. The screen does not decide whether a newer one exists |
The check for the latest version runs once a day in the same browser.
Notices when a newer version exists
When a newer version exists, a notice appears in these places. Export is not stopped.
| Where | What it says | Who sees it |
|---|---|---|
| Top of the settings screen (on every tab) | Please update the plugin to 9 (Settings > Connection > Plugin update). It comes with an Update now button | Whoever opens the settings screen |
| Top of record detail and list views | A newer plugin version (9) is available. Update it under Plugin settings > Connection > Plugin update. | Users who open the app |
The Update now button at the top of the settings screen only takes you to Update now on the Connection tab. The update starts when you press it there.
Three ways to update
Plugin update has three buttons.
| Button | Who can use it | What happens |
|---|---|---|
| Update now | kintone system administrators | Gets the latest ZIP from PRING and replaces the plugin with the new version through kintone’s standard API. The settings of your apps stay. Reload the screen when it finishes |
| Download ZIP | Anyone who can open the settings screen | Makes a download link (works once, valid for 7 days). Importing the ZIP into kintone is done by a kintone system administrator |
| Send the link to the registered address | Anyone who can open the settings screen | Sends the same kind of link by email to the address registered for your contract. Use it when the system administrator is someone else |
When the latest version could not be checked, all three buttons are disabled.
Update with Update now
This is work for a kintone system administrator. You do not import a ZIP by hand.
- On the Connection tab, under Plugin update, press Update now.
- In the confirmation “Update the plugin”, read it and press Update. To stop, press Cancel.
- Progress is shown. When it ends you see “Updated. Please reload this page.” Press Reload.
| What the screen shows | What is happening |
|---|---|
| Getting the new version… | Getting the latest ZIP from PRING. The file is also checked to make sure it is not damaged |
| Loading it into kintone… | Uploading the ZIP to kintone |
| Updating… | Replacing the current plugin with the new version through kintone’s standard API. It runs with the kintone rights of the person who pressed the button |
| Updated. Please reload this page. | Done |
The confirmation says “The settings of your apps stay.” What is replaced is the plugin, not the settings of each app.
Update with a ZIP
Use this when you are not a system administrator, or when Update now did not work.
- Press Download ZIP. You see “The download link is ready (works once, valid for 7 days).”
- Press “Open the link”. A new tab opens and the ZIP download starts.
- A kintone system administrator opens System administration → Plugins → “読み込む” (Import) and selects that ZIP. The plugin is replaced with the new version. The settings of your apps stay.
If the system administrator is someone else, hand the ZIP file to that person.
Rules for the download link
| Item | Rule |
|---|---|
| Uses | Once. Opening the link starts the ZIP download, and the same link cannot be used again |
| Period | 7 days from when it was made |
| When it no longer works | Press Download ZIP again to get a new link |
| What you can get | The plugin ZIP only |
| Handling | Do not share it with other people |
Send the link to the registered address
Press “Send the link to the registered address” and the download link arrives by email.
- The recipient is only the email address registered for your contract (licence). You cannot enter or change a recipient on screen.
- After sending, the screen shows the address with only its first letter left, such as “Sent the link to a***@example.com (valid for 7 days).”
- You can send one mail per hour.
- The mail comes in the display language of the settings screen (Japanese, English or Thai).
- The link in the mail is the same kind as the Download ZIP link: it works once and is valid for 7 days.
The update announcement email (from PRING operations)
Customers on an older version receive an update announcement email from PRING operations. It is there so that you notice a newer version exists and can update. It goes to the email address registered for your contract.
The subject is “[PRING] A new plugin version is available — update link”. The body says:
| Content | Description |
|---|---|
| New version | The number of the new version |
| Your version | The version number of the plugin in your kintone (only when it is known) |
| Link | A link to download the new plugin. It works once and is valid for 7 days. Do not share it |
| How to update | In kintone, open System administration > Plugins and import the downloaded file (the settings of your apps stay). Or open the PRING plugin settings and press “Update now” (kintone system administrators only) |
| If you do not recognize it | If you do not recognize this email, please ignore it |
The email you receive from “Send the link to the registered address” has the same content. Old versions of the plugin have no Plugin update section, so those customers import the ZIP from the link in this email.
What to check after updating
- Reload the settings screen and open the Connection tab.
- Under Plugin update, check that “Your version” shows the same number as “Latest version” and that you see “You have the latest version.” The update notice at the top of the screen is gone too.
- Check that the connected state and your template list are still there.
- Open a record and check that the export buttons appear.
If the number does not change, contact support and include the “Your version” and “Latest version” numbers.
When the update does not work
| What you see on screen or in the browser | Cause and fix |
|---|---|
| Could not update. You need kintone system administrator rights. Use Download ZIP and ask a system administrator to install it. | You do not have system administrator rights. Press Download ZIP in the message and hand the ZIP to an administrator. A system administrator sees the same message when kintone does not accept the replacement |
| The downloaded file is damaged. Please try again. | The ZIP that was fetched was damaged, so it was not passed to kintone. Press Update now again |
| Could not update. Please try again later. | A problem with the connection, kintone or PRING. One of “An error occurred on the kintone side”, “An error occurred on the PRING server” or “Could not connect” appears above it. Try again after a while. If it continues, press “Contact support” in the message. The inquiry number is filled in automatically |
| No version has been published yet. | The latest version could not be checked. Wait a while and reload the settings screen |
| “token already used” in the browser | That link was already opened. Press Download ZIP again |
| “token expired” in the browser | More than 7 days have passed since the link was made. Press Download ZIP again |
| “token not found” in the browser | The link is incomplete or wrong. Open the whole link from the mail as it is. If you are not sure, press Download ZIP again |
| The link mail can be sent once an hour. Please try again later. | A mail was already sent within the last hour. Look for the mail, or use Download ZIP |
| No e-mail address is registered for the licence. Please contact support. | No email address is registered for your contract. Contact us through the contact form. Until then, use Download ZIP |
| Could not send the mail. Please use Download ZIP. | The mail could not be sent. Use Download ZIP |
| Could not load the PRING settings screen. Reload on a network that can reach PRING, or update the plugin to the latest version (System administration > Plugins). | It appears instead of the screen when the main part of the settings screen cannot be loaded from PRING. Reload on a network that can reach PRING. If it continues, update with the link in the announcement email, or contact us through the contact form |
To contact support, use “Contact support” in the settings screen or the contact form. See Contact support for the steps.
Related pages
Frequently asked questions
Can anyone use Update now?
Only kintone system administrators. Others can see the button, but it shows "Could not update. You need kintone system administrator rights. Use Download ZIP and ask a system administrator to install it." Then use Download ZIP, or the link by email, and hand it to an administrator.
I am a system administrator but I see that I need administrator rights.
The same message appears when kintone does not accept the plugin replacement. Use Download ZIP, then import the ZIP in System administration → Plugins → "読み込む" (Import). If that does not work either, contact support.
Do I lose my settings or templates when I update?
The confirmation says "The settings of your apps stay." When you import a ZIP, the announcement email also says the settings of your apps stay. After updating, check that the Connection tab still shows the connected state and that your template list is still there.
The download link no longer works.
A link works once and is valid for 7 days. A link that was already opened, or is older than 7 days, shows "token already used" or "token expired" in the browser. Press Download ZIP on the Connection tab again to get a new link.
Where does the link email go?
Only to the email address registered for your contract (licence). You cannot change the recipient. The screen shows the address with only its first letter left (for example a***@example.com). You can send one mail per hour, in the display language of the settings screen.
The email to the registered address does not arrive.
Check your spam folder. If you see "No e-mail address is registered for the licence. Please contact support.", no address is registered. If you see "Could not send the mail. Please use Download ZIP.", update with Download ZIP.
I see "No version has been published yet." and the buttons are disabled.
The latest version could not be checked. This appears when no version is published and also when PRING could not be reached. Wait a while and reload the settings screen.
"Your version" shows "unknown".
The plugin did not pass its version number. The numbers cannot be compared, so the screen does not decide whether a newer one exists. "You have the latest version." may appear in this state, but it has not been checked. When a latest version number is shown, you can update with any of the three buttons.
A new version should be out, but the screen does not show it.
The check for the latest version runs once a day in the same browser. Right after a new version is released, it can take up to a day to appear.
I received an update announcement email. What do I do?
PRING operations sends it when your version is old. Import the ZIP from its link in kintone under System administration → Plugins → "読み込む" (Import). The link works once and is valid for 7 days. If you do not recognize the email, ignore it.
Users see "A newer plugin version is available".
This notice is for the administrator. Users do not need to do anything, and export is not stopped. The administrator updates from the Connection tab of the settings screen.
The settings screen has no Plugin update section.
Old versions of the plugin do not have this section. Use the link in the update announcement email from PRING operations to import the ZIP. If you have not received the email, send your kintone subdomain through the contact form (https://pring.tech/en/contact).