License info

License info : Object

Parameter	Type		Description
Function result	Object	←	Information about the active licence

Description

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.

The returned object contains the following properties:

{
    "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	collection of objects	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		collection of objects	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}

Example

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
        },
        {...}
    ]
}

See also

CHANGE LICENSES
Is license available
WEB Get server info

Properties

Command number	1489
Thread safe	✓