File Upload Utility
File Upload Utility
2011-2012 Ellucian. All rights reserved. The unauthorized possession, use, reproduction, distribution, display or disclosure of this material or
the information contained herein is prohibited.
Contains confidential and proprietary information of Ellucian and its subsidiaries. Use of these materials is limited to Ellucian licensees, and is
subject to the terms and conditions of one or more written license agreements between Ellucian and the licensee in question.
In preparing and providing this publication, Ellucian is not rendering legal, accounting, or other similar professional services. Ellucian makes no
claims that an institution's use of this publication or the software for which it is provided will insure compliance with applicable federal or state
laws, rules, or regulations. Each organization should seek legal, accounting and other similar professional services from competent providers of
the organizations own choosing.
Revision History
Contents
Introduction. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
Software requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
GURUPLD table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
Software requirements
To use the File Upload Utility, you must have the following software installed:
Banner General 8.5
Web Tailor 8.5
Note
For specific software version requirements, please see the Banner DC
Release Interdependency Matrix that is available in the Customer
Support Center.
Field Description
Directory The Oracle directory on the Banner database server where the
file will be uploaded.
Directory Path The directory path on your local machine where the file to be
uploaded can be found. Display only.
File Name Name for the uploaded file. If no name is specified, then the
name of the uploaded file will have the same as the name of the
file on your computer.
User ID The user ID of the person who entered the data or changed it
last. Display-only.
Activity Date The date the information was entered, or was last changed.
Display-only.
GURUPLD table
The GURUPLD table, delivered with Banner General, is used by Oracle to transfer the
contents of a user file to a BLOB. The definition of this table is dictated by Oracle and
even though it has a standard Banner name, the columns are pre-determined and may not
be altered. Therefore, the table will not have some standard Banner columns, including the
following:
GURUPLD_USER_ID
GURUPLD_DATA_ORIGIN
GURUPLD_ACTIVITY_DATE
Additionally, the column names will not be prefaced by the name of the table.
Note
The GURUPLD table cannot be used in Multi-Entity Processing nor may it
be run thru the Banner Database Extension Utility (DBEU).
Configuration
To configure the File Upload Utility, perform the following steps:
Update the DAD Document Table to specify the GURUPLD table, by replacing
www_documents with GURUPLD.
Note
This assumes that the DAD already exists and is working for Self-Service
Banner.
Depending on your Oracle version, update the DAD using one of the following
procedures:
OAS 10.1.2.x on page 7
OAS 10.1.3.x on page 8
OAS 11g Oracle Fusion Middleware (FMW) on page 8
OAS 10.1.2.x
To update the DAD using OAS 10.1.2.x, perform the following steps:
2. Select HTTP_Server.
3. Select Administration.
5. Under the DADs section locate the correct data for this database instance.
9. Click Apply.
To update the DAD using OAS 10.1.3.x, perform the following steps:
For example:
<Location /dad_name>
SetHandler pls_handler
Order allow,deny
Allow from All
AllowOverride None
PlsqlDatabaseUsername www_user
PlsqlDatabasePassword password
PlsqlDatabaseConnectString Hostname:Port:SID SIDFormat
PlsqlAuthenticationMode Basic
PlsqlNLSLanguage AMERICAN_AMERICA.AL32UTF8
PlsqlDefaultPage homepage.htm
PlsqlBeforeProcedure twbklist.p_main
PlsqlDocumentTablename GURUPLD
PlsqlAlwaysDescribeProcedure Off
PlsqlErrorStyle DebugStyle
</Location>
PlsqlDocumentTablename GURUPLD
5. Click Apply.
6. From the Oracle HTTP Server drop down menu, select Control > Restart.
Access the General User Preferences Maintenance (GUAUPRF) form in Banner and
specify the appropriate URL in the User Value field to point to the URL where this DAD
is associated.
Note
If you use a DAD on the INB server instead of the normal SSB server to
handle Job Submission output, the style sheets will be missing and the
web pages will not display correctly. To resolve this issue you can either
change this URL to point to the SSB server or copy the CSS files from the
SSB server to the INB server.
Note
Many Job Submission processes only accept a combined path and file
name length of up to 30 characters, so it is recommended that the path
not exceed 30 characters.
The command to create the directory, as the BANINST1 user, and assign access uses the
following format:
SQLPLUS BANINST1/PASSWORD
The GURUPLD table is delivered with access to BANINST1, but access must also be given
to the account associated with the DAD, for example WWW_USER, using the following
format:
Note
If the GTVSDAX entry overrides the GURUPLD table name, please
ensure that BANINST1, in addition to WWW_USER, is granted the same
privileges to the override table.
To give users access to the directory within Banner, the directory objects must be created
and then users must be given access to the directory objects, as special objects, using the
Oracle/Banner Security Maintenance (GSASECR) form.
1. Create the directory object using the Objects tab on the Oracle/Banner Security
Maintenance (GSASECR) form.
3. Make sure the user testing this process (for example saisusr) is enrolled in
BAN_GENERAL_C class.
1. Login to Banner as BANSECR and open the File Upload Utility (GUAUPLP) form.
Directory = BAN_GUAUPLP_UPLOAD_DIR
File Name = Name for the uploaded file. If no name is specified, then the name of the
uploaded file will have the same as the name of the file on your computer.
Convert End of Line = Checked. This selection will convert End Of Line (EOL)
characters such as CR (carriage return) and LF (line feed).
Note
Web Tailor information text for DEFAULT may be added as desired for
each of the following pages, twbkupld.p_upload,
twbkupld.p_uploadcommit, and twbkupld.p_upload_start.
1. Access the File Upload Utility (GUAUPLP) form and click Manual File Upload.
Note
You may also upload a file by selecting Options > Upload File
[GUAUPLP] on the Process Submission Controls (GJAPCTL) form.
2. Select the type of upload that you will be performing, and click Continue. Only the
options for which security access has been granted will be displayed.
The file will be uploaded from your computer to the specified directory on the database
server using either the uploaded file name or the file name as defined on GUAUPLP.
4. Close the browser window to return to the form where you originated the download.
5. If you look in the location '/u01/banner/data/upload' you should see the file
that you just uploaded.