تحويل ملف Excel إلى تنسيق مختلف يشير هذا REST API إلى ملف Excel convert
بتنسيق ملف مختلف.
الطلب هو طلب HTTP بمحتوى متعدد الأجزاء (انظرRFC 2046 أوRFC 1341 يحتوي الجزء الأول من المحتوى المتعدد الأجزاء على ملف البيانات، ويحتوي الجزء الثاني على خيارات الحفظ.
معلمة الاستعلام
اسم المعلمة
يكتب
وصف
شكل
خيط
تنسيق الملف: csv، xls، html، mhtml، ods، pdf، xml، txt، tiff، xlsb، xlsm، xlsx، xltm، xltx، xps، png، jpg، gif، emf، bmp، md، Numbers، wmf، svg، وما إلى ذلك.
كلمة المرور
خيط
كلمة المرور المطلوبة لفتح الملف Excel.
المسار الخارجي
خيط
مسار حفظ النتيجة. إذا كان ملفًا واحدًا، فيجب أن يتضمن الرمز outPath
اسم الملف وامتداده. أما في حالة وجود ملفات متعددة، فيجب أن يتضمن الرمز outPath
المجلد فقط.
اسم التخزين
خيط
اسم التخزين الذي يوجد فيه الملف.
التحقق من قيود Excel
منطقي
ما إذا كان يتم التحقق من تقييد ملف Excel عندما يقوم المستخدم بتعديل الكائنات المرتبطة بالخلايا.
تنسيق التدفق
خيط
تنسيق تدفق ملف الإدخال.
منطقة
خيط
الإعدادات الإقليمية للمصنف.
ملاءمة الصفحة العريضة لكل ورقة
منطقي
تناسب الصفحة على نطاق واسع في ورقة العمل.
طول الصفحة يتناسب مع كل ورقة
منطقي
الصفحة الطويلة تناسب ورقة العمل.
اسم الورقة
خيط
تحويل ورقة العمل المحددة.
فهرس الصفحة
خيط
تحويل الصفحة المحددة من ورقة العمل، مطلوب sheetName.
صفحة واحدة لكل ورقة
منطقي
عند التحويل إلى تنسيق PDF، صفحة واحدة لكل ورقة.
صفوف تلقائية
منطقي
يتناسب تلقائيًا مع جميع الصفوف في هذا المصنف.
ملاءمة الأعمدة التلقائية
منطقي
يتناسب عرض الأعمدة في هذا المصنف تلقائيًا.
معلمة نص الطلب
اسم المعلمة
يكتب
وصف
ملف البيانات
ملف البيانات
يتم حفظ ملف البيانات في الجزء الأول من المحتوى المتعدد الأجزاء.
حفظ الخيارات
هدف
خيار الحفظ هو الحفظ في الجزء الثاني من المحتوى المتعدد الأجزاء.
الباقي API
API
يكتب
وصف
رابط سواجر
/خلايا/تحويل
يضع
تحويل المصنف من محتوى الطلب إلى تنسيق ما
ضع كتاب العمل المحول
المواصفات OpenAPI يحدد واجهة برمجة يمكن الوصول إليها بشكل عام ويسمح لك بتنفيذ تفاعلات REST مباشرة من متصفح الويب.
يمكنك استخدامcURL أداة سطر أوامر للوصول بسهولة إلى خدمات الويب Aspose.Cells. يوضح المثال التالي كيفية إجراء مكالمات إلى Cloud API باستخدام cURL.
عائلة SDK السحابية
يُعد استخدام حزمة تطوير برمجيات (SDK) أفضل طريقة لتسريع عملية التطوير. فهي تُعنى بالتفاصيل البسيطة وتُتيح لك التركيز على مهام مشروعك. يُرجى الاطلاع علىمستودع GitHub للحصول على قائمة كاملة بـ Aspose.Cells Cloud SDKs.
توضح أمثلة التعليمات البرمجية التالية كيفية إجراء مكالمات إلى خدمات الويب Aspose.Cells باستخدام مجموعات أدوات تطوير البرامج المختلفة:
C#
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
namespace Aspose.Cells.Cloud.SDK.Tests.Api.Example
{
using Microsoft.VisualStudio.TestTools.UnitTesting;
using Aspose.Cells.Cloud.SDK.Request;
using System.Collections.Generic;
using Aspose.Cells.Cloud.SDK.Api;
using System;
using System.IO;
[TestClass]
public class CellsApiExample
{
string CellsCloudClientId ="....";//get from https://dashboard.aspose.cloud/#/applications
string CellsCloudClientSecret="...";//get from https://dashboard.aspose.cloud/#/applications
CellsApi cellsApi = new CellsApi(CellsCloudClientId, CellsCloudClientSecret);
string localName = "Book1.xlsx";
string localPath = "D:/TestData/CellsCloud";
string outputFilePath = "D:/Outpath";
[TestCategory("Cells")]
[TestMethod]
public void Example()
{
IDictionary<string, Stream> mapFiles = new Dictionary<string, Stream>();
mapFiles.Add(localName, File.OpenRead(localPath +"/"+ localName));
PutConvertWorkbookRequest request = new PutConvertWorkbookRequest { File = mapFiles, format = "pdf" };
var response = cellsApi.PutConvertWorkbook(request);
File.WriteAllBytes(outputFilePath, response);
}
}
}
Java
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
package com.aspose.cloud.cells.api;
import com.aspose.cloud.cells.client.*;
import com.aspose.cloud.cells.model.*;
import com.aspose.cloud.cells.request.*;
import java.io.IOException;
import org.junit.Test;
import java.util.ArrayList;
import java.util.List;
import java.io.File;
import java.util.HashMap;
public class Example {
private CellsApi api;
public Example(){
try {
String CellsCloudClientId ="....";//get from https://dashboard.aspose.cloud/#/applications
String CellsCloudClientSecret="...";//get from https://dashboard.aspose.cloud/#/applications
api = new CellsApi(CellsCloudClientId, CellsCloudClientSecret);
} catch (ApiException e) {
e.printStackTrace();
}
}
public void Run(){
try{
String localName = "Book1.xlsx";
String localPath = "D:/TestData/CellsCloud";
String format = "pdf";
PutConvertWorkbookRequest request = new PutConvertWorkbookRequest();
request.setFormat(format);
HashMap<String,File> fileMap = new HashMap<String,File>();
fileMap.put(localName ,CellsApiUtil.GetFileHolder(localPath"+"localName) );
request.setFile(fileMap);
this.api.putConvertWorkbook(request);
} catch (ApiException e) {
e.printStackTrace();
}catch (IOException e) {
e.printStackTrace();
}
}
}
PHP
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
<?php
require_once('vendor\autoload.php');
use \Aspose\Cells\Cloud\Api\CellsApi;
use \Aspose\Cells\Cloud\Request\PutConvertWorkbookRequest;
$CellsCloudClientId = "...." ; # get from https://dashboard.aspose.cloud/#/applications
$CellsCloudClientSecret = "...."; # get from https://dashboard.aspose.cloud/#/applications
$cellsApi = new CellsApi($CellsCloudClientId , $CellsCloudClientSecret );
$request = new PutConvertWorkbookRequest();
$request->setFile( 'TestData/Book1.xlsx');
$request->setFormat("pdf");
$response = $cellsApi->putConvertWorkbook($request);
copy($response->getPathname(),"Book1.pdf");
Ruby
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
require 'openssl'
require 'bundler'
require 'aspose_cells_cloud'
CellsCloudClientId = "...." # get from https://dashboard.aspose.cloud/#/applications
CellsCloudClientSecret = "...." # get from https://dashboard.aspose.cloud/#/applications
@instance = AsposeCellsCloud::CellsApi.new(CellsCloudClientId, CellsCloudClientSecret)
local_name = 'Book1.xlsx'
format = "pdf"
mapFiles = { }
mapFiles[local_name]= ::File.open(File.expand_path("TestData/"+local_name),"r")
request = AsposeCellsCloud::PutConvertWorkbookRequest.new(:File=>mapFiles,:format=>format);
@instance.put_convert_workbook(request);
Node.js
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
import { CellsApi, PutConvertWorkbookRequest } from "asposecellscloud";
var fs = require('fs');
var path = require('path');
var process = require('process');
const _ = require('asposecellscloud');
const CellsCloudClientId ="....";//get from https://dashboard.aspose.cloud/#/applications
const CellsCloudClientSecret="...";//get from https://dashboard.aspose.cloud/#/applications
const cellsApi = new CellsApi(CellsCloudClientId, CellsCloudClientSecret);
var localPath = "TestData/CellsCloud/"
var localName = "Book1.xlsx"
describe('example', function(){
it("should call successfully" , function(){
var format = "pdf"
var mapFiles = {};
mapFiles[localName]= fs.createReadStream(localPath +localName) ;
var request = new PutConvertWorkbookRequest();
request.file = mapFiles;
request.format = format;
return cellsApi.putConvertWorkbook(request)
});
});
Python
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
import os
import shutil
import sys
from asposecellscloud.apis.cells_api import CellsApi
from asposecellscloud.models import *
from asposecellscloud.requests import *
CellsCloudClientId ='....' # get from https://dashboard.aspose.cloud/#/applications
CellsCloudClientSecret='....' # get from https://dashboard.aspose.cloud/#/applications
api = CellsApi(CellsCloudClientId,CellsCloudClientSecret)
response = api.put_convert_workbook(PutConvertWorkbookRequest("Book1.xlsx",format= "pdf"))
shutil.move( response ,"Book12.pdf")
Perl
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
use lib 'lib';
use strict;
use warnings;
use File::Slurp;
use MIME::Base64;
use AsposeCellsCloud::CellsApi;
my $CellsCloudClientId = "...."; # get from https://dashboard.aspose.cloud/#/applications
my $CellsCloudClientSecret = "...."; # get from https://dashboard.aspose.cloud/#/applications
my $config = AsposeCellsCloud::Configuration->new( client_id => $CellsCloudClientId , client_secret => $CellsCloudClientSecret );
my $instance = AsposeCellsCloud::CellsApi->new(AsposeCellsCloud::ApiClient->new( $config));
my $localName = 'Book1.xlsx';
my $format = 'pdf';
my $mapFiles = {};
$mapFiles->{$localName}= "TestData/".$localName ;
my $request = AsposeCellsCloud::Request::PutConvertWorkbookRequest->new();
$request->{file} = $mapFiles;
$request->{format} = $format;
$instance->put_convert_workbook(request=> $request);
Go
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
package main
import (
"os"
. "github.com/aspose-cells-cloud/aspose-cells-cloud-go/v25"
)
func main() {
println("Hello Aspose.Cells Cloud!")
CellsCloudClientId := "...." // get from https://dashboard.aspose.cloud/#/applications
CellsCloudClientSecret := "...." // get from https://dashboard.aspose.cloud/#/applications
instance := NewCellsApiService(CellsCloudClientId, CellsCloudClientSecret)
request := PutConvertWorkbookRequest{File: map[string]string{"Book1.xlsx": "TestData/Book1.xlsx"}, Format: "pdf"}
data, _, err := instance.PutConvertWorkbook(&request)
if err == nil {
file, _ := os.OpenFile("Book1.pdf", os.O_WRONLY|os.O_CREATE|os.O_APPEND, 0644)
file.Write(data)
defer file.Close()
}
}