1 Career Voyages Web Site Notes Personnel / Contact Info Name Organization / Role Phone XPAND Manager / Career Voyages Programmer / Career Voyages Programmer / ACINet creates occupation reports in pop-up windows DBA - for web services Programmer / ASL creates Ed and Training web services Network Administrator Network Administrator Graphics Manager Group Career Voyages web site content manager Apprenticeship contact Programmer/Manager DOLETA Manager Jaypar Inc Compliance Used to Provide BAT data for Apprenticeship Provides BAT data for Apprenticeship Runs the CF servers at DOL Primary Contact Analyzes the WebTrends report Runs the CF servers at DOL Manager Contact at the National Crosswalk Service Center (NCSC)
2 Address U.S. Department of Labor 200 Constitution Ave, NW Washington, DC Domain Names DOL has and has implemented:.gov We have and have implemented:.com.net.org. info thecareervoyages.com The following are not used:.us.biz.cc.tv.bz Regarding the Spanish landing page (explorandoprofesiones.gov), we own both explorandoprofesiones.org explorandoprofesiones.com Both point to explorandoprofesiones.gov File Naming, Includes and Basic Structure Includes are used extensively, and follow a logical naming convention
3 Each displayed page calls a wrapper, located in the wrappers subdirectory, which contains all of the standard elements, that is, those elements that appear on every page. For example, o When a printer-friendly page is requested, the wrapperprinterfriendly.cfm is called, and o When an in-demand page is requested, the wrapperindemand.cfm wrapper is called. o See the wrapperdesign.doc file for a graphic showing how everything fits together. Important: follow the established file naming conventions when creating new files certain bits of logic depend on this naming convention. The order of the right side items is o Different Areas menu OR rotating images o Career Videos o Career Links o Language toggle (if used) o PDF files (automatically inserted here via wrapper)
4 Server/Access Information URL Address Description Username/Password Development Server Machine at XPAND Remote Desktop: RT-Coldfusion Share: \\rt-coldfusion\cf (Y: drive) This is the Cold Fusion Administrator server, which Password: enables you to set DSN s, build Verity searches, etc. URL The interface to the administrator server is a web page that can be accessed from anywhere. The web server is the built-in web server that comes with ColdFsion. This is the development web server for the Career Voyages site. It is used to view the site as it is being developed and to get approval for changes. Path to Verity collections: C:\ColdFusion8\verity\collections Path to server root: C:\ColdFusion8\wwwroot\careervoyages The web server is the built-in web server that comes with ColdFsion. Web site login (Windows level): NONE Username: Password: URL Development Server Machine (CFMX) at Xpand/Herndon This is the Cold Fusion Administrator server, which enables Password: you to set DSN s, build Verity searches, etc. The interface to the administrator server is a web page that can be accessed from anywhere. This web server is called cfadmin in IIS. URL This is the development web server for the Career Voyages Web site login (Windows level):
5 (inside firewall) IIS Web Server URL site. It is used to view the site as it is being developed and to get approval for changes. This web server is called careervoyages in IIS and is password protected using IIS. Path to Verity collections: C:\ColdFusion8\verity\collections Path to server root: C:\ColdFusion8\wwwroot This is the IIS server that enables you to create FTP and virtual web servers. To access this server, you must use Remote Desktop to actually get on the rt-coldfusion machine. Once you are on the machine, open Internet Information Services Manager Current Virtual Web Servers careervoyages for the Career Voyages site (details above) cfadmin to run the Cold Fusion Administrator (details above) Current FTP Servers (details above) FTP to D:\websites enables FTP access to the machine Citrix Machine You must use Citrix to securely post files to the staging server at DOL (details below). Once you have logged into the Citrix machine using your web browser (remote.doleta.gov): The V: drive will be your PC s C: drive, and You will use FTP on the Citrix server to transfer files to the staging and live servers at DOL. (Actually, Username: Password: Remote Desktop login: Username: Password: Username: Password: domain=etadol ICA Client File Security window info: full access/always ask
6 you don t FTP in the classic sense see below.) Live Server at DOL This is the live web site at DOL. For security reasons, you cannot FTP to the live machine. Therefore, you must all changes to name at DOL Path to Verity collections: C:\ColdFusion8\verity\collections Path to server root: UNKNOWN N/A Cold Fusion (CFMX) Machine IP s (Career Voyages Dev Server) Careervoyages Individual Coldfusionadmin FTP to d:\websites Web Servers IP and IP (URL resolves to IP) IP IP FTP Server IP Industry Codes / Industry Strings Used in File Naming, Etc. Industry Industry String Category Xpand s Industry ID RAIS Code Prefix (OLD) Advanced Manufacturing advmanufacturing Industries Automotive Services automotive Industries Construction construction Industries Energy energy Industries Financial Services financial Industries Health Care healthcare Industries Hospitality hospitality Industries 7 43-
7 Information Technology infotech Industries Retail retail Industries Transportation transportation Industries Biotechnology biotechnology Industries 11 Geospatial Technology geospatialtechnology Emerging Industries 12 Nanotechnology nanotechnology Emerging Industries 13 Aerospace aerospace Industries 14 Homeland Security homelandsecurity Industries 15 Education education Industries 16 Business Management and Administration business Industries 17 Other noindustry Industries 20 Quality Assurance Use the following URL to launch Quality Center: URL After the client files are downloaded, select 'Quality Center'. o User Name: o Password: o Keep the 'Default' domain. o Select Project 'Career_Voyages'. After login, select the 'Defects' module. You will find all defects assigned to you. After fixing a defect, please set the Status to Fixed, and reassign the defect to the QA tester. WebTrends Stats Each month, 1. Compile the stats using the webtrendstracker.xls file under the Z:\directories\ folder and then copy these into your monthly report. 2. Send the following stats to the appropriate personnel: Page Views Visits Average Length of Visit (min) Total Hits
8 Unique Visitors Visitors Who Visited More Than Once 508 Compliance The tool to easily make sure you are compliant is called PageScreamer and is available at We have purchased this already, and the password to download the software is D1reng23 Verity Collections Name careervoyages cfnotebook Creation Method Cold Fusion admin page Cold Fusion admin page The search admin page, which is located under the web root at URL enables you to create and maintain the Verity collections required for the Career Voyages site. Important: this must be run on each server: local, dev, and live! Scheduled Tasks Task Description Scheduled Task Location run123livesitetest.cfm Every 15 minutes, this scheduled task calls the ColdFusion dev 123livesitetest.cfm page on the Xpand dev machine. machine at Xpand. 123livesitetest.cfm makes an http call to the index.cfm page on the LIVE server. Creation Method Cold Fusion Administrator If the site s web server does NOT respond with a 200 OK message, an is sent to the request.appmaster address (set in Application.cfm) with the date and time. run123flushcache.cfm Every night at 3:00 AM, this task calls the 123flushcache.cfm page on the LIVE server. This page merely flushes the cache on whatever Charlie Cain s machine at Xpand. Cold Fusion Administrator
9 machine it s on. Tie-Ins with Other XPAND Web Sites/Databases ACINet ASL The Occupation Description reports, viewable from the In-Demand pages and elsewhere, come from an ACINet web service. o The data for the Tools and Technology pop-up page comes from this web service as well. o URL The Occupations By State and State Report pages come from ACINet.asp pages. The Certification section found within the Education and Training menus comes from an ACINet web service. o URL (list) o URL (detail) Within each industry, 4 of Education and Training sections (Apprenticeship, Community Colleges, 4-year Colleges, and Other Options BUT NOT CERTIFICATIONS) display data that comes from an ASL web service created by Jim Weng. o The URL for this web service is set in the Application.cfm file and uses a date-based naming convention. For example, URL is the May 25, 2005 version. IMPORTANT: If the web service is modified in any way, the web service URL must also change this is the result of a caching problem with the Cold Fusion server. o Certain data chunks from DOL databases (see below) were incorporated into the ASL database to make this web service possible. To facilitate the integration of the DOL data, we created a simple list of industry codes that correspond with DOL codes (see below). o The Apprenticeship, Community Colleges, and 4-year Colleges sections are comprised of a list page and a detail page. o The Other Options section, which is NOT industry-specific, is merely a listing of One-Stop Career Centers in a specific geographic region. The maps and driving directions, which are used by the above ASL web services, come from a separate ASL web service and were created by Harold Yang. o The URL for the map web service is http URL.
10 o The URL for the address broker web service is URL IMPORTANT: The following industries do not currently have Apprenticeship/BAT data. The web service is turned off for these. Business Management and Administration (entire Apprenticeship section removed because no Apprenticeships exist or will exist) Education (entire Apprenticeship section removed because no Apprenticeships exist or will exist) Financial Services (entire Apprenticeship section removed because no Apprenticeships exist or will exist) Nanotechnology (entire Apprenticeship section removed because no Apprenticeships exist or will exist) Retail (entire Apprenticeship section removed because no Apprenticeships exist or will exist) Aerospace (just CareerOneStop form displayed. However, this can be viewed from the generic Apprenticeship page.) Search for <cfset webserviceready = "no"> to find these files. Gov t Databases Used in the ASL/Career Voyages Web Services The Apprenticeship part of the web service uses data from the BAT (Bureau of Apprenticeship and Training) database. Parts of this DOL database, provided by DOL personnel, must be downloaded and incorporated into the ASL Oracle db each month. The password is batdoleta. The 4-year Colleges and Community Colleges part of the web service uses IPEDS (Integrated Postsecondary Education Data System) data. This data is updated on a yearly basis and is provided by Steve Rosenow at the National Crosswalk Service Center (NCSC), Other Web Site/Database Tie-Ins The Career Compass page passes variables to a NY Career Zone jsp page that returns an XML file. This file is then transformed using XSLT into the HTML page. o The URL for this web service is URL o IMPORTANT: If you make changes to the in-demand occupations (which ones are in-demand, not the associated numbers), you must also change the soccodes in the careercompass-nyczresults.xsl file. The Career Changers Military page uses a static XML page and XSLT to produce the HTML. This static XML file is actually a rather long representation of an Access database that shows the relationships between military and in-demand civilian occupations. We could have accessed the Access file directly, but we want to keep Career Voyages database free because of technical issues downtown.
12 Color Pallette Application.cfm contains the RGB values used in HTML Fonts The standard font is ITC Avant Garde Gothic Image Size Restrictions Page Headers max width is 550 pixels Image map graphics on the main pages (Different Areas ): max 460 wide, standard is 450 Full screen width (bottom menus) is 588 pixels IPEDS Correction Tracker School Contact Phone Excel File Sent North Seattle Community College Alissa Agnello Red Rocks Community College Laura Licari Caldwell College Sister Catherine Waters (973) University of North Alabama Greg Gaston Updated Excel File Received at Xpand Excel File Implemented Google Search/Site Maps The sitemaps URL is: https://www.google.com/webmasters/sitemaps/ The username/password to get into the site are: username / password From here you can view all sorts of information regarding the site. However, in addition to logging in, you must also go through a verification process, outlined on the Google site, before you can actually view any info.
13 How to Create a Google Site Map Create a Google Site Map whenever new files are added/deleted to the site. 1. Run the Xenu link checker program, skipping the external links. 2. Save the result as a text file using File >> Export to TAB Separated File. 3. Import (open) the file into Excel, using tab as the delimiter. 4. Save the file in an Excel format. 5. Delete all columns except Address, Status and Type (A, B, and C) 6. Using search/replace, remove the non-relevant text items. The goal is to produce a list of URLs to all of the.cfm files in the root dir. IMPORTANT: The URL s must be full, starting with http: and, if designating a directory, end with /. Sort by Status and delete all of the entries beginning with skipped, that is, external links. Sort by Type and delete all of the entries that don t begin with text/html, that is, non.cfm files. Replace.cfm? with.cfmdeletethis. Run a filter to show just the records that DO NOT CONTAIN DELETETHIS Copy the resulting records into a new sheet. There should be roughly 350 records. This effectively deletes all of the files with query strings (these are duplicates). Replace URL with Remove any extraneous headers/columns/rows. All that should exist now is URL s. Copy this list of URL s to the listofurls.txt file. 7. Run the create123cvsitemap.cfm file, but first make sure it is using the text file you just created as the source material. Running this file will create the 123cvsitemap.xml file, which is the actual site map used by Google. 8. Open the 123cvsitemap.xml file and save it again in the UTF-8 format. 9. this file to Lichuan and have him copy it to the CV root directory on the live server. IMPORTANT: Before doing this, you will need to rename this file something other than.xml for the file to get through the DOL firewall. Inform the recipient of the (Lichuan) that they need to rename the file using an.xml extension. 10. Go to the Google site and add/resubmit the site map. Be sure to use the full URL as indicated by Google, for example, URL.
14 How to Add New IPEDS Data IPEDS (Integrated Postsecondary Education Data System) data is periodically updated and provided by Steve Rosenow at the National Crosswalk Service Center (NCSC). This data maps school programs (courses of study) against occupations (SOCCODE). Periodically, this data must be refreshed, usually because either We added an industry/occupations and need to regenerate the data, or Steve has provided a periodic update, usually every 6 months. Typically, we send Steve a list of the Career Voyages occupations and the industries in which they fall. Steve sends us a crosswalk db file that maps the Career Voyages occupations against schools courses of study. However, even after this, the db file must be massaged a bit: Note: All the relevant files are in the directory. 1. From Steve s new crosswalk file, have Othman create an Excel file that contains unique CIP_Titles, that is, courses of study. 2. Massage this a bit so that it looks like the other CIP_Titles files. For ease of use, you create an alpha sort column. 3. Forward this file to name so he can select the ones to reject; some courses of study simply aren t applicable to Career Voyages. 4. When the file comes back from name, you must do some things to the self correction files and have Othman update the IPEDS db. Othman Updates 1. Forward Name s updated file with the rejects back to Othman and have him do 2 things: a. Delete the rejected courses of study from the db, and b. Have him create a new CV_IPEDS_PROGRAMS_DATE.xls file. This file contains tabs for schools (1 tab) and the courses of study offered by those schools (3 tabs). They are linked by UNIT_ID, which is a unique identifier for that school. You will use this file to create the self-update file you send to schools wishing to change their IPEDS data at Career Voyages. Your Updates 1. Within Name s updated file, delete the rejected courses of study, re-do the alpha numbers and copy this to the Copy and Paste CIP Titles tab of the Self_Correction_Template.xls file. You use this template file to create the actual self-update file that you then send to schools.
15 How to Add a New Industry Update the Background Docs (SEE BELOW) Inform Steve Rosenow so he can generate a new set of IPEDS data. Inform Jim Weng so he can change his code. Inform Sandy so she can change her code. Modify the.cfm pages that generate the XML and regenerate the XML. Regenerate all of the data download docs Add the industry files to the inccodesetdisplayvariablesforwebse rvices.cfm file if the pages are going to be bi-lingual For all displayed files, add solamente text at the tops of the pages (if the pages are going to be bi-lingual and not initially translated) Create/identify photos for rotating pics include. In addition to the sub areas pages, get the following Update the master Excel file with a new Industry ID. Have Name determine the primary industry if it s a multi-occ industry. He ll need the Industry ID and the occs that fall under that industry. He ll need the Industry ID. Send the Industry ID and the occs that fall under that industry. This will enable her to change the industry links on the Occupations by State pop-up: URL Send her the code for the new Ed and Training menu for inclusion on the state report pages Have her provide occupationsbystate-download.xls generatexml-allaudiences-whichindustriesaregrowing.cfm generatexml-startforall.cfm generatexml-allindustries-indemandoccs.cfm generatexml-allindustries-certifications-occlist.cfm indemandoccs download.xls (and pdf) top50occs-download.xls (and pdf) pdf for occupationsbystate-download.xls (xls provided by Sandy) photooccupationdesc small.jpg, photooccupationdesc132011small.jpg Industry Overview Links
16 content. Sample Occs for T2 Job Corp vocational offering 3 sample vids for the main page 2 chunks for the Apprenticeship page Modify the left nav wrapper.cfm Add industry to the site map sitemap-main.cfm page Create new graphics headers 5 orange/blue menus Create 11 standard.cfm business-main.cfm pages for the root dir. business-4yearcollegesws.cfm business-apprenticeshipws.cfm business-certifications.cfm business-commcollegesws.cfm business-links.cfm business-otheroptions-careerclusters.cfm business-otheroptions-careeronestopws.cfm business-otheroptions-jobcorps.cfm business-otheroptionsws.cfm business-toolsandtechnology.cfm Create sub area pages for the root dir. business-videos.cfm General Management Operations Marketing and Sales Finance and Accounting Human Resources Administrative Support Entrepreneurs Create content includes. inccontent-business-getstartedtable.cfm inccontent-business-links.cfm inccontent-business-videos.cfm Modify the Other Options includes inccontent-allindustries-otheroptions-jobcorpssection.cfm inccontent-allindustries-otheroptions-careerclusterssection.cfm inccontent-allindustries-otheroptions-mainmenu.cfm
17 Create right side includes. incrightside-business-btncareerlinks.cfm incrightside-business-btncareervideos.cfm incrightside-business-btntoolsandtechnology.cfm incrightside-business-menudiffareas.cfm incrightside-business-rotatingpics.cfm Update You Are Here trail. incyouarehere.cfm Update the following files with new text based logic, for example education Make mods to the Other In- Demand Occupations page as needed careervideos-main.cfm certifications-acinet-detailws.cfm certifications-acinet-listws.cfm links-byindustry.cfm occupationdesc-acinet-results.cfm singleindustryoccupations-main.cfm toolsandtechnology-acinet-results.cfm toolsandtechnology-main.cfm (orange/blue menu) inccode-setdisplayvariablesforwebservices.cfm inccontent-4yearcolleges-startlearningtable.cfm (orange/blue menu) inccontent-allindustries-btnindemandoccupations.cfm inccontent-allindustries-btnindemandoccupationsbtnindustryoverview.cfm inccontent-allindustries-btnindustryoverview.cfm inccontent-allindustries-btnseeindemand.cfm inccontent-allindustries-certifications.cfm inccontent-apprenticeship-startlearningtable.cfm (orange/blue menu) inccontent-allindustries-samplevideosection.cfm inccontent-careeradvisors-dofirstlist.cfm (orange/blue menu) inccontent-certifications-startlearningtable.cfm (orange/blue menu) inccontent-commcolleges-startlearningtable.cfm (orange/blue menu) ALL set coordinate files, for example, inccode-set17startlearningmenucoords.cfm inccontent-parents-dofirstlist.cfm inccontent-students-dofirstlist.cfm incsmallwindow-allindustries-industryoverview.cfm Move top 50 to white button status Incorporate 6 left over occs from Other In-Demand Remove otherindemandoccupations-main.cfm Make mods to the XSLT allaudiences-whichindustriesaregrowing-multioccdetail.xsl
18 files allaudiences-whichindustriesaregrowing-monooccindustrytotals.xsl allindustries-certifications-occlist.xsl careercompass-nyczresults.xsl occupationdesc-acinet-results.xsl IMPORTANT: Make manual mods to the totals on the singleindustryoccupations-main.cfm page. The XSLT doesn t work for some reason. Generate new XML Test Web Services Occupation Description Certifications T2 State Report In Demand Occupations by State Career Compass Implement Spanish translation Will roll out after initial implementation Make changes to all relevant graphics Make changes to explorandoprofesiones-main.cfm Search for and remove the relevant (Solamente en Inglés) chunks Search for and remove the relevant NEED SPANISH chunks Images Check availability of images for the new occs. IMPORTANT: MUST REGEN XML AFTER UPDATING EXCEL FILE.
19 How to Update the Site with New Occs A lot needs to be when adding occupations because this data impacts several different areas of the site. IMPORTANT: Before doing anything, always make back-ups of the files!! Update the Background Docs indemandoccs xls Update the ALLOCCS tab with the new data. See the table below for the data sites 2009 In the ALLOCCS tab, resort using the TOP50FORMULA column and determine if it 2009 impacts the Top 50 occs. If needed, regenerate the Top 50 occupations. In the top50occs-download tab, copy the data from the ALLOCCS tab and create the 2009 corresponding downloadable files, top50occs-download.pdf and top50occsdownload.xls In the indemand download tab, copy the data from the ALLOCCS tab and 2009 create the corresponding downloadable files, indemand download.pdf and indemand download.xls In the ALLOCCS tab, sort by PROJECTEDNEED > INDUSTRY > MULTIPLEYESNO, 2009 and then cut and paste the no occs to the Mono-Occs tab of calcmonomultiocctotals.xls, below. calcmonomultiocctotals.xls With the new data in indemandoccs xls copied to the mono-occs tabs (see above), re-calculate the rest of the tabs. The results of these calculations will be used in the multiindustryoccupations-main.cfm and inccontent-allaudienceswhichindustriesaregrowingtable.cfm files. A LOT of this file is cross checking tallys with different sorts from the web pages indemandoccs xls indemandoccs soccodelists.txt indemandoccs cutandpastefornycz.txt Also, when copying columns of numbers, use the rounded figures, meaning, copy to a text file first, then to the next tab. Update the MONOOCCINDUSTRYTOTALS tab with the data from the Calc Mono-Occ Industry Totals tab (in the calcmonomultiocctotals.xls file). This data will be imported into that Access db and used to generate the XML for the main Which Industries are Growing table, which looks at just mono-industry occupations. Update the indemandoccs soccodelists.txt file this is a comma delineated list of soccodes. Using indemandoccs soccodelists.txt, create the indemandoccs cutandpastefornycz.txt this will be used for the Career Compass XSLT file. Basically, you replace commas with code chunks
20 mocsoc08.xls Industry XML files that support the In-Demand, Other, and Top 50 Occupations pop-ups. Files that support the Career Changers > Military pages. Have Sandy generate an Excel file with the following columns: 2009 MOC_CODE, MOC_TITLE, SOC_CODE, SOC_TITLE, MPC, SVC Add the following columns: 2009 NAVYWARRANT, MARINEWARRANT, INDUSTRY And rename the file mocsocyear.xls Sort Z-A in the MPC column, then Z-A in the SVC column. We do this to identify all of 2009 the Navy Warrant Officers. These are duplicates of the Navy Officers. For the Navy Warrant Officers, put a Y in the NAVYWARRANT column For the Marine Warrant Officers, put a Y in the MARINEWARRANT column IMPORTANT: Some of these are not duplicates of Marine Officers. Resort the sheet by MOC_CODE, and manually determine which of the 2009 MARINEWARRANT = Y rows are NOT duplicates. For the non-dups, change the Y to YKEEP. OPTIONAL: Some of the MOC_CODES are NOT unique. For example, MOC_CODE is both Undersea Medical Officer AND Minesweeping Boatswain's Mate. You can manually go through and identify those where the MOC_CODE is not unique. Resort the sheet by MOC_CODE. For the codes beginning with a zero, insert a carrot 2009 symbol (^) after the code, for example, 0002^. This must be because of the way the XSLT is processed. Resort the sheet by SOC_CODE. For each occupation, determine which is the primary 2009 industry and insert the correct industry string (elsewhere in this doc) for all the occupations in the sheet. Some occs already have this information in the indemandoccs xls. Use your best judgment. IMPORTANT: Use none instead of the noindustry string. Update the Files Open the indemandoccs mdb file and import the ALLOCCS and MONOOCCINDUSTRYTOTALS tabs of the indemandoccs xls file. Each tab gets its own table In a browser, generate the corresponding XML files at URL 2009 mocsoc08.mdb and import the CVCrossWalk tab of the mocsoc08.xls file. In a browser, generate the corresponding files (2 XML and 2 includes) at URL
21 Career Compass Which Industries are Growing.cfm files With the new data in the indemandoccs cutandpastefornycz.txt file, update the careercompass-nyczresults.xsl file. Update inccontent-allaudiences-whichindustriesaregrowingtable.cfm, singleindustryoccupations-main.cfm and multiindustryoccupations-main.cfm