# Artikel auswählen

Der Einstieg über **Übersetzen → Artikel übersetzen**. Von hier führen drei Wege zu einer
Artikelliste.

<!-- TODO Screenshot: images/uebersetzen-startseite.png -->

## Die drei Wege

| Weg | Wann |
| ----------------------------------- | ------------------------------------------ |
| **Artikelgruppen auswählen** → *Anzeigen* | der Regelfall: eine oder mehrere Warengruppen am Stück |
| **Alle Artikel durchsuchen** | wenn einzelne Artikel gesucht werden, quer über das Sortiment |
| **Artikelliste importieren** | wenn die Artikel schon als Liste vorliegen — als CSV-Datei oder aus Excel kopiert |

<p class="callout success">Der Weg über Artikelgruppen lädt die Artikel dieser Gruppen vollständig — man sieht sofort, was drin ist. Der Weg über alle Artikel setzt eine Suche voraus, weil das Sortiment sonst zu groß wäre.</p>

Die Gruppenauswahl nimmt **mehrere** Gruppen; gesucht werden kann darin nach Nummer und
Bezeichnung.

## Eine Artikelliste importieren

**Artikelliste importieren** öffnet die Ansicht *Artikelliste*. Übersetzt werden danach nur
die Artikel dieser Liste.

<!-- TODO Screenshot: images/uebersetzen-artikelliste.png -->

### Liste einlesen

| Weg | Inhalt |
| ---------------------------------------- | ------------------------------------------ |
| **CSV-Datei auswählen** | eine Datei mit der Endung `.csv`, `.txt` oder `.tsv` |
| **Artikelnummern einfügen** | eine Artikelnummer je Zeile, oder Spalten direkt aus Excel kopiert |

Trennzeichen und Zeichensatz erkennt die Ansicht selbst: Semikolon, Tabulator, Komma oder
senkrechter Strich, UTF-8 oder der Windows-Zeichensatz, in dem Excel eine CSV-Datei oft
speichert.

Darunter erscheint eine Vorschau der ersten zehn Zeilen, dazu:

| Einstellung | Bedeutung |
| ---------------------------------------------------- | ------------------------------------------ |
| **Erste Zeile enthält Spaltenüberschriften** | ist vorbelegt, wenn eine Spalte etwa *Artikelnummer*, *Art-Nr* oder *SKU* heißt |
| **Spalte mit der Artikelnummer** | aus dieser Spalte werden die Nummern gelesen; vorbelegt mit der erkannten Spalte |
| **Optional: nur Zeilen mit Wert in Spalte ...** und **... gleich** | nimmt nur die Zeilen, die in einer anderen Spalte einen der gewählten Werte haben — etwa nur die als unzureichend gekennzeichneten Übersetzungen |

Der Filter erscheint nur, wenn die Liste mehr als eine Spalte hat. Doppelte Artikelnummern
zählen einmal, auch in anderer Schreibweise. Wie viele Artikelnummern erkannt wurden, steht
über der Schaltfläche **Artikel laden**.

### Gefundene Artikel

**Artikel laden** holt die Artikel aus der SelectLine. Nummern, die es dort nicht gibt, meldet
ein Hinweis über der Tabelle; *Anzeigen* listet sie auf, *Kopieren* legt sie in die
Zwischenablage. **Neue Liste** führt zurück zum Einlesen.

<p class="callout danger">Nach dem Laden sind <strong>alle</strong> gefundenen Artikel ausgewählt. Soll nur ein Teil der Liste übersetzt werden, vor dem Konfigurieren abwählen — sonst geht die ganze Liste zu DeepL.</p>

## Die Artikelliste

Die Wege über Artikelgruppen und über alle Artikel enden in derselben Tabelle; die Ansicht
*Artikelliste* zeigt dieselben Spalten ohne die HTML-Texte:

| Spalte | Inhalt |
| ---------------------- | ---------------------------------------------- |
| **Artikelgruppe** | Nummer und Bezeichnung der Gruppe |
| **Artikelnummer** | |
| **Bezeichnung** | |
| **Zusatz** | |
| **Sprachen** | welche Fremdsprachen am Artikel **schon** vorhanden sind |
| **Langtext**, **Bestelltext** | jeweils gekürzt; der vollständige Text erscheint als Tooltip |
| **HTMLLangtext**, **HTMLBestelltext** | dito |

<p class="callout success">Die Spalte <strong>Sprachen</strong> ist die wichtigste beim Arbeiten: Sie zeigt, welche Übersetzungen es am Artikel bereits gibt. Steht dort <code>EN</code>, würde ein Import in <code>EN</code> die vorhandene Fassung überschreiben.</p>

## Suchen

| | |
| ----------------------- | -------------------------------------------- |
| **Suchfeld** | Artikelnummer oder Bezeichnung |
| **Mindestlänge** | 3 Zeichen |
| **Verzögerung** | die Suche startet kurz nach der letzten Eingabe |

<p class="callout warning">In der Ansicht <em>Alle Artikel</em> bleibt die Tabelle leer, bis mindestens 3 Zeichen eingegeben oder ein Filter gesetzt ist. Das ist kein Fehler, sondern verhindert, dass das ganze Sortiment geladen wird.</p>

In der Ansicht über Artikelgruppen sucht das Feld dagegen innerhalb der bereits geladenen
Artikel.

## Auswählen

| Aktion | Wie |
| ---------------------------- | --------------------------------------- |
| einzelnen Artikel wählen | Häkchen oder Klick auf die Zeile |
| alle Artikel wählen | Symbol **Alle Artikel auswählen** über der Tabelle |
| Auswahl leeren | Symbol **Auswahl zurücksetzen** oder *Auswahl leeren* |
| einzelnen wieder entfernen | am Kreuz des Chips über der Tabelle |

Über der Tabelle stehen die gewählten Artikel als Chips, dazu ihre Anzahl.

<p class="callout warning">„Alle Artikel auswählen" bezieht sich auf die <strong>gerade angezeigten</strong> Artikel — also auf das Ergebnis von Suche und Filter, nicht auf das ganze Sortiment. Vorher also einen Blick auf die Zahl der Treffer werfen.</p>

<p class="callout danger">Die Auswahl ist gleichzeitig die Rechnung bei DeepL: Jeder ausgewählte Artikel wird mit allen gewählten Texten übersetzt. 500 Artikel versehentlich mit ausgewählt heißt 500 Artikel bezahlt.</p>

Siehe [Das DeepL-Konto](https://wiki.dako-it.com/books/finntranslate/page/das-deepl-konto).

## Weiter zur Konfiguration

Die Schaltfläche **Konfigurieren** oben rechts. Sie bleibt gesperrt, solange kein Artikel
ausgewählt ist.

## Nächster Schritt

[Der erweiterte Filter](https://wiki.dako-it.com/books/finntranslate/page/der-erweiterte-filter)