LookupTable.ReadLookupTablesByUids Method
Gets the lookup tables and the corresponding code masks for a 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/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.
- language
Type: System.Int32
Locale ID (LCID).
Return Value
Type: [LookupTable Web service].LookupTableDataSet
Remarks
To create a lookup table for test purposes, see Walkthrough: Creating a Hierarchical Lookup Table or see 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 |
|---|---|
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.
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.LookupTableDataSetlut =
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);
}