Data can be extracted and then be used with for example Microsoft Power BI to build reports.

Requirements

Limitations

  • Maximum extraction period 1 month.
  • Maximum 10 extracts per day.
  • Only current data is extracted.

Working with extracted data

  1. Contact Printix.
  2. Authenticate.
  3. Get the data extract endpoint.
  4. Data extract request.
  5. Data extract response.

Contact Printix

Please contact us if you want to extract data, so we can email you the required Secret and ClientId.

Authenticate

You must authenticate using the provided Secret and ClientId before you can proceed.

Please open the Printix api documentation and browse to the section: Authentication

Get the data extract endpoint

Make a GET request to the tenant URL. Example:

  • https://api.printix.net/v1/tenants/acme.printix.net

The response contains a “px:dataextract” link:

"_links" : {
      "px:dataextract" : {
        "href" : 
"https://api.printix.net/dataextract/tenants/99999999-8888-7777-6666-fedcba987654"
      }

Type of extracts

  • NETWORKS
    Information about networks.
  • TRACKING_DATA
    Information about which user printed what, where and when.
  • JOBS
    Information about pending and printed documents.
  • PRINTERS
    Information about the printers and print queues.
  • DRIVERS
    Information about print drivers.
  • DEVICE_READINGS
    Meter readings from printers.
  • USERS
    Information about users.
  • GROUPS
    Information about groups.
  • WORKSTATIONS
    Information about computers.

Data extract request

To extract data types TRACKING_DATA and PRINTERS, you should make a POST like the below on the “px:dataextract” link:

{
  "from": "2018-03-01T00:00:00.000Z",
  "to": "2018-04-01T00:00:00.000Z",
  "blobStoreAccountName" : <your azure blob store account name>,
  "blobStoreAccountKey" : <your azure blob store account key>,
  "extracts": [
     "TRACKING_DATA",
     "PRINTERS"
  ]
}

Data extract response

The response will provide download links for the extracts. When you get the response, the data extracts are not ready yet, so both each extract and the extract-resource as a whole has “completed” timestamps, which are all initially null, but will get filled in as the extracts become ready.

Use the extract-resource’s “self” link to GET an updated copy of it, to check when all the files are ready.

{
  "completed" : null,
  "started" : "2018-03-19T13:56:44.167Z",
  "extractStatuses" : [ {
    "type" : "TRACKING_DATA",
    "downloadUri" : 
"https://mydata.blob.core.windows.net/30a3df4a-cc77-4159-8ff4-5c0a2bb25acc/tracking-data.zip?sig=WzsNrwZiAJamy78bsyzBNXvQkBCaD572Sghf8%2B21ba8%3D&st=2018-03-19T13%3A41%3A44Z&se=2018-03-20T13%3A56%3A44Z&sv=2017-04-17&sp=r&sr=b",
    "completed" : null
  }, {
    "type" : "PRINTERS",
    "downloadUri" : "https://mydata.blob.core.windows.net/30a3df4a-cc77-4159-8ff4-5c0a2bb25acc/printers.zip?sig=yCunQGbF7yIPGhbByzmSLsGsRqifNhhc7gLKGeiAy3E%3D&st=2018-03-19T13%3A41%3A44Z&se=2018-03-20T13%3A56%3A44Z&sv=2017-04-17&sp=r&sr=b",
    "completed" : null
  } ],
  "expires" : "2018-03-20T13:56:44.739Z",
  "params" : {
    "blobStoreAccountName" : null,
    "blobStoreAccountKey" : null,
    "from" : "2018-03-01T00:00:00Z",
    "to" : "2018-04-01T00:00:00Z",
    "extracts" : [ "TRACKING_DATA", "PRINTERS" ]
  },
"container" : "30a3df4a-cc77-4159-8ff4-5c0a2bb25acc",
"_links" : {
    "self" : {
      "href" : 
"https://api.printix.net/dataextract/tenants/99999999-8888-7777-6666-fedcba987654/extract/30a3df4a-cc77-4159-8ff4-5c0a2bb25acc"
    }
  }
}

Feedback

Was this helpful?

Yes No
You indicated this topic was not helpful to you ...
Could you please leave a comment telling us why? Thank you!
Thanks for your feedback.

Post your comment on this topic.

Please do not use this for support questions.
Printix Help Center

Post Comment