Logging QML Type

Handles aspects of console system logging. More...

• List of all members, including inherited members

Properties

• append : bool
• enabled : bool
• messagePattern : string
• name : string
• outputLocation : url
• userData : string

Methods

• setFilterRules(string rules)

Detailed Description

The Logging component provides means to configure and create console logs, for diagnostic and error-checking purposes.

This component can return a number of properties provided by the app, which can be recorded into the console log in the format defined by the messagePattern property. This pattern should be structured using these placeholders for the described relevant properties:

%{appname}: The app's name
%{category}: Logging category
%{file}: Path to source file
%{function}: Function
%{line}: Line in source file
%{message}: The actual message
%{pid}: The application's process ID
%{threadid}: The system-wide ID of current thread (if it can be obtained)
%{qthreadptr}: A pointer to the current thread
%{type}: "debug", "warning", "critical" or "fatal"
%{time process}: time of the message, in seconds since the process started
%{time boot}: The time of the message, in seconds since the system boot if that can be determined. If the time since boot could not be obtained, the output is indeterminate.
%{time [format]}: System time when the message occurred. If the format is not specified, the ISO 8601 format is used.

This sample provides a simple console logging interface, including buttons to enable or disable logging and to open the created log file, and a text field to define the message pattern. When logging is enabled, every process going on within your app will be reported in the console log.

Item {
        ColumnLayout {

                Text {
                        text: "Message Pattern"
                }

                TextField {
                        id:outputTextField
                }

                TextField {
                        Layout.fillWidth: true

                        text: "%{if-category}%{category}: %{endif}%{message}"

                        onEditingFinished: {
                                AppFramework.logging.messagePattern = text;
                        }
                }

                RowLayout {
                        Layout.fillWidth: true

                        Button {
                                text: AppFramework.logging.enabled ? "Disable Logging" : "Enable Logging"
                                onClicked: {
                                        forceActiveFocus();
                                        AppFramework.logging.enabled = !AppFramework.logging.enabled;
                                }
                        }

                        Button {
                                text: "Open Output"
                                enabled: urlInfo.isLocalFile

                                onClicked: {
                                        Qt.openUrlExternally(AppFramework.logging.outputLocation);
                                }

                                UrlInfo {
                                        id: urlInfo

                                        url: AppFramework.logging.outputLocation
                                }
                        }
                }

                TextField {
                        id: logMessage

                        Layout.fillWidth: true

                        text: "Log message"
                        placeholderText: "Message to include in log output";
                }
        }

        Timer {
                id: logTimer

                repeat: true
                interval: 1000
                triggeredOnStart: true

                onTriggered: {
                        console.log("logTimer");
                        logRandom();
                }
        }

        FileDialog {
                id: fileDialog

                title: "Log Output File"
                nameFilters: [ "Log files (*.log)", "All files (*)" ]
                folder: AppFramework.resolvedPathUrl("~/ArcGIS/AppStudio/Logs")

                onAccepted: {
                        AppFramework.logging.outputLocation = fileUrl;
                }
        }

        Connections {
                target: AppFramework.logging

                onOutputLocationChanged: {
                        outputTextField.text = Qt.binding(function () {
                                return AppFramework.logging.outputLocation;
                        });
                }
        }
}

You can also record specific messages within your console log when certain lines of code are executed. This code sample prints a line in the console log when the user has finished editing a text field that writes a new filepath to the FileFolder component.

TextField {
    Layout.fillWidth: true

        text: fileFolder.path

    onEditingFinished: {
        fileFolder.path = text.trim();
        console.log("New filepath:", fileFolder.path);
    }
}

Property Documentation

Method Documentation