//File: HDAISItem.idl
// Change history
// DAIS RTF 1.1	6064 2004-10-01	CORBA 3 TypeID key word collision
// DAIS RTF 1.1	6320 2004-10-01	CORBA 3 Home key word collision
// HDAIS FTF	6418 2004-09-09	Exceptions added
// HDAIS FTF	7092 2004-09-09	Userquality changed from short to long
// HDAIS FTF	7092 2004-09-09	operator renamed
#ifndef __HDAIS_ITEM_IDL
#define __HDAIS_ITEM_IDL
#include <HDAISCommon.idl>
#pragma prefix "omg.org"

module DAIS {
module HDA {
module Item {

struct Description {
	ItemID									id;
	string									label;};

typedef sequence<Description>				Descriptions;

typedef unsigned short							OPCOperator;
const OPCOperator								OPCHDA_EQUAL		=1;
const OPCOperator								OPCHDA_LESS			=2;
const OPCOperator								OPCHDA_LESSEQUAL	=3;
const OPCOperator								OPCHDA_GREATER		=4;
const OPCOperator								OPCHDA_GREATEREQUAL	=5;
const OPCOperator								OPCHDA_NOTEQUAL		=6;

struct AttributeFilter {
	AttributeID									attribute_id;
	OPCOperator									opc_operator; //7094
	SimpleValue									filter_value;
};
typedef sequence<AttributeFilter>				AttributeFilters;

interface Iterator
{
	boolean next_n (
		in	unsigned long					n,
		out	Descriptions					items);

	void reset();

	Iterator clone();

	void destroy();
};

interface IHome			//6320
{
	exception UnknownResourceID {string reason;};
	exception UnknownItemID {string reason;};
	exception InvalidFilter {string reason;};
	exception InvalidValueType {string reason;}; //6418
	exception InvalidAttribute {string reason;}; //6418
	
	Description find (
		in	ItemID							item)
		raises (UnknownItemID);
	
	Descriptions find_each(
		in	ItemIDs							items)
		raises (UnknownItemID);

	Iterator find_by_parent (
		in	ResourceID						node,
		in	string							pathname_criteria,
		in	SimpleValueType					data_type_filter,
		in	AttributeFilters				attribute_filters) //7092
		raises (UnknownResourceID,
				InvalidFilter,
				InvalidValueType, //6418
				InvalidAttribute); //6418

	Iterator find_by_type (
		in	ResourceID						node,
		in	string							pathname_criteria,
		in	SimpleValueType					data_type_filter,
		in	ResourceIDs						type_filter,		//6064
		in	AttributeFilters				attribute_filters) //7092
		raises (UnknownResourceID,
				InvalidFilter,
				InvalidValueType, //6418
				InvalidAttribute); //6418

	Strings get_pathnames ( 
		in	ItemIDs							items);

	ItemIDs get_ids (
		in	Strings							pathnames);
};
};};};
#endif // _HDAIS_ITEM_IDL