docs/de/user/import.rst

   1 Migration von einem Drittanbieter
   2 =================================
   3
   4 In wallabag 2.x kannst du Daten von folgenden Anbietern importieren:
   5
   6 - Pocket <#id1>`_
   7 - Readability <#id2>`_
   8 - Instapaper <#id4>`_
   9 - wallabag 1.x <#id6>`_
  10 - wallabag 2.x <#id7>`_
  11
  12 Wir haben zusätzlich `ein Skript für die Migration per Kommandozeile <#import-via-command-line-interface-cli>`_ geschrieben.
  13
  14 Da Importe eine Menge Zeit in Anspruch nehmen können, haben wir auch ein asynchrones Aufgabensystem entwickelt. `Du kannst die Dokumentation hier lesen <http://doc.wallabag.org/de/master/developer/asynchronous.html>`_ (für Experten).
  15
  16 Pocket
  17 ------
  18
  19 Erstelle eine neue Applikation in Pocket
  20 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  21
  22 Um deine Daten von Pocket zu importieren, nutzen wir die Pocket API. Du musst
  23 eine neue Applikation auf ihrer Entwicklerwebsite erstellen, um fortzufahren.
  24
  25 * Erstelle eine neue Applikation `auf der Entwicklerwebsite <https://getpocket.com/developer/apps/new>`_
  26 * Fülle die erforderlichen Felder aus: Name, Beschreibung, Berechtigungen (nur **abrufen**), Plattform
  27   (**web**), akzeptiere die Nutzungsbedingungen und reiche deine neue Applikation ein
  28
  29 Pocket wird dir einen **Consumer Key** geben (z.B. `49961-985e4b92fe21fe4c78d682c1`).
  30 Du musst den ``pocket_consumer_key`` in dem Abschnitt ``Import`` in dem ``Interne Einstellungen`` Menü
  31 konfigurieren.
  32
  33 Jetzt ist alles in Ordnung, um von Pocket zu migrieren.
  34
  35 Importiere deine Daten in wallabag 2.x
  36 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  37
  38 Klicke auf den ``Importieren`` Link im Menü, auf ``Inhalte importieren`` in dem Pocketabschnitt und
  39 dann auf ``Verbinde mit Pocket und importieren Daten``.
  40
  41 Du musst wallabag erlauben, mit deinem Pocketaccount zu interagieren.
  42 Deine Daten werden importiert. Datenimport kann ein sehr anspruchsvoller Prozess für deinen Server
  43 sein (wir müssen daran arbeiten, um diesen Import zu verbessern).
  44
  45 Readability
  46 -----------
  47
  48 Exportiere deine Readability-Daten
  49 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  50
  51 Auf der Tools-Seite (`https://www.readability.com/tools/ <https://www.readability.com/tools/>`_), klicke auf "Daten exportieren" im "Daten-Export"-Abschnitt. Du wirst eine E-Mail mit einem Downloadlink zu einer JSON-Datei erhalten, welche zugegebenermaßen nicht mit .json endet.
  52
  53 Importiere deine Daten in wallabag 2.x
  54 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  55
  56 Klicke auf den ``Importieren``-Link im Menü, auf ``Inhalte importieren`` im Readability-Abschnitt und wähle dann deine JSON-Datei aus und lade sie hoch.
  57
  58 Deine Daten werden dann importiert. Dies kann eine starke Belastung für den Server sein.
  59
  60 Instapaper
  61 ----------
  62
  63 Exportiere deine Instapaper-Daten
  64 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  65
  66 Klicke in den Einstellungen (`https://www.instapaper.com/user <https://www.instapaper.com/user>`_) auf "CSV-Datei herunterladen" im Export-Abschnitt. Eine CSV-Datei mit dem Namen ``instapaper-export.csv`` wird heruntergeladen.
  67
  68 Importiere deine Daten in wallabag 2.x
  69 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  70
  71 Klicke auf den ``Importieren``-Link im Menü, auf ``Inhalte importieren`` im Instapaper-Abschnitt und wähle dann deine CSV-Datei aus und lade sie hoch.
  72
  73 Deine Daten werden dann importiert. Dies kann eine starke Belastung für den Server sein.
  74
  75 wallabag 1.x
  76 ------------
  77
  78 Wenn du in der Vergangenheit wallabag 1.x genutzt hast, musst du deine Daten exportieren, bevor du auf wallabag 2.x umsteigst, da sich viel an der Anwendung und der Datenbank geändert hast. In deiner alten wallabag-installation kannst du deine Daten exportieren, indem du die Konfigurationsseite auf der alten wallabag-Instanz öffnest.
  79
  80 .. image:: ../../img/user/export_v1.png
  81    :alt: Export aus wallabag 1.x
  82    :align: center
  83
  84 .. note::
  85     Wenn du mehrere Accounts auf der gleichen wallabag-Instanz hast, muss jeder Nutzer seine Daten aus 1.x exportieren und in 2.x importieren.
  86
  87 .. note::
  88     Falls während des Exports oder des Imports Probleme auftreten sollten, scheue dich nicht, den `Support zu kontaktieren <https://www.wallabag.org/pages/support.html>`__.
  89
  90 Wenn du dann die JSON-Datei mit deinen Einträgen heruntergeladen hast, kannst du `wallabag 2 über die Standard-Prozedur installieren <http://doc.wallabag.org/en/master/user/installation.html>`__.
  91
  92 Nach dem Erstellen des Benutzeraccounts auf deiner neuen "wallabag 2.x"-Instanz, navigiere auf den Import-Bereich und wähle `Aus wallabag v1 importieren`. Wähle deine JSON-Datei und lade sie hoch.
  93
  94 .. image:: ../../img/user/import_wallabagv1.png
  95    :alt: Import aus wallabag v1
  96    :align: center
  97
  98 wallabag 2.x
  99 ------------
 100
 101 Gehe auf der alten wallabag-Instanz, die du vorher genutzt hast, auf `Alle Artikel` und exportiere diese dann als JSON.
 102
 103 .. image:: ../../img/user/export_v2.png
 104    :alt: Export aus wallabag v2
 105    :align: center
 106
 107 Nach dem Erstellen des Benutzeraccounts auf deiner neuen "wallabag 2.x"-Instanz, navigiere auf den Import-Bereich und wähle `Aus wallabag v2 importieren`. Wähle deine JSON-Datei und lade sie hoch.
 108
 109 .. note::
 110     Falls während des Exports oder des Imports Probleme auftreten sollten, scheue dich nicht, den `Support zu kontaktieren <https://www.wallabag.org/pages/support.html>`__.
 111
 112 Import über die Kommandozeile (CLI)
 113 -----------------------------------
 114
 115 Falls du auf deinem Server Zugriff auf die Kommandozeile hast, kannst du den folgenden Befehl ausführen, um deine Daten aus wallabag v1 zu importieren:
 116
 117 ::
 118
 119     bin/console wallabag:import 1 ~/Downloads/wallabag-export-1-2016-04-05.json --env=prod
 120
 121 Bitte ersetze die Werte:
 122
 123 * ``1`` ist die Benutzer-ID in der Datenbank (die ID des ersten Benutzers ist immer 1)
 124 * ``~/Downloads/wallabag-export-1-2016-04-05.json`` ist der Pfad zu deiner wallabag v1-Exportdatei
 125
 126 Wenn du alle Artikel als gelesen markieren möchtest, kannst du die ``--markAsRead``-Option hinzufügen.
 127
 128 Um eine wallabag 2.x-Datei zu importieren, musst du die Option ``--importer=v2`` hinzufügen.
 129
 130 Als Ergebnis wirst du so etwas erhalten:
 131
 132 ::
 133
 134     Start : 05-04-2016 11:36:07 ---
 135     403 imported
 136     0 already saved
 137     End : 05-04-2016 11:36:09 ---