Avaya DXX-1015-01 manual ADU.FindOrCreate, ADU.ForceTerminate, ADU.ForwardEvent

Page 53

ADU.FindOrCreate

status = Vesp_Request( "ADU.FindByKey", callback, 0x2132, session, "key", "1137", &aduid );

ADU.FindOrCreate

IDL Syntax ORBStatus FindOrCreate( in SeqCouple match, in SeqCouple, oncreate, out string vdu_id) ;

Description This method searches the local server for an ADU that exactly matches all names and values in the match. It does not support wildcards. If a match is not found on the local server, it searches other ADU servers. If a match is found, it returns the id of the ADU. If multiple matches are found, the id of the most recently created ADU is returned.

If ADU.FindOrCreate does not find a match, the local server creates the ADU with the names and values from the combined list of match and oncreate. The id is then returned. This is the only case where the oncreate parameter is used.

Note: This method is intended to by used by the Avaya Toolkit. If you know the ADU needs to be created, it is recommended that you use the Create method because it is considerably faster and much more efficient.

Input Parameters

name

Search key to find ADU.

value

Value to match if name is found.

Output Parameters

aduid

Agent Data Unit Identifier.

Returns

VESP_SUCCESS

Request was successful..

VESP_ERROR

Requires values to find ADU. The match parameter may be empty.

ADU.ForceTerminate

IDL Syntax ORBStatus ADU.ForceTerminate(in string duid)

Description Forces the ADU object to be deleted from memory and from the database both, so it can no longer be used.

ADU.ForwardEvent

IDL Syntax ORBStatus ForwardEvent( in unsigned long handleis, in Event Event) ;

Issue 1.0 June 2002 53

Image 53
Contents Avaya Interaction Center Acknowledgment Contents Agent Data Unit Server Programmer’s Guide ContentsTypographical Conventions Before YOU BeginContacting Technical Support Font Type MeaningElectronic Documentation Product DocumentationReadme File Educational Services Educational ServicesIssue 1.0 June 2002 Printed DocumentationAgent Data Unit Server Programmer’s Guide Overview Start-up ProceduresChapter ADU Server ADU Server Cooperation of ADU ServersDefinition of an ADU Chapter Agent Data UnitADU Lifecycle ADU CreationAgent Data Unit Listing Active ADUsADU Termination Aduid Bytes Example Description ContentsADU Data Table 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 Following ADU fields are used by queues on Avaya IC Queue ADU FieldsContainers ContainersContainer Names and Special Tokens Limitations of Container Syntax Containername .!loginidParameter Type Default Description Container ConfigurationsADU.Update VDU.Update ADU.Create VDU.CreateEDU Values written if tscon is set to true Agent Data Unit Description Message Chapter Event MonitoringADU Event Monitoring Event Monitoring Starting and Stopping Event MonitoringMonitoring Criteria Syntax Setting Event Monitoring CriteriaSetting Event Monitoring Criteria Example ADU.Assign loginid=Joe & ts.1.s=wrapup Relational Operators Symbol Definition DescriptionWildcard Definition Example Boolean OperatorsMonitoring Criteria Wildcards Criteria Example Description Monitoring Criteria ExamplesEvent Monitoring Agent Data Unit Server Programmer’s Guide Priority Description Cause/Recommended Action Chapter AlarmsAlarms Configuration Parameters Chapter ADU Server ConfigurationSystem Considerations ADU Server Alias NameADU Server Configuration Configuration Parameters Sheet 4 Name Description Set them on the Config tab of the ADU Server Editor dialogADU 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.DeleteValues ADU.DeleteSubTreeADU.EventsIn ADU.EventsInADU.Find Locate an ADU having a key containing ADU.FindByKeyADU.ForceTerminate ADU.FindOrCreateADU.ForwardEvent ADU.FindOrCreateADU.GetOneValue ADU.GetActiveADU.GetSomeValues ADU.GetSomeValuesADU.GetSubTree ADU.GetValueHistory ADU.GetValuesADU.GetValuesHistory ADU.GetValuesHistoryFirst value that was set was truth ADU.IncrValue ADU.IncrValueADU.Monitor ADU.SetAndTerminate ADU.RemoteWatcherADU.SetAndTransfer ADU.SetDefaultHistoryFilterADU.SetAndTransfer Hsnostart Hsnochange Hsnotransfer Hsnouser Hsnodelete ADU.SetHistoryFilterADU.SetOneValue ADU.SetOneValueADU.SetValuesExtended ADU.SetValuesADU.Suspend ADU.SuspendADU.Terminate ADU.Touch ADU.TerminateMineADU.Transfer ADU.TransferADU Server Methods Agent Data Unit Server Programmer’s Guide Index SymbolsAduid IndexIssue 1.0 June 2002 Index Index Index Agent Data Unit Server Programmer’s Guide