お知らせ:

当社は、お客様により充実したサポート情報を迅速に提供するため、本ページのコンテンツは機械翻訳を用いて日本語に翻訳しています。正確かつ最新のサポート情報をご覧いただくには、本内容の英語版を参照してください。

ファイルのアップロード

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

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

ファイルURIスキームを渡す方法

ファイルのURIスキームを引数としてuploadFile()メソッドに渡すことで、指定したフォルダーインスタンスのフォルダーにファイルをアップロードできます:

copy
<FOLDER_INSTANCE>.uploadFile(
    uri: Uri,
    success: (ZCatalystFile) → Unit,
    failure: ((ZCatalystException) → Unit)?,
    progress: ((Long, Long, Double) → Unit)?
): ZCatalystRequest<ZCatalystResponse<ZCatalystFile>>?

パラメータ:

  • uri: アップロードするファイルのファイルURIスキーム

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

copy
ZCatalystApp.getInstance().getFileStoreInstance().getFolderInstance(2823000000006561).uploadFile("/src.example.com/files/productImage.png",
    {
        println(" >> File Upload Success -$it")
    },
    {
        println(" >> File Upload Failed -$it")
    })

ファイルパスを渡す方法

ローカルシステムのファイルパスを引数としてuploadFile()メソッドに渡すことで、指定したフォルダーインスタンスのフォルダーにファイルをアップロードできます:

copy
<FOLDER_INSTANCE>.uploadFile(
    filePath: String,
    success: (ZCatalystFile) → Unit,
    failure: ((ZCatalystException) → Unit)?,
    progress: ((Long, Long, Double) → Unit)?
): ZCatalystRequest<ZCatalystResponse<ZCatalystFile>>?

パラメータ:

  • filepath: アップロードするファイルのファイルパス

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

copy
ZCatalystApp.getInstance().getFileStoreInstance().getFolderInstance(2823000000006561).uploadFile("/Desktop/HelplineCard.jpg",
    {
        println(" >> File Upload Success -$it")
    },
    {
        println(" >> File Upload Failed -$it")
    })

ファイルURIスキームとファイル名を渡す方法

ファイルURIスキームとファイル名の両方を個別の引数としてuploadFile()メソッドに渡すことで、指定したフォルダーインスタンスのフォルダーにファイルをアップロードできます:

copy
<FOLDER_INSTANCE>.uploadFile(
    uri: Uri,
    fileName: String,
    success: (ZCatalystFile) → Unit,
    failure: ((ZCatalystException) → Unit)?,
    progress: ((Long, Long, Double) → Unit)?
): ZCatalystRequest<ZCatalystResponse<ZCatalystFile>>?

パラメータ:

  • uri: アップロードするファイルのファイルURIスキーム
  • fileName: アップロードするファイルの名前

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

copy
ZCatalystApp.getInstance().getFileStoreInstance().getFolderInstance(2823000000006561).uploadFile("/src.example.com/files", "productImage.png",
    {
        println(" >> File Upload Success -$it")
    },
    {
        println(" >> File Upload Failed -$it")
    })

ファイルパスとファイル名を渡す方法

ローカルシステムのファイルパスとファイル名の両方を引数としてuploadFile()メソッドに渡すことで、指定したフォルダーインスタンスのフォルダーにファイルをアップロードできます:

copy
<FOLDER_INSTANCE>.uploadFile(
    filePath: String,
    fileName: String,
    success: (ZCatalystFile) → Unit,
    failure: ((ZCatalystException) → Unit)?,
    progress: ((Long, Long, Double) → Unit)?
): ZCatalystRequest<ZCatalystResponse<ZCatalystFile>>?

パラメータ:

  • filepath: アップロードするファイルのファイルパス
  • fileName: アップロードするファイルの名前

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

copy
ZCatalystApp.getInstance().getFileStoreInstance().getFolderInstance(2823000000006561).uploadFile("/Desktop", "HelplineCard.jpg",
    {
        println(" >> File Upload Success -$it")
    },
    {
        println(" >> File Upload Failed -$it")
    })

inputStreamとファイル名でファイルを渡す方法

inputStreamとしてのファイルとファイル名の両方を引数としてuploadFile()メソッドに渡すことで、指定したフォルダーインスタンスのフォルダーにファイルをアップロードできます:

copy
<FOLDER_INSTANCE>.uploadFile(stream: InputStream,
                   fileName: String,
                   success: (ZCatalystFile) -> Unit,
                   failure: ((ZCatalystException) -> Unit)? = null,
                   progress: ((bytesWritten: Long, contentLength: Long, percentage: Double) -> Unit)? = null)
            : ZCatalystRequest<ZCatalystResponse<ZCatalystFile>>?

パラメータ:

  • stream: ファイルのinputStream
  • fileName: アップロードするファイルの名前

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

copy
val file = File("/Desktop/HelplineCard.jpg")
val inputStream: InputStream = FileInputStream(file)
ZCatalystApp.getInstance().getFileStoreInstance().getFolderInstance(2823000000006561).uploadFile(inputStream,
    {
        println(" >> File Upload Success -$it")
    },
    {
        println(" >> File Upload Failed -$it")
    })

最終更新日 2026-02-23 18:09:41 +0530 IST