SaveQVSSettings Method
Overloads
SaveQVSSettings(QVSSettings) |
Saves the specified QlikView Server settings. |
SaveQVSSettings(QVSSettings)
Saves the specified QlikView Server settings.
Declaration
void SaveQVSSettings(QVSSettings qvsSettings)
Parameters
Type | Name | Description |
---|---|---|
QVSSettings | qvsSettings |
The QlikView Server settings to save. |
Remarks
implementnotes
The QVSID property of qvsSettings
must contain a valid QlikView Server ID.
Only the settings specified by the Scope property will be saved. None of the properties
of qvsSettings
corresponding to the specified scope can be null.
All settings except General and Distribution requires that the QlikView Management Service is able to communicate with the QlikView Server.
If the settings are saved with Scope set to Cluster and any of the specified cluster Members have a license with a different serial number than the main QlikView Server (first cluster member in the list), the correct license ControlNumber must be supplied.
security
Requires membership of local groups QlikView Management API and QlikView Administrator.
Examples
The following code example uses the QMS API to retrieve a registered QlikView Server and its logging settings. It changes the log folder and then saves the logging settings. If everything goes well, it prints the original logging folder and then a message when it's done. If anything goes wrong, it prints an error message.
The service key injection is assumed to be handled behind the scenes. For an example of how to inject the service key, see Samples.
using System;
using System.Collections.Generic;
using QMSAPI;
class Program
{
static void Main(string[] args)
{
try
{
// create a QMS API client
IQMS apiClient = new QMSClient();
//retrieve a time limited service key
ServiceKeyClientMessageInspector.ServiceKey = apiClient.GetTimeLimitedServiceKey();
// get a list of QVS services
List<ServiceInfo> qvsServices = apiClient.GetServices(ServiceTypes.QlikViewServer);
if (qvsServices.Count > 0)
{
// retrieve logging settings for the first QVS in the list
QVSSettings qvsSettings = apiClient.GetQVSSettings(qvsServices[0].ID, QVSSettingsScope.Logging);
Console.WriteLine("QVS log folder before change: " + qvsSettings.Logging.Folder);
// change log folder
qvsSettings.Logging.Folder = @"\\myshare\logs";
// save settings
apiClient.SaveQVSSettings(qvsSettings);
Console.WriteLine("Settings saved. Log folder changed.");
}
}
catch (Exception ex)
{
Console.WriteLine("An exception occurred: " + ex.Message);
}
// wait for user to press any key
Console.ReadKey();
}
}
See Also
Did this page help you?
If you find any issues with this page or its content – a typo, a missing step, or a technical error – let us know how we can improve!