LookupTable.ReadLookupTablesMultiLangByUids Method

Article
10/22/2013

Gets the multilanguage lookup tables and the corresponding code masks of specified list of lookup table GUIDs.

Namespace: [LookupTable Web service]
Service reference: http://ServerName:32843/[Project Service Application GUID]/PSI/LookupTable.svc
Web service reference: http://ServerName/ProjectServerName/_vti_bin/PSI/LookupTable.asmx?wsdl

Syntax

'Declaration
<SoapDocumentMethodAttribute("https://schemas.microsoft.com/office/project/server/webservices/LookupTable/ReadLookupTablesMultiLangByUids", RequestNamespace := "https://schemas.microsoft.com/office/project/server/webservices/LookupTable/",  _
    ResponseNamespace := "https://schemas.microsoft.com/office/project/server/webservices/LookupTable/",  _
    Use := SoapBindingUse.Literal, ParameterStyle := SoapParameterStyle.Wrapped)> _
Public Function ReadLookupTablesMultiLangByUids ( _
    ltUidList As Guid(), _
    autoCheckOut As Boolean _
) As LookupTableMultiLangDataSet
'Usage
Dim instance As LookupTable
Dim ltUidList As Guid()
Dim autoCheckOut As Boolean
Dim returnValue As LookupTableMultiLangDataSet

returnValue = instance.ReadLookupTablesMultiLangByUids(ltUidList, _
    autoCheckOut)

[SoapDocumentMethodAttribute("https://schemas.microsoft.com/office/project/server/webservices/LookupTable/ReadLookupTablesMultiLangByUids", RequestNamespace = "https://schemas.microsoft.com/office/project/server/webservices/LookupTable/", 
    ResponseNamespace = "https://schemas.microsoft.com/office/project/server/webservices/LookupTable/", 
    Use = SoapBindingUse.Literal, ParameterStyle = SoapParameterStyle.Wrapped)]
public LookupTableMultiLangDataSet ReadLookupTablesMultiLangByUids(
    Guid[] ltUidList,
    bool autoCheckOut
)

Parameters

ltUidList
Type: []
Array of multilanguage lookup table GUIDs.

autoCheckOut
Type: System.Boolean
If true, automatically checks out the specified lookup tables for editing.

Return Value

Type: [LookupTable Web service].LookupTableMultiLangDataSet

Remarks

To create a multilanguage lookup table for test purposes, see the example in CreateLookupTablesMultiLang or see the LookupTables section in Using the ProjTool Test Application in Project Server 2010.

Warning

Create test lookup tables only on a test installation of Project Server.

Project Server Permissions

Permission	Description
LogOn	Allows the user to log on to Project Server. Global permission.

Examples

In the following code fragment, ReadOneMultiLangLUT reads a lookup table specified by the lutUid parameter. LookupTableWS is an arbitrary name for a reference to the LookupTable Web service. To test the code, add it to a sample console application. For more information, see Prerequisites for ASMX-Based Code Samples.

using PSLibrary = Microsoft.Office.Project.Server.Library;
. . .
private const string LOOKUPTABLEWEBSERVICE = "_vti_bin/PSI/LookupTable.asmx";
private string baseUrl = "https://ServerName/ProjectServerName"/
private static LookupTableWS.LookupTable lookupTable =
    new LookupTableWS.LookupTable();

// Initialize the LookupTable Web service for Windows logon.
lookupTable.Url = baseUrl + LOOKUPTABLEWEBSERVICE;
lookupTable.Credentials = CredentialCache.DefaultCredentials;
. . . 
private void ReadOneMultiLangLUT (Guid lutUid)
{
    LookupTableWS.LookupTableMultiLangDataSet lutMultiLang =
        new LookupTableWS.LookupTableMultiLangDataSet();

    if (lutUid == Guid.Empty)
        lutUid = new Guid("1796cacc-5406-4c93-80cb-e7fb1271d32a");
    Guid[] lutUids = { lutUid };

    lutMultiLang = lookupTable.ReadLookupTablesMultiLangByUids(lutUids, false);
    string xmlFile = @"C:\Project\DataSets\MultilanguageLookupTableDataSet.xml";
    SaveDataSetToXml(lutMultiLang, xmlFile);
}
// Save the DataSet for examination.
private void SaveDataSetToXml(DataSet ds, string filePathName)
{
    ds.WriteXml(filePathName);
}