Retrieve Equipment Home Locations By Code
    • 25 Sep 2024
    • 2 Minutes to read
    • Dark
      Light

    Retrieve Equipment Home Locations By Code

    • Dark
      Light

    Article summary

    Get
    /em-rest-api/rest/1/emhomeloc

    Query Standards

    Finder

    Following row finders are available for data filtering and optimizing request performance.

    • find by Code
    • find by Date
    • By UUID

    Select by Code

    Recommended finder parameters. Refer to Query Parameters for example.

    ParameterDescriptionSample
    locationCodeLocation Code001-CHI

    Select by Date

    This is an optional finder for Equipment Home Locations by Audit Date.

    ParameterDescriptionSample
    AuditDateCreate or update date time filter2022-12-20

    By UUID

    This is an optional finder for querying a specific Equipment Home Location by row ID.

    ParameterDescriptionSample
    /VUUIDThe VUuid attribute is the Unique row ID/em-rest-api/rest/1/emhomeloc/001-CHI
    Security
    HTTP
    Type basic

    Basic authentication

    Query parameters
    finder
    string
    ExamplefindByCode;locationCode=001-SF
    limit
    integer
    Example500
    offset
    integer
    Example0
    totalResults
    boolean
    Exampletrue
    orderBy
    string
    ExampleEmhlHomelocCode:desc
    Responses
    200

    OK

    Headers
    Content-Type
    string
    Exampleapplication/vnd.oracle.adf.resourcecollection+json
    example-0

    Successful Response - Finder - findByDate

    {
      "items": [
        {
          "EmhlHomelocCode": "001-CHI",
          "EmhlName": "Chicago Yard / Warehouse",
          "EmhlSname": null,
          "EmhlCompCode": "001",
          "EmhlCompName": "CMiC Construction Inc",
          "EmhlDeptCode": "416",
          "EmhlDeptName": "Chicago Equip / Whse",
          "EmhlIuCreateDate": "2015-05-11T03:03:28Z",
          "EmhlIuUpdateDate": null,
          "EmhlErecIncFlag": "N",
          "links": [
            {
              "rel": "self",
              "href": "http://mobtest.cmiccloudr12.com:80/cmictestrti/em-rest-api/rest/1/emhomeloc/001-CHI",
              "name": "emhomeloc",
              "kind": "item"
            },
            {
              "rel": "canonical",
              "href": "http://mobtest.cmiccloudr12.com:80/cmictestrti/em-rest-api/rest/1/emhomeloc/001-CHI",
              "name": "emhomeloc",
              "kind": "item"
            }
          ]
        },
        {
          "EmhlHomelocCode": "001-SF",
          "EmhlName": "San Francisco Yard / Warehouse",
          "EmhlSname": null,
          "EmhlCompCode": "001",
          "EmhlCompName": "CMiC Construction Inc",
          "EmhlDeptCode": "716",
          "EmhlDeptName": "San Francisco Equip / Whse",
          "EmhlIuCreateDate": "2015-05-11T03:03:28Z",
          "EmhlIuUpdateDate": null,
          "EmhlErecIncFlag": "N",
          "links": [
            {
              "rel": "self",
              "href": "http://mobtest.cmiccloudr12.com:80/cmictestrti/em-rest-api/rest/1/emhomeloc/001-SF",
              "name": "emhomeloc",
              "kind": "item"
            },
            {
              "rel": "canonical",
              "href": "http://mobtest.cmiccloudr12.com:80/cmictestrti/em-rest-api/rest/1/emhomeloc/001-SF",
              "name": "emhomeloc",
              "kind": "item"
            }
          ]
        },
        {
          "EmhlHomelocCode": "001-EXT",
          "EmhlName": "External Customers",
          "EmhlSname": null,
          "EmhlCompCode": "001",
          "EmhlCompName": "CMiC Construction Inc",
          "EmhlDeptCode": "080",
          "EmhlDeptName": "Support Services",
          "EmhlIuCreateDate": "2015-05-11T03:03:28Z",
          "EmhlIuUpdateDate": null,
          "EmhlErecIncFlag": "N",
          "links": [
            {
              "rel": "self",
              "href": "http://mobtest.cmiccloudr12.com:80/cmictestrti/em-rest-api/rest/1/emhomeloc/001-EXT",
              "name": "emhomeloc",
              "kind": "item"
            },
            {
              "rel": "canonical",
              "href": "http://mobtest.cmiccloudr12.com:80/cmictestrti/em-rest-api/rest/1/emhomeloc/001-EXT",
              "name": "emhomeloc",
              "kind": "item"
            }
          ]
        },
        {
          "EmhlHomelocCode": "HIKUU- YRD",
          "EmhlName": "Company HIKUU Yard / Warehouse",
          "EmhlSname": null,
          "EmhlCompCode": "HIKUU",
          "EmhlCompName": "CMiC Construction Canada Ltd.",
          "EmhlDeptCode": "056",
          "EmhlDeptName": "Equipment/Warehouse Operations",
          "EmhlIuCreateDate": "2015-05-11T03:03:28Z",
          "EmhlIuUpdateDate": null,
          "EmhlErecIncFlag": "N",
          "links": [
            {
              "rel": "self",
              "href": "http://mobtest.cmiccloudr12.com:80/cmictestrti/em-rest-api/rest/1/emhomeloc/HIKUU-%20YRD",
              "name": "emhomeloc",
              "kind": "item"
            },
            {
              "rel": "canonical",
              "href": "http://mobtest.cmiccloudr12.com:80/cmictestrti/em-rest-api/rest/1/emhomeloc/HIKUU-%20YRD",
              "name": "emhomeloc",
              "kind": "item"
            }
          ]
        },
        {
          "EmhlHomelocCode": "002-YARD",
          "EmhlName": "Company 002 Yard / Warehouse",
          "EmhlSname": null,
          "EmhlCompCode": "002",
          "EmhlCompName": "Fresenius Medical Care",
          "EmhlDeptCode": "056",
          "EmhlDeptName": "Equipment/Warehouse Operations",
          "EmhlIuCreateDate": "2015-05-11T03:03:28Z",
          "EmhlIuUpdateDate": null,
          "EmhlErecIncFlag": "N",
          "links": [
            {
              "rel": "self",
              "href": "http://mobtest.cmiccloudr12.com:80/cmictestrti/em-rest-api/rest/1/emhomeloc/002-YARD",
              "name": "emhomeloc",
              "kind": "item"
            },
            {
              "rel": "canonical",
              "href": "http://mobtest.cmiccloudr12.com:80/cmictestrti/em-rest-api/rest/1/emhomeloc/002-YARD",
              "name": "emhomeloc",
              "kind": "item"
            }
          ]
        }
      ],
      "count": 5,
      "hasMore": true,
      "limit": 5,
      "offset": 0,
      "links": [
        {
          "rel": "self",
          "href": "http://mobtest.cmiccloudr12.com:80/cmictestrti/em-rest-api/rest/1/emhomeloc",
          "name": "emhomeloc",
          "kind": "collection"
        }
      ]
    }
    example-1

    Successful Response - Finder - findByCode

    {
      "items": [
        {
          "EmhlHomelocCode": "001-SF",
          "EmhlName": "San Francisco Yard / Warehouse",
          "EmhlSname": null,
          "EmhlCompCode": "001",
          "EmhlCompName": "CMiC Construction Inc",
          "EmhlDeptCode": "716",
          "EmhlDeptName": "San Francisco Equip / Whse",
          "EmhlIuCreateDate": "2015-05-11T03:03:28Z",
          "EmhlIuUpdateDate": null,
          "EmhlErecIncFlag": "N",
          "links": [
            {
              "rel": "self",
              "href": "http://mobtest.cmiccloudr12.com:80/cmictestrti/em-rest-api/rest/1/emhomeloc/001-SF",
              "name": "emhomeloc",
              "kind": "item"
            },
            {
              "rel": "canonical",
              "href": "http://mobtest.cmiccloudr12.com:80/cmictestrti/em-rest-api/rest/1/emhomeloc/001-SF",
              "name": "emhomeloc",
              "kind": "item"
            }
          ]
        }
      ],
      "count": 1,
      "hasMore": false,
      "limit": 5,
      "offset": 0,
      "links": [
        {
          "rel": "self",
          "href": "http://mobtest.cmiccloudr12.com:80/cmictestrti/em-rest-api/rest/1/emhomeloc",
          "name": "emhomeloc",
          "kind": "collection"
        }
      ]
    }
    object