Page tree

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

The information on this page refers to License Statistics v5.4 14 or newer, which changed specifications required for generating the XML filethe xsd schema. If you are using an earlier version of License Statistics, please refer to the documentation for releases prior to v5.414.

If you use a different license server than one of those currently supported by License Statistics (see Supported license servers), you can customize License Statistics to run with your specific license server. To run License Statistics with your license server, your parser must write an UTF-8 encoded XML file that License Statistics can read and understand. In this way, virtually any licensing system can communicate with the License Statistics ' graphing engine. 

See Adding and editing realtime license servers for information about adding a custom license server to License Statistics.

...

The specifications for the XML file are as follows: 

  • CUSTOM_STAT – required
    - VENDOR – required
  • USAGE – the usage of a single feature
    - FEATURE is required and indicates ; the name of the feature
    - VERSION – the version of the feature
    - USED_LICENSES – the sum of licenses used by users (including borrowed and licenses, but excluding reserved licenses)
    - DENIED_LICENSES – the sum of denied licenses
    - BORROWED_LICENSES – the sum of licenses borrowed by users
    - RESERVED_LICENSES – the sum of reserved licenses
    - TOTAL_LICENSES – "UNLIMITED" or numeric value of licenses in the feature
    - SHARE – specifies which the type of license sharing in use
    - EXPIRES – "permanentPERMANENT", or an empty string, or the date on which the feature is set to expire, in "YYYY-MM-dd" format

  • USER – the usage of the feature for a single user
    - USERNAME
    - HOSTNAME
    - IP – the user's IP address
    - USED_LICENSES – the number of licenses used by the user
    - DENIED_LICENSES – the number of licenses the user was denied
    - BORROW_ EXPIRE_TIME – if the used licenses are borrowed, this indicates the date when the borrow is due to expire, in "YYYY-MM-DD HH:mm" format
    - CHECKOUT_TIME – required; the date on which the user checked out the licenses, in "YYYY-MM-DD HH:mm" format

Important:

  1. USED_LICENSES and DENIED_LICENSES have to be located in separate USER entries.
  2. All dates and times must be in the following format: YYYY-MM-DD [HH:MM]format specified for the variable in the list above.
  3. Only one VENDOR name can be used.

...

Code Block
languagexml
<xs:schema attributeFormDefault="unqualified" elementFormDefault="qualified" xmlns:xs="http://www.w3.org/2001/XMLSchema">
    <xs:simpleType name="xfDate">
        <xs:restriction base="xs:string">
            <xs:pattern value="\d{4}-\d{2}-\d{2}"/>
        </xs:restriction>
    </xs:simpleType>
    <xs:simpleType name="xfDateTime">
        <xs:restriction base="xs:string">
            <xs:pattern value="\d{4}-\d{2}-\d{2} \d{2}:\d{2}"/>
        </xs:restriction>
    </xs:simpleType>

    <xs:element name="CUSTOM_STAT">
        <xs:complexType>
            <xs:sequence>
                <xs:element name="USAGE" maxOccursminOccurs="unbounded0" minOccursmaxOccurs="0unbounded">
                    <xs:complexType>
                        <xs:sequence>
                            <xs:sequence>
                                <xs:element name="USER" maxOccursminOccurs="unbounded0" minOccursmaxOccurs="0unbounded">
                                    <xs:complexType>
                                        <xs:simpleContent>
                                            <xs:extension base="xs:string">
                                                <xs:attribute type="xs:string" name="USERNAME" use="optional"/>
                                                <xs:attribute type="xs:string" name="HOSTNAME" use="optional"/>
                                                <xs:attribute type="xs:string" name="IP" use="optional"/>
                                                <xs:attribute type="xs:stringxfDateTime" name="BORROWCHECKOUT_EXPIRE_TIME" use="optionalrequired"/>
                                                <xs:attribute type="xs:stringxfDateTime" name="CHECKOUTBORROW_EXPIRE_TIME" use="optional"/>
                                                <xs:attribute type="xs:nonNegativeInteger" name="USED_LICENSES" use="optional"/>
                                                <xs:attribute type="xs:nonNegativeInteger" name="DENIED_LICENSES" use="optional"/>
                                            </xs:extension>
                                        </xs:simpleContent>
                                    </xs:complexType>
                                </xs:element>
                            </xs:sequence>
                        </xs:sequence>
                        <xs:attribute name="FEATURE" use="required">
                            <xs:simpleType>
                                <xs:restriction base="xs:string">
                                    <xs:minLength value="1"/>
                                </xs:restriction>
                            </xs:simpleType>
                        </xs:attribute>
                        <xs:attribute type="xs:float" name="VERSION" use="optional"/>
                        <xs:attribute type="xs:nonNegativeInteger" name="USED_LICENSES" use="optional"/>
                        <xs:attribute type="xs:nonNegativeInteger" name="DENIED_LICENSES" use="optional"/>
                        <xs:attribute type="xs:nonNegativeInteger" name="RESERVED_LICENSES" use="optional"/>
                        <xs:attribute type="xs:nonNegativeInteger" name="BORROWED_LICENSES" use="optional"/>
                        <xs:attribute type="xs:string" name="TOTAL_LICENSES" use="optional"/>
                        <xs:attribute type="xs:string" name="SHARE" use="optional"//>
                        <xs:attribute name="EXPIRES">
                            <xs:attribute type="simpleType>
                                <xs:union memberTypes="xfDate">
                                    <xs:simpleType>
                                        <xs:restriction base="xs:string" name="EXPIRES" use="optional>
                                            <xs:enumeration value="permanent"/>
                                            <xs:enumeration value=""/>
                                        </xs:restriction>
                                    </xs:simpleType>
                                </xs:union>
                            </xs:simpleType>
                        </xs:attribute>
                    </xs:complexType>
                </xs:element>
            </xs:sequence>
            <xs:attribute name="VENDOR" use="required">
                <xs:simpleType>
                    <xs:restriction base="xs:string">
                        <xs:minLength value="1"/>
                    </xs:restriction>
                </xs:simpleType>
            </xs:attribute>
        </xs:complexType>
    </xs:element>
</xs:schema>