GET visit/getStructureByTitle?Title={Title}&UseDiacritics={UseDiacritics}&PageNumber={PageNumber}&PageSize={PageSize}&Token={Token}

Retrieve all organization structure data defined by name. Agenda "Visit" has to be licensed. Privilege "View" of licensed agenda "Organizational structure" required. Data may also be restricted by record permission "View" of agenda "Organizational structure". Paging supported

Request Information

Authorization

  • Authorization by token required

Availability

  • Method disabled by configuration

URI Parameters

NameDescriptionTypeAdditional information
Title

Title of the searched organization structure unit

string

Required

String length: inclusive between 0 and 200

UseDiacritics

Optional parameter may be omitted. Search data by using case sensitivity and diacritical signs or not. The meaning is: 1 - with diacritical signs and case sensitivity; 0 - without diacritical signs and case insensitivity. Default value is 0

integer

Range: inclusive between 0 and 1

PageNumber

Optional parameter may be omitted. All records are displayed when is omitted otherwise specific page is displayed

integer

Matching regular expression pattern: ([0-9]+)

PageSize

Optional parameter may be omitted. Define number of records in the page.

integer

Matching regular expression pattern: ([0-9]+)

Token

The action is authorized by this token. Token should generated by calling action "POST login". Expiration time of each token is 20 seconds

globally unique identifier

Required

Body Parameters

None.

Response Information

Response Codes

Http CodeError NumberDescription
200 request succesfully done 0 Successfully done
400 bad request 1002 Entry parameter missing or parameter bindigs failed
401 unauthorized 1000 Token {0} not found
401 unauthorized 1001 Token {0} already expired
401 unauthorized 1006 Ip filter violated for ip client address [{0}]
401 unauthorized 1007 Ip filter [{0}] parsing failed
401 unauthorized 1008 Request rate policy violated for [{0}]
403 server refuses fo fulfill the request 1161 Privilege View of agenda Organizational structure violated for [{0}]
403 server refuses fo fulfill the request 8 Not licensed
404 required resource does not exist on the server 1160 Organization structure [{0}] not found
415 unsupported Media Type The request entity has a media type which the server or resource does not support. Only application/json and application/xml are supported
500 internal error Server exception description

Resource Description

BaseRespOfOrgStructureGetAllResp
NameDescriptionTypeAdditional information
Result

RequestResult

None.

Request

OrgStructureGetAllResp

None.

Response Formats

application/json, text/json

Sample:
{
  "Result": {
    "Message": "sample string 1",
    "Code": 2,
    "ModelStateErr": [
      "sample string 1",
      "sample string 2"
    ]
  },
  "Request": {
    "Unit": [
      {
        "Structure": "sample string 1",
        "UdsCollection": [
          {
            "SystemName": "sample string 1",
            "Name": "sample string 2",
            "Value": "sample string 3",
            "IsExtern": 4,
            "DataType": "sample string 5"
          },
          {
            "SystemName": "sample string 1",
            "Name": "sample string 2",
            "Value": "sample string 3",
            "IsExtern": 4,
            "DataType": "sample string 5"
          }
        ]
      },
      {
        "Structure": "sample string 1",
        "UdsCollection": [
          {
            "SystemName": "sample string 1",
            "Name": "sample string 2",
            "Value": "sample string 3",
            "IsExtern": 4,
            "DataType": "sample string 5"
          },
          {
            "SystemName": "sample string 1",
            "Name": "sample string 2",
            "Value": "sample string 3",
            "IsExtern": 4,
            "DataType": "sample string 5"
          }
        ]
      }
    ],
    "Paging": {
      "CurrentPage": 1,
      "PageSize": 2,
      "TotalCount": 3,
      "TotalPages": 4
    }
  }
}

application/xml, text/xml

Sample:
<Response xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
  <Result>
    <Message>sample string 1</Message>
    <Code>2</Code>
    <ModelStateErr>
      <string>sample string 1</string>
      <string>sample string 2</string>
    </ModelStateErr>
  </Result>
  <Request>
    <OrganizationStructure>
      <Unit>
        <Structure>sample string 1</Structure>
        <UdsCollection>
          <UdsOut>
            <SystemName>sample string 1</SystemName>
            <Name>sample string 2</Name>
            <Value>sample string 3</Value>
            <IsExtern>4</IsExtern>
            <DataType>sample string 5</DataType>
          </UdsOut>
          <UdsOut>
            <SystemName>sample string 1</SystemName>
            <Name>sample string 2</Name>
            <Value>sample string 3</Value>
            <IsExtern>4</IsExtern>
            <DataType>sample string 5</DataType>
          </UdsOut>
        </UdsCollection>
      </Unit>
      <Unit>
        <Structure>sample string 1</Structure>
        <UdsCollection>
          <UdsOut>
            <SystemName>sample string 1</SystemName>
            <Name>sample string 2</Name>
            <Value>sample string 3</Value>
            <IsExtern>4</IsExtern>
            <DataType>sample string 5</DataType>
          </UdsOut>
          <UdsOut>
            <SystemName>sample string 1</SystemName>
            <Name>sample string 2</Name>
            <Value>sample string 3</Value>
            <IsExtern>4</IsExtern>
            <DataType>sample string 5</DataType>
          </UdsOut>
        </UdsCollection>
      </Unit>
    </OrganizationStructure>
    <Paging>
      <CurrentPage>1</CurrentPage>
      <PageSize>2</PageSize>
      <TotalCount>3</TotalCount>
      <TotalPages>4</TotalPages>
    </Paging>
  </Request>
</Response>