Avaya DXX-1015-01 manual ADU.DeleteSubTree, ADU.DeleteValues

Page 50

Chapter 7 ADU Server Methods

If used with a container name (“a.b”), you only delete that one name, a.b. However, the ADU Server methods are not able to address names “below” that point. Although a.b.c may still exist, the ADU Server cannot find it, even though GetSubTree on “a” still sees them. Resolving a.b.c depends on resolving a.b, which does not exist anymore. Callers should generally not delete elements from non-leaf positions.

Input Parameters

aduid

Agent Data Unit Identifier.

name

Name whose values are to be deleted from the ADU.

ADU.DeleteSubTree

IDL Syntax ORBStatus DeleteSubTree( in ADU_ID aduid, in string name) ;

Description This method does a DeleteOneValue on the given name and every name in the subcontainer beneath it, cutting a branch from the tree a container represents. If given a simple container name (“data”), it deletes the entire container.

Input Parameters

aduid

Agent Data Unit Identifier.

name

Name whose values are to be deleted from the ADU.

ADU.DeleteValues

IDL Syntax ORBStatus DeleteValues( in ADU_ID aduid, in SeqString names) ;

Description Given a list of names, this method removes from the ADU the names and their values, in effect making the ADU smaller. Values are deleted from active memory only. This method does not interact with the database.

If used with a container name (“a.b”), this method only deletes that one name, a.b. However, the ADU Server is not able to address names “below” that point. Although a.b.c may still exist, the ADU Server cannot find it, even though GetSubTree on “a” still sees them. Resolving a.b.c depends on resolving a.b, which does not exist anymore. Callers should generally not delete elements from non-leaf positions.

Input Parameters

aduid

Agent Data Unit Identifier.

names

List of names whose values are to be deleted from the ADU.

50 Agent Data Unit Server Programmer’s Guide

Image 50
Contents Avaya Interaction Center Acknowledgment Contents Contents Agent Data Unit Server Programmer’s GuideContacting Technical Support Before YOU BeginTypographical Conventions Font Type MeaningElectronic Documentation Product DocumentationReadme File Issue 1.0 June 2002 Educational ServicesEducational Services Printed DocumentationAgent Data Unit Server Programmer’s Guide Overview Start-up ProceduresChapter ADU Server Cooperation of ADU Servers ADU ServerADU Lifecycle Chapter Agent Data UnitDefinition of an ADU ADU CreationAgent Data Unit Listing Active ADUsADU Termination ADU Data Table Bytes Example Description ContentsAduid AduidADU Contents Field Name Description Set By ADU ContentsCore ADU Fields Sheet 1 Agent ADU FieldsDescription Set By Sheet 2 Sheet 3 Value Explanation Voice Data ContainersSheet 4 Queue ADU Fields Following ADU fields are used by queues on Avaya ICContainers ContainersContainer Names and Special Tokens Containername .!loginid Limitations of Container SyntaxADU.Update VDU.Update Container ConfigurationsParameter Type Default Description ADU.Create VDU.CreateEDU Values written if tscon is set to true Agent Data Unit Description Message Chapter Event MonitoringADU Event Monitoring Starting and Stopping Event Monitoring Event MonitoringMonitoring Criteria Syntax Setting Event Monitoring CriteriaSetting Event Monitoring Criteria Example ADU.Assign loginid=Joe & ts.1.s=wrapup Symbol Definition Description Relational OperatorsWildcard Definition Example Boolean OperatorsMonitoring Criteria Wildcards Monitoring Criteria Examples Criteria Example DescriptionEvent Monitoring Agent Data Unit Server Programmer’s Guide Chapter Alarms Priority Description Cause/Recommended ActionAlarms System Considerations Chapter ADU Server ConfigurationConfiguration Parameters ADU Server Alias NameADU Server Configuration Configuration Parameters Sheet 4 Set them on the Config tab of the ADU Server Editor dialog Name DescriptionADU Server Configuration Chapter IDL Specification IDL Specification Exception Information Chapter ADU Server MethodsMethod Objectives ADU Server Methods Routing RequestsMethod Overview Method Overview ADU.Create MethodsADU.Assign ADU.Deassign ADU.DeassignADU.DeleteOneValue ADU.DeleteSubTree ADU.DeleteValuesADU.EventsIn ADU.EventsInADU.Find ADU.FindByKey Locate an ADU having a key containingADU.ForwardEvent ADU.FindOrCreateADU.ForceTerminate ADU.FindOrCreateADU.GetActive ADU.GetOneValueADU.GetSomeValues ADU.GetSomeValuesADU.GetSubTree ADU.GetValues ADU.GetValueHistoryADU.GetValuesHistory ADU.GetValuesHistoryFirst value that was set was truth ADU.IncrValue ADU.IncrValueADU.Monitor ADU.RemoteWatcher ADU.SetAndTerminateADU.SetAndTransfer ADU.SetDefaultHistoryFilterADU.SetAndTransfer ADU.SetHistoryFilter Hsnostart Hsnochange Hsnotransfer Hsnouser HsnodeleteADU.SetOneValue ADU.SetOneValueADU.SetValues ADU.SetValuesExtendedADU.Suspend ADU.SuspendADU.Terminate ADU.TerminateMine ADU.TouchADU.Transfer ADU.TransferADU Server Methods Agent Data Unit Server Programmer’s Guide Symbols IndexIndex AduidIssue 1.0 June 2002 Index Index Index Agent Data Unit Server Programmer’s Guide