Epi2CrewbrainFile/EPI2CrewbrainFile

EPI → CrewBrain Dokumenten-Uploader

Dieses Tool überträgt PDF-Dokumente (Angebote, Aufträge, Lieferscheine) automatisiert aus definierten Ordnern in CrewBrain und ordnet sie den passenden Jobs/Events zu.

Die Zuordnung erfolgt über die EventIDManual (z. B. 4843-01), die aus dem Dateinamen extrahiert wird.

---

Voraussetzungen in CrewBrain (wichtig)

Damit Dokumente hochgeladen werden können, müssen in CrewBrain passende Zusatzinformationen vom Typ „Dokument“ angelegt sein.

1. Zusatzinformationen anlegen

Öffne in CrewBrain:

https:///administration/jobs/jobdata

(z. B. https://vt-media.crewbrain.com/administration/jobs/jobdata)

Lege dort für jede Dokumentart eine Zusatzinformation an:

• Angebot
• Auftrag
• Lieferschein

Wichtig:

• Der Typ der Zusatzinformation muss „Dokument“ sein
• Jede Zusatzinformation erhält intern eine TypeID

---

2. TypeID ermitteln

Nach dem Anlegen oder Bearbeiten einer Zusatzinformation kannst du die TypeID direkt aus der URL ablesen:

Beispiel:

https://vt-media.crewbrain.com/administration/jobs/jobdata/additionaldatatype/2

➡️ TypeID = 2

Diese TypeID wird später in der Anwendung konfiguriert.

---

Konfiguration (appsettings.json)

Relevanter Bereich: Crewbrain

"Crewbrain": {
  "ApiBase": "https://vt-media.crewbrain.com/api",

  "Upload": {
   "Target": "AdditionalData", 
      "AttachmentsVisibility": "ALL",
    "Angebot": {
      "TypeId": 1,
      "OverwriteSingleDocument": false
    },
    "Auftrag": {
      "TypeId": 0,
      "OverwriteSingleDocument": true
    },
    "Lieferschein": {
      "TypeId": 2,
      "OverwriteSingleDocument": false
    }
  },

  "TokenAuth": {
    "AccessToken": ""
  }
}
Erklärung der Felder
Feld	Bedeutung
ApiBase	Basis-URL der CrewBrain API

Crewbrain:Upload:Target:

"AdditionalData" = AddOnField-Dokument (TypeId je Dokumentart)

"JobAttachments" = normales Job Attachment (TypeId wird ignoriert)

Upload.<Typ>.TypeId	TypeID der Zusatzinformation (siehe oben)
Upload.<Typ>.OverwriteSingleDocument	Ersetzt vorhandenes Dokument (nur erlaubt bei DOCUMENT_SINGLE)
TokenAuth.AccessToken	Wird automatisch vom Tool gesetzt
Dokumentverarbeitung
Unterstützte Dateitypen: PDF

Event-Zuordnung erfolgt über EventIDManual im Dateinamen

Unterstützte Formate:

905-01

4843-01

12345-01

Bei mehreren Treffern im Dateinamen wird automatisch die längste ID verwendet

Beispiel
ABM4843-01-Kunde-Angebot.pdf
→ EventIDManual = 4843-01
Token-Authentifizierung
Das Tool verwendet CrewBrain Access Tokens (X-API-KEY):

Beim ersten Start:

Benutzername & Passwort werden einmalig abgefragt

Token wird automatisch gespeichert

Tokens bleiben 14 Tage nach letzter Nutzung gültig

Bei 401/403 wird automatisch ein neuer Token angefordert

⚠️ Passwörter werden nicht gespeichert

Ergebnis
Erfolgreich hochgeladene Dateien werden in einen Uploaded/-Unterordner verschoben

Bei Namenskonflikten wird ein Zeitstempel vor der Dateiendung ergänzt:

Angebot_4843-01.pdf
→ Angebot_4843-01_202601210915301234.pdf
Hinweise
Fehlerhafte oder nicht zuordenbare Dateien werden nicht verschoben

Alle API-Requests (inkl. Payload-Preview) sind im DEBUG-Log sichtbar

Base64-Inhalte werden im Log nicht vollständig ausgegeben