//File: DAISItem.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
// DAIS RTF 1.1	7078 2004-09-09	Improved error reporting
#ifndef _DAIS_ITEM_IDL
#define _DAIS_ITEM_IDL
#pragma prefix "omg.org"
#include <DAISCommon.idl>

module DAIS {
module DataAccess {
module Item {

struct Description 
{
	ItemID									id;
	string									label;
	SimpleValue								value;  //includes the canonical_data_type
	Quality									dais_quality;
	DateTime								time_stamp;
	AccessRights							access_rights;
	unsigned long							scan_rate;
};
typedef sequence< Description >				Descriptions;

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;}; //7078
	exception UnkownTypeID {string reason;}; //7078
	exception InvalidAccessRight {string reason;}; //7078

	
	Description find (
		in	ItemID							item
	) raises (UnknownItemID);
	
	Descriptions find_each(
		in	ItemIDs							items
	) raises (UnknownItemID);

	Iterator find_by_parent (
		in	ResourceID						node, 
		in	string							filter_criteria,  
		in	SimpleValueType					data_type_filter,     
		in	AccessRights					access_rights_filter
	) raises (UnknownResourceID,
				InvalidFilter,
				InvalidValueType, //7078
				InvalidAccessRight); //7078

	Iterator find_by_type (
		in	ResourceID						node,
		in	ResourceIDs						type_filter,		//6064
		in	string							filter_criteria,  
		in	SimpleValueType					data_type_filter,     
		in	AccessRights					access_rights_filter
	) raises (UnknownResourceID,
				InvalidFilter,
				InvalidValueType, //7078
				UnkownTypeID,  //7078
				InvalidAccessRight); //7078

	Strings get_pathnames ( 
		in	ItemIDs							items
	);

	ItemIDs get_ids (
		in	Strings							pathnames
	);
	
	Strings get_access_paths (
		in	ItemID							item
	) raises (UnknownItemID);
};};};};
#endif // _DAIS_ITEM_IDL