fs::new_root_folder (public)

 fs::new_root_folder [ -package_id package_id ] \
    [ -pretty_name pretty_name ] [ -description description ] \
    [ -name name ]

Defined in packages/file-storage/tcl/file-storage-procs.tcl

Create a root folder for a package instance.

Switches:

-package_id (optional)

Package instance associated with this root folder

-pretty_name (optional)

-description (optional)

-name (optional)

Returns:

folder_id of the new root folder

Partial Call Graph (max 5 caller/called nodes):

Testcases:

fs_add_delete_copy

Source code:

    if {$package_id eq ""} {
        set package_id [ad_conn package_id]
    }

    if {$pretty_name eq ""} {
        set pretty_name [apm_instance_name_from_id $package_id]
    }

    if {$name eq ""} {
        set name "file-storage_${package_id}"
    }

    return [db_exec_plsql new_root_folder {}]

Generic XQL file:

packages/file-storage/tcl/file-storage-procs.xql

PostgreSQL XQL file:

<fullquery name="fs::new_root_folder.new_root_folder">
    <querytext>
	select file_storage__new_root_folder (
	    :package_id,
            :pretty_name, -- label
	    :name, -- name
	    :description
        )
        </querytext>
</fullquery>

packages/file-storage/tcl/file-storage-procs-postgresql.xql

Oracle XQL file:

<fullquery name="fs::new_root_folder.new_root_folder">
    <querytext>
            begin
                :1 := file_storage.new_root_folder(
	 	    folder_url => :name,
		    package_id => :package_id,
                    folder_name => :pretty_name,
		    description => :description
                );
            end;
        </querytext>
</fullquery>

packages/file-storage/tcl/file-storage-procs-oracle.xql