AddAttachment

Syntaxe

Paramètres

Description

Cette fonction permet de téléverser un fichier d'une machine utilisateur vers une emplacement d'entreposage spécifié.

Remarques

• Gestion du téléversement entre client et serveur : La fonction AddAttachment constitue l'un des mécanismes principaux par lesquels PeopleSoft permet de transférer des fichiers depuis la machine locale de l'utilisateur vers le serveur. Elle encapsule toute la logique de communication, incluant la sélection du fichier, sa validation et son envoi via une interface intégrée. Cette abstraction rend inutile l'utilisation d'API systèmes plus complexes. Elle garantit également que le fichier final est conforme aux conventions de stockage imposées par l'application. Son usage simplifie ainsi les développements impliquant des documents, preuves ou pièces justificatives.
• Importance de la structure de nommage via DirAndFilePrefix : Le paramètre DirAndFilePrefix joue un rôle déterminant dans la gestion interne des fichiers, car il permet d'organiser efficacement les pièces jointes dans des répertoires logiques. En imposant un préfixe systématique, il contribue à éviter les conflits de noms lors de l'enregistrement de multiples fichiers similaires. Cette structuration aide aussi les administrateurs et les scripts d'exploitation à repérer plus facilement les fichiers entreposés. L'intégration de ce paramètre est une bonne pratique lorsqu'on traite des environnements multi-utilisateurs. Finalement, il favorise une meilleure maintenabilité des référentiels de documents.
• Contrôle strict du type de fichier via FileType : Le paramètre FileType permet d'accepter uniquement certains formats de fichier, ce qui est essentiel dans des environnements où la conformité et la sécurité sont prioritaires. En ne permettant que des extensions précises, le système réduit les risques d'injection de fichiers exécutables ou de contenu non autorisé. Cette validation diminue aussi les erreurs de traitement ultérieur, notamment dans des flux de travaux nécessitant l'analyse automatique des fichiers. Le développeur peut ainsi imposer des formats standardisés, comme PDF ou CSV. Ce filtrage contribue globalement à la qualité des données et à la sécurité de l'application.
• Sécurité et limitations via MaxSize : Le paramètre MaxSize sert à contrôler la taille des fichiers acceptés, ce qui joue un rôle important dans la protection de l'environnement PeopleSoft. Limiter la taille empêche les utilisateurs d'envoyer des fichiers massifs susceptibles de saturer le stockage. Cela protège également le réseau contre des transferts inutilement lourds, pouvant ralentir l'application. En ajoutant une valeur maximale réaliste, l'administrateur réduit les risques d'abus, qu'ils soient accidentels ou intentionnels. Cette limitation permet enfin de prévenir des erreurs de temps de transfert ou des dépassements de ressources.
• Importance du paramètre PreserveCase dans la standardisation : Le paramètre PreserveCase peut sembler secondaire, mais il a une importance opérationnelle non négligeable dans les systèmes sensibles au nom exact des fichiers. En contrôlant la casse, on peut soit conserver le nom tel qu'il est fourni par l'utilisateur, soit l'uniformiser selon une règle. L'uniformisation permet d'éviter que deux fichiers logiquement identiques apparaissent différents du seul fait des majuscules/minuscules. Cela facilite les recherches, l'indexation et les scripts automatisés. Dans des environnements multilingues, cette option permet également de normaliser les conventions d'écriture.
• Personnalisation de l'expérience utilisateur via UploadPageTitle : Le paramètre UploadPageTitle permet de définir un titre plus clair ou plus contextualisé pour la fenêtre de téléversement. Cette personnalisation est très utile lorsque la fonction AddAttachment est utilisée dans des composants variés ayant des finalités différentes. Un titre adapté permet d'éviter des confusions, surtout dans les interfaces complexes où plusieurs téléversements sont possibles. Cela renforce également l'ergonomie pour les utilisateurs non experts qui doivent comprendre immédiatement l'action attendue. Enfin, cette flexibilité facilite la localisation ou l'adaptation selon les besoins du projet.
• Amélioration du transfert de gros fichiers grâce à AllowLargeChunks : Le paramètre AllowLargeChunks est essentiel pour le transfert de fichiers volumineux ou segmentés. Il permet à PeopleSoft d'utiliser un mode de traitement optimisé, réduisant les risques d'interruption de téléversement en cas de réseau instable. Sans cette option, les gros fichiers pourraient provoquer des erreurs ou des délais d'attente excessifs. Il offre donc plus de robustesse dans les environnements où les utilisateurs ont des documents lourds tels que des vidéos ou scans haute résolution. Ce paramètre augmente ainsi la fiabilité du processus de téléversement dans des contextes variés.
• Centralisation, validation et auditabilité des fichiers téléversés : En utilisant AddAttachment, le système PeopleSoft centralise automatiquement les fichiers dans un emplacement défini et sécurisé. Cette centralisation facilite les politiques d'audit et de conformité, car les documents ne transitent pas de manière incontrôlée dans différentes zones du serveur. Le processus assure également une validation cohérente de chaque fichier, selon les paramètres fournis, créant un flux documenté et contrôlé. Cela évite les erreurs manuelles et renforce la traçabilité des opérations effectuées par les utilisateurs. Globalement, AddAttachment contribue à une gestion documentaire plus sûre et professionnelle.