– både software og hardware

Denne artikkelen forklarer hvordan man kaller opp metoder hos en klient fra en workflow i .NET Workflow Foundation (WF).

Å kalle eksterne metoder fra en workflow er nyttig i mange sammenhenger. Blant annet hvis man har et brukergrensesnitt, og ønsker at en workflow skal signalisere til klienten at den må oppdatere data, skifte til et annet vindu eller lignende.

I Workflow Foundation (WF) gjøres dette ved hjelp av workflow-aktiviteten CallExternalMethod.

(Klikk på bildene for større versjon)

CallExternalMethod i toolbox'en i VisualStudio

[caption id="attachment_580" align="alignnone" width="110" caption="CallExternalMethod satt inn i en workflow."][/caption]

CallExternalMethod har properties for hvilket interface og hvilken metode som skal kalles opp på klienten.

Aktiviteten CallExternalMethod kaller opp metoder som er implementert utenfor workflow’en, for eksempel i en konsoll- eller Windows Presentation Foundation-applikasjon (WPF).

Metodekallene gjøres ved hjelp av et interface som både workflow’en og klienten har tilgang til. Klassen som implementerer interface’et ligger hos klienten.

Et slikt interface må ha attributten ExternalDataExchange og kan for eksempel se ut som dette:

    [ExternalDataExchange]
    public interface IClientMethods
    {
        void SignalToClient();
    }

Implementasjonen av interfacet er definert i klienten:

    public class ClientMethods : IClientMethods
    {
        public void SignalToClient()
        {
            Console.WriteLine("SignalToClient Received!");
        }
    }

For at en workflow skal kunne kalle opp klienten, må de kobles sammen. Koblingen gjøres ved at klienten registrerer en instans av klassen hos workflow-runtimen ved hjelp av ExternalDataExchangeService. Workflow-instansen kan da kalle metoder hos klienten.

     ExternalDataExchangeService dataExchange;
     dataExchange = new ExternalDataExchangeService();
     workflowRuntime.AddService(dataExchange);

     ClientMethods clientMethods = new ClientMethods();
     dataExchange.AddService(clientMethods);

Oppdatering av grafiske brukergrensesnitt fra workflows

Når man lager Windows-applikasjoner med Windows Forms eller WPF (Windows Presentation Foundation) er det en viktig detalj som man må huske på:

Workflows kjøres i egne threads. Men all oppdatering av brukergrensesnittet må skje i vinduets thread. Derfor må man gjøre en vri i koden.

• Workflow’en kaller en metode på klienten som skal oppdatere GUI’en (brukergrensesnittet).
• Dette kallet kjører i “feil” thread og kan ikke oppdatere brukergrensesnittet direkte.
• Dette fanger man opp i en if-setning, som lager et delegat (“metodepeker”) til den samme metoden.
• Deretter kaller man opp Invoke med dette delegatet som parameter.
• Invoke gjør at metoden kalles opp igjen i rett thread.
• Ved hjelp av if-setningen, vet man nå at metoden kjører i riktig thread.
• Nå kan brukergrensesnittet oppdateres fra koden.

Her ser man hvordan dette kan se ut:

// Definer et delegat til metoden
delegate void ClientMethodDelegate(bool enabled);

// Metoden som kalles opp fra workflow
void TheClientMethod(bool enabled)
{
    // Er vi i "feil" thread for å oppdatere GUI?
    if (InvokeRequired)
    {
        // Bruk Invoke til å kalle opp TheClientMethod
        // fra riktig thread.
        Invoke(
                new ClientMethodDelegate(SetInputEnabled),
                new object[] {enabled}
                );
    }
    else
    {
        // Vi er i riktig thread. Oppdater GUI.
        button1.Enabled = enabled;
    }
}