feat(cli): add enable/disable condition commands (H4 client path)
This commit is contained in:
@@ -135,6 +135,32 @@ public interface IOpcUaClientService : IDisposable
|
||||
/// </returns>
|
||||
Task<StatusCode> ShelveAlarmAsync(string conditionNodeId, ShelveKind kind, double shelvingTimeSeconds = 0, CancellationToken ct = default);
|
||||
|
||||
/// <summary>
|
||||
/// Enables an alarm condition by invoking the OPC UA Part 9 ConditionType <c>Enable</c> method
|
||||
/// (the H4 client-driven path). The method takes no input arguments.
|
||||
/// </summary>
|
||||
/// <param name="conditionNodeId">The condition node associated with the alarm being enabled.</param>
|
||||
/// <param name="ct">The cancellation token that aborts the enable request.</param>
|
||||
/// <returns>
|
||||
/// <see cref="StatusCodes.Good"/> on success, or the server's bad <see cref="StatusCode"/>
|
||||
/// (from the underlying <see cref="ServiceResultException"/>) when the enable call
|
||||
/// returns a bad result. Other transport-level failures still surface as exceptions.
|
||||
/// </returns>
|
||||
Task<StatusCode> EnableAsync(string conditionNodeId, CancellationToken ct = default);
|
||||
|
||||
/// <summary>
|
||||
/// Disables an alarm condition by invoking the OPC UA Part 9 ConditionType <c>Disable</c> method
|
||||
/// (the H4 client-driven path). The method takes no input arguments.
|
||||
/// </summary>
|
||||
/// <param name="conditionNodeId">The condition node associated with the alarm being disabled.</param>
|
||||
/// <param name="ct">The cancellation token that aborts the disable request.</param>
|
||||
/// <returns>
|
||||
/// <see cref="StatusCodes.Good"/> on success, or the server's bad <see cref="StatusCode"/>
|
||||
/// (from the underlying <see cref="ServiceResultException"/>) when the disable call
|
||||
/// returns a bad result. Other transport-level failures still surface as exceptions.
|
||||
/// </returns>
|
||||
Task<StatusCode> DisableAsync(string conditionNodeId, CancellationToken ct = default);
|
||||
|
||||
/// <summary>
|
||||
/// Reads raw historical samples for a historized node.
|
||||
/// </summary>
|
||||
|
||||
@@ -461,6 +461,50 @@ public sealed class OpcUaClientService : IOpcUaClientService
|
||||
return StatusCodes.Good;
|
||||
}
|
||||
|
||||
/// <inheritdoc />
|
||||
public Task<StatusCode> EnableAsync(string conditionNodeId, CancellationToken ct = default) =>
|
||||
CallEnableDisableAsync(conditionNodeId, enabling: true, ct);
|
||||
|
||||
/// <inheritdoc />
|
||||
public Task<StatusCode> DisableAsync(string conditionNodeId, CancellationToken ct = default) =>
|
||||
CallEnableDisableAsync(conditionNodeId, enabling: false, ct);
|
||||
|
||||
/// <summary>
|
||||
/// Shared body for the H4 Enable/Disable client path. Invokes the OPC UA Part 9 ConditionType
|
||||
/// <c>Enable</c>/<c>Disable</c> method (no input arguments) on the condition object node, mirroring
|
||||
/// the <see cref="AcknowledgeAlarmAsync"/> convention: the methods live on the <c>.Condition</c>
|
||||
/// child node, and a bad call result surfaces as the returned <see cref="StatusCode"/> rather than
|
||||
/// escaping as an uncaught <see cref="ServiceResultException"/>.
|
||||
/// </summary>
|
||||
/// <param name="conditionNodeId">The condition node associated with the alarm.</param>
|
||||
/// <param name="enabling"><c>true</c> to invoke Enable; <c>false</c> to invoke Disable.</param>
|
||||
/// <param name="ct">The cancellation token that aborts the request.</param>
|
||||
private async Task<StatusCode> CallEnableDisableAsync(string conditionNodeId, bool enabling, CancellationToken ct)
|
||||
{
|
||||
ThrowIfDisposed();
|
||||
ThrowIfNotConnected();
|
||||
|
||||
// Enable/Disable live on the same .Condition child node as Acknowledge/Confirm.
|
||||
var conditionObjId = conditionNodeId.EndsWith(".Condition")
|
||||
? NodeId.Parse(conditionNodeId)
|
||||
: NodeId.Parse(conditionNodeId + ".Condition");
|
||||
var methodId = enabling ? MethodIds.ConditionType_Enable : MethodIds.ConditionType_Disable;
|
||||
|
||||
try
|
||||
{
|
||||
await _session!.CallMethodAsync(conditionObjId, methodId, [], ct);
|
||||
}
|
||||
catch (ServiceResultException ex)
|
||||
{
|
||||
Logger.Warning(ex, "Failed to {Operation} alarm on {ConditionId} (status {Status})",
|
||||
enabling ? "enable" : "disable", conditionNodeId, ex.StatusCode);
|
||||
return ex.StatusCode;
|
||||
}
|
||||
|
||||
Logger.Debug("{Operation} alarm on {ConditionId}", enabling ? "Enabled" : "Disabled", conditionNodeId);
|
||||
return StatusCodes.Good;
|
||||
}
|
||||
|
||||
/// <inheritdoc />
|
||||
public async Task<IReadOnlyList<DataValue>> HistoryReadRawAsync(
|
||||
NodeId nodeId, DateTime startTime, DateTime endTime, int maxValues = 1000, CancellationToken ct = default)
|
||||
|
||||
Reference in New Issue
Block a user