Share this page

# readPositionLines

## Purpose

This operation reads position lines in PPM Center.

## Function

This operation enables external applications to read the position lines of the

staffing profile identified by position ID in PPM Center. The operation returns

the positionLineType object.

To perform this operation, the user must meet the following conditions:

- View staffing profile access grant

- In Staffing profile ACL list

## Related information

The following data types:

- positionLineType

- effortContourType

- effortCellType

- assignmentType

- promisedAssignmentType

- skillProficiencyType

- userDataType

- resultObjectType

## Input

An array of positionLineType object.

## Return

An array of resultObjectType object

## Java Interface

`public OperationResultWSBean[]
readPositionLines(PositionLineWSBean[] ids)`

Parameters | Description
--- | ---
ids | Wrapper of the positionLineType object array

## Java Examples

Example: reads position lines of staffing profile

    private PositionLineType[] readPositionLines(String serviceURL,
    PositionIdentifierType[] ids) throws Exception{

        PositionLineType[] plType = null;
        StaffingProfileServiceStub stub = new
    StaffingProfileServiceStub(ctx, serviceURL);
        ReadPositionLinesDocument inDoc =
    ReadPositionLinesDocument.Factory.newInstance();
        ReadPositionLinesDocument.ReadPositionLines readPL =
    inDoc.addNewReadPositionLines();
        readPL.setPositionIdArray(ids);

        // Invoke web service
        ReadPositionLinesResponseDocument outDoc =
    stub.readPositionLines(inDoc);
        plType =
    outDoc.getReadPositionLinesResponse().getPositionLineArray();

        return plType;

## Errors and Exceptions

Possible root cause descriptions:

Message Code | Message | Cause(s) | Possible Corrective Action
--- | --- | --- | ---
exception.exceededThreshold | The web service call exceeds the threshold limit for processing. Please batch your updates. | The number of position lines in one Web service call is limited to 50. The web service call exceeds the threshold limit for processing | Reduce the number of position lines in the Web service call
exception.authorization | You do not have the privilege to take this action. Please consult your PPM Administrator | You do not have the required access grants for this operation | Verify that your account has the required access grants
exception.cannotLoadPosition | Position id {0} does not exist. | The position ID does not exist | Specify a different position ID
exception.cannotViewStaffingProfile | User cannot view staffing profile {0} | You do not have the required access grants for this operation | Verify that your account has the required access grants

https://admhelp.microfocus.com PPM 8942
Tips to improve your search results... OpenText™ Project and Portfolio Management Help Center PPM Help 26.2-26.3 All View Local Help Center View Online Help Center Version: