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:

  At design time, when no context is available, the method's parameters are null. In this case, the activity arguments can't be read, so you may want to provide default values for them.

• 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) - Processes an image and returns the extracted text information. The Options parameter is a dictionary of activity arguments having as key the argument name and as value the argument value.

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) }
            };
        }
    }