Classe OCRAsyncCodeActivity

Definição

• Espaço de nomes: UiPath.OCR.Contracts.Activities
• Montagem: UiPath.OCR.Contracts

Description

Uma classe abstrata que deve ser implementada para construir um AsyncCodeActivity da estrutura Workflow Foundation.

Membros

Métodos

• BeforeExecute(System.Activities.AsyncCodeActivityContext, System.AsyncCallback, object) System.Collections.Generic.Dictionary<string, object> - Substitui esse método para calcular e fornecer todos os argumentos de entrada da atividade, exceto o argumento Image , e retorna os argumentos de entrada da atividade como um dicionário em que a chave é o nome do argumento e o valor é o argumento valor.
  Observação: em tempo de design, quando nenhum contexto está disponível, os parâmetros do método são nulos. Nesse caso, os argumentos da atividade não podem ser lidos, portanto, convém fornecer valores padrão para eles.
• BeginExecute(System.Activities.AsyncCodeActivityContext, System.AsyncCallback, object) System.IAsyncResult - Este método pode ser substituído para implementar o código da atividade. Ele é chamado pelo runtime do fluxo de trabalho para executar a atividade de forma assíncrona. Ele também fornece acesso ao rastreamento, variáveis e argumentos.
• EndExecute(System.Activities.AsyncCodeActivityContext, System.IAsyncResult) - System.Collections.Generic.IEnumerable<System.Collections.Generic.KeyValuePair<System.Drawing.Rectangle, string>> - Este método pode ser substituído para notificar o tempo de execução do fluxo de trabalho que a operação de atividade assíncrona associada foi concluída.
• OCRAsyncCodeActivity()
• OnSuccess(System.Activities.AsyncCodeActivityContext, UiPath.OCR.Contracts.DataContracts.OCRResult) void OnSuccess - Este método é chamado após o cálculo do resultado do OCR. Pode ser usada para definir argumentos de saída ou quaisquer outras operações finais.
• PerformOCRAsync(System.Drawing.Image, System.Collections.Generic.Dictionary<string, object>, System.Threading.CancellationToken) System.Threading.Tasks.Task<UiPath.OCR.Contracts.DataContracts.OCRResult> - Processa uma imagem e retorna as informações de texto extraídas. O parâmetro de opções é um dicionário de argumentos de atividade tendo como chave o nome do argumento e como valor o valor do argumento.

Propriedades

• ExtractWords - Obtém ou define se as palavras devem ser extraídas.
• Image System.Activities.InArgument<System.Drawing.Image> ─ Imagem a ser processada.
• Language System.Activities.InArgument<string> - O idioma usado pelo mecanismo OCR para extrair a string do elemento de interface gráfica. Para o mecanismo Google OCR, esse campo precisa conter o prefixo do arquivo do idioma, como "ron" para romeno, "ita" para italiano e "fra" para francês. Você pode encontrar os prefixos de idiomas compatíveis nesta página.
• Output System.Activities.OutArgument<UiPath.OCR.Contracts.OcrActivityResult> — A saída da atividade. Argumento legado, obsoleto.
• Text System.Activities.OutArgument<string> — O valor textual da palavra.

Exemplo de código

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