Deprecated features

The features listed in this section are deprecated and will be removed in future versions of the API.

Deprecated features

Sorting order argument

The sortOrder argument has been replaced by the orderBy argument. The orderBy argument is similar to sortOrder, except that it is an array of objects instead of a single object. For more details see Sorting.

Suggesting using null

The use of null for suggesting values for fields is considered deprecated and should be avoided. For more details see Suggesting values.

Aggregates

The schema section that enables fetching of some aggregate values is obsolete and has been replaced with a more complex reading using grouping. For more details see Grouping.

Joins

Some joins are invalid and either don’t return the expected data or return an error. These joins are considered deprecated and should be avoided. They are marked as deprecated.

The GraphiQL IDE is hiding these fields from the schema documentation and is reporting them as deprecated when present in a query.

Deprecation warning

Every time a deprecated feature is used in a query or mutation, a warning will be included in the response, as part of the extensions. The response data is not affected. The warning includes a message explaining what is deprecated and what should be used instead, as well as the path to the deprecated feature in the query or mutation.

Here is an example:

query read($cid : Int)
{
   useCompany(no: $cid) 
   {
      generalLedgerAccount(first:2, 
                           sortOrder : {accountNo : ASC}) 
      {
         items 
         {
            accountNo
            name
         }
      }
   }
}

{
   "data": {
      "useCompany": {
         "generalLedgerAccount": {
            "items": [
               {
                  "accountNo": 1000,
                  "name": "Forskning og utvikling"
               },
               {
                  "accountNo": 1020,
                  "name": "Konsesjoner"
               }
            ]
         }            
      }
   },
   "extensions": {
      "warnings": [
         {
            "message": "The argument 'sortOrder' is deprecated and will be removed. Use 'orderBy' instead.",
            "path": [
               "useCompany",
               "generalLedgerAccount"
            ]
         }
      ],
      "vbnxt-trace-id": "83bcb079fb2c8..."
   }
}