EDAApplyUpdateFailed

Overview

The EDAApplyUpdateFailed class represents exceptions that were raised while applying updates on the server.

For example, consider the ProcessDelta function of the TDABusinessProcessor class:

procedure TDABusinessProcessor.ProcessDelta(const aConnection: IDAConnection;
  const aDelta: IDADelta;
  ChangeTypes: TDAChangeTypes = AllChanges;
  ADeltaStruct : TDADeltaStruct = nil);
var
  change: TDADeltaChange;
  canremove: boolean;
  currcmd, inscmd, delcmd, updcmd, updcmd_AutoInc: IDASQLCommand;
  ...
begin
try
  //Applying updates on the server
  ...
except
  on E: Exception do begin
    change.Status := csFailed;
    change.Message := E.Message;
    canremove := FALSE;
    if ... then ...
    else if FRaiseExceptionAtError then begin
      //FRaiseExceptionAtError: boolean 
      raise EDAApplyUpdateFailed.Create(change, E);
    end;
  end;

This function raises the exception with the EDAApplyUpdateFailed class, if the exception was raised while applying updates on the server and if the flag FRaiseExceptionAtError is true.

Location

Unit: uDADelta.pas
Ancestry: Exception | EROException | EDAException | EDAApplyUpdateFailed

constructor Create

Creates a new EDAApplyUpdateFailed object with the specified failed update record and the original exception object that contains information about the exception.

constructor Create(aChange: TDADeltaChange; anOriginalException: Exception)

Parameters:

aChange: Specified failed update record.
anOriginalException: Original exception object that contains information about the exception.

Assign virtual (declared in EROException)

Copies data from a given source.

procedure Assign(Source: EROException)

Parameters:

Source:

Clone (declared in EROException)

function Clone: EROException

DeltaName

Published property that defines the name of the logical entity that is associated with the specified failed update record (TDADeltaChange object).

property DeltaName: string read write

GetAttributeCount virtual (declared in EROException)

Returns the number of custom attributes defined for the class. The code generator always overrides this method to return actual data for the certain class.

This method is for internal use for SOAP processing.

class function GetAttributeCount: Integer

GetAttributeName virtual (declared in EROException)

Returns the name of custom attribute defined for the class, with the specified index. The code generator always overrides this method to return actual data for the certain class.

This method is for internal use for SOAP processing.

class function GetAttributeName(aIndex: Integer): string

Parameters:

aIndex: The index of attribute.

GetAttributeValue virtual (declared in EROException)

Returns the value of custom attribute defined for the class, with the specified index. The code generator always overrides this method to return actual data for the certain class.

This method is for internal use for SOAP processing.

class function GetAttributeValue(aIndex: Integer): string

Parameters:

aIndex: The index of attribute.

ReadException virtual (declared in EROException)

Deserializes the exception instance from the serializer object. The code generator always overrides this method. The method is called intenally, users have no need to call it.

procedure ReadException(aSerializer: TROBaseSerializer)

Parameters:

aSerializer: The serializer object containing the exception to read.

RecID

Published property that contains the record ID that is associated with the specified failed update record.

property RecID: Integer read write

TryGetAttribute (declared in EROException)

class function TryGetAttribute(aName: string; out aValue: string): Boolean

Parameters:

aName:
aValue:

WriteException virtual (declared in EROException)

Deserializes the exception instance from the serializer object. The code generator always overrides this method. The method is called intenally, users have no need to call it.

procedure WriteException(aSerializer: TROBaseSerializer)

Parameters:

aSerializer: The serializer object containing the exception to read.

DeltaName

Published property that defines the name of the logical entity that is associated with the specified failed update record (TDADeltaChange object).

property DeltaName: string read write

RecID

Published property that contains the record ID that is associated with the specified failed update record.

property RecID: Integer read write

GetAttributeCount virtual (declared in EROException)

Returns the number of custom attributes defined for the class. The code generator always overrides this method to return actual data for the certain class.

This method is for internal use for SOAP processing.

class function GetAttributeCount: Integer

GetAttributeName virtual (declared in EROException)

Returns the name of custom attribute defined for the class, with the specified index. The code generator always overrides this method to return actual data for the certain class.

This method is for internal use for SOAP processing.

class function GetAttributeName(aIndex: Integer): string

Parameters:

aIndex: The index of attribute.

GetAttributeValue virtual (declared in EROException)

Returns the value of custom attribute defined for the class, with the specified index. The code generator always overrides this method to return actual data for the certain class.

This method is for internal use for SOAP processing.

class function GetAttributeValue(aIndex: Integer): string

Parameters:

aIndex: The index of attribute.

TryGetAttribute (declared in EROException)

class function TryGetAttribute(aName: string; out aValue: string): Boolean

Parameters:

aName:
aValue:

constructor Create

Creates a new EDAApplyUpdateFailed object with the specified failed update record and the original exception object that contains information about the exception.

constructor Create(aChange: TDADeltaChange; anOriginalException: Exception)

Parameters:

aChange: Specified failed update record.
anOriginalException: Original exception object that contains information about the exception.

Assign virtual (declared in EROException)

Copies data from a given source.

procedure Assign(Source: EROException)

Parameters:

Source:

Clone (declared in EROException)

function Clone: EROException

ReadException virtual (declared in EROException)

Deserializes the exception instance from the serializer object. The code generator always overrides this method. The method is called intenally, users have no need to call it.

procedure ReadException(aSerializer: TROBaseSerializer)

Parameters:

aSerializer: The serializer object containing the exception to read.

WriteException virtual (declared in EROException)

Deserializes the exception instance from the serializer object. The code generator always overrides this method. The method is called intenally, users have no need to call it.

procedure WriteException(aSerializer: TROBaseSerializer)

Parameters:

aSerializer: The serializer object containing the exception to read.

Delta