Click or drag to resize
IQMS2SetDSCAPISettings Method
Sets Directory Service Connector (DSC) Settings.

Namespace: PIX.Services.V12.Api2
Assembly: 
Syntax
void SetDSCAPISettings(
	DirectoryServiceConnectorAPISettings dscSettings
)

Parameters

dscSettings
Type: PIX.QMSAPI.DataObjectsDirectoryServiceConnectorAPISettings
DSC settings that should be saved.
Remarks
Security note Security Note

Requires membership of local group QlikView Management API and the role Document Folder Administrator.

Examples
The following code example uses the QMS API to retrieve Directory Service Connector settings. It changes its name and then saves it. If everything goes well, it prints the original name 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.

C#
 using System;
 using System.Collections.Generic;
 using System.Linq;
 using QMSAPI;

class Program
{
     static void Main(string[] args)
     {
         try
         {
            // create a QMS API client
            IQMS2 apiClient = new QMS2Client();

            //retrieve a time limited service key
            ServiceKeyClientMessageInspector.ServiceKey = apiClient.GetTimeLimitedServiceKey();

            //get a list of all Directory Service Connectors
            ServiceInfo[] dsConnectors = apiClient.GetServices(ServiceTypes.QlikViewDirectoryServiceConnector);

            //get Directory Service Connector settings for the first DSC in the list
            DirectoryServiceConnectorAPISettings settings = apiClient.GetDSCAPISettings(dsConnectors[0].ID);
            if (settings != null)
            {
                 //retrieve and print the current name
                 Console.WriteLine("DSC name before change: " + settings.Name);
                 //change the name
                 settings.Name = "NewName";
                 //save settings
                 apiClient.SetDSCAPISettings(settings);
                 Console.WriteLine("Settings saved. DSC name changed.");
            }
         }
         catch(Exception e)
         {
             Console.WriteLine("An error occured: " + e.Message);
         }
         // wait for user to press any key
         Console.ReadLine();
     }
}
See Also