OCRNativeActivity-Klasse

Definition

• Namespace: UiPath.OCR.Contracts.Activities
• Assembly: UiPath.OCR.Contracts

Beschreibung

Eine abstrakte Klasse, die implementiert werden muss, um eine NativeActivity aus dem Workflow Foundation-Framework zu erstellen.

Mitglieder

Methoden

• BeforeExecute(System.Activities.NativeActivityContext) System.Collections.Generic.Dictionary<string, object> – Überschreibt diese Methode zum Berechnen und Bereitstellen aller Aktivitätseingabeargumente außer dem Bildargument und gibt Aktivitätseingabeargumente als Verzeichnis zurück, bei dem der Schlüssel der Argumentname und der Wert der Argumentwert ist.
  Hinweis: Zur Entwurfszeit, wenn kein Kontext verfügbar ist, sind die Parameter der Methode NULL. In diesem Fall können die Aktivitätsargumente nicht gelesen werden, daher sollten Sie Standardwerte dafür angeben.
• Execute(System.Activities.NativeActivityContext) void Execute(System.Activities.NativeActivityContext – Diese Methode kann mit der Implementierung des Aktivitätscodes überschrieben werden. Er wird von der Workflow-Laufzeit aufgerufen, um die Aktivität auszuführen. Sie bietet auch Zugriff auf Nachverfolgung, Variablen und Argumente.
• OCRNativeActivity.OCRNativeActivity() – Aktivitätskonstruktor.
• OnSuccess(System.Activities.NativeActivityContext, UiPath.OCR.Contracts.DataContracts.OCRResult) void OnSuccess(System.Activities.NativeActivityContext context, UiPath.OCR.Contracts.DataContracts.OCRResult result) – Diese Methode wird nach Berechnung des OCR-Ergebnisses aufgerufen. Sie kann verwendet werden, um Ausgabeargumente oder andere endgültige Vorgänge festzulegen.
• PerformOCRAsync(System.Drawing.Image, System.Collections.Generic.Dictionary<string, object>, System.Threading.CancellationToken) - Verarbeitet ein Bild und gibt die extrahierten Textinformationen zurück. Der Parameter Options ist ein Wörterbuch von Aktivitätsargumenten, das als Schlüssel den Argumentnamen und als Wert den Argumentwert hat.

Eigenschaften

• ExtractWords - Ruft ab oder legt fest, ob die Wörter extrahiert werden sollen.
• Image System.Activities.InArgument<System.Drawing.Image> – Zu verarbeitendes Bild.
• Language System.Activities.InArgument<string> - Die vom OCR-Modul zum Extrahieren der Zeichenfolge aus dem UI-Element verwendete Sprache.
• Output System.Activities.OutArgument<UiPath.OCR.Contracts.OcrActivityResult> – Die Aktivitätsausgabe. Veraltetes Argument.
• Text System.Activities.OutArgument<string> – Die extrahierte Zeichenfolge.

Codebeispiel

[DisplayName("Sample OCRNativeActivity")]
internal class SampleOCRNativeActivity : OCRNativeActivity
    {
        public InArgument<string> CustomInput { get; set; }

        public OutArgument<string> CustomOutput { get; set; }

        public override Task<OCRResult> PerformOCRAsync(Image image, Dictionary<string, object> options, CancellationToken ct)
        {
            string customInput = options[nameof(CustomInput)] as string;
            string text = $"Text from {nameof(SampleOCRNativeActivity)} with custom input: {customInput}";
            return Task.FromResult(OCRResultHelper.FromText(text));
        }

        protected override void OnSuccess(NativeActivityContext context, OCRResult result)
        {
            CustomOutput.Set(context, $"Custom output: '{result.Text}' has {result.Words.Length} words.");
        }

        protected override Dictionary<string, object> BeforeExecute(NativeActivityContext context)
        {
            return new Dictionary<string, object>
            {
                { nameof(CustomInput), CustomInput.Get(context) }
            };
        }
    }