Skip to main content

Class: ProjectExternalStateEvent

Defined in: src/common/web/api/project/ProjectEvents.ts:85

Emitted whenever the external state of a project has been updated.

Param​

The project ID.

Param​

The user ID.

Param​

The connector instance ID.

Param​

The new project's external state.

Extends​

Constructors​

Constructor​

new ProjectExternalStateEvent(name, origin, sender, target, hops, trace, apiKey): ProjectExternalStateEvent

Defined in: src/common/web/core/messaging/Message.ts:63

Parameters​

name​

string

The name of the message.

origin​

UnitID

The initial source component of the message.

sender​

UnitID

The component from where the message came from.

target​

Channel

Where the message should go to.

hops​

UnitID[] = []

A list of components the message was sent through.

trace​

string = ...

A unique trace identifying messages that logically belong together.

apiKey​

string = ""

An optional API key to access protected resources.

Returns​

ProjectExternalStateEvent

Inherited from​

Event.constructor

Properties​

api_key​

readonly api_key: string = ""

Defined in: src/common/web/core/messaging/Message.ts:50

Inherited from​

Event.api_key

connector_instance​

readonly connector_instance: string = ""

Defined in: src/common/web/api/project/ProjectEvents.ts:88

external_state​

readonly external_state: ProjectExternalState

Defined in: src/common/web/api/project/ProjectEvents.ts:92

hops​

readonly hops: UnitID[] = []

Defined in: src/common/web/core/messaging/Message.ts:46

Inherited from​

Event.hops

name​

readonly name: string

Defined in: src/common/web/core/messaging/Message.ts:33

Inherited from​

Event.name

origin​

readonly origin: UnitID

Defined in: src/common/web/core/messaging/Message.ts:36

Inherited from​

Event.origin

payload​

readonly payload: MessagePayload

Defined in: src/common/web/core/messaging/Message.ts:52

Inherited from​

Event.payload

project_id​

readonly project_id: number = 0

Defined in: src/common/web/api/project/ProjectEvents.ts:86

sender​

readonly sender: UnitID

Defined in: src/common/web/core/messaging/Message.ts:39

Inherited from​

Event.sender

target​

readonly target: Channel

Defined in: src/common/web/core/messaging/Message.ts:42

Inherited from​

Event.target

trace​

readonly trace: string = ""

Defined in: src/common/web/core/messaging/Message.ts:48

Inherited from​

Event.trace

user_id​

readonly user_id: string = ""

Defined in: src/common/web/api/project/ProjectEvents.ts:87

Category​

readonly static Category: string = "Event"

Defined in: src/common/web/core/messaging/Event.ts:9

Inherited from​

Event.Category

Accessors​

messageCategory​

Get Signature​

get messageCategory(): string

Defined in: src/common/web/core/messaging/Event.ts:14

Gets the global message category.

Returns​

string

Inherited from​

Event.messageCategory

Methods​

convertToJSON()​

convertToJSON(): string

Defined in: src/common/web/core/messaging/Message.ts:76

Converts this message to JSON.

Returns​

string

Inherited from​

Event.convertToJSON

toString()​

toString(): string

Defined in: src/common/web/core/messaging/Message.ts:154

Gets the string representation of this message.

Returns​

string

Inherited from​

Event.toString

build()​

static build(messageBuilder, userID, projectID, connector_instance, external_state, chain): EventComposer<ProjectLogbookEvent>

Defined in: src/common/web/api/project/ProjectEvents.ts:97

Helper function to easily build this message.

Parameters​

messageBuilder​

MessageBuilder

userID​

string

projectID​

number

connector_instance​

string

external_state​

ProjectExternalState

chain​

null | Message

Returns​

EventComposer<ProjectLogbookEvent>

convertFromJSON()​

static convertFromJSON(msgType, data): Message

Defined in: src/common/web/core/messaging/Message.ts:93

Creates a message from JSON data.

Parameters​

msgType​

ConstructableMessage

The message type to construct.

data​

string

The JSON data string.

Returns​

Message

  • The created message.

Inherited from​

Event.convertFromJSON

define()​

static define(name): Function

Defined in: src/common/web/core/messaging/Message.ts:128

Defines a new message.

The decorator takes care of wrapping the new class as a dataclass, passing the correct message name to its constructor. It also registers the new message type in the global MessageTypesCatalog.

Examples:

    @Message.define("msg/command")
    class MyCommand extends Command {
        ...
    }

Parameters​

name​

string

The name of the message.

Returns​

Function

Inherited from​

Event.define

isProtected()​

static isProtected(): boolean

Defined in: src/common/web/core/messaging/Message.ts:108

The frontend never receives or issues protected messages.

Returns​

boolean

Inherited from​

Event.isProtected

messageName()​

static messageName(): string

Defined in: src/common/web/core/messaging/Message.ts:101

Retrieves the name of the message type on a message class basis.

Returns​

string

Inherited from​

Event.messageName