Documentation

AmazonReportRequestList extends AmazonReportsCore
in package

Application

implements Iterator

Fetches a list of report requests from Amazon.

This Amazon Reports Core Object retrieves a list of previously requested reports from Amazon. No parameters are required, but a number of filters are available to narrow the list of report requests that are returned. This object can also count the number of report requests. This object can use tokens when retrieving the list.

Interfaces, Classes and Traits

Iterator

$config : mixed
$env : mixed
$marketplaceId : mixed
$mockFiles : mixed
$mockIndex : mixed
$mockMode : mixed
$options : mixed
$proxyInfo : mixed
$rawResponses : mixed
$storeName : mixed
$throttleCount : mixed
$throttleGroup : mixed
$throttleLimit : mixed
$throttleSafe : mixed
$throttleStop : mixed
$throttleTime : mixed
$tokenFlag : mixed
$tokenUseFlag : mixed
$urlbase : mixed
$urlbranch : mixed
$count : mixed
$i : mixed
$index : mixed
$reportList : mixed
__construct() : mixed: AmazonReportRequestList fetches a list of report requests from Amazon.
cancelRequests() : bool: Cancels the report requests that match the given parameters. Careful!
current() : type: Iterator function
fetchCount() : bool: Fetches a count of Report Requests from Amazon.
fetchRequestList() : bool: Fetches a list of Report Requests from Amazon.
fetchURL() : array<string|int, mixed>: Get url or send POST data
getCount() : number|bool: Returns the report request count.
getDateProcessingCompleted() : string|bool: Returns the date processing for the specified report request was finished.
getDateProcessingStarted() : string|bool: Returns the date processing for the specified report request started.
getEndDate() : string|bool: Returns the end date for the specified report request.
getIsScheduled() : string|bool: Returns whether or not the specified report request is scheduled.
getLastResponse() : array<string|int, mixed>|bool: Gives the latest response data received from Amazon.
getList() : array<string|int, mixed>|bool: Returns the full list.
getOptions() : array<string|int, mixed>: Returns options array.
getRawResponses() : array<string|int, mixed>|bool: Gives all response code received from Amazon.
getReportId() : string|bool: Returns the report ID for the specified entry.
getReportType() : string|bool: Returns the report type for the specified entry.
getRequestId() : string|bool: Returns the report request ID for the specified entry.
getStartDate() : string|bool: Returns the start date for the specified report request.
getStatus() : string|bool: Returns the processing status for the specified report request.
getSubmittedDate() : string|bool: Returns the date the specified report request was submitted.
getThrottleCountForLastRequest() : int: Gives the number of times the last call to sendRequest was throttled
hasToken() : bool: Returns whether or not a token is available.
key() : type: Iterator function
next() : mixed: Iterator function
resetReportStatuses() : mixed: Removes report status options.
resetReportTypes() : mixed: Removes report type options.
resetRequestIds() : mixed: Removes report request ID options.
resetTimeLimits() : mixed: Removes time limit options.
rewind() : mixed: Iterator function
setConfig() : mixed
setMaxCount() : bool: Sets the maximum response count. (Optional)
setMock() : mixed: Enables or disables Mock Mode for the object.
setReportStatuses() : bool: Sets the report status(es). (Optional)
setReportTypes() : bool: Sets the report type(s). (Optional)
setRequestIds() : bool: Sets the report request ID(s). (Optional)
setStore() : mixed: Sets the store values.
setThrottleStop() : mixed: Enables or disables the throttle stop.
setTimeLimits() : mixed: Sets the time frame options. (Optional)
setUseToken() : bool: Sets whether or not the object should automatically use tokens if it receives one.
valid() : type: Iterator function
_calculateStringToSignV2() : string: generates the string to sign, copied from Amazon
_getParametersAsString() : string: Fuses all of the parameters together into a string, copied from Amazon
_sign() : string: Runs the hash, copied from Amazon
_signParameters() : string: validates signature and sets up signing of them, copied from Amazon
_urlencode() : string: Reformats the provided string using rawurlencode while also replacing ~, copied from Amazon
checkResponse() : bool: Checks whether or not the response is OK.
checkToken() : bool: Checks for a token and changes the proper options
fetchMockFile() : SimpleXMLObject|string|bool: Fetches the given mock file, or attempts to.
fetchMockResponse() : bool|array<string|int, mixed>: Generates a fake HTTP response using the mock file list.
genQuery() : string: Handles generation of the signed query string.
genTime() : string: Generates timestamp in ISO8601 format.
log() : bool: Writes a message to the log.
parseXML() : bool: Parses XML response into array.
prepareCancel() : mixed: Sets up options for using CancelReportRequests.
prepareCount() : mixed: Sets up options for using countFeeds.
prepareToken() : mixed: Sets up options for using tokens.
resetMock() : mixed: Sets mock index back to 0.
sendRequest() : array<string|int, mixed>: Sends a request to Amazon via cURL
sleep() : mixed: Sleeps for the throttle time and records to the log.

$config


    protected
        mixed
    $config

$env


    protected
        mixed
    $env

$marketplaceId


    protected
        mixed
    $marketplaceId

$mockFiles


    protected
        mixed
    $mockFiles

$mockIndex


    protected
        mixed
    $mockIndex
     = 0

$mockMode


    protected
        mixed
    $mockMode
     = false

$options


    protected
        mixed
    $options

$proxyInfo


    protected
        mixed
    $proxyInfo
     = []

$rawResponses


    protected
        mixed
    $rawResponses
     = []

$storeName


    protected
        mixed
    $storeName

$throttleCount


    protected
        mixed
    $throttleCount
     = 0

$throttleGroup


    protected
        mixed
    $throttleGroup

$throttleLimit


    protected
        mixed
    $throttleLimit

$throttleSafe


    protected
        mixed
    $throttleSafe

$throttleStop


    protected
        mixed
    $throttleStop
     = false

$throttleTime


    protected
        mixed
    $throttleTime

$tokenFlag


    protected
        mixed
    $tokenFlag
     = false

$tokenUseFlag


    protected
        mixed
    $tokenUseFlag
     = false

$urlbase


    protected
        mixed
    $urlbase

$urlbranch


    protected
        mixed
    $urlbranch

$count


    private
        mixed
    $count

$i


    private
        mixed
    $i
     = 0

$index


    private
        mixed
    $index
     = 0

$reportList


    private
        mixed
    $reportList

__construct()

AmazonReportRequestList fetches a list of report requests from Amazon.


    public
                __construct(string $s[, bool $mock = false ][, array<string|int, mixed>|string $m = null ]) : mixed

The parameters are passed to the parent constructor, which are in turn passed to the AmazonCore constructor. See it for more information on these parameters and common methods.

Parameters

$s : string: Name for the store you want to use.
$mock : bool = false: [optional]
This is a flag for enabling Mock Mode. This defaults to FALSE.
$m : array<string|int, mixed>|string = null: [optional]
The files (or file) to use in Mock Mode.

Return values

mixed —

cancelRequests()

Cancels the report requests that match the given parameters. Careful!


    public
                cancelRequests() : bool

Submits a CancelReportRequests request to Amazon. Amazon will send as a response the list of feeds that were cancelled, along with the count of the number of affected feeds. This data can be retrieved using the same methods as with fetchRequestList and fetchCount.

Return values

bool —

FALSE if something goes wrong

current()

Iterator function


    public
                current() : type

Return values

type —

fetchCount()

Fetches a count of Report Requests from Amazon.


    public
                fetchCount() : bool

Submits a GetReportRequestCount request to Amazon. Amazon will send the number back as a response, which can be retrieved using getCount.

Return values

bool —

FALSE if something goes wrong

fetchRequestList()

Fetches a list of Report Requests from Amazon.


    public
                fetchRequestList([mixed $r = true ]) : bool

Submits a GetReportRequestList request to Amazon. Amazon will send the list back as a response, which can be retrieved using getList. Other methods are available for fetching specific values from the list. This operation can potentially involve tokens.

Parameters

$r : mixed = true

Return values

bool —

FALSE if something goes wrong

fetchURL()

Get url or send POST data


    public
                fetchURL(string $url, array<string|int, mixed> $param) : array<string|int, mixed>

Parameters

$url : string
$param : array<string|int, mixed>: ['Header'] $param['Post']

Return values

array<string|int, mixed> —

$return['ok'] 1 - success, (0,-1) - fail $return['body'] - response $return['error'] - error, if "ok" is not 1 $return['head'] - http header

getCount()

Returns the report request count.


    public
                getCount() : number|bool

This method will return FALSE if the count has not been set yet.

Return values

number|bool —

number, or FALSE if count not set yet

getDateProcessingCompleted()

Returns the date processing for the specified report request was finished.


    public
                getDateProcessingCompleted(int $i) : string|bool

This method will return FALSE if the list has not yet been filled.

Parameters

$i : int: [optional]
List index to retrieve the value from. Defaults to 0.

Return values

string|bool —

single value, or FALSE if Non-numeric index

getDateProcessingStarted()

Returns the date processing for the specified report request started.


    public
                getDateProcessingStarted(int $i) : string|bool

This method will return FALSE if the list has not yet been filled.

Parameters

$i : int: [optional]
List index to retrieve the value from. Defaults to 0.

Return values

string|bool —

single value, or FALSE if Non-numeric index

getEndDate()

Returns the end date for the specified report request.


    public
                getEndDate(int $i) : string|bool

This method will return FALSE if the list has not yet been filled.

Parameters

$i : int: [optional]
List index to retrieve the value from. Defaults to 0.

Return values

string|bool —

single value, or FALSE if Non-numeric index

getIsScheduled()

Returns whether or not the specified report request is scheduled.


    public
                getIsScheduled(int $i) : string|bool

This method will return FALSE if the list has not yet been filled.

Parameters

$i : int: [optional]
List index to retrieve the value from. Defaults to 0.

Return values

string|bool —

single value, or FALSE if Non-numeric index

getLastResponse()

Gives the latest response data received from Amazon.


    public
                getLastResponse([int $i = null ]) : array<string|int, mixed>|bool

Response arrays contain the following keys:

head - The raw HTTP head, including the response code and content length
body - The raw HTTP body, which will almost always be in XML format
code - The HTTP response code extracted from the head for convenience
answer - The HTTP response message extracted from the head for convenience
ok - Contains a 1 if the response was normal, or 0 if there was a problem
headarray - An associative array of the head data, for convenience

Parameters

$i : int = null: [optional]
If set, retrieves the specific response instead of the last one. If the index for the response is not used, FALSE will be returned.

Return values

array<string|int, mixed>|bool —

associative array of HTTP response or FALSE if not set yet

getList()

Returns the full list.


    public
                getList([int $i = null ]) : array<string|int, mixed>|bool

This method will return FALSE if the list has not yet been filled. The array for a single report will have the following fields:

ReportRequestId
ReportType
StartDate
EndDate
Scheduled
ReportProcessingStatus
GeneratedReportId
StartedProcessingDate
CompletedDate

Parameters

$i : int = null: [optional]
List index to retrieve the value from. Defaults to NULL.

Return values

array<string|int, mixed>|bool —

multi-dimensional array, or FALSE if list not filled yet

getOptions()

Returns options array.


    public
                getOptions() : array<string|int, mixed>

Gets the options for the object, for debugging or recording purposes. Note that this also includes key information such as your Amazon Access Key ID.

Return values

array<string|int, mixed> —

All of the options for the object.

getRawResponses()

Gives all response code received from Amazon.


    public
                getRawResponses() : array<string|int, mixed>|bool

Return values

array<string|int, mixed>|bool —

list of associative arrays of HTTP response or FALSE if not set yet

getReportId()

Returns the report ID for the specified entry.


    public
                getReportId(int $i) : string|bool

This method will return FALSE if the list has not yet been filled.

Parameters

$i : int: [optional]
List index to retrieve the value from. Defaults to 0.

Return values

string|bool —

single value, or FALSE if Non-numeric index

getReportType()

Returns the report type for the specified entry.


    public
                getReportType(int $i) : string|bool

This method will return FALSE if the list has not yet been filled.

Parameters

$i : int: [optional]
List index to retrieve the value from. Defaults to 0.

Return values

string|bool —

single value, or FALSE if Non-numeric index

getRequestId()

Returns the report request ID for the specified entry.


    public
                getRequestId(int $i) : string|bool

This method will return FALSE if the list has not yet been filled.

Parameters

$i : int: [optional]
List index to retrieve the value from. Defaults to 0.

Return values

string|bool —

single value, or FALSE if Non-numeric index

getStartDate()

Returns the start date for the specified report request.


    public
                getStartDate(int $i) : string|bool

This method will return FALSE if the list has not yet been filled.

Parameters

$i : int: [optional]
List index to retrieve the value from. Defaults to 0.

Return values

string|bool —

single value, or FALSE if Non-numeric index

getStatus()

Returns the processing status for the specified report request.


    public
                getStatus(int $i) : string|bool

This method will return FALSE if the list has not yet been filled.

Parameters

$i : int: [optional]
List index to retrieve the value from. Defaults to 0.

Return values

string|bool —

single value, or FALSE if Non-numeric index

getSubmittedDate()

Returns the date the specified report request was submitted.


    public
                getSubmittedDate(int $i) : string|bool

This method will return FALSE if the list has not yet been filled.

Parameters

$i : int: [optional]
List index to retrieve the value from. Defaults to 0.

Return values

string|bool —

single value, or FALSE if Non-numeric index

getThrottleCountForLastRequest()

Gives the number of times the last call to sendRequest was throttled


    public
                getThrottleCountForLastRequest() : int

Return values

int —

hasToken()

Returns whether or not a token is available.


    public
                hasToken() : bool

Return values

bool —

key()

Iterator function


    public
                key() : type

Return values

type —

next()

Iterator function


    public
                next() : mixed

Return values

mixed —

resetReportStatuses()

Removes report status options.


    public
                resetReportStatuses() : mixed

Use this in case you change your mind and want to remove the Report Status parameters you previously set.

Return values

mixed —

resetReportTypes()

Removes report type options.


    public
                resetReportTypes() : mixed

Use this in case you change your mind and want to remove the Report Type parameters you previously set.

Return values

mixed —

resetRequestIds()

Removes report request ID options.


    public
                resetRequestIds() : mixed

Use this in case you change your mind and want to remove the Report Request ID parameters you previously set.

Return values

mixed —

resetTimeLimits()

Removes time limit options.


    public
                resetTimeLimits() : mixed

Use this in case you change your mind and want to remove the time limit parameters you previously set.

Return values

mixed —

rewind()

Iterator function


    public
                rewind() : mixed

Return values

mixed —

setConfig()


    public
                setConfig() : mixed

Return values

mixed —

setMaxCount()

Sets the maximum response count. (Optional)


    public
                setMaxCount(array<string|int, mixed>|string $s) : bool

This method sets the maximum number of Report Requests for Amazon to return. If this parameter is not set, Amazon will only send 10 at a time.

Parameters

$s : array<string|int, mixed>|string: Positive integer from 1 to 100.

Return values

bool —

FALSE if improper input

setMock()

Enables or disables Mock Mode for the object.


    public
                setMock([bool $b = true ][, array<string|int, mixed>|string|int $files = null ]) : mixed

Use this method when you want to test your object without sending actual requests to Amazon. When Mock Mode is enabled, responses are pulled from files you specify instead of sending the request. Be careful, as this means that the parameters you send will not necessarily match the response you get back. The files are pulled in order of the list, looping back to the first file after the last file is used. The log records every time a file is set or used, or if the file is missing. This method is also used to set response codes used by certain functions. Mock Mode is particularly useful when you need to test functions such as canceling orders or adding new products.

Parameters

$b : bool = true: [optional]
When set to TRUE, Mock Mode is enabled for the object. Defaults to TRUE.
$files : array<string|int, mixed>|string|int = null: [optional]
The list of files (or single file) to be used with Mock Mode. If a single string is given, this method will put it into an array. Integers can also be given, for use in fetchMockResponse. These numbers should only be response codes, such as 200 or 404.

Return values

mixed —

setReportStatuses()

Sets the report status(es). (Optional)


    public
                setReportStatuses(array<string|int, mixed>|string $s) : bool

This method sets the list of report types to be sent in the next request.

Parameters

$s : array<string|int, mixed>|string: A list of report types, or a single type string.

Return values

bool —

FALSE if improper input

setReportTypes()

Sets the report type(s). (Optional)


    public
                setReportTypes(array<string|int, mixed>|string $s) : bool

This method sets the list of report types to be sent in the next request.

Parameters

$s : array<string|int, mixed>|string: A list of report types, or a single type string.

Return values

bool —

FALSE if improper input

setRequestIds()

Sets the report request ID(s). (Optional)


    public
                setRequestIds(array<string|int, mixed>|string $s) : bool

This method sets the list of report request IDs to be sent in the next request.

Parameters

$s : array<string|int, mixed>|string: A list of report request IDs, or a single type string.

Return values

bool —

FALSE if improper input

setStore()

Sets the store values.


    public
                setStore(string $s) : mixed

This method sets a number of key values from the config file. These values include your Merchant ID, Access Key ID, and Secret Key, and are critical for making requests with Amazon. If the store cannot be found in the config file, or if any of the key values are missing, the incident will be logged.

Parameters

$s : string: The store name to look for.

Return values

mixed —

setThrottleStop()

Enables or disables the throttle stop.


    public
                setThrottleStop([bool $b = true ]) : mixed

When the throttle stop is enabled, throttled requests will not be repeated. This setting is off by default.

Parameters

$b : bool = true: Defaults to TRUE.

Return values

mixed —

setTimeLimits()

Sets the time frame options. (Optional)


    public
                setTimeLimits([string $s = null ][, string $e = null ]) : mixed

This method sets the start and end times for the next request. If this parameter is set, Amazon will only return Report Requests that were submitted between the two times given. If these parameters are not set, Amazon will only return Report Requests that were submitted within the past 90 days. The parameters are passed through strtotime, so values such as "-1 hour" are fine.

Parameters

$s : string = null: [optional]
A time string for the earliest time.
$e : string = null: [optional]
A time string for the latest time.

Return values

mixed —

setUseToken()

Sets whether or not the object should automatically use tokens if it receives one.


    public
                setUseToken([bool $b = true ]) : bool

If this option is set to TRUE, the object will automatically perform the necessary operations to retrieve the rest of the list using tokens. If this option is off, the object will only ever retrieve the first section of the list.

Parameters

$b : bool = true: [optional]
Defaults to TRUE

Return values

bool —

FALSE if improper input

valid()

Iterator function


    public
                valid() : type

Return values

type —

_calculateStringToSignV2()

generates the string to sign, copied from Amazon


    protected
                _calculateStringToSignV2(array<string|int, mixed> $parameters) : string

Parameters

$parameters : array<string|int, mixed>

Return values

string —

_getParametersAsString()

Fuses all of the parameters together into a string, copied from Amazon


    protected
                _getParametersAsString(array<string|int, mixed> $parameters) : string

Parameters

$parameters : array<string|int, mixed>

Return values

string —

_sign()

Runs the hash, copied from Amazon


    protected
                _sign(string $data, string $key, string $algorithm) : string

Parameters

$data : string
$key : string
$algorithm : string: 'HmacSHA1' or 'HmacSHA256'

Return values

string —

_signParameters()

validates signature and sets up signing of them, copied from Amazon


    protected
                _signParameters(array<string|int, mixed> $parameters, string $key) : string

Parameters

$parameters : array<string|int, mixed>
$key : string

Return values

string —

signed string

_urlencode()

Reformats the provided string using rawurlencode while also replacing ~, copied from Amazon


    protected
                _urlencode(string $value) : string

Almost the same as using rawurlencode

Parameters

$value : string

Return values

string —

checkResponse()

Checks whether or not the response is OK.


    protected
                checkResponse(array<string|int, mixed> $r) : bool

Verifies whether or not the HTTP response has the 200 OK code. If the code is not 200, the incident and error message returned are logged.

Parameters

$r : array<string|int, mixed>: The HTTP response array. Expects the array to have the fields code, body, and error.

Return values

bool —

TRUE if the status is 200 OK, FALSE otherwise.

checkToken()

Checks for a token and changes the proper options


    protected
                checkToken(SimpleXMLObject $xml) : bool

Parameters

$xml : SimpleXMLObject: response data

Return values

bool —

FALSE if no XML data

fetchMockFile()

Fetches the given mock file, or attempts to.


    protected
                fetchMockFile([bool $load = true ]) : SimpleXMLObject|string|bool

This method is only called when Mock Mode is enabled. This is where files from the mock file list are retrieved and passed back to the caller. The success or failure of the operation will be recorded in the log, including the name and path of the file involved. For retrieving response codes, see fetchMockResponse.

Parameters

$load : bool = true: [optional]
Set this to FALSE to prevent the method from loading the file's contents into a SimpleXMLObject. This is for when the contents of the file are not in XML format, or if you simply want to retrieve the raw string of the file.

Return values

SimpleXMLObject|string|bool —

A SimpleXMLObject holding the contents of the file, or a string of said contents if $load is set to FALSE. The return will be FALSE if the file cannot be fetched for any reason.

fetchMockResponse()

Generates a fake HTTP response using the mock file list.


    protected
                fetchMockResponse() : bool|array<string|int, mixed>

This method uses the response codes in the mock file list to generate an HTTP response. The success or failure of this operation will be recorded in the log, including the response code returned. This is only used by a few operations. The response array will contain the following fields:

head - ignored, but set for the sake of completion
body - empty XML, also ignored
code - the response code fetched from the list
answer - answer message
error - error message, same value as answer, not set if status is 200
ok - 1 or 0, depending on if the status is 200

Return values

bool|array<string|int, mixed> —

An array containing the HTTP response, or simply the value FALSE if the response could not be found or does not match the list of valid responses.

genQuery()

Handles generation of the signed query string.


    protected
                genQuery() : string

This method uses the secret key from the config file to generate the signed query string. It also handles the creation of the timestamp option prior.

Return values

string —

query string to send to cURL

genTime()

Generates timestamp in ISO8601 format.


    protected
                genTime([string $time = false ]) : string

This method creates a timestamp from the provided string in ISO8601 format. The string given is passed through strtotime before being used. The value returned is actually 30 seconds early, to prevent it from tripping up Amazon. If no time is given, the current time is used.

Parameters

$time : string = false: [optional]
The time to use. Since this value is passed through strtotime first, values such as "-1 hour" are fine. Defaults to the current time.

Return values

string —

Unix timestamp of the time, minus 30 seconds.

log()

Writes a message to the log.


    protected
                log(string $msg[, string $level = 'Info' ]) : bool

This method adds a message line to the log file defined by the config. This includes the priority level, user IP, and a backtrace of the call.

Parameters

$msg : string: The message to write to the log.
$level : string = 'Info': [optional]
The priority level of the message. This is merely for the benefit of the user and does not affect how the code runs. The values used in this library are "Info", "Warning", "Urgent", and "Throttle".

Return values

bool —

FALSE if the message is empty, NULL if logging is muted

parseXML()

Parses XML response into array.


    protected
                parseXML(SimpleXMLObject $xml) : bool

This is what reads the response XML and converts it into an array.

Parameters

$xml : SimpleXMLObject: The XML response from Amazon.

Return values

bool —

FALSE if no XML data is found

prepareCancel()

Sets up options for using CancelReportRequests.


    protected
                prepareCancel() : mixed

This changes key options for using CancelReportRequests. Please note: because the operation for cancelling feeds does not use all of the parameters, some of the parameters will be removed. The following parameters are removed: max count and token.

Return values

mixed —

prepareCount()

Sets up options for using countFeeds.


    protected
                prepareCount() : mixed

This changes key options for using countFeeds. Please note: because the operation for counting feeds does not use all of the parameters, some of the parameters will be removed. The following parameters are removed: request IDs, max count, and token.

Return values

mixed —

prepareToken()

Sets up options for using tokens.


    protected
                prepareToken() : mixed

This changes key options for switching between simply fetching a list and fetching the rest of a list using a token. Please note: because the operation for using tokens does not use any other parameters, all other parameters will be removed.

Return values

mixed —

resetMock()

Sets mock index back to 0.


    protected
                resetMock([bool $mute = false ]) : mixed

This method is used for returning to the beginning of the mock file list.

Parameters

$mute : bool = false: [optional]
Set to TRUE to prevent logging.

Return values

mixed —

sendRequest()

Sends a request to Amazon via cURL


    protected
                sendRequest(string $url[, array<string|int, mixed> $param = [] ]) : array<string|int, mixed>

This method will keep trying if the request was throttled.

Parameters

$url : string: URL to feed to cURL
$param : array<string|int, mixed> = []: parameter array to feed to cURL

Return values

array<string|int, mixed> —

cURL response array

sleep()

Sleeps for the throttle time and records to the log.


    protected
                sleep() : mixed

Return values

mixed —