LookupTable.ReadLookupTablesByUids method

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

Namespace:  WebSvcLookupTable
Assembly:  ProjectServerServices (in ProjectServerServices.dll)

Syntax

'Declaration
<SoapDocumentMethodAttribute("https://schemas.microsoft.com/office/project/server/webservices/LookupTable/ReadLookupTablesByUids", 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 ReadLookupTablesByUids ( _
    ltUidList As Guid(), _
    autoCheckOut As Boolean, _
    language As Integer _
) As LookupTableDataSet
'Usage
Dim instance As LookupTable
Dim ltUidList As Guid()
Dim autoCheckOut As Boolean
Dim language As Integer
Dim returnValue As LookupTableDataSet

returnValue = instance.ReadLookupTablesByUids(ltUidList, _
    autoCheckOut, language)
[SoapDocumentMethodAttribute("https://schemas.microsoft.com/office/project/server/webservices/LookupTable/ReadLookupTablesByUids", 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 LookupTableDataSet ReadLookupTablesByUids(
    Guid[] ltUidList,
    bool autoCheckOut,
    int language
)

Parameters

  • ltUidList
    Type: []

    Array of lookup table GUIDs.

  • autoCheckOut
    Type: System.Boolean

    If true, check out for making changes.

Return value

Type: WebSvcLookupTable.LookupTableDataSet

Remarks

To create a lookup table for test purposes, see Walkthrough: Creating a Hierarchical Lookup Table or see Using the ProjTool Test Application.

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, the ReadOneLUT method 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 in Project 2013.

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 ReadOneLUT (Guid lutUid)
{
    LookupTableWS.LookupTableDataSet lut =
        new LookupTableWS.LookupTableDataSet ();

    if (lutUid == Guid.Empty)
        lutUid = new Guid("23bdb945-eacc-4390-af70-f8644683c5bb");
    Guid[] lutUids = { lutUid };

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

See also

Reference

LookupTable class

LookupTable members

WebSvcLookupTable namespace

Other resources

Locale ID (LCID) Chart