Package pamfax :: Package processors :: Class FaxHistory
[hide private]
[frames] | no frames]

Class FaxHistory

source code

Class encapsulating actions related to fax history for this account

Instance Methods [hide private]
 
__init__(self, api_credentials, http)
Instantiates the FaxHistory class
source code
 
add_fax_note(self, fax_uuid, note)
Add a note (free text) to the fax
source code
 
count_faxes(self, type)
Returns the number of faxes from users history with a specific state.
source code
 
delete_fax(self)
DEPRECATED! Use DeleteFaxes instead
source code
 
delete_fax_from_trash(self)
DEPRECATED! Use DeleteFaxesFromTrash instead
source code
 
delete_faxes(self, uuids, siblings_too=None)
Moves faxes to the trash.
source code
 
delete_faxes_from_trash(self, uuids)
Removes faxes from trash
source code
 
empty_trash(self)
Removes all faxes from trash for user and if user is member of a company and has delete rights also for the owners inbox faxes
source code
 
get_fax_details(self, uuid)
Returns the details of a fax in progress.
source code
 
get_fax_group(self, uuid)
Returns a fax groups details.
source code
 
get_inbox_fax(self, uuid, mark_read=None)
Returns the details of a fax in the inbox.
source code
 
get_transmission_report(self, uuid)
Get a .pdf-Version of a transmission report.
source code
 
list_fax_group(self, uuid, current_page=None, items_per_page=None)
Lists all faxes in a group (that are sent as on job).
source code
 
list_fax_notes(self, fax_uuid)
Lists all notes for the given fax in reverse order (latest first)
source code
 
list_inbox_faxes(self, current_page=None, items_per_page=None)
List all faxes in the inbox of the current user.
source code
 
list_outbox_faxes(self, current_page=None, items_per_page=None)
Faxes in the outbox that are currently in the sending process
source code
 
list_recent_faxes(self, count=None, data_to_list=None)
Returns a list of latest faxes for the user.
source code
 
list_sent_faxes(self, current_page=None, items_per_page=None)
List all sent faxes (successful or not)
source code
 
list_trash(self, current_page=None, items_per_page=None)
List all faxes in trash
source code
 
list_unpaid_faxes(self, current_page=None, items_per_page=None)
Lists all unpaid faxes that are waiting for a payment.
source code
 
restore_fax(self, uuid)
Restores a fax from the trash.
source code
 
set_fax_read(self, uuid)
Sets a fax' read date to current time.
source code
 
set_faxes_as_read(self, uuids)
Sets the read date of all the faxes to the current time
source code
 
set_spam_state_for_faxes(self, uuids, is_spam=None)
Sets the spamscore for all the faxes depending on the flag "is_spam" Takes an array of faxes UUIDs and marks them a spam if the second argument (is_spam) is true.
source code
Method Details [hide private]

add_fax_note(self, fax_uuid, note)

source code 

Add a note (free text) to the fax

Arguments: fax_uuid -- uuid of the fax note -- text to add to the fax

count_faxes(self, type)

source code 

Returns the number of faxes from users history with a specific state.

Arguments: type -- Possible values: history, inbox, inbox_unread, outbox or unpaid

delete_faxes(self, uuids, siblings_too=None)

source code 

Moves faxes to the trash.

If siblings_too is true will perform for the given faxes and all other recipients from the same fax jobs. siblings_too will only be evaluated for uuids beloging to an outgoing fax and will be ignored for incoming faxes uuids

delete_faxes_from_trash(self, uuids)

source code 

Removes faxes from trash

This method is similar to EmptyTrash() which deletes all the faxes from trash

Arguments: uuids -- ids of faxes to be removed vom trash

get_fax_details(self, uuid)

source code 

Returns the details of a fax in progress.

Arguments: uuid -- UUID of the fax to show

get_fax_group(self, uuid)

source code 

Returns a fax groups details.

Arguments: uuid -- Uuid of one of the faxes in the group.

get_inbox_fax(self, uuid, mark_read=None)

source code 

Returns the details of a fax in the inbox.

Arguments: uuid -- UUID of the fax to show mark_read -- If true marks the fax as read (default: false).

get_transmission_report(self, uuid)

source code 

Get a .pdf-Version of a transmission report.

On the transmission report basic data of the fax and a preview of the first page is shown. Should always be called with API_MODE_PASSTHRU, as the result is the pdf as binary data

Arguments: uuid -- @attribute[RequestParam('uuid','string')]

list_fax_group(self, uuid, current_page=None, items_per_page=None)

source code 

Lists all faxes in a group (that are sent as on job).

Arguments: uuid -- Uuid of one of the faxes in the group.

Keyword arguments: current_page -- The page which should be shown items_per_page -- How many items are shown per page

list_fax_notes(self, fax_uuid)

source code 

Lists all notes for the given fax in reverse order (latest first)

Arguments: fax_uuid -- uuid of the fax to list notes for

list_inbox_faxes(self, current_page=None, items_per_page=None)

source code 

List all faxes in the inbox of the current user.

Keyword arguments: current_page -- The page which should be shown items_per_page -- How many items are shown per page

list_outbox_faxes(self, current_page=None, items_per_page=None)

source code 

Faxes in the outbox that are currently in the sending process

Keyword arguments: current_page -- The page which should be shown items_per_page -- How many items are shown per page

list_recent_faxes(self, count=None, data_to_list=None)

source code 

Returns a list of latest faxes for the user.

Does not contain deleted and delayed faxes (See ListTrash for deleted faxes).

Keyword arguments: count -- The count of items to return. Valid values are between 1 and 100 data_to_list -- Any message types you want this function to return. Allowed models are 'sent', 'inbox', 'outbox'. Leave empty to get faxes of any type.

list_sent_faxes(self, current_page=None, items_per_page=None)

source code 

List all sent faxes (successful or not)

Keyword arguments: current_page -- The page which should be shown items_per_page -- How many items are shown per page

list_trash(self, current_page=None, items_per_page=None)

source code 

List all faxes in trash

Keyword arguments: current_page -- The page which should be shown items_per_page -- How many items are shown per page

list_unpaid_faxes(self, current_page=None, items_per_page=None)

source code 

Lists all unpaid faxes that are waiting for a payment.

When this user makes a transaction to add credit, these faxes will be sent automatically if they are younger that 2 hours.

Keyword arguments: current_page -- The page which should be shown items_per_page -- How many items are shown per page

restore_fax(self, uuid)

source code 

Restores a fax from the trash.

Arguments: uuid -- uuid of fax to restore

set_fax_read(self, uuid)

source code 

Sets a fax' read date to current time.

Fax needs to be a fax in the inbox.

Arguments: uuid -- uuid of fax to set as read

set_faxes_as_read(self, uuids)

source code 

Sets the read date of all the faxes to the current time

Arguments: uuids -- array of uuids for faxes to set as read

set_spam_state_for_faxes(self, uuids, is_spam=None)

source code 

Sets the spamscore for all the faxes depending on the flag "is_spam" Takes an array of faxes UUIDs and marks them a spam if the second argument (is_spam) is true. Removes the Spam state if is_spam is false. If 15 or more faxes of the same sender has been marked as spam, all incoming faxes are directly moved to the trash. This is user specific, so if user A reports 15 faxes of one sender, then only all incoming faxes from the sender to him are directly sent to the trash.