La conversion de la mise en page d’un document Word est un besoin fréquent lors de la génération de rapports, de contrats ou de brochures imprimables. GroupDocs.Merger Cloud SDK for Node.js permet aux développeurs de programmer convertir l’orientation des pages Word dans Node.JS avec seulement quelques lignes de code. Ce guide vous accompagne à travers les étapes requises, montre un exemple complet fonctionnel, démontre les appels cURL équivalents et explique l’installation et la configuration afin que vous puissiez intégrer les changements d’orientation de page dans vos applications Node.js.

Étapes pour convertir l’orientation de page Word dans Node.JS

  1. Installez le SDK et configurez les informations d’identification : Utilisez npm pour ajouter la bibliothèque et configurez votre ID client et secret.

    npm install groupdocs-merger-cloud

  2. Créer l’instance de l’API: Initialisez ChangePageOrientationApi avec l’objet de configuration.

    const GroupDocsMergerCloud = require('groupdocs-merger-cloud');
const clientId = 'YOUR_CLIENT_ID';
const clientSecret = 'YOUR_CLIENT_SECRET';
const config = new GroupDocsMergerCloud.Configuration(clientId, clientSecret);
const orientationApi = new GroupDocsMergerCloud.ChangePageOrientationApi(config);

  3. Construire les options de requête : Définissez le fichier source, la plage de pages, l’orientation souhaitée et le chemin de sortie.

const options = new GroupDocsMergerCloud.ChangePageOrientationOptions();
options.fileInfo = new GroupDocsMergerCloud.FileInfo();
options.fileInfo.filePath = 'input.docx';
options.pages = ['1-']; // all pages
options.orientation = GroupDocsMergerCloud.Orientation.Landscape; // or Portrait
options.outputPath = 'output.docx';

  1. Exécuter le changement d’orientation : Envoyez la requête et gérez la réponse.

    const request = new GroupDocsMergerCloud.ChangePageOrientationRequest(options);
orientationApi.changePageOrientation(request)
    .then(response => {
        console.log('Page orientation conversion completed.');
        console.log('Output stored at:', response.path);
    })
    .catch(error => {
        console.error('Error during orientation conversion:', error);
    });

  2. (Optionnel) Ajuster les paramètres supplémentaires: Vous pouvez modifier le tableau pages pour cibler des pages spécifiques ou changer l’énumération orientation en Portrait pour une mise en page différente.

Modification de l’orientation de la page Word - Exemple de code complet

L’exemple suivant montre le flux de travail complet pour changer l’orientation d’un fichier DOCX à l’aide du GroupDocs.Merger Cloud SDK for Node.js.

const GroupDocsMergerCloud = require('groupdocs-merger-cloud');

// ==== Configuration ====
// Replace with your actual credentials
const clientId = 'YOUR_CLIENT_ID';
const clientSecret = 'YOUR_CLIENT_SECRET';
const config = new GroupDocsMergerCloud.Configuration(clientId, clientSecret);

// ==== API Instance ====
const orientationApi = new GroupDocsMergerCloud.ChangePageOrientationApi(config);

// ==== Request Construction ====
const options = new GroupDocsMergerCloud.ChangePageOrientationOptions();
options.fileInfo = new GroupDocsMergerCloud.FileInfo();
options.fileInfo.filePath = 'input.docx';               // source Word document
options.pages = ['1-'];                                 // apply to all pages (1 to end)
options.orientation = GroupDocsMergerCloud.Orientation.Landscape; // Portrait or Landscape
options.outputPath = 'output.docx';                     // destination file

const request = new GroupDocsMergerCloud.ChangePageOrientationRequest(options);

// ==== Execution ====
orientationApi.changePageOrientation(request)
    .then(response => {
        console.log('Page orientation conversion completed.');
        console.log('Output stored at:', response.path);
    })
    .catch(error => {
        console.error('Error during orientation conversion:', error);
    });

Note: Ce exemple de code démontre la fonctionnalité principale. Avant de l’utiliser dans votre projet, assurez‑vous de mettre à jour les chemins de fichiers (input.docx, output.docx) afin qu’ils correspondent à vos emplacements réels, vérifiez que toutes les dépendances requises sont correctement installées et testez soigneusement dans votre environnement de développement. Si vous rencontrez des problèmes, veuillez consulter la documentation officielle ou contacter l’équipe de support pour obtenir de l’aide.

Changer l’orientation de la page via l’API REST avec cURL

Si vous préférez une approche purement HTTP, la même opération peut être effectuée avec des commandes cURL contre les points de terminaison REST de GroupDocs.Merger Cloud.

  1. Obtenir un jeton d’accès
curl -X POST "https://api.groupdocs.cloud/v1.0/oauth2/token" \
        -H "Content-Type: application/json" \
        -d '{"client_id":"YOUR_CLIENT_ID","client_secret":"YOUR_CLIENT_SECRET"}'

La réponse contient access_token.

  1. Télécharger le fichier DOCX source
curl -X POST "https://api.groupdocs.cloud/v1.0/merger/storage/upload" \
        -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
        -F "file=@input.docx" \
        -F "path=/input.docx"
  1. Demande de changement d’orientation
curl -X POST "https://api.groupdocs.cloud/v1.0/merger/words/changePageOrientation" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -H "Content-Type: application/json" \
     -d '{
           "fileInfo": { "filePath": "/input.docx" },
           "pages": ["1-"],
           "orientation": "Landscape",
           "outputPath": "/output.docx"
         }'
  1. Télécharger le fichier résultant
curl -X GET "https://api.groupdocs.cloud/v1.0/merger/storage/download?path=/output.docx" \
        -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
        -o output.docx

Pour plus de détails sur les charges utiles de la requête et les paramètres pris en charge, consultez la documentation officielle de l’API.

Installation et configuration de GroupDocs.Merger Cloud SDK for Node.js

Pour commencer, installez le package depuis npm et configurez vos identifiants.

npm install groupdocs-merger-cloud

const GroupDocsMergerCloud = require('groupdocs-merger-cloud');
const clientId = 'YOUR_CLIENT_ID';
const clientSecret = 'YOUR_CLIENT_SECRET';
const config = new GroupDocsMergerCloud.Configuration(clientId, clientSecret);

Téléchargez la dernière bibliothèque depuis la page de publication si vous avez besoin d’une version spécifique. Assurez-vous que votre environnement exécute Node.js 12 ou une version supérieure et que vous disposez d’un compte GroupDocs Cloud valide.

Configuration des options d’orientation de la page

Le SDK expose plusieurs propriétés que vous pouvez ajuster :

  • pages - Définissez les pages à affecter (par ex., ['1-5'] pour les cinq premières pages).
options.pages = ['1-5'];
  • orientation - Choisissez GroupDocsMergerCloud.Orientation.Portrait ou Landscape.
options.orientation = GroupDocsMergerCloud.Orientation.Portrait;
  • outputPath - Spécifiez le chemin de destination dans votre stockage cloud.
options.outputPath = 'converted/output.docx';

Ces options font partie de la classe ChangePageOrientationOptions documentée dans la référence API.

Conclusion

Modifier la mise en page des fichiers Word de manière programmatique est simple avec le GroupDocs.Merger Cloud SDK for Node.js. En suivant les étapes ci‑dessus, vous pouvez convertir l’orientation des pages Word dans Node.JS, automatiser le traitement en masse et intégrer les changements d’orientation dans n’importe quel flux de travail de documents. N’oubliez pas d’obtenir une licence appropriée pour une utilisation en production ; les détails des tarifs sont disponibles sur la page du produit, et vous pouvez obtenir une licence temporaire depuis la page de licence temporaire. Avec le SDK installé et configuré, vous êtes prêt à enrichir vos applications avec des capacités flexibles de manipulation de documents.

FAQ

  • Comment changer l’orientation de la page dans les documents Word en utilisant Node.js ?
    Utilisez le ChangePageOrientationApi du GroupDocs.Merger Cloud SDK for Node.js, définissez l’orientation souhaitée dans les options de requête, puis exécutez l’appel API.

  • Existe-t-il un moyen d’exporter l’orientation de page Word en Node.JS sans écrire de code ?
    Oui, la même opération peut être effectuée via l’API REST en utilisant des commandes cURL, ce qui est utile pour des scripts rapides ou l’intégration avec d’autres systèmes.

  • Quelles orientations sont prises en charge pour les documents Word ?
    Le SDK prend en charge les modes Portrait et Landscape via l’énumération Orientation. Vous pouvez également spécifier des plages de pages pour appliquer le changement sélectivement.

  • Ai-je besoin d’une licence pour exécuter cela en production ?
    Une licence valide est requise pour les déploiements en production. Vous pouvez commencer avec une licence temporaire depuis la page de licence temporaire et passer à une licence complète à mesure que votre utilisation augmente.

En savoir plus