Skip to content
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
61 changes: 27 additions & 34 deletions about/license.md
Original file line number Diff line number Diff line change
Expand Up @@ -10,62 +10,55 @@ description: Dynamic Web TWAIN SDK Documentation License Page

# License

## How do I get a trial License
## Trial License

Please visit our <a href="https://www.dynamsoft.com/customer/license/trialLicense?ver=latest&product=dwt" target="_blank">customer portal</a> to request for a trial license.
### Request trial license

## Full licenses
You can request a trial license of Dynamic Web TWAIN via our <a href="https://www.dynamsoft.com/customer/license/trialLicense?ver=latest&product=dwt" target="_blank">customer portal</a> or [contacting support](https://www.dynamsoft.com/company/contact/).

Dynamic Web TWAIN has the following licensing options:
### Update trial license

### <a href="https://www.dynamsoft.com/Products/WebTWAIN_License.aspx#per_browser_client" target="_blank">Per Client Device</a> / <a href="https://www.dynamsoft.com/Products/WebTWAIN_License.aspx#per_page" target="_blank">Per Page</a>
You can set the new key via the `ProductKey` API.

For Per Client Device/ Per Page license, you need to use <a href="{{site.info}}api/Dynamsoft_WebTwainEnv.html#organizationid" target="_blank">organizationID</a> to set.
1. Open `dynamsoft.webtwain.config.js` from your local project or search `ProductKey` to locate the code for license setting.

``` javascript
Dynamsoft.DWT.organizationID = "123456"; // replace the number 123456 with YOUR-ORGANIZATION-ID
```
2. Update `ProductKey` in the code.

Please note that this licensing mode is only supported from `DWT` 17.0 and needs to be used with Dynamsoft License Server (`DLS` for short). See more about <a href="https://www.dynamsoft.com/license-tracking/docs/selfhosting/managelts.html?ver=latest" target="_blank">What is a DLS</a>
```javascript
Dynamsoft.DWT.ProductKey = 't0076lQAAAGNcO61He******'; // update the ProductKey with yours
```

LTS supports two deployment methods: <a href="https://www.dynamsoft.com/license-tracking/docs/dshosting/index.html?ver=latest" target="_blank">Dynamsoft-hosting</a> and <a href="https://www.dynamsoft.com/license-tracking/docs/selfhosting/index.html?ver=latest" target="_blank">Self-hosting</a>. See <a href="https://www.dynamsoft.com/license-server/docs/about/licensefaq.html?ver=latest#how-secure-is-the-dynamsoft-license-server" target="_blank">How secure is the Dynamsoft License Server</a>
3. Refresh your scan page and try again.

If you use Self-hosting, you also need to set <a href="{{site.info}}api/Dynamsoft_WebTwainEnv.html#licenseserver" target="_blank">licenseServer</a>
## Full license

``` javascript
Dynamsoft.DWT.licenseServer = ["https://your.mainServer.com"];
Dynamsoft.DWT.organizationID = "123456"; // replace the number 123456 with YOUR-ORGANIZATION-ID
```
You can find all the full licenses you own via our <a href="https://www.dynamsoft.com/customer/license/fullLicense" target="_blank">customer portal</a>.

### <a href="https://www.dynamsoft.com/Products/WebTWAIN_License.aspx#per_server" target="_blank">Per Server</a>
Depending on the type of full license you are using, you can add/update the full license via the `ProductKey` or `organizationID` API (available for Dynamic Web TWAIN v17.0+).

For <a href="https://www.dynamsoft.com/Products/WebTWAIN_License.aspx#per_server" target="_blank">Per Server</a> license, you need to use <a href="{{site.info}}api/WebTwain_Util.html#productkey" target="_blank">ProductKey</a> to set.
### Update ProductKey

In most cases, you can just make the change in the file `dynamsoft.webtwain.config.js` .
If you are using a **ProductKey**, you can search `ProductKey` to locate the code for license setting which resides in the `dynamsoft.webtwain.config.js` file for most cases.

``` javascript
// If you have multiple license keys, just separate them with semicolons.
Dynamsoft.DWT.ProductKey = 't0076lQAAAGNcO61He******; t0076lQAAAGNcO61He******';
Dynamsoft.DWT.ProductKey = 't0076lQAAAGNcO61He******'; // update the ProductKey with yours
```

If it is set elsewhere, you need to find it and replace it. For example, if you are making use of the <a href="https://www.npmjs.com/package/dwt" target="_blank">dwt package</a> ( `dynamsoft.webtwain.min.js` or `dynamsoft.webtwain.min.mjs` ), the file `dynamsoft.webtwain.config.js` doesn't exist and you should already have the above line of code in your own JavaScript where you can update the license when needed.

### Other Licenses
If you have multiple license keys, separate them with semicolons like below:

The license setting way is the same as Per Server License, please refer to the above Per Server License section.
``` javascript

#### Notes:
Please note that `DLS` license <strong>organizationID and ProductKey cannot be used together</strong>. And you need to connect to `DLS` to track license usage.
Dynamsoft.DWT.ProductKey = 't0076lQAAAGNcO61He******; t0076lQAAAGNcO61He******';
```

All license usage data is submitted to the `DLS` hosted by Dynamsoft. You can
### Update organizationID

* <a href="https://www.dynamsoft.com/license-tracking/docs/common/licenseitems.html" target="_blank">View activated license items</a>
* <a href="https://www.dynamsoft.com/license-tracking/docs/common/statistics.html" target="_blank">View the license usage statistics</a>
* <a href="https://www.dynamsoft.com/license-tracking/docs/common/usagealerts.html" target="_blank">Get notified about license status</a>
If you are using an **organizationID**, you can simply update the `organizationID` in your code.

> Read more about <a href="https://www.dynamsoft.com/license-tracking/docs/common/mechanism.html" target="_blank">the mechanism</a> behind license tracking.
``` javascript
Dynamsoft.DWT.organizationID = "123456"; // replace the number 123456 with YOUR-ORGANIZATION-ID
```

## Terms
## License Agreement

View the <a href="https://www.dynamsoft.com/Products/WebTwain_license.aspx" target="_blank">Dynamic Web TWAIN License Agreement</a>.