[APS1 to APS2] In APS1 we used classes to get specific data from account/user/POA, how should it be done in APS2?

Original Publishing Date:
2020-01-22

Symptoms

In APS1 we had classes to tell APS controller which data should be used to automatically populate a setting, for example class="login" provided service user's e-mail, class="given-name" provided the name from the contact.

Resolution

In APS2 it is possible to access all data of account from UI, to get detailed information about all service users you need to create an aps/ResourceStore with this apsType:

        userstore = new ResourceStore({
            apsType: "http://aps-standard.org/types/core/service-user/1.0",
            target: "/aps/2/resources/"
        });

The following request will be send to the controller:

GET /aps/2/resources?implementing(http://aps-standard.org/types/core/account/1.0):

[
{
    "aps":
    {
        "type": "http://parallels.com/aps/types/pa/account/1.0",
        "id": "4867bc2b-0542-4d96-bdef-1ad4aeef6e0b",
        "status": "aps:ready",
        "revision": 3,
        "modified": "2014-01-28T03:44:48Z"
    },
    "addressPostal":
    {
        "countryName": "de",
        "extendedAddress": "",
        "locality": "test",
        "postOfficeBox": null,
        "postalCode": "123456",
        "region": "",
        "streetAddress": "asdfdf 12"
    },
    "companyName": "Test Customer",
    "id": 1000005
}
]

Note: there are two permission scopes, for more details check this article.

The full list of built-in types can be found here.