GetPrintersEvents

  • Web Service URL: https://[SERVER_ADDRESS]/EventsWS/EventsData.asmx

  • MPS Version: From 5.3.0

Description

This method returns a list of all printer events that are pending, awaiting resolution, or ignored according to the requested eventStatusID.

Syntax

public string GetPrintersEvents(string dealerName, string dealerUserEmail, string dealerUserPassword, int eventStatusID)

Parameters

  • dealerName: Name of the provider;

  • dealerUserEmail: Email address of the provider user;

  • dealerUserPassword: Encrypted user password;

  • eventStatusID: Indicator of the type of events to be returned.

Parameter

Accepted types

eventStatusID

1 - Pending events
2 - Events awaiting resolution
3 - Ignored events

Return fields

Field name

Description

EventID

Event ID number

EnterpriseID

Company ID number

EnterpriseName

Company name

WarningID

Event type ID number

WarningName

Event name. Example: Printer not communicating/Off, Out of paper, etc.

WarningData

Additional information about the event

CreatedDate

Date and hour when the event was identified by the system

CriticalID

Indicates the critical level of this event (according to the providers' rules):
1 - Critical
2 - Moderate
3 - Minor

PrinterDeviceID

Printer identification number in the system

PrinterName

Name of the printer where the event is occurring

PrinterModel

Printer model

PrinterManufacturer

Printer manufacturer

PrinterSerial

Printer serial number

PrinterAddress

Printer IP address at the company

PrinterLocation

Physical location of the printer at the company

PrinterSite

Printer site

PrinterDepartment

Printer department

Click here to learn more about the format of returns.

Possible errors returned

Click here to check the possible errors that may be returned and learn about their reasons.

Restrictions

  • To execute this method, the user must be assigned to monitor the company to which the desired events belong, have at least restricted permissions in the Events Area, permission for Basic Printer Events, and permission for Advanced Printer Events.

  • The method only returns events that the user has permission to view. If you do not have the necessary permissions, the event list will be returned blank.