ファイルのアップロード

# ファイルのアップロード

{{%note%}}{{%bold%}}注意:{{%/bold%}} Catalystでは、{{%bold%}}早期アクセス{{%/bold%}}モードで{{%bold%}}Stratus{{%/bold%}}と呼ばれる新しいオブジェクトストレージコンポーネントを提供しています。このコンポーネントは、現在の{{%italics%}}Cloud Scale File Store{{%/italics%}}コンポーネントの大幅なアップグレードです。Stratusコンポーネントの詳細については、{{%link href="/ja/cloud-scale/help/stratus/introduction/" %}}こちら{{%/link%}}をご覧ください。<br /><br />早期アクセスモードでStratusコンポーネントを使用するには、{{%link href="mailto:support@zohocatalyst.com" %}}{{%bold%}}support@zohocatalyst.com{{%/bold%}}{{%/link%}}までメールでお問い合わせください。{{%/note%}}

{{%link href="/ja/cloud-scale/help/file-store/introduction"%}}File Store{{%/link%}}内の既存のフォルダにファイルをアップロードできます。フォルダにファイルがアップロードされると、一意の{{%link href="/ja/cloud-scale/help/file-store/implementation/#create-a-folder"%}}File ID{{%/link%}}が生成されます。画像、テキストドキュメント、CSV、またはその他の種類のファイルを最大100MBのファイルサイズまでアップロードできます。

以下で説明するいずれかの方法でファイルをアップロードできます。以下のすべてのメソッドのコードセクションで使用されている{{%badge%}}&lt;FOLDER_INSTANCE&gt;{{%/badge%}}は、{{%link href="/ja/sdk/ios/v2/cloud-scale/file-store/create-folder-instance"%}}フォルダインスタンスページ{{%/link%}}で定義されたインスタンスです。これは、ファイルをアップロードするフォルダを参照します。

### Delegateを使用する方法

Delegateを使用して、指定されたフォルダインスタンスのフォルダにファイルをアップロードできます。これは2つの方法で実行できます：

#### i. ファイルパスを渡す方法

File Reference IDとファイルパスをDelegateメソッドオブジェクトとともに{{%badge%}}upload(){{%/badge%}}メソッドの引数として渡すことができます：

{{%code class="language-bash"%}}&lt;FOLDER_INSTANCE&gt;.upload( fileRefId : String, filePath : URL, fileUploadDelegate : ZCatalystFileUploadDelegate ){{%/code%}}

**パラメータ**:

* {{%badge%}}**fileRefId**{{%/badge%}}: 特定のアップロードタスクを識別するための一意の参照IDです。タスクが正常に完了した後、Delegateメソッドで返されます。

* {{%badge%}}**filePath**{{%/badge%}}: ローカルシステム内のアップロードするファイルのファイルパスです。

* {{%badge%}}**fileUploadDelegate**{{%/badge%}}: {{%badge%}}ZCatalystFileUploadDelegate{{%/badge%}}型のインスタンスです。

サンプルコードスニペットを以下に示します：

{{%code class="language-bash line-numbers"%}}func progress(fileRefId: String, session: URLSession, sessionTask: URLSessionTask, progressPercentage: Double, totalBytesSent: Int64, totalBytesExpectedToSend: Int64) {
	print("The percentage of file upload is \(progressPercentage)")
	}
	func didFinish(fileRefId: String, fileDetails: ZCatalystFile) {
	print("The file with reference id " + fileRefId + " is successfully uploaded.")
	}
	func didFail(fileRefId: String, with error: ZCatalystError?) {
	print("The file with reference id " + fileRefId + " upload has been failed due to \(ZCatalystError.self)")
	}
	}
let filePath = self.testBundle?.path( forResource : "companylogo", ofType : "jpeg" ) //ここにファイル名を入力してください
let url = URL( fileURLWithPath : filePath! )
ZCatalystApp.shared.getFileStoreInstance().getFolderInstance( id : 2823000000006544 ).upload( fileRefId : fileRefId, filePath : url, fileUploadDelegate : self ) //これをあなたのフォルダIDに置き換えてください
{{%/code%}}

#### ii. ファイルデータを渡す方法

ファイルデータをDelegateメソッドオブジェクトとともに{{%badge%}}upload(){{%/badge%}}メソッドの引数として渡すことができます：

{{%code class="language-bash"%}}&lt;FOLDER_INSTANCE&gt;.upload( fileRefId : String, fileName : String, fileData : Data, fileUploadDelegate : ZCatalystFileUploadDelegate ){{%/code%}}

**パラメータ**:

* {{%badge%}}**fileName**{{%/badge%}}: アップロードするファイルの名前です。

* {{%badge%}}**fileData**{{%/badge%}}: {{%badge%}}Data{{%/badge%}}型のファイルの内容です。

* {{%badge%}}**fileUploadDelegate**{{%/badge%}}: {{%badge%}}ZCatalystFileUploadDelegate{{%/badge%}}型のインスタンスです。

サンプルコードスニペットを以下に示します：

{{%code class="language-bash line-numbers"%}}func progress(fileRefId: String, session: URLSession, sessionTask: URLSessionTask, progressPercentage: Double, totalBytesSent: Int64, totalBytesExpectedToSend: Int64)
{
	print("The percentage of file upload is \(progressPercentage)")
	}
	func didFinish(fileRefId: String, fileDetails: ZCatalystFile)
	{
	print("The file with reference id " + fileRefId + " is successfully uploaded.")
	}
	func didFail(fileRefId: String, with error: ZCatalystError?)
	{
	print("The file with reference id " + fileRefId + " upload has been failed due to \(ZCatalystError.self)")
	}
}
if let data = image?.pngData()
ZCatalystApp.shared.getFileStoreInstance().getFolderInstance( id : 105000000121098 ).upload( fileRefId : "1234567", fileName : url.lastPathComponent, fileData: data, fileUploadDelegate : self ) //ここにファイル参照IDを入力してください
{{%/code%}}

### Completion Handlerを使用する方法

Completion Handlerを使用して、指定されたフォルダインスタンスのフォルダにファイルをアップロードできます。これは2つの方法で実行できます：

#### i. ファイルパスを渡す方法

ファイルパスをCompletion Handlerとともに{{%badge%}}upload(){{%/badge%}}メソッドの引数として渡すことができます：

{{%code class="language-bash"%}}&lt;FOLDER_INSTANCE&gt;.upload( filePath : URL, completion : @escaping ( Result&lt; ZCatalystFile, ZCatalystError &gt; ) -> Void ){{%/code%}}

**パラメータ**:

* {{%badge%}}**filePath**{{%/badge%}}: ローカルシステム内のアップロードするファイルのファイルパスです。

* {{%badge%}}**completion**{{%/badge%}}: 操作が成功した場合、completionブロックはアップロードされたファイルの詳細を返します。それ以外の場合は、エラーを返します。

サンプルコードスニペットを以下に示します：

{{%code class="language-bash line-numbers"%}}let filePath = self.testBundle?.path( forResource : "document", ofType : "jpeg" ) //ここにファイル名を入力してください
	let url = URL( fileURLWithPath : filePath! )
ZCatalystApp.shared.getFileStoreInstance().getFolderInstance( id : 105000000121098 ).upload( filePath : url) { ( fileResult ) in
//これをあなたのフォルダIDに置き換えてください
	switch fileResult{
	  case .success (let file) :    
	   print ("Image has been successfully uploaded and it's id is " + file.id)
	  case .error(let error) :
   	print( "Error occurred &gt;&gt;&gt; \( error )" )
  } 
}
{{%/code%}}

#### ii. ファイルデータを渡す方法

ファイルデータをCompletion Handlerとともに{{%badge%}}upload(){{%/badge%}}メソッドの引数として渡すことができます：

{{%code class="language-bash"%}}&lt;FOLDER_INSTANCE&gt;.upload( fileName : String, fileData : Data, completion: @escaping (Result&lt;ZCatalystFile, ZCatalystError&gt;) -> Void ){{%/code%}}

**パラメータ**:

* {{%badge%}}**fileName**{{%/badge%}}: アップロードするファイルの名前です。

* {{%badge%}}**fileData**{{%/badge%}}: {{%badge%}}Data{{%/badge%}}型のファイルの内容です。

サンプルコードスニペットを以下に示します：

{{%code class="language-bash line-numbers"%}}let image = UIImage ( named : "document" ) 
//ファイル名をここに置き換えてください
	if let data = image?.pngData(){
ZCatalystApp.shared.getFileStoreInstance().getFolderInstance(id: 105000000121098).upload(fileName: "document", fileData: data, fileRefId : "123456789983") { (result) in
//ファイル名とファイル参照IDをここに置き換えてください
	switch result{
	  case .success (let file) :    
	   print ("Image has been successfully uploaded and it's id is \(file.id)")
	  case .error(let error) :
   	print( "Error occurred &gt;&gt;&gt; \( error )" )
  	}
 	}
	}
{{%/code%}}

注意: Catalystでは、早期アクセスモードでStratusと呼ばれる新しいオブジェクトストレージコンポーネントを提供しています。このコンポーネントは、現在のCloud Scale File Storeコンポーネントの大幅なアップグレードです。Stratusコンポーネントの詳細については、こちらをご覧ください。

早期アクセスモードでStratusコンポーネントを使用するには、support@zohocatalyst.comまでメールでお問い合わせください。

File Store内の既存のフォルダにファイルをアップロードできます。フォルダにファイルがアップロードされると、一意のFile IDが生成されます。画像、テキストドキュメント、CSV、またはその他の種類のファイルを最大100MBのファイルサイズまでアップロードできます。

以下で説明するいずれかの方法でファイルをアップロードできます。以下のすべてのメソッドのコードセクションで使用されている<FOLDER_INSTANCE>は、フォルダインスタンスページで定義されたインスタンスです。これは、ファイルをアップロードするフォルダを参照します。

Delegateを使用する方法

Delegateを使用して、指定されたフォルダインスタンスのフォルダにファイルをアップロードできます。これは2つの方法で実行できます：

i. ファイルパスを渡す方法

File Reference IDとファイルパスをDelegateメソッドオブジェクトとともにupload()メソッドの引数として渡すことができます：

copy

         <FOLDER_INSTANCE>.upload( fileRefId : String, filePath : URL, fileUploadDelegate : ZCatalystFileUploadDelegate )

パラメータ:

fileRefId: 特定のアップロードタスクを識別するための一意の参照IDです。タスクが正常に完了した後、Delegateメソッドで返されます。
filePath: ローカルシステム内のアップロードするファイルのファイルパスです。
fileUploadDelegate: ZCatalystFileUploadDelegate型のインスタンスです。

サンプルコードスニペットを以下に示します：

copy

         func progress(fileRefId: String, session: URLSession, sessionTask: URLSessionTask, progressPercentage: Double, totalBytesSent: Int64, totalBytesExpectedToSend: Int64) {
	print("The percentage of file upload is \(progressPercentage)")
	}
	func didFinish(fileRefId: String, fileDetails: ZCatalystFile) {
	print("The file with reference id " + fileRefId + " is successfully uploaded.")
	}
	func didFail(fileRefId: String, with error: ZCatalystError?) {
	print("The file with reference id " + fileRefId + " upload has been failed due to \(ZCatalystError.self)")
	}
	}
let filePath = self.testBundle?.path( forResource : "companylogo", ofType : "jpeg" ) //ここにファイル名を入力してください
let url = URL( fileURLWithPath : filePath! )
ZCatalystApp.shared.getFileStoreInstance().getFolderInstance( id : 2823000000006544 ).upload( fileRefId : fileRefId, filePath : url, fileUploadDelegate : self ) //これをあなたのフォルダIDに置き換えてください

    

ii. ファイルデータを渡す方法

ファイルデータをDelegateメソッドオブジェクトとともにupload()メソッドの引数として渡すことができます：

copy

         <FOLDER_INSTANCE>.upload( fileRefId : String, fileName : String, fileData : Data, fileUploadDelegate : ZCatalystFileUploadDelegate )

パラメータ:

fileRefId: 特定のアップロードタスクを識別するための一意の参照IDです。タスクが正常に完了した後、Delegateメソッドで返されます。
fileName: アップロードするファイルの名前です。
fileData: Data型のファイルの内容です。
fileUploadDelegate: ZCatalystFileUploadDelegate型のインスタンスです。

サンプルコードスニペットを以下に示します：

copy

         func progress(fileRefId: String, session: URLSession, sessionTask: URLSessionTask, progressPercentage: Double, totalBytesSent: Int64, totalBytesExpectedToSend: Int64)
{
	print("The percentage of file upload is \(progressPercentage)")
	}
	func didFinish(fileRefId: String, fileDetails: ZCatalystFile)
	{
	print("The file with reference id " + fileRefId + " is successfully uploaded.")
	}
	func didFail(fileRefId: String, with error: ZCatalystError?)
	{
	print("The file with reference id " + fileRefId + " upload has been failed due to \(ZCatalystError.self)")
	}
}
if let data = image?.pngData()
ZCatalystApp.shared.getFileStoreInstance().getFolderInstance( id : 105000000121098 ).upload( fileRefId : "1234567", fileName : url.lastPathComponent, fileData: data, fileUploadDelegate : self ) //ここにファイル参照IDを入力してください

    

Completion Handlerを使用する方法

Completion Handlerを使用して、指定されたフォルダインスタンスのフォルダにファイルをアップロードできます。これは2つの方法で実行できます：

i. ファイルパスを渡す方法

ファイルパスをCompletion Handlerとともにupload()メソッドの引数として渡すことができます：

copy

         <FOLDER_INSTANCE>.upload( filePath : URL, completion : @escaping ( Result< ZCatalystFile, ZCatalystError > ) -> Void )

パラメータ:

filePath: ローカルシステム内のアップロードするファイルのファイルパスです。
completion: 操作が成功した場合、completionブロックはアップロードされたファイルの詳細を返します。それ以外の場合は、エラーを返します。

サンプルコードスニペットを以下に示します：

copy

         let filePath = self.testBundle?.path( forResource : "document", ofType : "jpeg" ) //ここにファイル名を入力してください
	let url = URL( fileURLWithPath : filePath! )
ZCatalystApp.shared.getFileStoreInstance().getFolderInstance( id : 105000000121098 ).upload( filePath : url) { ( fileResult ) in
//これをあなたのフォルダIDに置き換えてください
	switch fileResult{
	  case .success (let file) :    
	   print ("Image has been successfully uploaded and it's id is " + file.id)
	  case .error(let error) :
   	print( "Error occurred >>> \( error )" )
  } 
}

    

ii. ファイルデータを渡す方法

ファイルデータをCompletion Handlerとともにupload()メソッドの引数として渡すことができます：

copy

         <FOLDER_INSTANCE>.upload( fileName : String, fileData : Data, completion: @escaping (Result<ZCatalystFile, ZCatalystError>) -> Void )

パラメータ:

fileName: アップロードするファイルの名前です。
fileData: Data型のファイルの内容です。
completion: 操作が成功した場合、completionブロックはアップロードされたファイルの詳細を返します。それ以外の場合は、エラーを返します。

サンプルコードスニペットを以下に示します：

copy

         let image = UIImage ( named : "document" ) 
//ファイル名をここに置き換えてください
	if let data = image?.pngData(){
ZCatalystApp.shared.getFileStoreInstance().getFolderInstance(id: 105000000121098).upload(fileName: "document", fileData: data, fileRefId : "123456789983") { (result) in
//ファイル名とファイル参照IDをここに置き換えてください
	switch result{
	  case .success (let file) :    
	   print ("Image has been successfully uploaded and it's id is \(file.id)")
	  case .error(let error) :
   	print( "Error occurred >>> \( error )" )
  	}
 	}
	}

    

最終更新日 2026-03-30 13:40:30 +0530 IST

Yes

Thank you for your feedback!

Send your feedback to us

Skip

Submit

File Store File Store Implementation Upload File - API