J'ai maintenant travaillé sur de nombreuses migrations de la version 7.6 à MAS. Cela a été un beau changement de rythme par rapport à la même ancienne mise à jour 7.6. Cependant, dans le cadre du passage à MAS, nous avons également déménagé là où se trouve le stockage des fichiers pour DOCLINKS. Vous pouvez désormais utiliser les réclamations de volume persistantes (PVC) ou S3. Nous hébergeons maintenant DOCLINKS à l'aide de S3. Le passage à S3 signifie que nous devons modifier DOCLINKS. Ce faisant, j'ai beaucoup appris sur la modification de DOCLINKS et sur la manière de le faire en toute sécurité, sans casser toutes vos pièces jointes stockées.
‍

Avant de commencer à expliquer le processus des meilleures pratiques. Je veux être sûr que vous connaissez les éléments importants qui contrôlent DOCLINKS. Les tables principales sont DOCINFO et DOCLINKS. Vous devez également comprendre que la pièce jointe physique se trouve dans le PVC, ou dans le compartiment S3, et non dans la base de données elle-même.

DOCINFO

Cela permet de stocker les métadonnées de la pièce jointe. Colonnes clés :

• DOCINFOID
  
  • Identifiant unique
  • Relation avec DOCLINKS
• NOM D'URL
  
  • Chemin de fichier réel
• TYPE D'URL
  
  • FICHIER ou URL
• DOCTYPE
  
  • Pièce jointe, image, etc.
  • S3 - Il s'agit d'une balise de métadonnées qui n'a aucun impact sur l'emplacement actuel des fichiers.
  • Dossier : il peut être utilisé comme dossier enfant (ou structure de dossiers distincte) et sépare les pièces jointes.

LIENS VERS LES DOCKS

Ceci relie le document à un Gérez record. Colonnes clés :

• TABLE DES PROPRIÉTAIRES
  
  • Indique sur quel objet vit le DOCLINKS
  • Exemple : ordre de travail
• IDENTIFIANT DU PROPRIÉTAIRE
  
  • ID unique pour la colonne du tableau
  • Utilisé pour trouver l'enregistrement sur lequel se trouve le DOCLINK ; utilisé dans les relations pour joindre la table avec des pièces jointes
• DOCINFOID
  
  • Relation avec DOCINFO

Meilleures pratiques

Sauvegarde du système

Chaque fois que vous apportez une modification à DOCLINKS, DOCINFO ou, honnêtement, à tout autre élément lié aux données, effectuez une sauvegarde de votre système. Effectuez d'abord les modifications dans un environnement non lié à la production. Vous pouvez également exécuter SQL pour créer une sauvegarde de table DOCINFO afin de ne pas la perdre et supprimer la table une fois que vous avez terminé pour revenir facilement à la table DOCINFO.

SQL

SELECT * INTO DOCINFO_BACKUP FROM DOCINFO;
DROP TABLE DOCINFO_BACKUP;

DB2

CREATE TABLE DOCINFO_BACKUP AS (SELECT * FROM DOCINFO) WITH DATA; 
DROP TABLE DOCINFO_BACKUP; 

Oracle

CREATE TABLE DOCINFO_BACKUP AS SELECT * FROM DOCINFO; 
DROP TABLE DOCINFO_BACKUP; 

Commencez avec une seule pièce jointe

Réduisez d'abord les modifications que vous apportez à un fichier. Il se peut que de nombreux noms d'URL différents aient besoin d'être mis à jour. Si vous essayez de les faire toutes en même temps, vous risquez de gâcher toutes les URL. Prenez votre temps et étudiez d'abord ce qui est nécessaire pour changer.
‍

REMARQUE : les seules mises à jour que nous devrons apporter concernent la table DOCINFO et non la table DOCLINK. Vous ne devriez pas avoir besoin de mettre à jour DOCLINKS pendant tout ce processus.

Types d'URL de FICHIER

Je concentre mon énergie uniquement sur les types d'URL de FICHIER. Il s'agit des documents qui sont stockés dans le stockage des pièces jointes que vous utilisez.

Changement de couverture

Souvent, vous aurez envie d'effectuer un changement général, comme ci-dessous ; c'est presque un bon changement, mais il manque certaines informations :
‍

UPDATE DOCINFO SET URLNAME = REPLACE(URLNAME,'\\OLD','\\NEW')

Il s'agit d'une erreur qui peut entraîner de multiples problèmes :

• La sensibilité majuscules/minuscules peut être désactivée
• Vous pouvez mettre à jour tous vos dossiers
• Vous pourriez en faire un chemin UNC non valide

Motif DOCLINKS

Trouvez un modèle pour vos DOCLINKS et utilisez-le pour créer une déclaration de mise à jour. Vous pouvez commencer avec SQL comme suit :
‍

SELECT URLNAME FROM DOCINFO WHERE URLTYPE = 'FILE' 

Si tous les DOCLINKS ont un chemin similaire, tel que \ \ server \ DOCLINKS \, vous pouvez créer une instruction générale. Cependant, je recommande toujours de tester un seul document en utilisant quelque chose comme ceci :

‍

UPDATE DOCINFO SET URLNAME = 
REPLACE(URLNAME,'\\OLD_SERVER\DOCLINKS','\\NEW_SERVER\DOCLINKS') 
WHERE URLNAME = '\\OLD_SERVER\DOCLINKS\[TEST.TXT]' AND URLTYPE=’FILE’

Vérification

Vérifiez que la pièce jointe que vous modifiez fonctionne dans l'interface utilisateur frontale.

Remplacement contrôlé

L'utilisation d'un remplacement contrôlé vous permet de vous assurer de ne mettre à jour que les DOCLINKS qui correspondent à ce que vous souhaitez remplacer :

‍

UPDATE DOCINFO SET URLNAME = 
REPLACE(URLNAME,'\\OLD_SERVER\DOCLINKS','\\NEW_SERVER\DOCLINKS') 
WHERE URLNAME LIKE '\\OLD_SERVER\DOCLINKS%' AND URLTYPE=’FILE’

Répéter

Procédez ainsi pour tous les noms d'URL uniques dont vous avez besoin jusqu'à ce que tous vos enregistrements DOCINFO pointent vers votre nouveau stockage de fichiers.

‍

Tous les problèmes DOCINFO ne nécessitent pas nécessairement une telle mise à jour de l'URLNAME. Cependant, la modification des solutions de stockage de fichiers nécessitera ces modifications d'URL. Elles nécessiteront également quelques mises à jour de certaines configurations dans les propriétés du système. Il se peut que vous deviez mettre à jour les propriétés suivantes :

• mxe.DocClink.DocTypes.DefPath

• mxe.DocLink.DocTypes.TopLevelPaths

• mxe.DocLink.Path01

• mxe.attachmentstorage

• MXE.DocLink. Pièce jointe sécurisée

‍

Si vous utilisez S3, vous devrez également autoriser Manage à accéder au compartiment en mettant à jour les propriétés système suivantes :

• mxe.cosendpointuri

• clé d'accès mxe.cos

• clé secrète mxe.cos

• nom de compartiment mxe.cos

‍

Enfin, vous souhaiterez revoir vos doctypes. Après avoir effectué toutes ces modifications, la table DOCTYPES fera toujours référence à votre ancien système de stockage. Vous souhaiterez le mettre à jour vers votre nouveau système de stockage :

‍

UPDATE doctypes SET defaultfilepath = ‘[NEW Default Path]’

‍

La cause la plus fréquente de rupture des pièces jointes dans les environnements Maximo n'est pas la corruption ; ce sont des administrateurs bien intentionnés qui mettent à jour les chemins DOCLINK sans comprendre comment DOCINFO et DOCLINKS interagissent.
‍

Clients actuels : lors de la mise à niveau vers MAS, cela est géré pour vous dans le cadre de la mise à niveau. Si vous envisagez de vous inscrire Le cloud de Naviam, nous gérons ces modifications pour vous dans le cadre de la mise en œuvre. Vous n'aurez même pas à vous en soucier pour votre système.