X-Profile

X-Profiles provides high performance search queries for customer and organization data.

Key features

• CRUD operations with users
• CRUD operations with organizations
• CRUD operations with contacts

QueryRoot

List of queries:

#	Endpoint	Arguments	Return
1	organization	id	Organization
2	contact	id	Contact
3	role	roleName	Role
4	user	id userName email loginProvider providerKey	User

Organization

With this query you can get the organization by id

{
  organization(id: "689a72757c754bef97cde51afc663430") {
    id
    name
    ownerId
    parentId
    businessCategory
    addresses {
      addressType
    }
  }
}

Contact

With this query you can get the contact by id

{
  contact(id: "5f807280-bb1a-42b2-9a96-ed107269ea06") {
    id
    fullName
    memberType
    name
    organizationId
    organizations {
      name
    }
  }
}

Role

With this query you can get the role by name

{
  role(roleName: "Store administrator") {
    id
    name
    permissions
  }
}

User

With this query you can get the user by few arguments

{
  user(id: "9b605a3096ba4cc8bc0b8d80c397c59f") {
    accessFailedCount
    contact {
      id
      name
    }
    createdDate
    email
    isAdministrator
    passwordHash
  }
}

Queriable objects

Profile schema type

Mutations

List of mutations:

#	Endpoint	Arguments	Description
1	createContact	id name! memberType addresses phones emails groups fullName firstName! lastName! middleName salutation photoUrl timeZone defaultLanguage organizations	Creates contact
2	updateContact	id! name memberType addresses phones emails groups fullName firstName! lastName! middleName salutation photoUrl timeZone defaultLanguage organizations	Updates contact
3	deleteContact	contactId!	Deletes contact
4	createUser	id email createdBy createdDate isAdministrator lockoutEnabled lockoutEnd logins memberId password phoneNumber phoneContactConfirmed photoUrl roles storeId twoFactorEnabled userName userType	Creates user
5	updateUser	accessFailedCount email! id! isAdministrator lockoutEnabled lockoutEnd memberId phoneNumber phoneNumberConfirmed photoUrl roles storeId twoFactorEnabled userName! userType! passwordHash securityStamp!	Updates user
6	deleteUsers	userNames!	Delete users
7	updateAddresses	contactId! addresses!	Update addresses
8	createOrganization	id name memberType addresses phones emails groups	Creates organization
9	updateOrganization	id! name memberType addresses phones emails groups	Updates organization
10	updateRole	concurrencyStamp id! name! description permissions!	Updates role

CreateContact

Query

mutation($command: InputCreateContactType!) {
  createContact(command: $command) {
    id
    name
    firstName
    lastName
  }
}

Variables

{
  "command": {
  "firstName": "testGraphQlFirstName",
  "lastName": "testGraphQlLastName",
  "name": "testGraphQlName"
    }
}

UpdateContact

Query

mutation($command: InputUpdateContactType!){
  updateContact(command: $command) {
    id
    name
  }
}

Variables

{
  "command": {
    "id": "550e9b14-ddde-46fe-bc28-0afec83ade96",
    "firstName": "testGraphQlFirstName2",
    "lastName": "testGraphQlLastName2"
    }
}

DeleteContact

Query

mutation($command: InputDeleteContactType!){
  deleteContact(command: $command)
}

Variables

{
  "command": {
    "contactId": "550e9b14-ddde-46fe-bc28-0afec83ade96"
  }
}

CreateUser

Query

mutation($command: InputCreateUserType!) {
  createUser(command: $command) {
    succeeded
  }
}

Variables

{
  "command": {
    "email": "[email protected]",
    "userName": "graphqlTestUserName",
    "userType": "Customer"
  }
}

UpdateUser

Query

mutation($command: InputUpdateUserType!) {
  updateUser(command: $command) {
    succeeded
    errors{
      code
      description
    }
  }
}

Variables

{
  "command": {
    "id": "ae6f1cd7-957d-4b30-864c-8f40232a4df3",
    "userName": "graphqlTestUserName2",
    "userType": "Manager",
    "securityStamp": "",
    "email": "[email protected]"
  }
}

SecurityStamp - A random value that must change whenever a users credentials change (password changed, login removed)

DeleteUsers

Query

mutation($command: InputDeleteUserType!) {
  deleteUsers(command: $command) {
    succeeded
    errors{
      code
      description
    }
  }
}

Variables

{
  "command": {
    "userNames": ["graphqlTestUserName2"]
  }
}

UpdateAddresses

Query

mutation($command: InputUpdateContactAddressType!) {
  updateAddresses(command: $command) {
    addresses {
      addressType
    }
  }
}

Variables

{
  "command": {
    "contactId": "820c58c5-b518-454b-aefd-2fc4616bd25e",
    "addresses": [
      {
        "countryCode": "testCountryCode",
        "countryName": "testCountryName",
        "line1": "testLine1",
        "postalCode": "testPostalCode",
        "city": "testCity",
        "addressType": 3
      }
    ]
  }
}

Address type: 1 - Billing, 2 - Shipping, 3 - BillingAndShipping

CreateOrganization

Query

mutation($command: InputCreateOrganizationType!) {
  createOrganization(command: $command) {
    id
    name
    memberType
  }
}

Variables

{
  "command": {
    "name": "testOrganizationName",
    "emails": ["testOrg.graphql.local"]
  }
}

UpdateOrganization

Query

mutation($command: InputUpdateOrganizationType!) {
  updateOrganization(command: $command) {
    id
    name
    memberType
  }
}

Variables

{
  "command": {
    "id": "5385b5b7-1772-4c08-8596-27503b8fdddd",
    "name": "EditedTestOrganization",
    "emails": ["[email protected]"]
  }
}

UpdateRole

Query

mutation($command: InputUpdateRoleType!) {
  updateRole(command: $command) {
    succeeded
    errors {
      code
      description
    }
  }
}

Variables

{
  "command": {
    "id": "e75700bb597948cca7962e0bbcfdb97c",
    "name": "Use api",
    "permissions": [
      {
        "name": "platform:setting:read"
      },
      {
        "name": "catalog:create"
      }
    ],
    "concurrencyStamp": ""
  }
}

ConcurrencyStamp - A random value that should change whenever a role is persisted to the store

---

Last update: September 23, 2021