إضافة شكل إلى ورقة عمل Excel

يشير هذا REST API إلى إضافة شكل إلى ورقة عمل Excel.

RSET API

 
PUT http://api.aspose.cloud/v3.0/cells/{name}/worksheets/{sheetName}/shapes

معلمات الطلب هي:

اسم المعلمة	يكتب	المسار/سلسلة الاستعلام/نص HTTP	وصف
اسم	خيط	طريق	اسم المستند.
اسم الورقة	خيط	طريق	اسم ورقة العمل.
شكل DTO		جسم
نوع الرسم	خيط	استفسار	شكل نوع الكائن
الصف العلوي الأيسر	عدد صحيح	استفسار	مؤشر الصف العلوي الأيسر.
العمود الأيسر العلوي	عدد صحيح	استفسار	فهرس العمود العلوي الأيسر.
قمة	عدد صحيح	استفسار	يمثل الإزاحة الرأسية لـ Spinner من الصف الأيسر، بوحدة البكسل.
غادر	عدد صحيح	استفسار	يمثل الإزاحة الأفقية لـ Spinner من العمود الأيسر، بوحدة البكسل.
عرض	عدد صحيح	استفسار	يمثل ارتفاع Spinner، بوحدة البكسل.
ارتفاع	عدد صحيح	استفسار	يمثل عرض Spinner، بوحدة البكسل.
مجلد	خيط	استفسار	مجلد المستند.
اسم التخزين	خيط	استفسار	اسم التخزين.

المواصفات OpenAPI يحدد واجهة برمجة يمكن الوصول إليها بشكل عام ويسمح لك بتنفيذ تفاعلات REST مباشرة من متصفح الويب.

يمكنك استخدام أداة سطر الأوامر cURL للوصول بسهولة إلى خدمات الويب Aspose.Cells. يوضح المثال التالي كيفية إجراء مكالمات إلى Cloud API باستخدام cURL.

Request

 
curl -v "https://api.aspose.cloud/v3.0/cells/Book1.xlsx/worksheets/Sheet1/shapes?DrawingType=arc&upperLeftRow=1&upperLeftColumn=1&top=1&left=1&width=100&height=100" \
-X PUT \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-H "Authorization: Bearer <jwt token>"

Response

{
"Code": 200,
"Status": "OK"
}

عائلة SDK السحابية

يُعد استخدام حزمة تطوير برمجيات (SDK) أفضل طريقة لتسريع عملية التطوير. فهي تُعنى بالتفاصيل البسيطة وتُتيح لك التركيز على مهام مشروعك. يُرجى الاطلاع علىمستودع GitHub للحصول على قائمة كاملة بـ Aspose.Cells Cloud SDKs.

توضح أمثلة التعليمات البرمجية التالية كيفية إجراء مكالمات إلى خدمات الويب Aspose.Cells باستخدام مجموعات أدوات تطوير البرامج المختلفة:

	using Aspose.Cells.Cloud.SDK.Api;
	using Aspose.Cells.Cloud.SDK.Model;
	using Aspose.Cells.Cloud.SDK.Request;
	using System;
	using System.IO;
	using System.Collections.Generic;

	string CellsCloudClientId ="....";//get from https://dashboard.aspose.cloud/#/applications
	string CellsCloudClientSecret="...";//get from https://dashboard.aspose.cloud/#/applications
	string remoteFolder = "TestData/In";

	string localName = "Book1.xlsx";
	string remoteName = "Book1.xlsx";



	var shapeDTO = new Shape()
	{
	};
	var request = new PutWorksheetShapeRequest(
	name: remoteName,
	sheetName: "Sheet1",
	shapeDTO: shapeDTO,
	drawingType: "arc",
	upperLeftRow: 1,
	upperLeftColumn: 1,
	top: 10,
	left: 10,
	width: 100,
	height: 100,
	folder: remoteFolder,
	storageName: ""
	);
	cellsApi.PutWorksheetShape(request);

view raw ExamplePutWorksheetShape.cs hosted with ❤ by GitHub

Java

	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 {
	api = new CellsApi(
	System.getenv("CellsCloudClientId"),
	System.getenv("CellsCloudClientSecret"),
	"v3.0",
	System.getenv("CellsCloudApiBaseUrl")
	);
	} catch (ApiException e) {
	e.printStackTrace();
	}
	}
	public void Run(){
	try{
	String remoteFolder = "TestData/In";

	String localName = "Book1.xlsx";
	String remoteName = "Book1.xlsx";

	UploadFileRequest uploadFileRequest = new UploadFileRequest();
	uploadFileRequest.setPath( remoteFolder + "/" + remoteName );
	uploadFileRequest.setStorageName( "");
	HashMap<String,File> files = new HashMap<String,File>();
	files.put( localName , new File(localName ));
	uploadFileRequest.setUploadFiles(files);
	api.uploadFile(uploadFileRequest);

	PutWorksheetShapeRequest request = new PutWorksheetShapeRequest();
	Shape shapeDTO = new Shape();
	request.setShapeDTO(shapeDTO);

	request.setName(remoteName);

	request.setSheetName("Sheet1");

	request.setDrawingType("arc");

	request.setUpperLeftRow(1);

	request.setUpperLeftColumn(1);

	request.setTop(10);

	request.setLeft(10);

	request.setWidth(100);

	request.setHeight(100);

	request.setFolder(remoteFolder);

	request.setStorageName("");

	this.api.putWorksheetShape(request);



	} catch (ApiException e) {
	e.printStackTrace();
	}catch (IOException e) {
	e.printStackTrace();
	}
	}
	}

view raw Example_PutWorksheetShape.java hosted with ❤ by GitHub

PHP

	<?php
	require_once('vendor\autoload.php');
	use \Aspose\Cells\Cloud\Api\CellsApi;
	use \Aspose\Cells\Cloud\Request\PutWorksheetShapeRequest;

	$CellsCloudClientId = "...." ; # get from https://dashboard.aspose.cloud/#/applications
	$CellsCloudClientSecret = "...."; # get from https://dashboard.aspose.cloud/#/applications
	$cellsApi = new CellsApi($CellsCloudClientId , $CellsCloudClientSecret );

	$remoteFolder = "TestData/In";

	$localName = "Book1.xlsx";
	$remoteName = "Book1.xlsx";

	$shapeDTO = new \Aspose\Cells\Cloud\Model\Shape();



	$request = new PutWorksheetShapeRequest();
	$request->setName( $remoteName);
	$request->setSheetName( "Sheet1");
	$request->setShapeDTO( $shapeDTO);
	$request->setDrawingType( "arc");
	$request->setUpperLeftRow( 1);
	$request->setUpperLeftColumn( 1);
	$request->setTop( 10);
	$request->setLeft( 10);
	$request->setWidth( 100);
	$request->setHeight( 100);
	$request->setFolder( $remoteFolder);
	$request->setStorageName( "");
	$cellsApi->putWorksheetShape($request);

view raw Example_PutWorksheetShape.php hosted with ❤ by GitHub

Ruby

	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)

	remote_folder = 'TestData/In'

	local_name = 'Book1.xlsx'
	remote_name = 'Book1.xlsx'


	mapFiles = { }
	mapFiles[local_name] = ::File.open(File.expand_path("TestData/"+local_name),"r")

	uploadrequest = AsposeCellsCloud::UploadFileRequest.new( { :UploadFiles=>mapFiles,:path=>remote_folder })
	@instance.upload_file(uploadrequest)
	shapeDTO = AsposeCellsCloud::Shape.new();
	request = AsposeCellsCloud::PutWorksheetShapeRequest.new(:name=>remote_name,:sheetName=>'Sheet1',:shapeDTO=>shapeDTO,:DrawingType=>'arc',:upperLeftRow=>1,:upperLeftColumn=>1,:top=>10,:left=>10,:width=>100,:height=>100,:folder=>remote_folder,:storageName=>'');
	@instance.put_worksheet_shape(request);

view raw Example_PutWorksheetShape.rb hosted with ❤ by GitHub

Node.js

	import { CellsApi,Shape,PutWorksheetShapeRequest,UploadFileRequest } 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 remoteFolder = "TestData/In"
	var localPath = "TestData/CellsCloud/"
	var localName = "Book1.xlsx"
	var remoteName = "Book1.xlsx"

	describe('example', function(){
	it("should call successfully" , function(){

	var localNameRequest = new UploadFileRequest();
	localNameRequest.uploadFiles ={localName:fs.createReadStream(localPath + localName)};
	localNameRequest.path = remoteFolder + "/" + remoteName ;
	localNameRequest.storageName ="";
	cellsApi.uploadFile(localNameRequest );

	var shapeDTO = new Shape();


	var request = new PutWorksheetShapeRequest();
	request.name = remoteName;
	request.sheetName = "Sheet1";
	request.shapeDTO = shapeDTO;
	request.drawingType = "arc";
	request.upperLeftRow = 1;
	request.upperLeftColumn = 1;
	request.top = 10;
	request.left = 10;
	request.width = 100;
	request.height = 100;
	request.folder = remoteFolder;
	request.storageName = "";
	return cellsApi.putWorksheetShape(request)


	});
	});

view raw Example_PutWorksheetShape.ts hosted with ❤ by GitHub

Python

	import os
	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)
	request = PutWorksheetShapeRequest( 'Book1.xlsx', 'Sheet1',shape_dto= None,drawing_type= 'arc',upper_left_row= 1,upper_left_column= 1,top= 10,left= 10,width= 100,height= 100,folder= 'PythonTest',storage_name= '')
	api.put_worksheet_shape(request)

view raw Example_PutWorksheetShape.py hosted with ❤ by GitHub

Perl

	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 $remoteFolder = 'TestData/In';

	my $localName = 'Book1.xlsx';
	my $remoteName = 'Book1.xlsx';

	my $upload_file_request = AsposeCellsCloud::Request::UploadFileRequest->new( 'UploadFiles'=>{ $localName => $localName } ,'path'=>$remoteFolder . '/' . $remoteName );

	my $shape_dto = AsposeCellsCloud::Object::Shape->new();


	my $request = AsposeCellsCloud::Request::PutWorksheetShapeRequest->new();
	$request->{name} = $remoteName;
	$request->{sheet_name} = 'Sheet1';
	$request->{shape_dto} = $shape_dto;
	$request->{drawing_type} = 'arc';
	$request->{upper_left_row} = 1;
	$request->{upper_left_column} = 1;
	$request->{top} = 10;
	$request->{left} = 10;
	$request->{width} = 100;
	$request->{height} = 100;
	$request->{folder} = $remoteFolder;
	$request->{storage_name} = '';
	$instance->put_worksheet_shape(request=> $request);

view raw Example_PutWorksheetShape.pl hosted with ❤ by GitHub

	package main

	import (
	. "github.com/aspose-cells-cloud/aspose-cells-cloud-go/v25"
	)

	func main() {
	CellsCloudClientId := "...." // get from https://dashboard.aspose.cloud/#/applications
	CellsCloudClientSecret := "...." // get from https://dashboard.aspose.cloud/#/applications
	instance := NewCellsApiService(CellsCloudClientId, CellsCloudClientSecret)
	remoteFolder := "TestData/In"

	localName := "Book1.xlsx"
	remoteName := "Book1.xlsx"

	localNameRequest := new(UploadFileRequest)
	localNameRequest.UploadFiles = make(map[string]string)
	localNameRequest.UploadFiles[localName] = localName
	localNameRequest.Path = remoteFolder + "/" + remoteName
	localNameRequest.StorageName = ""
	instance.UploadFile(localNameRequest)

	var shapeDTO = new(Shape)

	request := new(PutWorksheetShapeRequest)
	request.Name = remoteName
	request.SheetName = "Sheet1"
	request.ShapeDTO = shapeDTO
	request.DrawingType = "arc"
	request.UpperLeftRow = int64(1)
	request.UpperLeftColumn = int64(1)
	request.Top = int64(10)
	request.Left = int64(10)
	request.Width = int64(100)
	request.Height = int64(100)
	request.Folder = remoteFolder
	request.StorageName = ""
	_, httpResponse, err := instance.PutWorksheetShape(request)
	if err != nil {
	println(err.Error())
	} else if httpResponse.StatusCode < 200 \|\| httpResponse.StatusCode > 299 {
	println("Fail")
	}
	}

view raw Example_PutWorksheetShape.go hosted with ❤ by GitHub

احصل على شكل حسب الفهرس في ورقة عمل Excel تحديث شكل على ورقة عمل Excel