OCRAsyncCodeActivity-Klasse

Definition

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

Beschreibung

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

Mitglieder

Methoden

• BeforeExecute(System.Activities.AsyncCodeActivityContext, System.AsyncCallback, object) System.Collections.Generic.Dictionary<string, object> – Überschreibt diese Methode zum Berechnen und Bereitstellen aller Aktivitätseingabeargumente außer dem Image -Argument und gibt die Aktivitätseingabeargumente als Verzeichnis zurück, bei dem der Schlüssel der Argumentname und der Wert das Argument ist Wert.
  Hinweis: Zur Entwurfszeit, wenn keine Kontexte verfügbar sind, sind die Parameter der Methode NULL. In diesem Fall können die Aktivitätsargumente nicht gelesen werden, daher sollten Sie Standardwerte dafür angeben.
• BeginExecute(System.Activities.AsyncCodeActivityContext, System.AsyncCallback, object) System.IAsyncResult – Diese Methode kann mit der Implementierung des Aktivitätscodes überschrieben werden. Sie wird von der Workflow-Laufzeit aufgerufen, um die Aktivität asynchron auszuführen. Sie bietet auch Zugriff auf Nachverfolgung, Variablen und Argumente.
• EndExecute(System.Activities.AsyncCodeActivityContext, System.IAsyncResult) – System.Collections.Generic.IEnumerable<System.Collections.Generic.KeyValuePair<System.Drawing.Rectangle, string>> – Diese Methode kann überschrieben werden, um die Workflow-Laufzeit darüber zu benachrichtigen, dass der zugehörige asynchrone Aktivitätsvorgang abgeschlossen wurde.
• OCRAsyncCodeActivity()
• OnSuccess(System.Activities.AsyncCodeActivityContext, UiPath.OCR.Contracts.DataContracts.OCRResult) void OnSuccess – 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) System.Threading.Tasks.Task<UiPath.OCR.Contracts.DataContracts.OCRResult> – Verarbeitet ein Bild und gibt die extrahierten Textinformationen zurück. Der Parameter Optionen ist ein Verzeichnis von Aktivitätsargumenten, die als Schlüssel den Argumentnamen und als Wert den Argumentwert haben.

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. Für die Google OCR-Engine muss dieses Feld das Präfix der Sprachdatei enthalten, z. B. „ron“ für Rumänisch, „ita“ für Italienisch und „fra“ für Französisch. Die unterstützten Sprachpräfixe finden Sie auf dieser Seite.
• Output System.Activities.OutArgument<UiPath.OCR.Contracts.OcrActivityResult> – Die Aktivitätsausgabe. Veraltetes Argument.
• Text System.Activities.OutArgument<string> – Der Textwert des Worts.

Codebeispiel

[DisplayName("Sample OCRAsyncCodeActivity")]
internal class SampleOCRAsyncCodeActivity : OCRAsyncCodeActivity
    {
        [Browsable(true)]
        public override InArgument<Image> Image { get; set; }

        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(SampleOCRAsyncCodeActivity)} with custom input: {customInput}";
            return Task.FromResult(OCRResultHelper.FromText(text));
        }

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

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