Gallup OMS Web Service Documentation

GetParentUnitsInStructuresByPersonAndStructurePrivilegeRequest

October2010

Gets the Parent Business Unit(s) in all Structures within the Structure(s) identified by the Child where the child has the StructurePrivilege that is passed in.

Service:Structures
Method:GetUnits
Permission:GetParentUnitsInStructuresByPersonAndStructurePrivilegeRequest

Properties

Name Type Required Description
Structures StructureBulkIdentifier Required
Child PersonIdentifier Required
StructurePrivilege StructurePrivilegeIdentifier Required

Exceptions

Exception Severity Code Condition
ArgumentMissing Critical 10010001 A required request input has not been specified.
IdentifierDoesNotExist Critical 10010002 Specified identifier does not exist.
DuplicateInputFound Critical 10010015 Duplicate input was found.
RelationshipNotFound Critical 10060002 Specified unit interaction does not exist in the Structure(s).

Examples

The following is an XML example of the GetParentUnitsInStructuresByPersonAndStructurePrivilegeRequest sent to the Structures.GetUnits method. 

<soapenv:Envelope xmlns:ns="http://schemas.gallup.com/oms/2010/10/" xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">
  <soapenv:Header />
  <soapenv:Body>
    <ns:GetUnits xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
      <ns:request i:type="a:GetParentUnitsInStructuresByPersonAndStructurePrivilegeRequest" xmlns:a="http://schemas.gallup.com/oms/2010/10/Structure">
        <a:Structures i:type="b:StructureBulkIdIdentifier" xmlns:b="http://schemas.gallup.com/oms/2010/10/Identifiers">
          <b:StructureIds i:nil="true" xmlns:c="http://schemas.microsoft.com/2003/10/Serialization/Arrays" />
        </a:Structures>
        <a:Child i:type="b:PersonIdIdentifier" xmlns:b="http://schemas.gallup.com/oms/2010/10/Identifiers">
          <b:PersonId>1</b:PersonId>
        </a:Child>
        <a:StructurePrivilege i:type="b:StructurePrivilegeIdIdentifier" xmlns:b="http://schemas.gallup.com/oms/2010/10/Identifiers">
          <b:StructurePrivilegeId>3</b:StructurePrivilegeId>
        </a:StructurePrivilege>
      </ns:request>
    </ns:GetUnits>
  </soapenv:Body>
</soapenv:Envelope>

[PRINT]© Gallup, Inc. All Rights Reserved. All information contained on this site is the property of Gallup and contains proprietary trade secrets of Gallup. This information is confidential and protected under the confidentiality agreements signed by each Gallup employee, and is to be used solely by Gallup employees in the performance of their responsibilities. None of the information contained in this site is to be copied, viewed, forwarded, downloaded or shred outside of Gallup without permission.

© Gallup, Inc. All Rights Reserved. All information contained on this site is the property of Gallup and contains proprietary trade secrets of Gallup. This information is confidential and protected under the confidentiality agreements signed by each Gallup employee, and is to be used solely by Gallup employees in the performance of their responsibilities. None of the information contained in this site is to be copied, viewed, forwarded, downloaded or shred outside of Gallup without permission.