Classe OCRAsyncCodeActivity

Namespace: UiPath.OCR.Contracts.Activities

Conjunto: 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 este 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 onde a chave é o nome do argumento e o valor é o valor do argumento.
  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 de atividade. Ele é chamado pelo tempo de execução do fluxo de trabalho para executar a atividade de forma assíncrona. Ele também fornece acesso a 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 de 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 calcular o resultado do OCR. Ele pode ser usado 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 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 de OCR para extrair a string do elemento de interface do usuário. Para o mecanismo de OCR do Google, esse campo precisa conter o prefixo do arquivo de idioma, como “ron” para romeno, “ita” para italiano e “fra” para francês. Você pode encontrar os prefixos de idioma suportados nesta página.
• Output System.Activities.OutArgument<UiPath.OCR.Contracts.OcrActivityResult> - A saída da atividade. Legado, argumento 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) }
            };
        }
    }