.. _`Text`:

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

Text
~~~~

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


Data source as text



**Documentation**

Import data as a Text.

:Opposite node: :ref:`Export Texts`
:Ref. nodes: :ref:`Texts`

For instructions on how to add or write custom plugins, see
:ref:`pluginwriting`.


*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*

    :<unnamed>:  datasource

        Datasource


*Output ports*

    :port1:  text

        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.

.. automodule:: node_import_text
    :noindex:

.. class:: ImportText
    :noindex:


**Plugins**

* :ref:`plugin_textdataimporterbase`





**Example flows**

* :download:`InputOutputGenerate.syx </_examples/Sympathy/InputOutputGenerate/InputOutputGenerate.syx>`