.. _`Text`:

.. _`org.sysess.sympathy.data.text.importtext`:

Text
````

.. image:: import_text.svg
   :width: 48


Import datasource as text




Documentation
:::::::::::::

URL datasource
==============

If input datasource is a URL resource, the node will download it to a
temporary file before importing it.

If the URL resource contains credential variables, these will be entered
as part of the URL. See
:ref:`Credentials Preferences<preferences_credentials>` for more info.


Definition
::::::::::


Input ports
===========

    **Input datasource**
        | Type: datasource
        | Description: Datasource configured to point at the location of the data

Output ports
============

    **port1**
        | Type: text
        | Description: Imported Text



Configuration
=============

    **Importer** (active_importer)
        Select data format importer

    **Action on import failure** (fail_strategy)
        Decide how failure to import a file should be handled.



Plugins
=======

* :ref:`plugin_textdataimporterbase`




Related nodes
=============

* :ref:`org.sysess.sympathy.data.text.importtexts`

* :ref:`org.sysess.sympathy.export.exportexts`




Examples
========



Example flows demonstrating this node:

* :download:`InputOutputGenerate.syx </Examples/Sympathy for Data/InputOutputGenerate/InputOutputGenerate.syx>`




The node can be found in:

* :download:`Types.syx </Examples/Sympathy for Data/Misc/Types.syx>`

* :download:`Text2Table.syx </Examples/Sympathy for Data/Data Processing/Convert/Text2Table.syx>`

* :download:`ConcatenateTexts.syx </Examples/Sympathy for Data/Data Processing/Text/ConcatenateTexts.syx>`

* :download:`Embed.syx </Examples/Sympathy for Data/Visual/Html/Embed.syx>`




Implementation
==============

.. automodule:: node_import_text
    :noindex:

.. class:: ImportText
    :noindex: