ProcessInstances.GetActivityInstanceByInstIdAsync

Description

The API gets the activity instance of the specified activity instance ID inside the connected AI Command Center.

Signature [C#]

Task<ActivityInstance> GetActivityInstanceByInstIdAsync(string processInstanceId, string activityInstanceId);

Properties

Input

Parameter	Type	Required / default	Description
processInstanceId	string	Required	The process instance id in which the activity instance is located.
activityInstanceId	string	Required	The activity instance id for which the activity instance has to be retrieved.

Output

Property	Description
Task<ActivityInstance>	Returns activity instance.

Remarks

Use GetActivityInstanceByIdAsync API to get the activity instance of a process instance inside the connected AI Command Center.

Example

C#

public async Task GetActivityInstanceByInstId()
{
    IControlRoomContext context = LoginControlRoom();
    try
    {
        string processInstanceId = "e42a93f5d53245d788909fd655b41cfe";
        string activityInstanceId = "58bfe04d347540188dfdb55f2e16f5ec";
        ActivityInstance activityInstance = await context.ProcessInstances.GetActivityInstanceByInstIdAsync(processInstanceId, activityInstanceId);
        System.Console.WriteLine("Activity Name: " + activityInstance.Name);
    }
    finally
    {
        context.Close();
    }
}

Connection helper

public IControlRoomContext LoginControlRoom()
{
    string RequiredSetting(string name) => Environment.GetEnvironmentVariable(name) ?? throw new InvalidOperationException($"Set {name} before running this example.");
    string serverUrl = RequiredSetting("INTELLIBUDDIES_SERVER_URL");
    string userName = RequiredSetting("INTELLIBUDDIES_USERNAME");
    string password = RequiredSetting("INTELLIBUDDIES_PASSWORD");
    string connectionString = $"ServerUrl={serverUrl};UserName={userName};Password={password}";
    IControlRoomContext context = new ControlRoomContext(connectionString);
    context.Open();
    return context;
}

See Get started for namespaces, configuration, and context cleanup, and SDK usage for error handling.