License info
License info : Object
| 引数 | 型 | 説明 | |
|---|---|---|---|
| 戻り値 | Object | ← | Information about the active licence |
説明
The License info command returns an object providing detailed information about the active license.
If the command is executed on a 4D application that does not use locally a license (e.g. 4D remote), the command returns a Null object.
戻り値のオブジェクトには、以下のプロパティが格納されています:
{
"name": "string",
"key": 0,
"licenseNumber": "string",
"version": "string",
"attributes": ["string1", "string2"], // optional
"userName": "string",
"userMail": "string",
"companyName": "string",
"platforms": ["string1", "string2"],
"expirationDate": {
// details here
}, // optional
"renewalFailureCount": 0, // optional
"products": [
{ // for each registered expansion product
"id": 0,
"name": "string",
"usedCount": 0,
"allowedCount": 0,
"rights": [
{
"count": 0,
"expirationDate": {
// details here
} // optional
}
]
}
]
}
| Property | Type | Description | Example |
|---|---|---|---|
| name | string | Commercial name | "4D Developer Professional vXX" |
| key | number | ID of the installed product. A unique number is associated to a 4D application (such as 4D Server, 4D in local mode, 4D Desktop, etc.) installed on a machine. This number is encrypted. | 12356789 |
| licenseNumber | string | License number | "4DDP16XXXXX1123456789" |
| version | string | Product version number | "16", "16R2" |
| attributes | collection of strings | License type(s) when applicable (optional) | ["application","OEM"] |
| userName | string | Name of 4D store account | "John Smith" |
| userMail | string | Mail of 4D store account | "john.smith@gmail.com" |
| companyName | string | Company name of 4D store account | "Alpha Cie" |
| platforms | collection of strings | License platform(s) | ["macOS", "windows"] |
| expirationDate | object | Date of expiration (optional) | {"day":2, "month":6, "year":2018} |
| renewalFailureCount | number | Number of unsuccessful automatic renewal attempts for at least one of the product licenses (optional) | 3 |
| products | Object の Collection | Description of product license (one element per product license). See below. |
Each object of the products collection can have the following properties:
| Property | Type | Description | Example | |
|---|---|---|---|---|
| id | number | License number | For available values, see the Is license available command | |
| name | string | License name | "4D Write - 4D Write Pro" | |
| usedCount | number | Number of consumed connections | 8 | |
| allowedCount | number | Total connections allowed for the product against the expiry dates | 15 | |
| rights | Object の Collection | Rights for the product (one element per expiration date) | ||
| [ ].count | number | Number of allowed connections | 15 (32767 means unlimited) | |
| [ ].expirationDate | object | Date of expiration (optional, same format as above) | {"day":1, "month":11, "year":2017} |
例題
You want to get information on your current 4D Server license:
var $obj : Object
$obj:=License info
$obj can contain, for example:
{
"name": "4D Server v16 R3",
"key": 123456789,
"licenseNumber": "xxxx",
"version": "16R3",
"userName": "John DOE",
"userMail": "john.doe@alpha.com",
"companyName": "Alpha",
"platforms": ["macOS", "windows"],
"expirationDate": {"day":1, "month":1, "year":2018},
"products":[
{
"allowedCount": 15,
"id": 808464697,
"name": "4D Write - 4D Write Pro",
"rights": [
{
"count": 5,
"expirationDate": {"day":1, "month":2, "year":2018}
}, {
"count": 10,
"expirationDate": {"day":1, "month":11, "year":2017}
}, {
"count": 10,
"expirationDate": {"day":1, "month":11, "year":2015} //expired, not counted
}
],
"usedCount": 12
},
{...}
]
}