Adobe Acrobat Enabling Online Review & Markup

PowerPoint PresentationLori DeFurio Developer Evangelist, ePaper Technologies November 2002
SetCollabPrefsPerDocument.fdf
JQ-JavaScriptSample.pdf
Join the team of professionals working with Adobe products and receive high-quality information, support, and co-marketing opportunities. The ASN includes these partner programs: Developers, Service Providers, Trainers, and Solution Sales Providers.
Increase your revenue with innovative Adobe Merchandising Tools! Here you will find co- marketing and customizable deliverables including box shots, advertising copy, Web banners and print ad templates for key Adobe products as well as marketing deliverables such as telesales guides and product brochures. These valuable selling tools for Adobe Channel Partners worldwide can help foster and build Adobe product and solutions awareness.
The worldwide hub for resellers, distributors, Adobe Licensing Centers, VAR's for sales tools, program and product information. Whether you are an Adobe channel partner in North America, Europe, Asia Pacific, Latin America, or elsewhere, we have information to help you sell Adobe products in your region.
There are numerous reasons why people become Adobe Certified Experts (ACE). Whether you want to test your skills, promote yourself and your business, or increase your chances of getting a job using Adobe products; this is the place where you'll learn to prepare yourself to become an ACE.
Certified Trainers
Certified Experts
ASN Events
Copyright ©2000 Adobe Systems Incorporated. All rights reserved. Terms of Use Online Privacy Policy Y2K Information
http://partners.adobe.com/ (2 of 2) [3/3/2002 1:27:25 PM]
Tech Resources
Technical Resources
Search Developer Knowledgebase
Technical Notes
Type Technology
Legal Notices
Adobe's Software Development Kits (SDKs) contain reference manuals, specifications and protocols, technical notes, sample code, development tools, and software applications - a complete tool set for taking full advantage of Adobe technology. Additional tools are available with membership in the ASN Developer Program. For details, see program information.
Acrobat • Overview • SDK Download • SDK Documents • Developer Knowledgebase • FDF Toolkit (forms) • Capture SDK • Developer Seminars • PDF Prefix Registration
After Effects • SDK
GoLive • Overview • Download SDK • Extend Script Module • FAQs • Developer Knowledgebase • Forum
Illustrator • SDK
Adobe Solutions Network
Join Developer Program
from Fatbrain.com
LiveMotion • Overview • Download SDK • Developer Knowledgebase • Forum
PageMaker • SDK
Photoshop • SDK
PostScript • SDK
Premiere • SDK
Graphics Technical Information
For general information about graphics in relation to Adobe's graphics- oriented SDKs (After Effects, Illustrator, Photoshop, and Premiere), including TIFF, see the Graphics Technical Information page.
Getting Started
If you are new to plug-in programming, this section contains some tips to help get you started.
Download and install the SDK in which you're interested.
The SDKs contain detailed technical documentation and sample code demonstrating the features of the API. Before beginning your development, familiarize yourself with the documentation, sample projects, and header files.
Set some break points in the sample code, compile them into the application's plug-in directory, and run them using the compiler's debugger. This will get you a clear idea of the flow of control between the plug-in and the host application.
When you're ready to create your own plug-in, start with the sample project which most closely resembles the functionality your plug-in requires, and replace its code with yours (one function at a time), debugging each step of the way.
Getting Help
The SDKs are made available to the general public, however, you must be a member of the ASN Developer Program - Premium Level or purchase Developer Support cases to receive Developer Technical Support.
http://partners.adobe.com/asn/developer/sdks.html (2 of 3) [3/3/2002 1:28:09 PM]
Adobe Solutions Network: Software Development Kits
The ASN Developer Program maintains several electronic mailing lists that are used for peer discussion among developers. They are unmoderated and populated by developers just like you, offering peer discussion of software development kits, Adobe plug-ins, and related issues.
The mailing list below has historically discussed the graphics and publishing SDKs, primarily Photoshop and Illustrator. To find other discussion lists for developers, see the SDK pages above, and visit the Adobe User-to-User Forums.
To join the Graphics & Publishing SDK discussion send an e-mail to: [email protected]
These fields need to be in the message body:
1. Your full name: 2. Business name: 3. Address: 4. City: 5. State: 6. Country: 7. Country code or ZIP: 8. Area code and phone number (business is fine): 9. ASN Developer Program member number:
10. "N/A" if not a member; "Info" if you want info.
Copyright ©2000-2001 Adobe Systems Incorporated. All rights reserved. Terms of Use Online Privacy Policy
http://partners.adobe.com/asn/developer/sdks.html (3 of 3) [3/3/2002 1:28:09 PM]
FrameMaker • FrameMaker Developer Knowledgebase
GoLive • GoLive Developer Knowledgebase
InDesign • InDesign Developer Knowledgebase
LiveMotion • LiveMotion Developer Knowledgebase
SVG • SVG Developer Knowledgebase
XMP • XMP Developer Knowledgebase
The developer KB provides "How To" and "Known Issue" information that
may not be found in the Software Development Kits. The GoLive KB is
intended for JavaScript programmers writing extend scripts which is
another method of extending the power of GoLive.
Developer Knowledgebase
http://support.adobe.com/devsup/devsup.nsf/main.html (1 of 2) [3/3/2002 1:28:15 PM]
Adobe Solutions Network: Technical Notes
Tech Resources
Technical Resources
Legal Notices
Most of these technical notes, specifications, supplements, and errata are PDF files for viewing with Adobe Acrobat® Reader. These unsupported documents are published by the ASN Developer Program. You are welcome to refer to these documents and pass them on to colleagues, but Adobe does not allow wide distribution. These documents are subject to change. We encourage you to bookmark this page and check occasionally to see if a more recent version of a document has become available.
Technical Notes
Acrobat Software Development Kit Documents
http://partners.adobe.com/asn/developer/technotes/main.html [3/3/2002 1:28:17 PM]
Tech Resources Tech Notes
Technical Journal
Patent Clarification Notice Adobe has a number of patents and patents pending, covering technology that is disclosed in the Portable Document Format (PDF) Specification, version 1.3 and later, as documented in PDF Reference and associated technical notes. For details, see the Patent Clarification Notice.
See the Acrobat SDK Documentation for API information (plug-in development).
PDF Reference Version 1.3/1.4
PDF features to facilitate ANSI CGATS.12, PDF/X, version 2.0 #5188 11/10/99 (PDF: 155 KB / 22 pages)
Acrobat Forms JavaScript Object Specification #5186 9/14/01 (PDF: 1.8 MB / 297 pages) Describes the Adobe-defined JavaScript classes for forms, as well as details the load and execution of JavaScripts in the Adobe Acrobat environment.
Recording Output Intentions for Color Critical Workflows #5413 1/22/01 (PDF: 60 KB / 12 pages) Describes a means for identifying the color characteristics of the intended output device associated with a PDF document.
PDF Public-Key Digital Signature and Encryption Specification September 12, 2001 (PDF: 70 KB / 9 pages)
Digital Signature Appearances for Public-Key Interoperability September, 2001 (PDF: 550 KB / 18 pages)
Extending The Adobe Acrobat Installer On The Windows Platform #5419 October, 2001 (PDF: 440 KB / 68 pages)
Deploying Adobe Acrobat Installers using SMS (Microsoft System Management Server®) #5420 August, 2001 (PDF: 160 KB / 26 pages)
Deploying Adobe Acrobat Installer using WTS (Microsoft Windows Terminal Service®) #5421 October, 2001 (PDF: 90 KB / 12 pages)
Customizing the Adobe Acrobat Installer using AEIT (Acrobat Enterprise Installation Tool) #5422 October 2001 (PDF: 400 KB / 34 pages)
Distiller Font Management #5408 9/14/00 (PDF: 278 KB / 46 pages) Specifies the types of fonts Distiller 4.05 supports and describes Distiller considerations for finding, embedding, and subsetting those fonts. It also explains how Distiller indirectly supports TrueType fonts. This document, which is explanatory in nature, is intended for more experienced Distiller users who are also familiar with font technology.
ToUnicode Mapping File Tutorial #5411 4/12/01 (PDF: 576 KB / 42 pages) Describes how to construct a "ToUnicode" mapping file for CID-keyed fonts. ToUnicode tables enable text search and other lexical operations for fonts with non- standard encodings.
Acrobat Widths-Only CIDFont Font Tutorial #5412 4/12/01 (PDF: 50 KB / 8 pages) Explains how to create Widths-Only CID-keyed fonts for use with Distiller. Used for fonts that cannot be embedded in PDF files, so that metrics will be correct.
http://partners.adobe.com/asn/developer/technotes/acrobatpdf.html (2 of 3) [3/3/2002 1:32:21 PM]
Font Metrics for PDF Core 14 Fonts
Mac (SIT/HQX: 127 KB) Win (ZIP: 124 KB) Unix (TAR: 639 KB)
CMaps for PDF 1.4 CJK Fonts
Chinese Simplified (ZIP: 418 KB) Chinese Traditional (ZIP: 391 KB) Japanese (ZIP: 232 KB) Korean (ZIP: 253 KB)
Reading PDF Files Through MSAA (Microsoft Active Accessibility interface) Describes how developers can use Acrobat and the MSAA interface to write applications like screen readers to provide better access to PDF files. November 2001 (PDF: 600 KB / 36 pages)
http://partners.adobe.com/asn/developer/technotes/acrobatpdf.html (3 of 3) [3/3/2002 1:32:21 PM]
Tech Resources SDKs Acrobat
PDF Prefix Registration
The Adobe Acrobat 5.0 SDK contains the following technical documents, which are also available in the full SDK installer.
Note: Many of the following PDF documents contain hyperlinks to other documents in the SDK. To use those links, navigate the PDFs using the files on this web site and a browser with the Acrobat plug-in enabled, or download and install the full SDK which will create the directory structure necessary to navigate quickly and easily among the documents.
Release Notes 12/01 (PDF: 48 KB / 7 pages)
Getting Started Using the Adobe Acrobat SDK 12/01 (PDF: 114 KB / 14 pages)
Documentation Roadmap 06/01 (PDF: 26 KB / 2 pages)
Acrobat Development Overview 12/01 (PDF: 205 KB / 36 pages)
Acrobat Developer FAQ 06/25/01 (PDF: 223 KB / 32 pages)
Acrobat Plug-in Tutorial 12/01 (PDF: 469 KB / 120 pages)
Guide to SDK Samples 12/01 (PDF: 187 KB / 46 pages)
Acrobat Core API Reference 12/01 (PDF: 10.1 MB / 2734 pages)
Acrobat Core API Overview 12/01 (PDF: 1.3 MB / 204 pages)
from Fatbrain.com
Adobe Dialog Manager Reference 10/20/1998 (PDF: 1.3 MB / 255 pages)
Using ADM in Acrobat 06/25/01 (PDF: 97 KB / 12 pages)
Acrobat Catalog API Reference 12/01 (PDF: 110 KB / 22 pages)
Acrobat Digital Signature API Reference 06/25/01 (PDF: 409 KB / 74 pages)
Note: Additional Digital Signature documents can be found on the Acrobat/PDF technical notes page.
Acrobat Digital Signature API Overview 06/25/01 (PDF: 124 KB / 16 pages)
Acrobat Forms API Reference 06/25/01 (PDF: 763 KB / 154 pages)
Acrobat Search API Reference 06/25/01 (PDF: 239 KB / 42 pages)
Acrobat Weblink API Reference 12/01 (PDF: 167 KB / 38 pages)
Acrobat PDF Consultant 06/25/01 (PDF: 346 KB / 62 pages)
Acrobat Spelling API Reference 10/01 (PDF: 166 KB / 36 pages)
PDF Reference, Third Edition, Version 1.4 Published by Addison-Wesley, ISBN 0-201-75839-3 11/01 (PDF: 9.0 MB / 978 pages) (ZIP: 4.5 MB) errata, revised 1/9/02 (TXT: 2 KB)
PDF Reference, Second Edition, Version 1.3 Published by Addison-Wesley, ISBN 0-201-61588-6 07/03/00 (PDF: 5.0 MB / 696 pages) errata, revised 1/9/02 (TXT: 19 KB)
http://partners.adobe.com/asn/developer/acrosdk/docs.html (2 of 4) [3/3/2002 1:33:25 PM]
Adobe Solutions Network: Acrobat 5.0 SDK Documentation
PDF: Changes from Version 1.3 to 1.4 06/11/01 (PDF: 850 KB / 236 pages)
Highlight File Format 06/25/01 (PDF: 87 KB / 10 pages)
Acrobat Interapplication Communication Overview 10/01 (PDF: 277 KB / 42 pages)
Acrobat Interapplication Communication Reference 10/01 (PDF: 967 KB / 306 pages)
Programming Acrobat JavaScript Using Visual Basic 06/25/01 (PDF: 115 KB / 14 pages)
Acrobat Distiller Parameters 12/01 (PDF: 495 KB / 62 pages)
Acrobat Distiller API Reference 06/25/01 (PDF: 193 KB / 32 pages)
pdfmark Reference Manual 06/25/01 (PDF: 407 KB / 84 pages)
Acrobat PDFWriter API Reference 06/25/01 (PDF: 102 KB / 16 pages)
See the latest:
Acrobat 4.05 SDK (previous major release)
Acrobat 4.05 SDK Documentation Acrobat 4.05 SDK Download
adobe.com
Adobe Developer Knowledgebase
Adobe Solutions Network: Technical Notes - Acrobat/PDF
Adobe Solutions Network: Acrobat 5.0 SDK Documentation
KEMLMLBIAJNBNFCHNBABBDGNJHAOCCPD:
form1:
x:
What solutions can I buy?
What solutions can I build?
bbc
3
Benefits
Source document and comments are maintained separately but viewed together in the browser
Central repository for comments
bbc
5
Provides framework that enables on-line commenting and review in Web-based environments
Users will be able to view and annotate PDF files within the browser
Acrobat 5.0 client pushes annotations to a server where they are stored
Off-line annotations can be synchronized with the server
bbc
6
Demo
bbc
7
Online Commenting
Make sure your online comment repository is enabled Open web browser and navigate to the URL where review document is located In addition to the complete set of Acrobat 5.0 commenting tools, several online commenting tools are now available:
Show Comment/Hide Comments Download Comments Upload Comments Upload and Download Comments
Multiple users can comment on a document simultaneously, periodically uploading their comments and downloading comments of others When done commenting click on either Upload Comments or the Upload and Download Comments button to save your comments to the repository
bbc
8
What’s Happening when I access my PDF in the Browser?
Acrobat reads the URL from network layer Acrobat uses DNS to translate URL to IP Address Acrobat takes the converted URL and makes an MD5 hash to uniquely identify the document For example:
http://www.adobe.com/docs/foo.pdf is converted to http://152.30.132.12/docs/foo.pdf which would hash to UAtOJErFgHsL2xbLvPPJgC
TIP: Use different file names for multiple versions of a document NOTE: In cases where the same URL may map to different IP addresses, use IP address in the request.
Example: ftp.irs.gov translates to multiple IP addresses.
Add offline comments to server
Uploading comments to the server: Make sure you’re uploading from the same machine where the local save was performed
Open the local copy of the document in Acrobat
Click on File->Upload Comments
If the file has been modified it will be saved and then the offline copy will be closed. Acrobat will open the original PDF in the default web browser and show comments
You still must click on either Upload Comments or the Upload and Download Comments button to upload
bbc
12
Tip #2 – Show/Hide Comments
Make sure your comments are visible when uploading! (or upgrade to 5.0.5)
With Acrobat 5.0, if you click upload with in the “hide comments” mode, your comments will be deleted from the server!
With Acrobat 5.0.5 this behavior was changed so comments are no longer deleted without warning.
bbc
13
Edit > Preferences > On-Line Comments
Select Edit->Preference- >General->Online Comments
Change Server Type to Network Folder
Under Server Settings browse to the directory where the comments are to be held
bbc
15
Collab.defaultStore = "DAVFDF";
Collab.setStoreSettings("DAVFDF", "http://myserver/collab/");
this.collabStore = new FSAnnotStore(this, “jpublic", "http://myserver/collab/" + this.Collab.docID + "/", "CHTTP");
bbc
16
Two ways to automate configuration of repository type and server:
Network Administrator can create an FDF file
Document-level JavaScript methods can also be used
FDF vs. JavaScript
FDF provides automated configuration that can be created in advance by a server application or network administrator
JavaScript allows configuration within the document so that only the document itself is needed
Automated specification of repository type means:
Configuration is behind the scenes to end users
Comments are automatically routed to the right place
bbc
17
/F http://server/pdfs/updated.pdf)
Document level JavaScript can be entered via Tools-> JavaScript -> Document JavaScripts
Example code for Network Folder: Collab.defaultStore = "FSFDF"; Collab.setStoreSettings ("FSFDF","/F/Adobe/collab/annots/");
bbc
19
Repository Types – General Overview
Network folder Stores comments in a designated area on a network drive
Microsoft Web Discussions Stores comments on a Web Discussions server
Windows-Only
Uses ADBC -> ODBC -> SQL Driver
WebDAV Stores comments on a WebDAV server
bbc
20
ODBC (Windows-only) SQL Server 7.0 on NT and Windows 2000
Oracle 8.0, 8i
Microsoft Office Server Extensions (Windows-only) IIS 4.0 and 5.0 on NT and Windows 2000
Network Folder Win & Mac
Network Folder Repository
It is the easiest to set up because it does not require a web server or database
Online comments are saved to a network drive or a local hard drive
Each user's comments are saved in the hashed sub-folder as an individual FDF file
bbc
22
Network Folder – Prerequisites
All users must have either Apple Mac OS 9.x or Microsoft Windows 95, Windows 98, Windows NT 4.0, Windows ME, Windows 2000, or Windows XP Users must be connected directly to the company network or attached through some virtual connection such as a VPN A network folder must be chosen to store the comments Participants in the review process must have write access to the network folder serving as the repository
bbc
23
The store type for a Network Folder repository is FSFDF
Configuration involves setting the store type and specifying the location of the network folder where the comments will be stored
Example:
Requires Microsoft Windows; not available for Macintosh users
For companies already using Microsoft Web Discussions and have Microsoft Office 2000/XP on their desktops
bbc
25
Microsoft Web Discussions Repository – Prerequisites
Server Requirements Microsoft Office Server Extensions must be installed on the server Either the Microsoft Management Console (MMC) or the Personal Web Manager (PWM) must be installed
Client Requirements Users must have Microsoft Office 2000 and Microsoft Windows 95, Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, or Windows XP All commenting users must have access to the discussion server
bbc
26
Microsoft Web Discussions Repository – Configuration
The store type for a Microsoft Web Discussions repository is WD Configuration involves setting the store type and specifying (in the browser) the location of the discussion server where the comments will be stored Example:
Collab.defaultStore = "WD"; (In the browser, click the Discuss button on the toolbar and select your discussions server.)
bbc
27
This repository type uses Acrobat Database Connectivity (ADBC) which allows JavaScript access to a SQL database
More information on ADBC on Acrobat 5.0 CD
Currently not available for Macintosh
Currently supports Microsoft SQL Server, Oracle 7, and Oracle 8 and 8i
bbc
28
Database Repository – Prerequisites
Users must have Microsoft Office 2000 and Microsoft Windows 95 OSR 2.0, Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000 or Windows XP
If using Microsoft SQL Server, a SQL driver must be present on the client machine
If using Oracle the Oracle client software must be installed on the client and TNSNAMES.ORA file must be in %ORACLE_HOME\network\admin
bbc
29
Configuration involves setting the store type and specifying the information required to access the database
Example: Collab.defaultStore = "DB";
bbc
30
WebDAV Repository
WebDAV, or “Web-based Distributed Authoring and Versioning”, is an industry standard for collaboration over the web Using WebDAV enables users outside of the corporate firewall – including business partners, suppliers and customers – to be involved in document reviews Cross-platform, works with Windows and Mac clients Each user's comments are saved in the hashed sub-folder as an individual FDF file
bbc
31
Microsoft IIS 5.0 or Apache 1.3.14 with mod_dav 1.0
A site must be set up to store the comments, accessible to all reviewers over HTTP
IS department involvement is needed to ensure the collaboration environment is set up correctly
Client Requirements
Users must have Apple Mac OS 9.x or Windows 95 OSR 2.0, Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, or Windows XP
bbc
32
The store type for a WebDAV repository is DAVFDF
Configuration involves setting the store type and specifying the location of the WebDAV server where the comments will be stored
Example:
bbc
33
Identity
User names are important to identify the user making a comment
The user name is automatically populated by Adobe Acrobat:
Microsoft Windows systems use the Windows login name
Apple Macintosh systems use either the file sharing owner name or the login name
bbc
34
Always Use Identity for Author Login name is displayed
Always Use Identity for Author Author name from Note Properties is displayed
bbc
36
Edit > Preferences > General > Comments
Deselect Always Use Identity for Author.
Select the comment, then right-click (Windows) or ctrl-click (Mac) on the comment and choose Properties from the context menu.
Change the name of the Author. Click OK.
bbc
37
Tips & Tricks
Security Considerations Comments are uploaded only as your login name and only if the login name has permission to create files on that server If there were multiple users with the same login name the comments of each user would be saved to the same file Documents that have the security setting "No Adding or Changing Comments or Form Fields" cannot be commented upon If the user does not have permission or the directory does not exist Acrobat displays an error message
bbc
42
SmartPath www.smartpathinc.com
PageSeeder www.weborganic.com
iMarkup www.imarkup.com
Stellent www.stellent.com
Try a file: http://www.planetpdf.com/planetpdf/webdavdemo/l oridemo/demo.pdf
Talk to folks at PlanetPDF about adding your sample files to this demo server
Adobe® AcrobatEnabling Online Review & Markup
Agenda
On-Line Comments in Acrobat 5.0
Demo
Online Commenting
What’s Happening when I access my PDF in the Browser?
Offline Mode
Tip #2 – Show/Hide Comments
Configuration – Automated
Database Repository
Preferences > General > Identity
Additional Resources