You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
DWT can import images in a few different ways, the most common which is to acquire images from image sources, which are scanners and other imaging hardware. (We can also load image files, both from the local file system and over the network, as explained [here]({{site.general-usage}}image-import/file-import.html))
18
+
17
19
After the web application has initialized DWT and instantiated a `WebTwain` object, the `WebTwain` object can perform image acquisition, which is a term that includes scanning and file input. We will first go over scanning in this section. Note that we also provide an add-on for webcam-based scanning, which you can learn more about [here]({{site.api}}Addon_Webcam.html).
Dynamic Web TWAIN (DWT) requires a valid license key to function. License keys authorize the use of DWT, as well as any configured add-on modules.
17
17
18
-
### Request trial license
18
+
##Use Trial Licenses
19
19
20
-
You can request a trial license of Dynamic Web TWAIN via our <ahref="https://www.dynamsoft.com/customer/license/trialLicense?product=dwt"target="_blank">customer portal</a> or [contacting support](https://www.dynamsoft.com/company/contact/).
20
+
You can request a trial license of Dynamic Web TWAIN through our <ahref="https://www.dynamsoft.com/customer/license/trialLicense?product=dwt"target="_blank">customer portal</a>, and we will email you your trial license key. You can also contact our [support team](https://www.dynamsoft.com/company/contact/) for new licenses and/or trial license extensions.
21
21
22
-
### Update trial license
22
+
### Configure Trial License Keys
23
23
24
-
You can set the new key via the `ProductKey` API.
24
+
License keys are configured in the [`Dynamsoft.DWT.ProductKey`]({{site.api}}Dynamsoft_WebTwainEnv.html#productkey) property. (**Note**: prior to version 17.0, this property was `Dynamsoft.WebTwainEnv.ProductKey`). The configuration differs depending on how a project loads DWT resource files (see [loading library resources]({{site.general-usage}}resource-loading.html) for more details). Trial key strings typically have the `t0076` prefix.
25
25
26
-
1. Open `dynamsoft.webtwain.config.js` from your local project or search `ProductKey` to locate the code for license setting.
1. Locate the `dynamsoft.webtwain.config.js` file (or search for `ProductKey`).
34
+
35
+
2. Assign the license key string to [`Dynamsoft.DWT.ProductKey`]({{site.api}}Dynamsoft_WebTwainEnv.html#productkey):
36
+
37
+
```javascript
38
+
Dynamsoft.DWT.ProductKey='t0076******'; // Use an offline trial key
39
+
```
40
+
41
+
3. Load (or reload, if replacing an existing key) the web application and see that it starts scanning.
42
+
43
+
<divclass="multi-panel-end">
44
+
45
+
</div><divclass="multi-panel-start"></div>
46
+
47
+
When using package managers such as `npm`, be sure to check out our web framework samples. Roughly speaking, it involves setting `Dynamsoft.DWT.ProductKey` before calling either [`Dynamsoft.DWT.Load()`]({{site.api}}Dynamsoft_WebTwainEnv.html#load) or [`Dynamsoft.DWT.CreateDWTObjectEx()`]({{site.api}}Dynamsoft_WebTwainEnv.html#createdwtobjectex):
48
+
49
+
-[Use Web TWAIN in Angular]({{site.indepth}}development/angular.html)
50
+
-[Use Web TWAIN in React]({{site.indepth}}development/react.html)
51
+
-[Use Web TWAIN in Vue]({{site.indepth}}development/vue.html)
52
+
53
+
<divclass="multi-panel-switching-end"></div>
54
+
55
+
## Using Full Licenses
56
+
57
+
Contact our [sales team](https://www.dynamsoft.com/store/dynamic-web-twain/) to purchase full licenses for Dynamic Web TWAIN. Use our <ahref="https://www.dynamsoft.com/customer/license/fullLicense"target="_blank">customer portal</a> to manage full licenses. Full licenses are either offline licenses, or DLS-connected licenses. DLS-connected licenses contact DLS servers for authentication purposes - please see [Dynamsoft License Server](https://www.dynamsoft.com/license-server/docs/about/index.html) for more details. Full licenses may also be configured with add-on modules.
58
+
59
+
### Acquiring Full Keys
60
+
61
+
<divclass="multi-panel-switching-prefix"></div>
62
+
63
+
-[DLS-Connected Keys](#get-dls-keys)
64
+
-[Offline Keys](#get-offline-keys)
65
+
66
+
<divclass="multi-panel-start"></div>
67
+
68
+
DLS-connected license keys begin with the `DLS` prefix. Learn more about the Dynamsoft Licensing Server [here](https://www.dynamsoft.com/license-server/docs/about/activate.html).
69
+
70
+
1. Without add-ons: activate the license in the customer portal, then acquire the DLS key. This key only authorizes the use of the core DWT module.
71
+
2. With add-ons: activate the license and configure the core DWT module along with add-ons into one project in DLS, then acquire the DLS key. This authorizes the use of the add-on modules on top of the core module.
72
+
73
+
<divclass="multi-panel-end">
74
+
75
+
</div><divclass="multi-panel-start"></div>
76
+
77
+
Offline license keys begin with the `f0068` prefix.
78
+
79
+
1. Without add-ons: activate the license in the customer portal, then acquire the offline key. This key only authorizes the use of the core DWT module.
80
+
2. With add-ons: activate the license in the customer portal, then acquire the offline keys. This may result in multiple license keys - one for the base DWT module, and separate ones for the add-ons. To use multiple keys in a single project, concatenate them (in any order) into a single string, separated with semicolons.
81
+
82
+
<divclass="multi-panel-switching-end"></div>
83
+
84
+
### Configuring Full License Keys
85
+
86
+
To use a full license key, set the value of [`Dynamsoft.DWT.ProductKey`]({{site.api}}Dynamsoft_WebTwainEnv.html#productkey) to the key string. (**Note**: prior to version 17.0, this property was `Dynamsoft.WebTwainEnv.ProductKey`) The configuration differs depending on how a project loads DWT resource files (see [loading library resources]({{site.general-usage}}resource-loading.html) for more details).
1. Locate the `dynamsoft.webtwain.config.js` file (or search for `ProductKey`).
98
+
99
+
2. Assign the license key string to [`Dynamsoft.DWT.ProductKey`]({{site.api}}Dynamsoft_WebTwainEnv.html#productkey):
29
100
30
101
```javascript
31
-
Dynamsoft.DWT.ProductKey='t0076lQAAAGNcO61He******'; //update the ProductKey with yours
102
+
Dynamsoft.DWT.ProductKey='DLS******'; //Use an online key
32
103
```
33
104
34
-
3. Refresh your scan page and try again.
105
+
3. Load (or reload, if replacing an existing key) the web application and see that it starts scanning.
106
+
107
+
<divclass="multi-panel-end">
108
+
109
+
</div><divclass="multi-panel-start"></div>
110
+
111
+
1. Locate the `dynamsoft.webtwain.config.js` file (or search for `ProductKey`).
35
112
36
-
## Full license
113
+
2. Assign the license key string to [`Dynamsoft.DWT.ProductKey`]({{site.api}}Dynamsoft_WebTwainEnv.html#productkey):
37
114
38
-
You can find all the full licenses you own via our <ahref="https://www.dynamsoft.com/customer/license/fullLicense"target="_blank">customer portal</a>.
115
+
```javascript
116
+
Dynamsoft.DWT.ProductKey='f0068******;'; // Use an online key
117
+
```
118
+
119
+
3. Load (or reload, if replacing an existing key) the web application and see that it starts scanning.
120
+
121
+
<divclass="multi-panel-end">
122
+
123
+
</div><divclass="multi-panel-start"></div>
124
+
125
+
Offline license keys with add-ons should be concatenated (in any order) into a single string, separated with semicolons, and assigned to the same property (e.g. `f0068******;f0068******`).
126
+
127
+
1. Locate the `dynamsoft.webtwain.config.js` file (or search for `ProductKey`).
128
+
129
+
2. Assign the license key string to [`Dynamsoft.DWT.ProductKey`]({{site.api}}Dynamsoft_WebTwainEnv.html#productkey):
130
+
131
+
```javascript
132
+
Dynamsoft.DWT.ProductKey='f0068******;f0068******'; // Use an online key
133
+
```
39
134
40
-
Depending on the type of full license you are using, you can add/update the full license via the `ProductKey` API (available for Dynamic Web TWAIN v17.0+).
135
+
3. Load (or reload, if replacing an existing key) the web application and see that it starts scanning.
41
136
42
-
### Update ProductKey
137
+
<divclass="multi-panel-end">
43
138
44
-
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.
139
+
</div><divclass="multi-panel-start"></div>
45
140
46
-
```javascript
47
-
Dynamsoft.DWT.ProductKey='t0076lQAAAGNcO61He******'; // update the ProductKey with yours
48
-
```
141
+
When using package managers such as `npm`, be sure to check out our web framework samples. Roughly speaking, it involves setting `Dynamsoft.DWT.ProductKey` before calling either [`Dynamsoft.DWT.Load()`]({{site.api}}Dynamsoft_WebTwainEnv.html#load) or [`Dynamsoft.DWT.CreateDWTObjectEx()`]({{site.api}}Dynamsoft_WebTwainEnv.html#createdwtobjectex):
49
142
50
-
If you have multiple license keys, separate them with semicolons like below:
143
+
-[Use Web TWAIN in Angular]({{site.indepth}}development/angular.html)
144
+
-[Use Web TWAIN in React]({{site.indepth}}development/react.html)
145
+
-[Use Web TWAIN in Vue]({{site.indepth}}development/vue.html)
### Loading from [jsDelivr](https://cdn.jsdelivr.net/npm/dwt@18.5.0/dist/dynamsoft.webtwain.min.js)
84
+
### Loading from [jsDelivr](https://cdn.jsdelivr.net/npm/dwt@latest/dist/dynamsoft.webtwain.min.js)
85
85
86
-
Note that jsDelivr currently has problems delivering the Dynamsoft Service installer (`https://cdn.jsdelivr.net/npm/dwt@18.5.0/dist/dist/`) due to [size restrictions](https://www.jsdelivr.com/documentation#id-configuring-a-default-file-in-packagejson); please consider hosting this particular resource file elsewhere. UKPKG is currently unaffected. For information about the Dynamsoft Service, learn more [here]({{site.extended-usage}}dynamsoft-service-configuration.html).
86
+
Note that jsDelivr currently has problems delivering the Dynamsoft Service installer (`https://cdn.jsdelivr.net/npm/dwt@latest/dist/dist/`) due to [size restrictions](https://www.jsdelivr.com/documentation#id-configuring-a-default-file-in-packagejson); please consider hosting this particular resource file elsewhere. UKPKG is currently unaffected. For information about the Dynamsoft Service, learn more [here]({{site.extended-usage}}dynamsoft-service-configuration.html).
0 commit comments