Adobe Connect User Community


Send this page





Bookmark and Share

Home >  Learning Center >  Tutorials >  Developing Flash-based Certificates for Adobe Connect Curriculum Module

Developing Flash-based Certificates for Adobe Connect Curriculum Module

Andrew Chemey, Adobe Systems

August 2010

Expertise Level: Administrator

  
5 Votes

This article serves to describe a template that can be used to develop certificates specifically for the Adobe Connect Curriculum Module.  In following the article and using the template, Administrators can insert a Flash-based Item into an Adobe Connect Curriculum that will present learners with a printable certificate of completion.   

Easy to Use

Even if you are not a developer – as long as you understand the purpose of this article, you will be able to use this template to create your own customized certificate.

In an effort to make this easy to use, I’ve written the first part of the article (after the overview with EASY steps that can be taken to use the template for your own purpose).  The template may only require you (or a developer) to replace just three images in the Flash-based file (which are for the certificates) and to move the order of the text objects on the stage to accommodate your certificate images

The template is developed so that the certificate does not need to be inserted with any pre-requisites.  It will dynamically determine the status of the Curriculum to determine whether the certificate should be displayed or not.

Technical Babble

The template and corresponding sample files provided with this article use the Adobe Connect XML-API’s to communicate with and retrieve data from Connect.  This makes the article very specific to Adobe Connect Curriculum Module and does not apply to use within any other Learning Management System (LMS).  The template does not use the AICC or SCORM-based standards to communicate.  The result of creating a Curriculum Certificate based on the template provided with this article is not intended to be inserted into an individual content file (e.g. Adobe Captivate or Adobe Presenter).  A separate article has been written for how a certificate can be created and inserted into Adobe Presenter or Adobe Captivate that will work within any LMS environment, including Adobe Connect.  Please see “Adding Learning Certificates to Presenter and Captivate Courses” found on the ConnectUsers website, for more information.

The Certificate for Connect Curriculum template is based on ActionScript 2.0 and is not currently available in ActionScript 3.0.  The component is provided “as-is” and may or may not be suitable for your environment or use.  It has been tested with Adobe Connect 6, 7 and 7.5. 

Requirements

  • Flash 8 or higher is recommended
  • Flash Player 8 or higher is recommended
  • Familiarity with ActionScript is recommended
  • Adobe Acrobat Connect Pro account with the Training Module
  • Files associated with this document are available for download.  These files may be compressed in .zip format and may require you to install an extraction program such as 7-Zip available from http://www.7-zip.com.

Overview

The Curriculum Certificate template is created in Flash and uses the XML-API’s of Adobe Connect.  It’s the XML-API’s of Adobe Connect that provide the data that you can use in a certificate. 

NOTE:  Do not be intimidated because of references to Flash, XML or Adobe Connect’s XML-API’s.  Please review “Customizing the Template” and “Demonstration”, above.

Figure 1 - Certificate in Adobe Connect Curriculum
Figure 1: Example of a Certificate in Adobe Connect

The figure above, displays a certificate created in Flash based on this Curriculum Certificate template.  It has been inserted as an Item and launched from a completed Adobe Connect Curriculum. 

The template and the sample files are designed to specifically work with Adobe Connect and even more specifically the Adobe Connect Curriculum Module.  The certificate attempts to:

  • Determine if the file was even launched in an Adobe Connect Curriculum Module
  • Determine if the user is enrolled in the Adobe Connect Curriculum
  • Queries Adobe Connect for the name of the Curriculum, the status of the Curriculum, the date the Curriculum was completed; and the Certificate ID of the Curriculum.

 

For example, if you just double-click on the SWF file that is provided as part of the template – you’ll see the message shown in Figure 2, below:

Figure 2 - Example of Loading Error
Figure 2: Attempting to Launch the Certificate outside the Curriculum Module

 

All of the ActionScript (code) has been provided for you.  All you need to do is to replace three images and move some text objects around the stage to format them with your own custom certificate. 

Using the Curriculum Certificate Template

The Curriculum Certificate Template is easy to use. As a reminder – please review these two demonstrations to see the Curriculum Certificate in Adobe Connect; AND to view how to customize the template for your own purposes:

 

Here are the steps to customize and use the Curriculum Certificate:

  • Extract (unzip) the contents of the template on your local machine
  • Open the template in Flash
  • Open the library and look for the three images found in the Certificates folder
  • Replace the three images with JPEG’s of your own certificate
  • Modify the text objects from three Movie Clips in the library
  • Publish the Flash-based certificate to generate a SWF
  • Import the certificate SWF into the Content Module of Adobe Connect
  • Reference the certificate from a Curriculum Module of Adobe Connect

Extract (unzip) the contents of the template on your local machine

Download the template from this article.  Extract it by using your favorite zip extractor.

Open the template in Flash

Double-click the template FLA (called “index.fla”) file to open it in Flash 8 or higher

Open the library; look for the three images in the Certificates folder

In Flash, open the library by selecting Window > Library from the Menu; or by pressing <Ctrl> + L on the keyboard.

Once opened, expand the “Certificates” folder and expand the “images” folder

There should be references to three image files in that folder:

  • certificateLandscape.jpg
  • certificate Portrait.jpg
  • certificateScreen.jpg

Figure 3 - Expanded Library of Curriculum Certificate Template
Figure 3: Expanded Library of the Curriculum Certificate template file in Adobe Flash

Replace the three images with JPEG’s of your own certificate

Replace the images associated with each of the certificate files, in the Curriculum Certificate Template Library.  This is accomplished by:

  • Double-clicking on the icon associated with each of the Bitmap references in the “images” folder of the Library
  • In the “Bitmap Properties” dialog, click import and select a JPG or other image file that represents your own custom certificate.

 

NOTE:  You should do this for each of the three Bitmap references in the library.  You should also match-up the size of the images, so there are not any conflicts with formatting during the display or print of your certificates.  The image file sizes are as follows:

Image

File Size

Landscape (certificateLandscape.jpg)

700 x 515 pixels

Portrait (certificatePortrait.jpg)

540 x 715 pixels

Screen (certificateScreen.jpg)

550 x 380pixels

Modify text objects from each of the three Movie Clips in the library

Not all certificates are created the same.  For example, the name of the user won’t appear in the same location (and you may want to modify the font and other styles, etc).  After importing your custom certificate images, insert, delete, move, or otherwise modify the available text objects that can be displayed on the certificates.

The Template provides a number of text objects that can be displayed and dynamically updated in your certificate, including the name of the learner, title of the Curriculum, etc.  If you insert Flash Text Objects on the stage with specific instance names, that data will be displayed on your custom report. 

Figure 4 - Screen Capture showing Instance Name of a Text Object in Curriculum Certificate Template
Figure 4: Text Object selected on Stage; Properties Window showing its instance name (name_txt)

For more information on “instance names”, please see the Flash documentation.

Text Objects

Here is the list of Text Objects that can be inserted in your Curriculum Certificates:

Instance Name

Description

name_txt

Displays the Learner’s Name from Adobe Connect

course_txt

Display’s the Title of the Curriculum. 
NOTE: This is the title of the entire Curriculum and not the title of the Certificate Item.

certificateID_txt

Displays the Certificate ID as generated by Adobe Connect

date_txt

Displays the current date (formatted as “January 01, 1999”)

month_txt

Displays the current month (formatted as “January”)

day_txt

Displays the current day (formatted as “01”)

year_txt

Displays the current year (formatted as “1999”)

dateCompleted_txt

Display’s the date the Curriculum was completed (formatted as “January 01, 1999”)

monthCompleted_txt

Displays the month the Curriculum was completed  (formatted as “January”)

dayCompleted_txt

Displays the day the Curriculum was completed  (formatted as “01”)

yearCompleted_txt

Displays the year the Curriculum was completed  (formatted as “1999”)

                       

Publish the Flash-based certificate to generate a SWF

Publish your custom certificate to generate a SWF file.  This can be accomplished by selecting Control > Test Movie from the Menu OR; File > Publish.  The SWF file will be inserted into Adobe Connect as your Curriculum Certificate.

Import the Certificate SWF into the Content Module of Adobe Connect

Import the resulting Curriculum Certificate SWF into Adobe Connect.  This is accomplished in the Content Tab of Adobe Connect.

Figure 5 - Screen Capture of the Content Tab of Adobe Connect
Figure 5: Content Tab of Adobe Connect

Reference the certificate from a Curriculum Module of Adobe Connect

Once the Curriculum Certificate has been inserted as Content, you can either create a course, or simply reference the Content Object from a Curriculum in the Training Module. 

NOTE:  The Training Module might not be purchased/available by all organizations.  Please contact your Adobe Connect Administrator for more information on Connect Training.

Figure 6 - Screen Capture of a Curriculum in Adobe Connect
Figure 6: Curriculum Certificate inserted as an Item in an Adobe Connect Curriculum

Sample Files

There is only one sample file provided with this article.  All of the code is available for you to review and modify, for your own purposes. 

Sample 1

This certificate is simply the “template” file that has been published as a Flash SWF file.  It displays a certificate with most of the Text Objects that are available in the template, including Name of Learner, Title of the Curriculum, the Curriculum ID and the date the Curriculum was completed.

This certificate provides both a print and quit button is provided (the latter may not work in all environments)

Conclusion

These prototype files are provided “as-is”, though I expect to be making changes to them.  Feel free to contact me with any updates and suggestions you might have for these files.



Member Comments

Share your thoughts. Tell us what you think about this tutorial.


AUGUST 16, 2010

You guys think you could check the links before posting?!?! None of the links on this page work.

Can we get the files!??

AUGUST 16, 2010

Your "Send us your feedback" link at the top of the page doesn't really work - it's telling me I have an invalid email address, but it's taking my username, and it's un-editable...Adobe-1 Usability-0

AUGUST 16, 2010

All of the links (including the feedback link) work for me.

AUGUST 16, 2010

Zip file doesn't work:
http://www.connectusers.com/tutorials/2010/08/cert_connect/CertificatesInConnectCurriculum_Template/index.zip

Returns a 404

Feedback button works, but if my username is not my email address it returns an error

AUGUST 16, 2010

Samples link doesn't work
http://www.connectusers.com/tutorials/2010/08/cert_connect/CertificatesInConnectCurriculum_Samples/CertificatesInConnectCurriculum_Sample1.zip

returns a 404

AUGUST 16, 2010

Yeah, I get the 404 error as well on those zip file links, regardless of which computer or web browser I use.

http://www.connectusers.com/tutorials/2010/08/cert_connect/CertificatesInConnectCurriculum_Template/index.zip

http://www.connectusers.com/tutorials/2010/08/cert_connect/CertificatesInConnectCurriculum_Samples/CertificatesInConnectCurriculum_Sample1.zip

Does the public have read-only access rights to those directory paths?

- Tom

ps. The Send us Your Feedback button works for me.

AUGUST 16, 2010

Tom - in the Feedback form, under "Your Email Address:" is your email address included here or your username "TomR"?

AUGUST 16, 2010

----
in the Feedback form, under "Your Email Address:" is your email address included here or your username "TomR"?

— mroyCDHA
----

Yes, my email address appears there, not my username.

AUGUST 17, 2010

Yeah...for me, it's my username - hence the issue

AUGUST 17, 2010

Andrew? Any luck re-linking the files? We're still getting 404's - I'd really like to implement this solution; we've been working with trying to create certificates with Connect for about a year now

AUGUST 17, 2010

Please try again - they should all be there.

AUGUST 17, 2010

Awesome! Thanks a lot

AUGUST 18, 2010

The links all worked when I handed the article off... :)

I realize there are still some problems with the format of the article (title is a big hint) and some of the links still do not work. Feel free to ping me directly and I can provide assistance on the missing links/article. The "walkthrough" demonstrates how easy it is to modify the certificate for your own purposes.

I hope the poor feedback is for the content of the article and not the issues in the technical difficulties in getting this article posted (of which I don't have any control - I'm just an author/developer). Constructive feedback is appreciated.

-Andrew

AUGUST 18, 2010

I do have an ActionScript update for forcing the page to be printed in landscape mode (it simply rotates the movieclip 90 degrees before printing). If I don't get that in an updated set of files or post the raw code here - feel free to ping me off-list for assistance.

AUGUST 23, 2010

Thanks Andrew for this great tutorial. It will come in handy.


FYI - Some of the links failed with Google Chrome, but they all worked with IE8.

AUGUST 26, 2010

Hello Andrew,

I've been trying out the template and noticed that the dateCompleted_txt variable has the comma in the wrong place:

August, 26 2010

should be:

August 26, 2010

I've very definitely interested in the code for rotating the movieclip 90º before printing. I'll contact you for that. Also, what would be the best way for me to center the certificate when printing it out? (I'm using slightly different dimensions) Thanks.

- Tom

AUGUST 27, 2010

Tom,

I've sent you privately an updated template for you to use (and walked through how to center your certificate on-screen and in print mode). The updated template corrects the date issue and provides a boolean to force landscape-mode printing or not.

Regards,

Andrew

AUGUST 27, 2010

Hey Andrew,

The latest improvements you've made to the Flash certificate are really excellent! The forced landscape works great when printing.

Note: after experimenting a little more, I decided to put the paper hairline border into a separate locked guide layer in the Flash "landscape" movieclip as I did have the certificate print on our copier a little out of alignment and did see it appear. The main thing is that it's visible while in Flash when adjusting the certificate location.

I added the certificate to a curriculum and it works very well. The only remaining question I have is, Andrew do you have any tips for handling reserved characters like a forward slash? One of our products actually has a forward slash "/" in its name. Consequently, the curriculum name for this product also had this character and wouldn't print this character or anything beyond it in the curriculum title. My workaround is I simply removed the forward slash for now in the curriculum title.

I'm very impressed with this tool for Adobe Connect. It's a real time-saver for our business and we'll be using it for every curriculum we develop.

Thanks again!

- Tom

AUGUST 27, 2010

Tom,

I'm glad it worked for you! Thank you for the great suggestions to improving the display/layout of the certificate.

If some characters are not appearing in the Certificate - it would probably be caused by a lack of embedded characters. If you include additional embedded characters in the font list, they should appear in the certificate.

Regards,

Andrew

DECEMBER 21, 2010

Is there a way to populate customized questions from event management onto the certificate or can it only be date, name course name, cert, number?

DECEMBER 21, 2010

@kfitch,

If the data (e.g. customized questions from event management) is available via the XML-API's then you can modify the certificate to display those questions.

Regards,

Andrew

FEBRUARY 03, 2011

Hi, not sure if I am having a version issue or what. When I try to ope the unzipped template file (index.fla)I keep getting an error message that says "unexpected file format".
I am using Flash Professional 8 and I noticed in the tutorial you were using a newer version. Please let me know what you think and how I can resolve this issue. I am looking forward to trying it out, I have done very little in Flash but the tutorial does make it look pretty easy.
Thanks,
Tom Bertram

FEBRUARY 03, 2011

Hello Andrew,

We recently noticed an issue with your ActionScript code. You're pulling the date completed from the wrong API. Instead of report-my-training, you should be calling the report-user-trainings-taken API and getting the date-taken value.

Currently, you're getting the date the curriculum was created, not when the user completes it. So, the wrong date appears on the printed certificate.

If you could fix this, I'd greatly appreciate it. I tried tinkering with your code, but the report-user-trainings-taken API also requires you to pass the principal id in order to grab the date-taken value, and I couldn't figure out how to integrate that into your code.

action=report-user-trainings-taken&principal-id=833422237

Thanks Andrew,

- Tom

FEBRUARY 06, 2011

Hi Andrew, I'm getting the same problem as Tom.

any help would be greatly appreciated

Thanks

Lars

FEBRUARY 07, 2011

@Tom Bertram - I sent you a file privately.

@TomR & larsjohnson - I'm looking at the API/Date issue, today.

-Andrew

FEBRUARY 08, 2011

In looking at the code, I see that the date of the cerificate is being populated with date-created. This is incorrect as this is the date that the course or curriculum was created (not the certificate). I see no easy way of fixing this as it does not seem like the date that the course was completed is available in the server response.

Please advise & Thanks,

Erik

FEBRUARY 08, 2011

sorry about the repeat comment, I see it's already been posted.

FEBRUARY 11, 2011

I have a new version of the file which addresses the completion issue (and adds debugging capabilities). I haven't uploaded to this site, yet. Please contact me directly for a copy. I am in the middle of updates to include better parsing of the XML and a AS3 version.

Regards,

Andrew


Andrew AT LearningConsulting DOT com

FEBRUARY 19, 2011

I now have an AS3 version of the certificate available. It has a number of changes/improvements, too:)

A new article is forthcoming (though you might want to contact me off-list since it might not be right away)...

MARCH 14, 2011

I have had numerous complaints from users stating the certificate is printing with other users names on it. Any ideas??

MARCH 16, 2011

@Kfitch - Do users share the same machine? Is it possible one user never logged out before another started taking the training?

MARCH 28, 2011

In some cases it is a community computer, but others it is an unused computer on the same system.. example, the director of education at hospital X's computer in his office, but whe he prints it prints another user from the same hospital who has never used his computer

MARCH 28, 2011

@kfitch - Can you contact me off-list to review?

Andrew AT LearningConsulting DOT com

Regards,

Andrew

APRIL 14, 2011

Andrew - I am new to the group and am needing assistance incorporate a certificate in a curriculum. I plan on reviewing this article and it's tutorials very carefully, but I am more of a content person and not all that adept with the programming aspect of things, so I need to understand it enough to provide and coding information to my IT support colleagues.

If you have any additional or updated information/recommendations on how to present this to my more technical colleagues for implementation, please feel free to contact me.

Thanks much!
Bonnie Davis
bonnie.c.davis1244@gmail.com

MAY 09, 2011

Hi Andrew,

I am also getting the message "unexpected file format" when I try to open it in Flash Professional 9.0

Can you help me please?

MAY 10, 2011

@connectflusher - contact me off-list so I can send you files that will open in Flash 9.

-Andrew

Andrew AT LearningConsulting DOT com

JUNE 09, 2011

Andrew,
Did you ever update the files on this blog to fix the completion date issue? If not can you send me the fla file with the fix?

Thanks,

JUNE 09, 2011

@Dave - No, I did not update the files associated with this article. Yes, I will send you the files along with some updated information. I can't seem to find your contact information. Please drop me a line (see my info, above).

JULY 27, 2011

Hi Andrew,
Could you please mail the updated files for generating the certificates? Please include any additional information that might be needed. Would drop you a message offline for the same.

Appreciate the good work!

Cheers,
Venky
venky [AT] vsworld [DOT] com

DECEMBER 30, 2011

Has anyone figured out a solution for the completion date issue? I also am having trouble with certificates printing the date of the curriculum creation versus the date the user completed it.

Great article! Thanks!

Bob
bmack AT worldclassbeer DOT com
Log in to leave comments


<< Back to Tutorials main menu.

?>