PC SOFT

DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

  • Conditions d'utilisation
  • Codes d'erreur
  • Destination de l'archive
  • Suppression de l'archive originale
  • Espace réservé
  • Ordre de découpage
  • Nombre de parties
  • Fermeture de l'archive
  • Actions réalisables sur une archive multi-parties
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaEtats et RequêtesCode Utilisateur (MCU)
WEBDEV
WindowsLinuxPHPWEBDEV - Code Navigateur
WINDEV Mobile
AndroidWidget AndroidiPhone/iPadApple WatchUniversal Windows 10 AppWindows Mobile
Autres
Procédures stockées
Découpe une archive en plusieurs sous-archives d'une taille donnée.
Versions 17 et supérieures
iPhone/iPad Cette fonction est désormais disponible pour les applications iPhone/iPad.
Nouveauté 17
iPhone/iPad Cette fonction est désormais disponible pour les applications iPhone/iPad.
iPhone/iPad Cette fonction est désormais disponible pour les applications iPhone/iPad.
WINDEVWEBDEV - Code ServeurEtats et RequêtesAjaxCode Utilisateur (MCU)
ResOuvreArchive, ResDécoupe sont des entiers
// Ouverture de l'archive "Archive"
ResOuvreArchive = zipOuvre("Archive", "D:\Sauvegardes\Sauvegarde.WDZ")
 
SI ResOuvreArchive = 0 ALORS
// Découpage d'une archive en plusieurs sous-archives (1,4 Mo chacune)
ResDécoupe = zipDécoupe("Archive", "A:\Archive.WDZ", 1400*1024)
...
FIN
 
WINDEVWEBDEV - Code ServeurEtats et RequêtesAjaxCode Utilisateur (MCU)
ResOuvreArchive, ResDécoupe sont des entiers
Archive est un zipArchive
 
// Ouverture de l'archive "Archive"
ResOuvreArchive = zipOuvre(Archive, "D:\Sauvegardes\Sauvegarde.WDZ")
 
SI ResOuvreArchive = 0 ALORS
// Découpage d'une archive en plusieurs sous-archives (1,4 Mo chacune)
ResDécoupe = zipDécoupe(Archive, "A:\Archive.WDZ", 1400*1024)
...
FIN
 
Windows Mobile
ResOuvreArchive, ResDécoupe sont des entiers
// Ouverture de l'archive "Archive"
ResOuvreArchive = zipOuvre("Archive", "\Sauvegardes\Sauvegarde.zip")
SI ResOuvreArchive = 0 ALORS
// Découpage d'une archive en plusieurs sous-archives (1,4 Mo chacune)
ResDécoupe = zipDécoupe("Archive", "\Archive.zip", 1400*1024)
...
FIN
 
Windows Mobile
ResOuvreArchive, ResDécoupe sont des entiers
Archive est un zipArchive
// Ouverture de l'archive "Archive"
ResOuvreArchive = zipOuvre(Archive, "\Sauvegardes\Sauvegarde.zip")
SI ResOuvreArchive = 0 ALORS
// Découpage d'une archive en plusieurs sous-archives (1,4 Mo chacune)
ResDécoupe = zipDécoupe(Archive, "\Archive.zip", 1400*1024)
...
FIN
 
Syntaxe
<Résultat> = zipDécoupe(<Archive> , <Destination de l'archive> [, <Taille des sous-archives> [, <Suppression de l'archive originale> [, <Espace réservé> [, <Gestion de la jauge>]]]])
<Résultat> : Entier
  • 0 si l'archive a été découpée,
  • Un code d'erreur (valeur supérieure à 0) dans le cas contraire. Pour plus de détails sur ces codes d'erreur, consultez les Remarques.
<Archive> : Chaîne de caractères (avec guillemets) ou variable de type zipArchive
Nom de l'archive à manipuler.
Ce nom peut correspondre :
  • soit au nom d'une archive défini avec la fonction zipOuvre ou la fonction zipCrée.
  • Versions 15 et supérieures
    WINDEVWEBDEV - Code ServeurEtats et RequêtesWindows MobileAjax soit au nom d'une variable de type zipArchive.
    Nouveauté 15
    WINDEVWEBDEV - Code ServeurEtats et RequêtesWindows MobileAjax soit au nom d'une variable de type zipArchive.
    WINDEVWEBDEV - Code ServeurEtats et RequêtesWindows MobileAjax soit au nom d'une variable de type zipArchive.
<Destination de l'archive> : Chaîne de caractères (avec guillemets)
Chemin complet de la nouvelle archive multi-parties (260 caractères maximum). Ce chemin doit contenir le nom de l'archive multi-parties à créer. Il est possible de spécifier le même chemin et nom que l'archive originale : l'archive originale sera écrasée par l'archive découpée.
<Taille des sous-archives> : Entier optionnel
Taille en octets des volumes à créer. La taille par défaut des sous-archives est égale à 1,4 Mo (1400*1024 octets). La taille minimale est égale à 300 Ko par sous-archive (300*1024 octets).
<Suppression de l'archive originale> : Booléen optionnel
  • Vrai si l'archive originale doit être détruite pendant le découpage,
  • Faux (valeur par défaut) si l'archive originale ne doit pas être détruite pendant le découpage.
<Espace réservé> : Entier optionnel
Taille (en octets) d'un espace réservé à diminuer de la première sous-archive. La taille de la première sous-archive correspondra à : <Taille des sous-archives> - <Espace réservé>.
<Gestion de la jauge> : Chaîne de caractères optionnelle (avec ou sans guillemets)
Versions 21 et supérieures
WINDEViPhone/iPadWindows Mobile Nom d'un champ Jauge présent dans une fenêtre. Cette jauge affichera la progression du découpage.
Nouveauté 21
WINDEViPhone/iPadWindows Mobile Nom d'un champ Jauge présent dans une fenêtre. Cette jauge affichera la progression du découpage.
WINDEViPhone/iPadWindows Mobile Nom d'un champ Jauge présent dans une fenêtre. Cette jauge affichera la progression du découpage.
Remarques

Conditions d'utilisation

Le découpage d'une archive ne peut être réalisé que si :
  • L'archive existe (la création d'une archive s'effectue avec la fonction zipCrée).
  • L'archive est accessible en lecture et en écriture.
  • L'archive est mono-partie.
Attention :
  • Archives au format "CAB" : Cette fonction n'est pas disponible.
  • Archives au format "RAR" : Cette fonction n'est pas disponible.
  • Archives au format "7z" : Cette fonction n'est pas disponible.
  • Archives au format "TAR" et "TARGZ" : Cette fonction n'est pas disponible.
LinuxiPhone/iPadWindows Mobile Rappel : Seules les archives au format ZIP sont disponibles.
Rappel :
  • LinuxiPhone/iPad Seules les archives au format ZIP, TAR et TGZ (TAR.GZ) sont disponibles.
  • Windows Mobile Seules les archives au format ZIP sont disponibles.

Codes d'erreur

Les codes d'erreur retournés sont les suivants :
  • 1 : Le chemin passé en paramètre n'existe pas.
  • 2 : Accès interdit : l'utilisateur n'a pas les droits nécessaires.
  • 3 : L'archive est corrompue.
  • 6 : Les sous-archives ne sont pas dans l'ordre.
  • 22 : Il est interdit de découper une archive au format zip en une seule partie.
Le message correspondant au code d'erreur peut être connu grâce à la fonction zipMsgErreur.

Destination de l'archive

<Destination> doit correspondre à un support accessible en lecture et en écriture. Ce support peut être :
  • Un disque dur.
  • Un lecteur de disquettes, un lecteur réseau, etc.
  • Un lecteur réseau auquel une lettre de lecteur a été attribué. Il est impossible d'effectuer un découpage vers un lecteur UNC.
La destination est une disquette : Une boîte de dialogue demande automatiquement le changement de disquettes. Si le bouton "Annuler" de cette boite de dialogue est utilisé, la fonction zipDécoupe renvoie l'erreur 3 : "L'archive découpée est corrompue (sa création n'est pas terminée), l'archive originale est intacte".
Attention : Si le paramètre <Suppression de l'archive originale> est Vrai, l'archive originale et l'archive découpée sont toutes les deux corrompues.
Extension de l'archive multi-parties (format WDZ)Extension de l'archive multi-parties (format ZIP)
Si l'extension de l'archive n'est pas précisée, l'extension par défaut de la première sous-archive sera .WDZ.
L'extension des autres sous-archives seront automatiquement rajoutées (".001" à ".999").
Par exemple : si <Destination> = "C:\MesArchives\ArchiveDécoupée.WDZ", l'archive sera découpée dans le répertoire "C:\MesArchives" de la manière suivante :
  • ArchiveDécoupée.WDZ
  • ArchiveDécoupée.001
  • ArchiveDécoupée.002
  • ArchiveDécoupée.003
  • ...
Si l'extension de l'archive n'est pas précisée, l'extension par défaut de la première sous-archive sera .ZIP.
L'extension des autres sous-archives seront automatiquement rajoutées (".Z01" à ".Z99").
Par exemple : si <Destination> = "C:\MesArchives\ArchiveDécoupée.ZIP", l'archive sera découpée dans le répertoire "C:\MesArchives" de la manière suivante :
  • ArchiveDécoupée.ZIP
  • ArchiveDécoupée.Z01
  • ArchiveDécoupée.Z02
  • ArchiveDécoupée.Z03
  • ...

Suppression de l'archive originale

Lorsque le paramètre <Suppression de l'archive originale> a pour valeur Vrai, le découpage entraîne la fermeture de l'archive originale ainsi que sa destruction au fur et à mesure du découpage.
Remarques :
  • Pour minimiser l'espace disque nécessaire pour effectuer le découpage, configurez le paramètre <Suppression de l'archive originale> à Vrai. En effet, pour découper une archive de taille importante, l'espace disque nécessaire correspond à deux fois la taille de l'archive : une fois pour l'archive originale et une fois pour l'archive découpée.
  • Ce paramètre doit être utilisé avec prudence. En effet, en cas de problème pendant le découpage, l'archive originale et l'archive découpée seront toutes les deux détruites. Si l'espace disque est suffisant, il est préférable de découper l'archive originale et de supprimer cette même archive originale par la suite.

Espace réservé

La taille de la première sous-archive peut être plus petite que la taille des autres sous-archives. Il suffit d'indiquer la taille en octets à diminuer de la première sous-archive dans le paramètre <Espace réservé>.
Par exemple, dans le cas d'une copie sur disquettes, il peut être utile que la première sous-archive n'occupe pas tout l'espace de la première disquette. Il est ainsi possible de conserver des fichiers existants sur la première disquette.
La taille de la première sous-archive correspondra à : <Taille des sous-archives> - <Espace réservé>.
Remarque : La taille de la première sous-archive doit respecter la formule suivante :
<Taille des sous-archives> - <Espace réservé> > 300 Ko.
Par exemple, si la taille de chaque sous-archive est de 1,4 Mo, la taille de l'espace réservé ne peut pas dépasser 1,1 Mo.

Ordre de découpage

Lors du découpage d'une archive, l'ordre de découpage est le suivant :
  • Création de la sous-archive N (extension ".NNN-1" ou ".ZNN-1").
  • ...
  • Création de la sous-archive 2 (extension ".001" ou "Z01").
  • Création de la sous-archive 1 (extension ".WDZ" ou "ZIP").
Par exemple, si une archive est découpée en 4 parties, 4 sous-archives seront construites. La quatrième sous-archive (extension ".003" ou "Z03") sera créée en premier. La première sous-archive (extension ".WDZ" ou ".ZIP") sera créée en dernier.
Découpage d'une archive directement sur disquettes : La première disquette insérée contiendra la dernière sous-archive.

Nombre de parties

La fonction zipNbPartieNécessaire permet de connaître le nombre de parties nécessaires au découpage de l'archive.
La fonction zipNbPartie permet de connaître le nombre de sous-archives d'une archive multi-parties.
Remarque : Le découpage d'une archive au format ZIP en une seule partie est interdit et provoque une erreur.

Fermeture de l'archive

Après utilisation de la fonction zipDécoupe sur une archive, cette archive ne se ferme pas. Il est nécessaire d'utiliser les fonctions :
  • zipFerme pour fermer l'archive mono-partie.
  • zipOuvre pour ouvrir la nouvelle archive multi-parties.
Remarque : Si le paramètre <Suppression de l'archive originale> a pour valeur Vrai, l'archive originale est automatiquement fermée par le découpage.

Actions réalisables sur une archive multi-parties

Certaines fonctions d'archivage sont utilisables uniquement sur des archives mono-partie (ajout et suppression de fichiers, création d'un exécutable auto-extractible, ...). Pour effectuer ces opérations, il suffit de regrouper les sous-archives (fonction zipRegroupe) pour obtenir une archive mono-partie.
A partir d'une archive multi-parties, il est uniquement possible de :
Composante : wd240zip.dll
Version minimum requise
  • Version 9
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire