Migrationsprotokoll

topfact AG intern>Organisation>Richtlinien - verbindliche Anweisungen>Urlaub - Organisationsrichtlinie>technische Dokumentation Überblick>Vorlagen für technische Dokumentationen>Migrationsprotokoll
Produkt: topfact6 MyWork
Erstellt am 01.04.2021 15:58, letzte Aktualisierung am 05.06.2026 11:02.

Das Ziel eines Migrationsprotokolls ist es uns als Dienstleister und dem Kunden einen transparenten Vorher-Nachher-Stand präsentieren zu können. Dies soll Unsicherheit und Fragen auf beiden Seiten minimieren.

Das Migrationsprotokoll teilt sich wie die Projekte in drei Phasen

1. Projektvorbereitung (Klärung- und Anforderungsphase)

  • Ziel: Dem Kunden und uns transparent vorlegen was der Status-Quo auf dem alten System ist. Gesprächsgrundlage für Umzugsfragen, etc.
  • Beispiel: Wie viele alte unbearbeitete Aufgaben liegen im System. Müssen diese Migriert werden oder können diese ignoriert werden?


2. Projektsprint (Umsetzungsphase, Migration)

  • Ziel: Uns transparent zeigen was migriert werden muss und wo es Probleme / Fehler gab oder geben könnte.
  • Beispiel: Wie viele Dokumente wurden beim Import nicht mit importiert, weil beispielsweise in der DW Dateistruktur keine Dateien mehr vorliegen, nur noch SQL Leichen in der Datenbank. (Lösung mit SQL Script, Prüfung anhand DWDOCID)
  • Beispiel: Wurden alle Stempel korrekt migriert, bzw. wie viele Stempel haben keinen passenden Nutzer zur Zuordnung?


3. Projektnachsorge (Übergabe und Dokumentation)

  • Ziel: Wasserdichte und transparente Kommunikation gegenüber dem Kunden: Was wurde gemacht, wie viele Dokumente waren vorher / nachher vorhanden. Was ist der OCR Stand der Dokumente, etc.
  • Beispiel: Wie weit ist der OCR Server im Fortschritt in den Jahren zurück?
  • Beispiel: Wie viele Dokumente waren im alten Archiv, wie viele sind im Neuen? Wie ist die Diskrepanz zu erklären?

SQL Script für OCR Verarbeitungsstatus:



Dokumentenvorlagen für den Migrationsauftrag

\\pedc\topfactAG\Einarbeitungen\Qualität\Abwicklungsstandards\Projektvorlagen\0-1 Vorbereitungsmaßnahmen

Dieses Dokument (1. Migrationsauftrag zur Dokumentenübernahme) soll mit dem Kunden gemeinsam ausgefüllt und abgenommen werden - bevor die Migration geplant wird!


Dokumentenvorlagen für das Migrationsprotokoll

\\pedc\topfactAG\Einarbeitungen\Qualität\Abwicklungsstandards\Beispiele für Checklisten und Protokolle\Beispiel für Archivmigrationsprotokoll

Folgendes soll nach der abgeschlossenen Datenübernahme an den Kunden geschickt werden

  1. Zusammenfassendes Migrationsprotokoll
  2. Liste der Belege die nicht übernommen werden konnten (inkl. Gründen)



Phase 1: Vorbereitung

Was ist vorab zu klären und zu besprechen?


Archive 

- Wie viele Archive existieren?

- Sollen diese alle übernommen werden oder sind einzelne veraltet?

- Wie ist die Wichtigkeit der Archive?


Dokumente 

- Wie viele Dokumente sind im alten System in jedem Archiv vorhanden (mit Status OK)? Sollen alle Importiert werden oder nur gültige?

SELECT * FROM [dwdata].[dbo].[MVE] WHERE TECHSTATUS = 'OK' -- üblicherweise gibt es ein Indexfeld das "gelöschte/ungültige" Dokumente identifiziert


- Wie viele davon sind ggf. noch "altes DW Format" 

Kann im DW Dateisystem geprüft werden: DWtiff Dateien sind "aktuell". Dateien mit den Dateiendungen .001 oder .0xx sind alt und müssen über ein ArchivExport Modul exportiert werden, dann per Renaming-Script umbenannt und dann erst mit dem FileReader eingelesen werden. 

- Welche Dokumente davon sollen überhaupt importiert werden?


Nutzer & Gruppen

- Welche Gruppen existieren, sind diese aktuell bzw. noch sinnvoll? Oder soll lieber eine neue Gruppenstruktur aufgesetzt werden?

TODO: Query für Gruppen aus alter topfact DB

- Welche Nutzer sind im System? Sollen alle übernommen werden?

SELECT * FROM [topfact].[dbo].[winstamm]


Zugriffsrechte

- Sind die Indexzugriffsrechte aktuell? Werden sie noch genutzt?

Siehe DocuWare Administration, Indexprofile

TODO: gibt es ein SQL Script diese auszulesen?


Stempel

- Welche Stempel existieren in DW? 

TODO: gibt es ein SQL Script diese auszulesen?

- Welche davon werden überhaupt noch genutzt?

- Welche werden wann im Workflow genutzt? --> zukünftige Zuordnung zu Gruppen statt zu einzelnen Nutzern!


Workflows

- Welche (aktiven) Dokumentenstrukturen existieren?

- Welche davon werden ggf. nicht mehr genutzt und können verworfen werden?

- Sind die Definitionen sinnvoll bzw. veraltet?

- Achtung! Für neues System: Zuordnung von Dokumentenstrukturen zu Gruppen anstatt zu Nutzern! 

-> Hier ggf. die Abteilungs- Gruppendefinition als Word Dokument vorbereiten die der Kunde ausfüllt.


Jobs und Automatismen

- Welche Jobs sind aktiv?

- Welche können verworfen werden?


Aufgaben

- Wie viele Aufgaben sind im alten System?


- Wie viele davon sind unbearbeitet / offen?

TODO: gibt es ein SQL Script diese auszulesen?


- Wie relevant sind die Aufgaben? Können diese ggf. zur Systemübernahme abgearbeitet und dann bei 0 aufgesetzt werden?

- Welche Aufgabenarten/Templates gibt es?

- Hängen Automatismen / E-Mail Benachrichtigungen daran?





Phase 2: Migration

Dokumente


Stempel via Stamp Tool

Anleitung: SQL Importieren von DocuWare Stempeln


Indexdaten

Anleitung: DB Tabellenmigration MySQL -> MS SQL

Phase 3: Dokumentation


Dokumente (pro Archiv)

- Wie viele Dokumente sind im alten Archiv?

SELECT COUNT(*) FROM [dwdata].[dbo].[WHM]


- Wie viele Dokumente sind im neuen Archiv importiert worden?

SELECT COUNT(*) FROM [topfactArchiv].[dbo].[tf_Archive001]


Passt die Zahl der Dokumente überein? Falls nicht...


- Sind Testdokumente aus der Testphase im Neuen Archiv, die noch nicht gelöscht wurden?

Testdokumente markieren, dann direkt in MyWork löschen (damit sie auch von der Platte entfernt werden)

 UPDATE

  [topfactArchiv].[dbo].[tf_Archive001]

  SET beschreibung = 'zuloeschen'

  WHERE tf_docid IN (

    SELECT

    tfa.tf_docid

    FROM [dwdata].[dbo].whm dw

    LEFT JOIN [topfactArchiv].[dbo].[tf_Archive001] tfa

    ON dw.DWDOCID = tfa.dwdocid

    WHERE tfa.dwdocid IS NULL --dokumente die keine dwdocid haben, aber eine tf_docid -> nur im neuen System abgelegt

    AND tfa.tf_docid IS NOT NULL

  )


- Wurden einzelne Dokumente nicht übernommen weil Techstatus=OK ein Export-Kriterium war?

- Information an den Kunden: Was ist mit den Dokumenten die "fehlen", was sind das für Dokumente und warum fehlen sie?

- Mögliche Gründe: Dateien im alten System waren nicht vorhanden, nur noch SQL DB Zeilen 

- Welche Dokumente sind die Diskrepanz?

  SELECT

  dw.DWDOCID, tfa.dwdocid, tfa.tf_docid, dw.DWSTOREDATETIME, dw.DWDISKNO, *

 

  FROM [dwdata].[dbo].whm dw --altes ARchiv

  LEFT JOIN [topfactArchiv].[dbo].[tf_Archive001] tfa --neues Archiv

  ON dw.DWDOCID = tfa.dwdocid

 

  --wo im neuen Archiv die DWDOCID leer ist: es gibt das Dokument nur in der alten Archivdatenbank, nicht in der Neuen...

  WHERE tfa.dwdocid IS NULL

 

  --AND dw.DWDISKNO IN (117, 118, 119) -- Optional weitere Kriterien

 

  ORDER BY dw.DWDOCID DESC


Weiteres..


Script für (+) Abweichungsmessung „Duplikate aus Altsystem“

 

SELECT distinct dwdocid, count(dwdocid) as duplikate, belegnummer, belegart, belegdatum

FROM [topfactArchiv].[dbo].[tf_Archive009]

WHERE dwdocid IS NOT NULL

GROUP BY dwdocid, belegnummer, belegart, belegdatum

HAVING count(dwdocid) > 1

ORDER By belegdatum desc

 

Script für (-) Abweichungsmessung „nicht importiert aus Altsystem“

 

SELECT * FROM [topfact6Sync_Glanz].[dbo].[v_dwdata_glanz19]

WHERE DWDOCID NOT IN (SELECT DISTINCT DWDOCID FROM [topfactArchiv].[dbo].[tf_Archive009] WHERE techinfo = 'Glanz19')



Lösungsmöglichkeiten sind nun (falls die Dokumente normal im alten Archiv vorhanden sind)

- nochmals einzeln als Datei Export ziehen

- Per SQL Script "markieren", dann mit ArchiveExport Modul exportieren und im neuen Archiv importieren

- Mit Kunden besprechen dass diese Dokumente nicht benötigt werden


Weitere Scripts zum Prüfen was sich wann am alten Archiv geändert hat:

-- In welchen Disks wurden neue Dokumente bearbeitet? In 2020+2021 abgelegt und in 2021 geändert

--> diese müssten wir mit kopieren

SELECT distinct DWDISKNO, COUNT(DWDISKNO) as anzahlbearbeitungenindiskno

--YEAR(DWMODDATETIME) as yr, *

  FROM [dwdata].[dbo].[WHM]

  where YEAR(DWMODDATETIME) >= 2021

  and YEAR(DWSTOREDATETIME) >= 2020

  --order by DWMODDATETIME desc

  GROUP BY DWDISKNO

 

-- In welchen Disks wurden alte Dokumente bearbeitet? vor 2020 abgelegt und in 2021 geändert

---> diese müssten wir später mit ArchiveExport holen

SELECT distinct DWDISKNO, COUNT(DWDISKNO) as anzahlbearbeitungenindiskno

--YEAR(DWMODDATETIME) as yr, *

  FROM [dwdata].[dbo].[WHM]

  where YEAR(DWMODDATETIME) >= 2021

  and YEAR(DWSTOREDATETIME) < 2020

  --order by DWMODDATETIME desc

  GROUP BY DWDISKNO

 

  SELECT *

  FROM [dwdata].[dbo].[WHM]

  where

  YEAR(DWMODDATETIME) >= 2021

  and YEAR(DWSTOREDATETIME) < 2020

  --AND DWDISKNO = 57

 -- AND DWMODUSER = 'GLEBER'

  order by DWMODDATETIME desc




Stempel

Der kritische Punkt beim Stempel-Import ist, das das Stempel Tool nur über die XML Daten der DW Dateistruktur arbeitet. D.h. Dokumente die über einen Archiv-Export aus DW exportiert wurden können keine Stempel Informationen enthalten. 

Ebenfalls problematisch sind Stempel, die vor einigen Jahren, von Mitarbeitern erstellt wurden die mittlerweile nicht mehr im (neuen) System existieren. Für diese Stempel muss eine Lösung gefunden werden.

Welche Nutzer sind alt und nicht in der neuen Liste, d.h. welche Stempel würden nicht angezeigt?

  SELECT *

  FROM [topfact6Sync].[dbo].[DWStamps_mve] stamps

  LEFT JOIN topfact6.dbo.TF_Benutzer b

  ON b.Kuerzel = stamps.username

  WHERE b.UserId IS NULL