ChannelDispatcher.I.OperationList — Telepathy D-Bus Interface Specification

# Interface ChannelDispatcher.Interface.OperationList

Interface Index (Compact) | Summary | Description | Signals | Properties | Types

### Signals

NewDispatchOperation | (o: Dispatch_Operation, a{sv}: Properties) |
DispatchOperationFinished | (o: Dispatch_Operation) |

### Properties

DispatchOperations | a(oa{sv}) (Dispatch_Operation_Details_List) | Read only |  |

### Types

Dispatch_Operation_Details | Struct | (oa{sv}) |

Added in 0.17.26. (as a stable interface)
Objects implementing this interface must also implement:

- org.freedesktop.Telepathy.ChannelDispatcher

### Description

This interface allows users of the ChannelDispatcher to enumerate all the pending dispatch operations, with change notification.

##### Rationale:

The existence of the DispatchOperations property allows a newly started approver to pick up existing dispatch operations.

This is on a separate interface so clients that aren't interested in doing this aren't woken up by its signals.

# Signals

(Permalink)

## NewDispatchOperation (o: Dispatch_Operation, a{sv}: Properties)

### Parameters

- Dispatch_Operation — o
The dispatch operation that was created.
- Properties — a{sv} (Qualified_Property_Value_Map)
The same properties that would appear in the Properties member of Dispatch_Operation_Details.

Emitted when a dispatch operation is added to DispatchOperations.

(Permalink)

## DispatchOperationFinished (o: Dispatch_Operation)

### Parameters

- Dispatch_Operation — o
The dispatch operation that was closed.

Emitted when a dispatch operation finishes (i.e. exactly once per emission of ChannelDispatchOperation.Finished).

##### Rationale:

Strictly speaking this is redundant with ChannelDispatchOperation.Finished, but it provides full change-notification for the DispatchOperations property.

# Properties

Accessed using the org.freedesktop.DBus.Properties interface.
(Permalink)

## DispatchOperations — a(oa{sv}) (Dispatch_Operation_Details_List)

Read only

The list of ChannelDispatchOperation objects currently being processed. Change notification is via the NewDispatchOperation and DispatchOperationFinished signals.

# Types

Struct (Permalink)

## Dispatch_Operation_Details — (oa{sv})

Details of a channel dispatch operation.

- Channel_Dispatch_Operation — o
The object path of the ChannelDispatchOperation.
- Properties — a{sv} (Qualified_Property_Value_Map)

Properties of the channel dispatch operation.

Connection managers MUST NOT include properties in this mapping if their values can change. Clients MUST ignore properties that appear in this mapping if their values can change.

##### Rationale:

The rationale is the same as for Channel_Details.

Each dictionary MUST contain at least the following keys:

- org.freedesktop.Telepathy.ChannelDispatchOperation.Interfaces
- org.freedesktop.Telepathy.ChannelDispatchOperation.Connection
- org.freedesktop.Telepathy.ChannelDispatchOperation.Account
- org.freedesktop.Telepathy.ChannelDispatchOperation.PossibleHandlers