Skip to content
Nappai Documentation

Extract Text from Binary

The Extract Text from Binary component acts as a translator for your data. It takes files that are stored in a raw, binary format (a sequence of numbers that computers use to store information) and converts them into a standard text format that humans can read and your other automation steps can understand.

Think of it as a bridge: on one side, you have unreadable binary code; on the other, you have clear, readable text. This component sits in the middle, decoding the binary so you can use it in reports, databases, or AI prompts.

How it Works

This component is designed for efficiency and simplicity. Here is the simple logic it follows:

  1. Receives Data: It starts by taking a Binary file or a stream of data from a previous step in your workflow.
  2. Decodes: It reads the underlying bytes of that file and attempts to interpret them as characters (text). It uses standard encoding methods (like UTF-8) to make sense of the numbers.
  3. Outputs Text: Once the conversion is successful, it produces a text string. This text is then passed along to the next component in your automation.

If the binary data does not contain readable text (for example, if it is an image file or a corrupted file), the component will handle the error internally to prevent your workflow from crashing, potentially returning an empty result or an error message depending on the data.

Connection & Credentials

This component does not require any external API connections, credentials, or login details. It operates entirely within the Nappai system using the data you provide directly in the workflow.

Operations

This component does not have multiple operations. It performs a single, consistent conversion from binary to text.

Inputs

The following fields are available to configure this component.

  • Binary: [REQUERIDO] The binary file or data stream you want to convert. This is the source material that will be turned into text. You can connect this to the output of any component that produces a file or raw bytes.
    • Visible in: All configurations

Outputs

This component produces one main result:

  • Data: This is the extracted text. It is a standard text string that you can now use in other parts of your automation. For example, you can send this text to an AI assistant for summarization, save it to a database, or use it in a document.

Output Data Example (JSON)

json { “Data”: “Hello World\nThis is a text extraction.\nLine 3” }

Connectivity

This component is typically used in the middle of a data processing pipeline.

  • Input Connection: Connect the Binary input to a component that produces a file, such as a “Read File” component, an “HTTP Download” component, or an “AI Agent” that returns raw bytes.
  • Output Connection: Connect the Data output to components that accept text input. Common next steps include:
    • AI Assistant: To analyze or summarize the text.
    • Database Writer: To store the extracted text in a record.
    • Text Matcher: To search for specific keywords within the extracted text.

Usage Example

Scenario: You have an automation that downloads a log file from a server. The log file is saved as a binary file. You want to read this log to check for errors.

  1. Download File: A component downloads a .log file and outputs it as a Binary file.
  2. Extract Text: Connect the downloaded file to the Extract Text from Binary component.
  3. Result: The component outputs the content of the log file as a readable text string.
  4. Next Step: You can now connect this text to an AI Assistant to ask, “What errors were found in this log?”

Tips and Best Practices

  • Ensure Valid Data: This component works best when the binary file actually contains text-based data (like a .txt or .csv file saved as binary). If you process an image (.jpg) or executable (.exe) file, the output may be unreadable garbage text.
  • Error Handling: If your binary source is occasionally corrupted, ensure your workflow has error handling steps after this component to manage empty or invalid text outputs.
  • Performance: This conversion is generally fast, but very large binary files may take slightly longer to process.

Security Considerations

  • Data Privacy: Since this component extracts text from files, ensure that the binary files you are processing do not contain sensitive personal information (PII) that you do not intend to share with subsequent AI or database steps.
  • Source Trust: Only process binary files from trusted sources. Executable or unknown binary formats might contain malicious code; this component only extracts text, but ensure your overall workflow security is robust.