أضف صورة في ملف Excel

يشير هذا REST API إلى add صورة جديدة لورقة عمل Excel.

RSET API

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

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

اسم المعلمة	يكتب	المسار/سلسلة الاستعلام/نص HTTP	وصف
اسم	خيط	طريق	اسم المصنف.
اسم الورقة	خيط	طريق	اسم ورقة العبادة.
صورة		جسم	كائن مصور
الصف العلوي الأيسر	عدد صحيح	استفسار	0
العمود الأيسر العلوي	عدد صحيح	استفسار	0
الصف الأيمن السفلي	عدد صحيح	استفسار	0
العمود الأيمن السفلي	عدد صحيح	استفسار	0
مسار الصورة	خيط	استفسار	مسار الصورة، إذا لم يتم توفير بيانات الصورة، فسيتم فحصها في نص الطلب.
مجلد	خيط	استفسار	مجلد المصنف.
اسم التخزين	خيط	استفسار	اسم التخزين.

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

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

Request

 
curl -v "http://api.aspose.com/v1.1/cells/Sample_Test_Book.xls/worksheets/Sheet6/pictures?picturePath=aspose-cloud.png" \
-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 waterMarkPNG = "WaterMark.png";
	string remoteName = "Book1.xlsx";


	this.UploadFile( waterMarkPNG, remoteFolder + "/WaterMark.png", "");

	var request = new PutWorksheetAddPictureRequest(
	name: remoteName,
	sheetName: "Sheet6",
	upperLeftRow: 1,
	upperLeftColumn: 1,
	lowerRightRow: 10,
	lowerRightColumn: 10,
	picturePath: remoteFolder + "/WaterMark.png",
	folder: remoteFolder,
	storageName: ""
	);
	cellsApi.PutWorksheetAddPicture(request);

view raw ExamplePutWorksheetAddPicture.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 waterMarkPNG = "WaterMark.png";
	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);
	UploadFileRequest uploadFileRequest = new UploadFileRequest();
	uploadFileRequest.setPath( remoteFolder + "/WaterMark.png" );
	uploadFileRequest.setStorageName( "");
	HashMap<String,File> files = new HashMap<String,File>();
	files.put( waterMarkPNG , new File(waterMarkPNG ));
	uploadFileRequest.setUploadFiles(files);
	api.uploadFile(uploadFileRequest);

	PutWorksheetAddPictureRequest request = new PutWorksheetAddPictureRequest();
	request.setName(remoteName);

	request.setSheetName("Sheet6");

	request.setUpperLeftRow(1);

	request.setUpperLeftColumn(1);

	request.setLowerRightRow(10);

	request.setLowerRightColumn(10);

	request.setPicturePath(remoteFolder + "/WaterMark.png");

	request.setFolder(remoteFolder);

	request.setStorageName("");

	this.api.putWorksheetAddPicture(request);

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

view raw Example_PutWorksheetAddPicture.java hosted with ❤ by GitHub

PHP

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

	$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";
	$waterMarkPNG = "WaterMark.png";
	$remoteName = "Book1.xlsx";


	CellsApiTestBase::ready( $this->instance,$waterMarkPNG ,$remoteFolder . "/WaterMark.png" , "");

	$request = new PutWorksheetAddPictureRequest();
	$request->setName( $remoteName);
	$request->setSheetName( "Sheet6");
	$request->setUpperLeftRow( 1);
	$request->setUpperLeftColumn( 1);
	$request->setLowerRightRow( 10);
	$request->setLowerRightColumn( 10);
	$request->setPicturePath( $remoteFolder . "/WaterMark.png");
	$request->setFolder( $remoteFolder);
	$request->setStorageName( "");
	$cellsApi->putWorksheetAddPicture($request);

view raw Example_PutWorksheetAddPicture.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'
	water_mark_png = 'WaterMark.png'
	remote_name = 'Book1.xlsx'


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

	uploadrequest = AsposeCellsCloud::UploadFileRequest.new( { :UploadFiles=>mapFiles,:path=>remote_folder })
	@instance.upload_file(uploadrequest)
	request = AsposeCellsCloud::PutWorksheetAddPictureRequest.new(:name=>remote_name,:sheetName=>'Sheet6',:upperLeftRow=>1,:upperLeftColumn=>1,:lowerRightRow=>10,:lowerRightColumn=>10,:picturePath=>remote_folder + '/WaterMark.png',:folder=>remote_folder,:storageName=>'');
	@instance.put_worksheet_add_picture(request);

view raw Example_PutWorksheetAddPicture.rb hosted with ❤ by GitHub

Node.js

	import { CellsApi,PutWorksheetAddPictureRequest,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"
	var waterMarkPNG = "WaterMark.png"

	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 waterMarkPNGRequest = new UploadFileRequest();
	waterMarkPNGRequest.uploadFiles ={waterMarkPNG:fs.createReadStream(localPath + waterMarkPNG)};
	waterMarkPNGRequest.path = remoteFolder + "/"+waterMarkPNG ;
	waterMarkPNGRequest.storageName ="";
	cellsApi.uploadFile(waterMarkPNGRequest );

	var request = new PutWorksheetAddPictureRequest();
	request.name = remoteName;
	request.sheetName = "Sheet6";
	request.upperLeftRow = 1;
	request.upperLeftColumn = 1;
	request.lowerRightRow = 10;
	request.lowerRightColumn = 10;
	request.picturePath = remoteFolder + "/"+waterMarkPNG;
	request.folder = remoteFolder;
	request.storageName = "";
	return cellsApi.putWorksheetAddPicture(request)



	});
	});

view raw Example_PutWorksheetAddPicture.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 = PutWorksheetAddPictureRequest( 'Book1.xlsx', 'Sheet6',upper_left_row= 1,upper_left_column= 1,lower_right_row= 10,lower_right_column= 10,picture_path= 'PythonTest' + '/WaterMark.png',folder= 'PythonTest',storage_name= '')
	api.put_worksheet_add_picture(request)

view raw Example_PutWorksheetAddPicture.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 $waterMarkPNG = 'WaterMark.png';
	my $remoteName = 'Book1.xlsx';

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

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


	my $request = AsposeCellsCloud::Request::PutWorksheetAddPictureRequest->new();
	$request->{name} = $remoteName;
	$request->{sheet_name} = 'Sheet6';
	$request->{upper_left_row} = 1;
	$request->{upper_left_column} = 1;
	$request->{lower_right_row} = 10;
	$request->{lower_right_column} = 10;
	$request->{picture_path} = $remoteFolder . '/WaterMark.png';
	$request->{folder} = $remoteFolder;
	$request->{storage_name} = '';
	$instance->put_worksheet_add_picture(request=> $request);

view raw Example_PutWorksheetAddPicture.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"
	waterMarkPNG := "WaterMark.png"
	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)
	waterMarkPNGRequest := new(UploadFileRequest)
	waterMarkPNGRequest.UploadFiles = make(map[string]string)
	waterMarkPNGRequest.UploadFiles[waterMarkPNG] = waterMarkPNG
	waterMarkPNGRequest.Path = remoteFolder + "/WaterMark.png"
	waterMarkPNGRequest.StorageName = ""
	instance.UploadFile(waterMarkPNGRequest)

	request := new(PutWorksheetAddPictureRequest)
	request.Name = remoteName
	request.SheetName = "Sheet6"
	request.UpperLeftRow = int64(1)
	request.UpperLeftColumn = int64(1)
	request.LowerRightRow = int64(10)
	request.LowerRightColumn = int64(10)
	request.PicturePath = remoteFolder + "/WaterMark.png"
	request.Folder = remoteFolder
	request.StorageName = ""
	_, httpResponse, err := instance.PutWorksheetAddPicture(request)
	if err != nil {
	println(err.Error())
	} else if httpResponse.StatusCode < 200 \|\| httpResponse.StatusCode > 299 {
	println("Fail")
	}
	}

view raw Example_PutWorksheetAddPicture.go hosted with ❤ by GitHub

احصل على صورة في ملف Excel حذف صورة في ملف Excel