OnSheetWorkbookCreate - OnSheetワークブックの作成

OnSheetのワークブックを作成します。

OnSheetとの連携の概要や必要な設定については、OnSheetとの連携についてを参照してください。

■ストリーム情報

入力フォーマットすべて
接続数無制限
説明 入力ストリームは使用せず、すべて無視します。
出力フォーマットRecord
説明 作成したワークブック情報のレコードです。
各フィールドの順序は固定です。
フィールド名データ型説明
idStringワークブックのID
pathStringワークブックのパス
nameStringワークブック名
currRevIdIntegerワークブックの現在のリビジョン
workspaceIdIntegerオーナーワークスペースのID
workspaceStringオーナーワークスペースのパス
organisationIdInteger法人ID
organisationString法人名
publicAccessString一般のアクセス権
isTemplateBooleanワークブックがテンプレートであるかどうか
isDeleteBooleanワークブックが削除されているイかどうか
timeZoneStringタイムゾーン
noteStringノート
createUserIdInteger作成者のID
createUserString作成者のパス
createTimeDateTime作成日時
lastModifiedUserIdInteger更新者のID
lastModifiedUserString更新者のパス
lastModifiedTimeDateTime更新日時
accessTokenStringアクセストークン

■コンポーネントプロパティ

名前プロパティ型マッピング説明
コネクション名connection- OnSheetサーバーへの接続情報を定義した汎用コネクションを指定します。
ユーザーを指定するboolean入力&出力 処理の実行に使用するユーザーをコネクションで定義されているユーザーを使用するか、 プロパティで指定するかを指定します。
はい [true] - プロパティでユーザー名とパスワードを指定します。
いいえ [false] - コネクションで定義されているユーザー名とパスワードを使用します。
ユーザー名string入力&出力ユーザーを指定するが「はい」の場合に処理に使用するユーザー名を指定します。
パスワードpassword入力&出力ユーザーを指定するが「はい」の場合に処理に使用するユーザーのパスワードを指定します。
テンプレートstring入力&出力 ワークブック作成時に複製するテンプレートを指定します。
テンプレートが指定されない場合空のワークブックが作成されます。
ワークブックの指定方法は以下のいずれかです。
  • 「corp1/workspace1/book1」のように法人名から指定。
  • 「workspace1/book1」のようにワークスペースから指定。法人名はコネクションで定義した値になります。
  • 「book1」のようにブック名のみを指定。ワークスペースはログインユーザーの個人ワークスペースになります。
  • 「55」のようにワークブックIDを指定
ノートstring入力&出力 ワークブックのノートを指定します。
ブック名string入力&出力 作成するワークブック名を指定します。
ワークスペースstring入力&出力 ワークブックを作成するワークスペースを指定します。
省略した場合ログインユーザーの個人ワークスペースが対象となります。
共有設定choice入力&出力 一般ユーザーに対するワークブックの共有設定を指定します。
なし [none]
共有なし
参照可 [read]
参照を許可する
編集可 [readwrite]
編集を許可する
参照可(要パスワード) [pread]
参照のためにパスワードが必要。編集不可
編集可(編集時要パスワード) [read-pwrite]
参照は自由だが編集のためにはパスワードが必要
編集可(要パスワード) [pread-pwrite]
参照・編集のためにパスワードが必要
テンプレートとして作成boolean入力&出力 作成するワークブックをテンプレートとするかどうかを指定します。

■トランザクション処理

コミット何もしません。
ロールバック何もしません。

■エラー処理

タイプパラ
メータ
エラー処理フロー
へのストリーム
エラー
コード
説明
汎用 なし コンポーネントの入力ストリーム なし WebAPIの実行でエラーになった場合

■コネクション設定

OnSheetコンポーネントを使用するためにはあらかじめ汎用コネクションにOnSheetサーバー接続用の設定をしておく必要があります。コネクション設定では以下のパラメータを定義します。

パラメータ名設定内容
url OnSheetサーバーのWebAPIのURLを指定します。
URLは通常「http://<ホスト名>/api/v1/rpc」です。
appKey OnSheetサーバーのアプリケーションキーを指定します。
アプリケーションキーの生成方法についてはOnSheetのWebAPIガイドを参照してください。
organisation OnSheetサーバーにログインするユーザーの法人名を指定します。
user OnSheetサーバーにログインするユーザー名を指定します。
password OnSheetサーバーにログインするユーザーのパスワードを指定します。
useProxy FSMCで設定したプロキシーサーバを使用する場合「true」を指定します。
プロキシサーバを使用しない場合は設定不要です。