Using Guest Connection

Any introductory work with web service can be organized via a guest connection. To work with such a connection, it is required first to save user credentials in the BI server registry that will be used for authorization. To do this, as an administrator start the PP.Util.exe utility with the /save_creds <repository id> /gc <user name> parameters. Working via a guest connection enables the user to execute operations for the objects, for which the user, which user credentials were saved, has access permissions.

After that the following moniker can be used to execute web service operations: "<repository id>!Guest!M". On the first access with this moniker a guest connection is created in the BI server. To execute operations that work with repository objects, an object moniker is formed by the same principle as on the regular connection: "<repository id>!Guest!M!<object id or key>".

It is not necessary to close the guest connection, it will be closed automatically after timeout determined in BI server settings is reached.

NOTE. On working with the guest connection the OpenMetabase and CloseMetabase operations are not used.

Example

Example of guest connection status check. If a guest connection is not created, it will be created automatically on executing the GetStatus operation.

SOAP request:

<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">

<s:Body xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">

<id>PPREPOSITORY!Guest!M</id>

</metabase>

</tArg>

</GetStatus>

</s:Body>

</s:Envelope>

SOAP response:

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">

<soapenv:Body>

<version xmlns=" ">Prerelease 9.2.23417 [Unicode]</version>

</GetStatusResult>

</soapenv:Body>

</soapenv:Envelope>

JSON request:

{
 "GetStatus" : 
  {
   "tArg" : 
    {
     "metabase" : 
      {
       "id" : "PPREPOSITORY!Guest!M"
      }
    }
  }
}

JSON response:

{
 "GetStatusResult" : 
  {
   "version" : "Prerelease 9.2.23417 [Unicode]",
   "release" : "9.2",
   "metabaseSessionTimeout" : "00:30:00.000",
   "metabaseStoreBinaryCount" : "0",
   "metabaseLocale" : "1033",
   "metabaseConnectionPoolMaxCount" : "0"
  }
}

    public static GetStatusResult TestGuestConnect(string mbDefinitionId)
    {
        var somClient = new SomPortTypeClient(); //Proxy object for operation execution
        //Operation execution parameters
        var tStatus = new GetStatus()
        {
            tArg = new GetStatusArg()
            {
                metabase = new MbId() { id = mbDefinitionId + "!Guest!M" }
            }
        };
        //get information about web service
        var result = somClient.GetStatus(tStatus);
        return result;
    }