aes70 1.6.2 → 2.0.0

package/src/controller/ControlClasses/OcaBlock.d.ts

@@ -1,4 +1,9 @@
+import { OcaActionObjectSearchResult } from '../../types/OcaActionObjectSearchResult';
+import { IOcaActionObjectSearchResultFlags } from '../../types/OcaActionObjectSearchResultFlags';
+import { IOcaBlockConfigurability } from '../../types/OcaBlockConfigurability';
 import { OcaBlockMember } from '../../types/OcaBlockMember';
+import { IOcaConstructionParameter } from '../../types/OcaConstructionParameter';
+import { OcaDatasetSearchResult } from '../../types/OcaDatasetSearchResult';
 import { OcaGlobalTypeIdentifier } from '../../types/OcaGlobalTypeIdentifier';
 import { OcaLibVolData_ParamSet } from '../../types/OcaLibVolData_ParamSet';
 import {
@@ -6,8 +11,6 @@ import {
   OcaLibVolIdentifier,
 } from '../../types/OcaLibVolIdentifier';
 import { OcaObjectIdentification } from '../../types/OcaObjectIdentification';
-import { OcaObjectSearchResult } from '../../types/OcaObjectSearchResult';
-import { IOcaObjectSearchResultFlags } from '../../types/OcaObjectSearchResultFlags';
 import { IOcaSignalPath, OcaSignalPath } from '../../types/OcaSignalPath';
 import { IOcaStringComparisonType } from '../../types/OcaStringComparisonType';
 import { PropertyEvent } from '../property_event';
@@ -15,22 +18,41 @@ import { RemoteDevice } from '../remote_device';
 import { OcaWorker } from './OcaWorker';
 
 /**
- * A block is an object with three aspects: - It can contain other blocks. - It
- * can contain workers. - It can contain agents. - It can contain data networks.
- * - It can contain application networks. - It has a signal flow topology. We
- * refer to an object inside a block as a **member** of that block. We refer to
- * the block which contains an object as the object's **container.1** Normally,
- * a block contains a set of members that together function as a processing unit
- * -- for example, a crossover channel or mixer strip.
+ * Collection object for hierarchical structuring of Control Object populations.
+ * The term **Block **means an instance of **OcaBlock**. A Block may contain
+ * **Action Objects** and/or **Dataset Objects**, where: An Action Object is
+ * defined as one of:
+ *
+ *  - Worker object;
+ *
+ *  - Agent object;
+ *
+ *  - Network Interface object;
+ *
+ *  - Network Application object.
+ *
+ *
+ * A Dataset Object is defined an instance of **OcaDataset** or of a subclass of
+ * **OcaDataset**. The term **Block Member** (or just **Member **in context)
+ * means an object contained in a Block - either an Action Object or a Dataset
+ * Object. The Block that contains an object is termed the object's **Owner**. A
+ * Block may define a **Signal Flow** that represents internal signal flows
+ * among its Members. Typically, a Block contains a set of Members that together
+ * function as a processing unit -- for example, a crossover channel or mixer
+ * strip.
  * @extends OcaWorker
  * @class OcaBlock
  */
 export declare class OcaBlock extends OcaWorker {
   /**
-   * This event is emitted whenever Members changes.
+   * This event is emitted whenever ActionObjects changes.
    */
-  OnMembersChanged: PropertyEvent<OcaObjectIdentification[]>;
+  OnActionObjectsChanged: PropertyEvent<OcaObjectIdentification[]>;
 
+  /**
+   * An alias for OnActionObjectsChanged
+   */
+  OnMembersChanged: PropertyEvent<OcaObjectIdentification[]>;
   /**
    * This event is emitted whenever SignalPaths changes.
    */
@@ -39,16 +61,26 @@ export declare class OcaBlock extends OcaWorker {
   /**
    * This event is emitted whenever MostRecentParamSetIdentifier changes.
    */
-  OnMostRecentParamSetIdentifierChanged: PropertyEvent<OcaLibVolIdentifier>;
+  OnMostRecentParamSetIdentifierChanged: PropertyEvent<number>;
+
+  /**
+   * This event is emitted whenever DatasetObjects changes.
+   */
+  OnDatasetObjectsChanged: PropertyEvent<OcaObjectIdentification[]>;
+
+  /**
+   * This event is emitted whenever MostRecentParamDatasetONo changes.
+   */
+  OnMostRecentParamDatasetONoChanged: PropertyEvent<number>;
 
   constructor(objectNumber: number, device: RemoteDevice);
 
   /**
-   * Gets the block type. For statically-defined blocks, the block type is a
-   * Uint32 with a value corresponding to the unique configuration of this
-   * block. For dynamically-defined blocks, the block type is the object number
-   * of the block's factory. For the root block, the value of this property is
-   * 1.
+   * Gets the Block type. For statically-defined Blocks, the Block type shall be
+   * a Uint32 with a value corresponding to the unique configuration of this
+   * Block . For dynamically-defined Blocks , the Block type shall be the ONo of
+   * the Block's Factory. For the Root Block, the value of this property shall
+   * be 1. Deprecated in v3 of this class.
    *
    * @method OcaBlock#GetType
    * @returns {Promise<number>}
@@ -57,9 +89,37 @@ export declare class OcaBlock extends OcaWorker {
   GetType(): Promise<number>;
 
   /**
-   * Invokes a factory to construct an instance of the given class, then adds it
-   * to the block. The return value indicates whether the member was
-   * successfully created and added.
+   * Constructs an Action Object according to the given construction
+   * specification and adds it to the Block. Added in version 3 of this class.
+   *
+   * @method OcaBlock#ConstructActionObject
+   * @param {string} ClassID
+   * @param {IOcaConstructionParameter[]} ConstructionParameters
+   *
+   * @returns {Promise<number>}
+   *   A promise which resolves to a single value of type ``number``.
+   */
+  ConstructActionObject(
+    ClassID: string,
+    ConstructionParameters: IOcaConstructionParameter[]
+  ): Promise<number>;
+
+  /**
+   * Invokes a Block Factory (i.e. an **OcaBlockFactoryAgent** instance) to
+   * construct an instance of a Block inside this Block.
+   *
+   * @method OcaBlock#ConstructBlockUsingFactory
+   * @param {number} FactoryONo
+   *
+   * @returns {Promise<number>}
+   *   A promise which resolves to a single value of type ``number``.
+   */
+  ConstructBlockUsingFactory(FactoryONo: number): Promise<number>;
+
+  /**
+   * Invokes a Block Factory (i.e. an **OcaBlockFactoryAgent** instance) to
+   * construct an instance of a Block inside this Block.
+   * An alias for ConstructBlockUsingFactory.
    *
    * @method OcaBlock#ConstructMemberUsingFactory
    * @param {number} FactoryONo
@@ -70,9 +130,8 @@ export declare class OcaBlock extends OcaWorker {
   ConstructMemberUsingFactory(FactoryONo: number): Promise<number>;
 
   /**
-   * Removes a member from the block and destroys the object. . Deletes all
-   * signal paths attached to its ports. The return value indicates whether the
-   * member was successfully removed and destroyed.
+   * Removes a Member from the Block and destroys the object. Deletes all Signal
+   * Paths that were attached to the object's Ports.
    *
    * @method OcaBlock#DeleteMember
    * @param {number} ObjectNumber
@@ -82,10 +141,23 @@ export declare class OcaBlock extends OcaWorker {
   DeleteMember(ObjectNumber: number): Promise<void>;
 
   /**
-   * Gets the list of block members. Does not recurse inner blocks. Each inner
-   * block is included in the returned list as a single object -- its contents
-   * are not enumerated. The return value indicates whether the list was
-   * successfully retrieved.
+   * Gets the list of Action Objects in the block. Does not recurse inner
+   * Blocks. Each inner Block shall be included in the returned list as a single
+   * object -- its contents shall not be enumerated. Return data shall not list
+   * Dataset Objects. Previously named **GetMembers.**
+   *
+   * @method OcaBlock#GetActionObjects
+   * @returns {Promise<OcaObjectIdentification[]>}
+   *   A promise which resolves to a single value of type :class:`OcaObjectIdentification[]`.
+   */
+  GetActionObjects(): Promise<OcaObjectIdentification[]>;
+
+  /**
+   * Gets the list of Action Objects in the block. Does not recurse inner
+   * Blocks. Each inner Block shall be included in the returned list as a single
+   * object -- its contents shall not be enumerated. Return data shall not list
+   * Dataset Objects. Previously named **GetMembers.**
+   * An alias for GetActionObjects.
    *
    * @method OcaBlock#GetMembers
    * @returns {Promise<OcaObjectIdentification[]>}
@@ -94,10 +166,31 @@ export declare class OcaBlock extends OcaWorker {
   GetMembers(): Promise<OcaObjectIdentification[]>;
 
   /**
-   * Gets the list of block members. Recurses inner blocks. Each inner block is
-   * included in the returned list as a single object, amd its contents are
-   * enumerated. The return value indicates whether the list was successfully
-   * retrieved.
+   * Get a list of Member Descriptors (see datatype OcaBlockMember) that
+   * identify all the Action Objects in this Block and in all contained Blocks.
+   * Each contained Block shall be included in the returned list, and its
+   * contents shall be enumerated and returned in the list as well. Return data
+   * shall not list Dataset Objects. In the event that the size of the returned
+   * list exceeds the implementation limit, this method shall return the
+   * **OcaStatus** value **BufferOverflow**. Previously named
+   * **GetMembersRecursive.**
+   *
+   * @method OcaBlock#GetActionObjectsRecursive
+   * @returns {Promise<OcaBlockMember[]>}
+   *   A promise which resolves to a single value of type :class:`OcaBlockMember[]`.
+   */
+  GetActionObjectsRecursive(): Promise<OcaBlockMember[]>;
+
+  /**
+   * Get a list of Member Descriptors (see datatype OcaBlockMember) that
+   * identify all the Action Objects in this Block and in all contained Blocks.
+   * Each contained Block shall be included in the returned list, and its
+   * contents shall be enumerated and returned in the list as well. Return data
+   * shall not list Dataset Objects. In the event that the size of the returned
+   * list exceeds the implementation limit, this method shall return the
+   * **OcaStatus** value **BufferOverflow**. Previously named
+   * **GetMembersRecursive.**
+   * An alias for GetActionObjectsRecursive.
    *
    * @method OcaBlock#GetMembersRecursive
    * @returns {Promise<OcaBlockMember[]>}
@@ -106,8 +199,7 @@ export declare class OcaBlock extends OcaWorker {
   GetMembersRecursive(): Promise<OcaBlockMember[]>;
 
   /**
-   * Adds a signal path to the block. The return value indicates whether the
-   * signal path was successfully added.
+   * Adds a Signal Path to the Block.
    *
    * @method OcaBlock#AddSignalPath
    * @param {IOcaSignalPath} Path
@@ -118,8 +210,7 @@ export declare class OcaBlock extends OcaWorker {
   AddSignalPath(Path: IOcaSignalPath): Promise<number>;
 
   /**
-   * Deletes a signal path from the block. The return value indicates whether
-   * the signal path was successfully added.
+   * Deletes a Signal Path from the block.
    *
    * @method OcaBlock#DeleteSignalPath
    * @param {number} Index
@@ -129,8 +220,7 @@ export declare class OcaBlock extends OcaWorker {
   DeleteSignalPath(Index: number): Promise<void>;
 
   /**
-   * Gets the map of signal paths in the block. Does not recurse inner blocks.
-   * The return value indicates whether the list was successfully retrieved.
+   * Gets the map of Signal Paths in the Block. Does not recurse inner Blocks.
    *
    * @method OcaBlock#GetSignalPaths
    * @returns {Promise<Map<number, OcaSignalPath>>}
@@ -139,8 +229,9 @@ export declare class OcaBlock extends OcaWorker {
   GetSignalPaths(): Promise<Map<number, OcaSignalPath>>;
 
   /**
-   * Gets the mapof signal paths in the block. Recurses inner blocks. The return
-   * value indicates whether the list was successfully retrieved.
+   * Gets the map of Signal Paths in the Block and all inner Blocks. In the
+   * event that the size of the returned data exceeds the implementation limit,
+   * this method shall return the **OcaStatus** value **BufferOverflow**.
    *
    * @method OcaBlock#GetSignalPathsRecursive
    * @returns {Promise<Map<number, OcaSignalPath>>}
@@ -149,7 +240,8 @@ export declare class OcaBlock extends OcaWorker {
   GetSignalPathsRecursive(): Promise<Map<number, OcaSignalPath>>;
 
   /**
-   * Gets the identifier of the paramset most recently applied to this block.
+   * Gets the identifier of the ParamSet most recently applied to this Block.
+   * **Deprecated** in v3 of this class.
    *
    * @method OcaBlock#GetMostRecentParamSetIdentifier
    * @returns {Promise<OcaLibVolIdentifier>}
@@ -158,9 +250,10 @@ export declare class OcaBlock extends OcaWorker {
   GetMostRecentParamSetIdentifier(): Promise<OcaLibVolIdentifier>;
 
   /**
-   * Applies the referenced paramset to this block, and sets the
-   * MostRecentParamSet property. The return value indicates whether the
-   * paramset was successfully applied.
+   * Applies the referenced ParamSet to this block, and sets the
+   * **MostRecentParamSetIdentifier** property. **Deprecated** in v3 of this
+   * class (OCA 1.5)** -** controllers should use the new **OcaDataset** method
+   * of storing ParamSets,
    *
    * @method OcaBlock#ApplyParamSet
    * @returns {Promise<OcaLibVolIdentifier>}
@@ -169,8 +262,11 @@ export declare class OcaBlock extends OcaWorker {
   ApplyParamSet(): Promise<OcaLibVolIdentifier>;
 
   /**
-   * Returns a paramset library volume data block which represents the current
-   * state of the block -- i.e. a "snapshot".
+   * Returns a ParamSet library volume data block which represents the current
+   * state of the block -- i.e. a "snapshot". **Deprecated** in v3 of this class
+   * (OCA 1.5)** -** controllers should use the new **OcaDataset** method of
+   * storing ParamSet, and use normal **OcaDataset** reading procedures for
+   * retrieving ParamSets.
    *
    * @method OcaBlock#GetCurrentParamSetData
    * @returns {Promise<OcaLibVolData_ParamSet>}
@@ -179,24 +275,23 @@ export declare class OcaBlock extends OcaWorker {
   GetCurrentParamSetData(): Promise<OcaLibVolData_ParamSet>;
 
   /**
-   * Stores a paramset library volume data block which represents the current
-   * state of the block ("snapshot") in the given library. **Replaces** the
-   * library volume at the specified LibVolIdentifier.
+   * Stores a ParamSet library volume data block which represents the current
+   * state of the block. **Deprecated** in v3 of this class (OCA 1.5)** -**
+   * controllers should use the new **OcaDataset** method of storing ParamSets.
+   * If using the (current) OcaDataset mechanism, the dataset identified must
+   * have been created prior to calling this method.
    *
    * @method OcaBlock#StoreCurrentParamSetData
-   * @param {IOcaLibVolIdentifier} LibVolIdentifier
+   * @param {IOcaLibVolIdentifier} Identifier
    *
    * @returns {Promise<void>}
    */
-  StoreCurrentParamSetData(
-    LibVolIdentifier: IOcaLibVolIdentifier
-  ): Promise<void>;
+  StoreCurrentParamSetData(Identifier: IOcaLibVolIdentifier): Promise<void>;
 
   /**
-   * Gets the global blocktype. The return value indicates whether the type was
-   * successfully retrieved. If this block has no global blocktype, the
-   * **Authority** field of the returned **GlobalType** parameter will be zero.
-   * **Added in version 2 of this class.**
+   * Gets the Global Blocktype. If this Block has no Global Blocktype, the
+   * **Authority** field of the returned **GlobalType** parameter shall be zero.
+   * Added in version 2 of this class.
    *
    * @method OcaBlock#GetGlobalType
    * @returns {Promise<OcaGlobalTypeIdentifier>}
@@ -205,8 +300,7 @@ export declare class OcaBlock extends OcaWorker {
   GetGlobalType(): Promise<OcaGlobalTypeIdentifier>;
 
   /**
-   * Gets the block's ONo map. The return value indicates whether the map was
-   * successfully retrieved. **Added in version 2 of this class.**
+   * Gets the Block's ONo map. Added in version 2 of this class.
    *
    * @method OcaBlock#GetONoMap
    * @returns {Promise<Map<number, number>>}
@@ -215,81 +309,353 @@ export declare class OcaBlock extends OcaWorker {
   GetONoMap(): Promise<Map<number, number>>;
 
   /**
-   * Returns object identifications of all objects in the block that match the
-   * given Role search string and Class ID. Return value indicates whether the
-   * method succeeded. **Added in version 2 of this class.**
+   * Returns object identifications of all Action Objects in the Block that
+   * match the given Role search string and Class ID. Return data shall not list
+   * Dataset Objects. Replaces deprecated method **FindMembersByRole**.
+   *
+   * @method OcaBlock#FindActionObjectsByRole
+   * @param {string} SearchName
+   * @param {IOcaStringComparisonType} NameComparisonType
+   * @param {string} SearchClassID
+   * @param {IOcaActionObjectSearchResultFlags} ResultFlags
+   *
+   * @returns {Promise<OcaActionObjectSearchResult[]>}
+   *   A promise which resolves to a single value of type :class:`OcaActionObjectSearchResult[]`.
+   */
+  FindActionObjectsByRole(
+    SearchName: string,
+    NameComparisonType: IOcaStringComparisonType,
+    SearchClassID: string,
+    ResultFlags: IOcaActionObjectSearchResultFlags
+  ): Promise<OcaActionObjectSearchResult[]>;
+
+  /**
+   * Returns object identifications of all Action Objects in the Block that
+   * match the given Role search string and Class ID. Return data shall not list
+   * Dataset Objects. Replaces deprecated method **FindMembersByRole**.
+   * An alias for FindActionObjectsByRole.
    *
    * @method OcaBlock#FindObjectsByRole
    * @param {string} SearchName
    * @param {IOcaStringComparisonType} NameComparisonType
    * @param {string} SearchClassID
-   * @param {IOcaObjectSearchResultFlags} ResultFlags
+   * @param {IOcaActionObjectSearchResultFlags} ResultFlags
    *
-   * @returns {Promise<OcaObjectSearchResult[]>}
-   *   A promise which resolves to a single value of type :class:`OcaObjectSearchResult[]`.
+   * @returns {Promise<OcaActionObjectSearchResult[]>}
+   *   A promise which resolves to a single value of type :class:`OcaActionObjectSearchResult[]`.
    */
   FindObjectsByRole(
     SearchName: string,
     NameComparisonType: IOcaStringComparisonType,
     SearchClassID: string,
-    ResultFlags: IOcaObjectSearchResultFlags
-  ): Promise<OcaObjectSearchResult[]>;
+    ResultFlags: IOcaActionObjectSearchResultFlags
+  ): Promise<OcaActionObjectSearchResult[]>;
+
+  /**
+   * Returns descriptors of all Action Objects that match the given Role search
+   * string and Class ID. Searches this Block and all contained Blocks. Return
+   * data shall not list Dataset Objects. In the event that the size of the
+   * returned data exceeds the implementation limit, this method shall return
+   * the **OcaStatus** value **BufferOverflow**.
+   *
+   * @method OcaBlock#FindActionObjectsByRoleRecursive
+   * @param {string} SearchName
+   * @param {IOcaStringComparisonType} NameComparisonType
+   * @param {string} SearchClassID
+   * @param {IOcaActionObjectSearchResultFlags} ResultFlags
+   *
+   * @returns {Promise<OcaActionObjectSearchResult[]>}
+   *   A promise which resolves to a single value of type :class:`OcaActionObjectSearchResult[]`.
+   */
+  FindActionObjectsByRoleRecursive(
+    SearchName: string,
+    NameComparisonType: IOcaStringComparisonType,
+    SearchClassID: string,
+    ResultFlags: IOcaActionObjectSearchResultFlags
+  ): Promise<OcaActionObjectSearchResult[]>;
 
   /**
-   * Returns block member descriptors of all objects in the block and all
-   * contained blocks that match the given Role search string and Class ID.
-   * **Added in version 2 of this class.**
+   * Returns descriptors of all Action Objects that match the given Role search
+   * string and Class ID. Searches this Block and all contained Blocks. Return
+   * data shall not list Dataset Objects. In the event that the size of the
+   * returned data exceeds the implementation limit, this method shall return
+   * the **OcaStatus** value **BufferOverflow**.
+   * An alias for FindActionObjectsByRoleRecursive.
    *
    * @method OcaBlock#FindObjectsByRoleRecursive
    * @param {string} SearchName
    * @param {IOcaStringComparisonType} NameComparisonType
    * @param {string} SearchClassID
-   * @param {IOcaObjectSearchResultFlags} ResultFlags
+   * @param {IOcaActionObjectSearchResultFlags} ResultFlags
    *
-   * @returns {Promise<OcaObjectSearchResult[]>}
-   *   A promise which resolves to a single value of type :class:`OcaObjectSearchResult[]`.
+   * @returns {Promise<OcaActionObjectSearchResult[]>}
+   *   A promise which resolves to a single value of type :class:`OcaActionObjectSearchResult[]`.
    */
   FindObjectsByRoleRecursive(
     SearchName: string,
     NameComparisonType: IOcaStringComparisonType,
     SearchClassID: string,
-    ResultFlags: IOcaObjectSearchResultFlags
-  ): Promise<OcaObjectSearchResult[]>;
+    ResultFlags: IOcaActionObjectSearchResultFlags
+  ): Promise<OcaActionObjectSearchResult[]>;
 
   /**
-   * Returns block member descriptors of all objects in the block and all
-   * contained blocks that match the given Label search string and Class ID.
-   * **Added in version 2 of this class.**
+   * Returns descriptors of all Action Objects that match the given Label search
+   * string and Class ID. Searches this Block and all contained Blocks. Return
+   * data shall not list Dataset Objects. In the event that the size of the
+   * returned data exceeds the implementation limit, this method shall return
+   * the **OcaStatus** value **BufferOverflow**.
+   *
+   * @method OcaBlock#FindActionObjectsByLabelRecursive
+   * @param {string} SearchName
+   * @param {IOcaStringComparisonType} NameComparisonType
+   * @param {string} SearchClassID
+   * @param {IOcaActionObjectSearchResultFlags} ResultFlags
+   *
+   * @returns {Promise<OcaActionObjectSearchResult[]>}
+   *   A promise which resolves to a single value of type :class:`OcaActionObjectSearchResult[]`.
+   */
+  FindActionObjectsByLabelRecursive(
+    SearchName: string,
+    NameComparisonType: IOcaStringComparisonType,
+    SearchClassID: string,
+    ResultFlags: IOcaActionObjectSearchResultFlags
+  ): Promise<OcaActionObjectSearchResult[]>;
+
+  /**
+   * Returns descriptors of all Action Objects that match the given Label search
+   * string and Class ID. Searches this Block and all contained Blocks. Return
+   * data shall not list Dataset Objects. In the event that the size of the
+   * returned data exceeds the implementation limit, this method shall return
+   * the **OcaStatus** value **BufferOverflow**.
+   * An alias for FindActionObjectsByLabelRecursive.
    *
    * @method OcaBlock#FindObjectsByLabelRecursive
    * @param {string} SearchName
    * @param {IOcaStringComparisonType} NameComparisonType
    * @param {string} SearchClassID
-   * @param {IOcaObjectSearchResultFlags} ResultFlags
+   * @param {IOcaActionObjectSearchResultFlags} ResultFlags
    *
-   * @returns {Promise<OcaObjectSearchResult[]>}
-   *   A promise which resolves to a single value of type :class:`OcaObjectSearchResult[]`.
+   * @returns {Promise<OcaActionObjectSearchResult[]>}
+   *   A promise which resolves to a single value of type :class:`OcaActionObjectSearchResult[]`.
    */
   FindObjectsByLabelRecursive(
     SearchName: string,
     NameComparisonType: IOcaStringComparisonType,
     SearchClassID: string,
-    ResultFlags: IOcaObjectSearchResultFlags
-  ): Promise<OcaObjectSearchResult[]>;
+    ResultFlags: IOcaActionObjectSearchResultFlags
+  ): Promise<OcaActionObjectSearchResult[]>;
+
+  /**
+   * Returns descriptors of all Action Objects with the given Role Path. Return
+   * data shall not list Dataset Objects.
+   *
+   * @method OcaBlock#FindActionObjectsByRolePath
+   * @param {string[]} SearchPath
+   * @param {IOcaActionObjectSearchResultFlags} ResultFlags
+   *
+   * @returns {Promise<OcaActionObjectSearchResult[]>}
+   *   A promise which resolves to a single value of type :class:`OcaActionObjectSearchResult[]`.
+   */
+  FindActionObjectsByRolePath(
+    SearchPath: string[],
+    ResultFlags: IOcaActionObjectSearchResultFlags
+  ): Promise<OcaActionObjectSearchResult[]>;
 
   /**
-   * Returns object identifications of all objects with the given name path.
-   * **Added in version 2 of this class.**
+   * Returns descriptors of all Action Objects with the given Role Path. Return
+   * data shall not list Dataset Objects.
+   * An alias for FindActionObjectsByRolePath.
    *
    * @method OcaBlock#FindObjectsByPath
    * @param {string[]} SearchPath
-   * @param {IOcaObjectSearchResultFlags} ResultFlags
+   * @param {IOcaActionObjectSearchResultFlags} ResultFlags
    *
-   * @returns {Promise<OcaObjectSearchResult[]>}
-   *   A promise which resolves to a single value of type :class:`OcaObjectSearchResult[]`.
+   * @returns {Promise<OcaActionObjectSearchResult[]>}
+   *   A promise which resolves to a single value of type :class:`OcaActionObjectSearchResult[]`.
    */
   FindObjectsByPath(
     SearchPath: string[],
-    ResultFlags: IOcaObjectSearchResultFlags
-  ): Promise<OcaObjectSearchResult[]>;
+    ResultFlags: IOcaActionObjectSearchResultFlags
+  ): Promise<OcaActionObjectSearchResult[]>;
+
+  /**
+   * Gets the Block's Configurability.
+   *
+   * @method OcaBlock#GetConfigurability
+   * @returns {Promise<IOcaBlockConfigurability>}
+   *   A promise which resolves to a single value of type ``IOcaBlockConfigurability``.
+   */
+  GetConfigurability(): Promise<IOcaBlockConfigurability>;
+
+  /**
+   * Gets the ONo of the paramDataset most recently applied to this Block.
+   *
+   * @method OcaBlock#GetMostRecentParamDatasetONo
+   * @returns {Promise<number>}
+   *   A promise which resolves to a single value of type ``number``.
+   */
+  GetMostRecentParamDatasetONo(): Promise<number>;
+
+  /**
+   * Applies the**** ParamDataset with the given ONo to this block, and sets the
+   * **MostRecentParamDatasetONo** property.
+   *
+   * @method OcaBlock#ApplyParamDataset
+   * @param {number} ONo
+   *
+   * @returns {Promise<void>}
+   */
+  ApplyParamDataset(ONo: number): Promise<void>;
+
+  /**
+   * Stores current parameter values of this Block in the Dataset Object
+   * identified by the ONo parameter. The Dataset Object must exist - this
+   * method shall not create it.
+   *
+   * @method OcaBlock#StoreCurrentParameterData
+   * @param {number} ONo
+   *
+   * @returns {Promise<void>}
+   */
+  StoreCurrentParameterData(ONo: number): Promise<void>;
+
+  /**
+   * Returns current parameter values of this Block to the Controller in a
+   * single **OcaBlob**. Format of the parameter data shall be
+   * implementation-specific and not defined in this standard.
+   *
+   * @method OcaBlock#FetchCurrentParameterData
+   * @returns {Promise<Uint8Array>}
+   *   A promise which resolves to a single value of type ``Uint8Array``.
+   */
+  FetchCurrentParameterData(): Promise<Uint8Array>;
+
+  /**
+   * Applies the supplied parameter data to the Block. Format of the parameter
+   * data shall be implementation-specific and not defined in this standard. The
+   * implementation may elect to save the supplied data in a ParamDataset. If
+   * so, this method shall set the **MostRecentParamDatasetONo** property to the
+   * object number of this ParamDataset. If not, this method shall set
+   * **MostRecentParamDatasetONo** to zero.
+   *
+   * @method OcaBlock#ApplyParameterData
+   * @returns {Promise<Uint8Array>}
+   *   A promise which resolves to a single value of type ``Uint8Array``.
+   */
+  ApplyParameterData(): Promise<Uint8Array>;
+
+  /**
+   * Constructs a Dataset and its Dataset Object.
+   *
+   * @method OcaBlock#ConstructDataset
+   * @param {string} ClassID
+   * @param {string} Name
+   * @param {string} Type
+   * @param {number|BigInt} MaxSize
+   * @param {Uint8Array} InitialContents
+   *
+   * @returns {Promise<number>}
+   *   A promise which resolves to a single value of type ``number``.
+   */
+  ConstructDataset(
+    ClassID: string,
+    Name: string,
+    Type: string,
+    MaxSize: number | BigInt,
+    InitialContents: Uint8Array
+  ): Promise<number>;
+
+  /**
+   * Duplicates a Dataset and its Dataset Object.
+   *
+   * @method OcaBlock#DuplicateDataset
+   * @param {number} OldONo
+   * @param {number} TargetBlockONo
+   * @param {string} NewName
+   * @param {number|BigInt} NewMaxSize
+   *
+   * @returns {Promise<number>}
+   *   A promise which resolves to a single value of type ``number``.
+   */
+  DuplicateDataset(
+    OldONo: number,
+    TargetBlockONo: number,
+    NewName: string,
+    NewMaxSize: number | BigInt
+  ): Promise<number>;
+
+  /**
+   * Returns identifiers of Dataset Objects in the Block. Shall not recurse
+   * inner Blocks. Return data shall not list Action Objects.
+   *
+   * @method OcaBlock#GetDatasetObjects
+   * @returns {Promise<OcaObjectIdentification[]>}
+   *   A promise which resolves to a single value of type :class:`OcaObjectIdentification[]`.
+   */
+  GetDatasetObjects(): Promise<OcaObjectIdentification[]>;
+
+  /**
+   * Returns descriptors of Dataset Objects in the Block and in contained
+   * Blocks. Return data shall not list Action Objects. In the event that the
+   * size of the returned data exceeds the implementation limit, this method
+   * shall return the **OcaStatus** value **BufferOverflow**.
+   *
+   * @method OcaBlock#GetDatasetObjectsRecursive
+   * @returns {Promise<OcaBlockMember[]>}
+   *   A promise which resolves to a single value of type :class:`OcaBlockMember[]`.
+   */
+  GetDatasetObjectsRecursive(): Promise<OcaBlockMember[]>;
+
+  /**
+   * Returns descriptors of all Datasets in the block that match the given
+   * search terms. Note: If substring comparison type is selected, null search
+   * terms match anything. Return data shall not list Action Objects.
+   *
+   * @method OcaBlock#FindDatasets
+   * @param {string} Name
+   * @param {IOcaStringComparisonType} NameComparisonType
+   * @param {string} Type
+   * @param {IOcaStringComparisonType} TypeComparisonType
+   *
+   * @returns {Promise<OcaDatasetSearchResult[]>}
+   *   A promise which resolves to a single value of type :class:`OcaDatasetSearchResult[]`.
+   */
+  FindDatasets(
+    Name: string,
+    NameComparisonType: IOcaStringComparisonType,
+    Type: string,
+    TypeComparisonType: IOcaStringComparisonType
+  ): Promise<OcaDatasetSearchResult[]>;
+
+  /**
+   * Returns descriptors of all Datasets in this Block and all contained Blocks
+   * that match the given search terms. Note: If substring comparison type is
+   * selected, null search terms match anything. In the event that the size of
+   * the returned list exceeds the implementation limit, this method shall
+   * return the **OcaStatus** value **BufferOverflow**.
+   *
+   * @method OcaBlock#FindDatasetsRecursive
+   * @param {string} Name
+   * @param {IOcaStringComparisonType} NameComparisonType
+   * @param {string} Type
+   * @param {IOcaStringComparisonType} TypeComparisonType
+   *
+   * @returns {Promise<OcaDatasetSearchResult[]>}
+   *   A promise which resolves to a single value of type :class:`OcaDatasetSearchResult[]`.
+   */
+  FindDatasetsRecursive(
+    Name: string,
+    NameComparisonType: IOcaStringComparisonType,
+    Type: string,
+    TypeComparisonType: IOcaStringComparisonType
+  ): Promise<OcaDatasetSearchResult[]>;
+
+  /**
+   * Gets the value of property **BlockFactoryONo**
+   *
+   * @method OcaBlock#GetBlockFactoryONo
+   * @returns {Promise<number>}
+   *   A promise which resolves to a single value of type ``number``.
+   */
+  GetBlockFactoryONo(): Promise<number>;
 }