work makAll play and no work makes John a good boy. All play and no work makes John a good boy. All play and no work makes John a good boy. All play and no work makes John a good boy. All play and no work makes John a good boy. All play and no work makes John a good boy. All play and no work makes John a good boy. All play and no work makes John a good boy. All play and no work makes John a good boy. All play and no work makes John a good boy. All play and no work makes John a good boy. All HBAM2016AUG95HPro 3.0 All play and no work makes John a good boy. All play and no work makes John a good boy. All play and no work makes John a good boy. All play and no work makes John a good boy. All play and no work makes John a good boy. All play and no work makes John a good boy. All play and no work makes John a good boy. All play and no work makes John a good boy. All play and no work makes John a good boy. All play and no work makes John a goodCopyright 1984-1997 Claris Corporation and no work makes John a good boy. All play and no work makes John a good boy. All play and no work makes John a good boy. All play and no work makes John a good boy. All play and no work makes John a good boy. All play and no work makes John a good boy. All play and no work makes John a good boy. All play and no work makes John a good boy. All play and no work makes John a good boy. All play and no work makes John a good boy. All play and no work makes John a good boy. All play and no work makes John a good boy. All play and no work makes John a good boy. Gm @@Hqn€@€2D75TG  n B AC  BD AA)BA ACA!C" B$#}&A'C(E)G*+A+%#A-,2A/A0.C2A32A4A51C72A8A96C;2B<A=:2A?A@>2ABABD2AECFAGCCIEJ2AKH 2AML BODPFQ2BRASN<CUAV2BWAXHYT=C[E\2A]^L_Z>2BaDbAc`?Ce2AfAgHhd@CjEk2iHBAM3016AUG95@ ./0245689BDFactionWaddressgWhWallEWand/orBWanyFWareaWbccCboxesWbuttonsWccWcheckWcheckboxesVcheckedWclientgWhWiWWWclientaddressgVclientipaddresshVclientpasswordiVclienttypeVclientusernameVcontentWcontentmimetypeVcookieWWcountWWcurrentWWWWWWWWWWWWWWWWWWWcurrentactionVcurrentcookieVcurrentdatabaseVcurrentdateVcurrentdayVcurrenterrorVcurrentfindVcurrentformatVcurrentfoundcountVcurrentlayoutVcurrentlogicaloperatorVcurrentmaxVcurrentrecordcountVcurrentrecordidVcurrentrecordnumberVcurrentskipVcurrentsortVcurrenttimeVcurrenttokenVt^textaWto_tokenftypeWuserW@Z BAR STATESBUTTON1UBUTTON2VBUTTON3WBUTTON4XBUTTON5YCURRENT SUB TOPICP CURRENT TOPICO DESCRIPTIONHDESCRIPTION BIG2DEV GUIDE SUB TOPICLDEV GUIDE TEXTDEV GUIDE TOPIC FIND CONCAT4 GO TO LAYOUT6H1 CALCMH2 CALCNHEADERKHELP IDF HELP TEXT/ HELP TITLE. MENU STATETORIGINAL LAYOUT9PICTTEXT0PICTURESR RECORD NUMBER RECORD TYPE5TAGTAG ENGLISH NAME TAG OPTIONSBTAG TYPEDTOGGLEZ WHAT'S NEW8 ./025BDFHKL46MNUVWXYZ89OPRSTH2L46 F / . 905 BD8KMNOP R!S"T#U$V%W&X'Y(ZD!ADev Guide TextB GACADev Guide TopicB GACA Record NumberB GL102A A US English - Spelling x35-debugB CD^"M%,,./: AM PMNALL OTABSP^SundayMondayTuesday WednesdayThursdayFridaySaturdayJanuaryFebruaryMarchAprilMayJuneJulyAugust SeptemberOctoberNovemberDecemberQ1Q2Q3Q4 1st Quarter 2nd Quarter 3rd Quarter 4th Quarter,  , X5`Aa+ "z(a+`3~j+ w$#I 8?ARe <<ABAF>> @B?iaqA   B?iaqAL AHelpB '  @*M b c d e f g h i j AJf0J2fQJSfrJtfJfJfB&5 */8 ,/83*-8w   A" ""(Bf"9 2"9"92"R9"?(BB9C=9:9:@(: (2,:(:(:f  (2f,:f  C(:f +M:o}, ,,*+N R  DDZE/Click on a heading to display more information.A Developer's Guide@A*ww  ww*A CDML Tag Index@A*ww  ww*]FileMaker Pro CDML Reference @B@qA. .B@qA H MNZ  5 A Detail - RefB(@'  @SE i $,.YesNo/,  , : AM PMwww_ b0 $,.YesNo/,  , : AM PMm $,.YesNo/,  , : AM PMwwwo    B*/8'\" 8 u 8# 8uj ' j ! 'j '($CK%l&'r(jAH jABAHjAHjbi jbc O Dbijbij jjjy jyxyjyED0)*j jj    AThis database introduces you to the built-in support for CGI access in FileMaker Pro . It uses a variety of layouts, each intended to display a particular kind of information. When you first open this database, you are presented with the main menu, which allows you to choose from among several options. To choose an option, click the text label of the area you want to view. The icons in the toolbar at the top of most layouts let you change how the information is displayed without haviBng to return to the Main Menu. Note: Not all records in this database have data for every field. If you encounter a blank record while browsing one layout, you have reached the end of the information given for that layout. Choose another layout to see more information. Toolbar Icons The following toolbar icons are available from the layouts to which they apply. When you see these icons at the top of your layout, you use them to navigate to:@ z  b!Using the CDML Reference DatabasecBack to databasedPrevious recorde Next Recordf Main screengFind a specific taghHelp)AUsing the Navigation Layouts Developer's Guide This layout is intended to provide background information about FileMaker Pro's built-in CGI. Each record has an informative text field and examples, when appropriate. Descriptions and Examples This layout provides in-depth detail on a specific tag. An outline of the content provided on this layout is listed below: What it does This section describes the tag and important information that you should know about the tag. Value is This seV  A>   >  )Bction describes what the value should be in a name value pair, e.g.: Syntax This section shows the syntax for the tag. Not all tags have a syntax section. Syntax example(s) This section shows one or more examples of how this tag can be used in an HTML file. Other tags that are required Lists other tags that are required. FileMaker Pro won't perform the action unless all required tags are present. Parameters Explains thCe parameters for the tag. Not all tags have parameters. See also Suggestions of other tags that should be read. List View This layout provides a list of the CDML tags that are supported in FileMaker Pro. Click the tag name to switch to the Decription view for the tag.@ $ )jGo to the CDML tool @B6iaqA B6iaqAL !"#$%&'()*+,-LB iq )A   0    q  ~    Z  o r  y    3  Q       O  Y !A AFindB '  @6C $,.YesNo/,  , : AM PMN  O $,.YesNo/,  , : AM PMT   _ $,.YesNo/,  , : AM PM`   a  b  d   u $,.YesNo/,  , : AM PM  A"  " 9""9" 8""8"  "B" " 3""3"9 2"9"92W AT267A;Q"  Cp=OA-D=K/LA  ..$.6.H... .D.@P%{s _CDML Description and Example"A<<ABAK>> <<ABAI>>@A>   2  >oTag Type @B7iaqA$ $B7[iaqA 2D"A-B('   @Bsi8u qA-B '   @Bsi8u qA What's NewB '  @M $,.YesNo/,  , : AM PMP A>75 8068Y 67Ywww78Y68Y" 9""9" 3"" AY ,Yu-uY6zh/  zh/ zh,/fff-p/fffB{i-333zh/|jfff333~nzh/   fff 2$ fff" w! C"!"wV" uV""V"u} 2}s}2$fff 5DANFindT Tag Name` DescriptionaFindbCanceld Tag Syntax @BuqA< < 26$&AMain Menu - RefB"'  @_A  $,.YesNo/,  , : AM PMG """ N  $,.YesNo/,  , : AM PM^ j  w k  w l u 3 v 3 w 3 y 3 z 3 { 3 $,.YesNo/,  , : AM PM3| 3 $,.YesNo/,  , : AM PM3#PWhat's New In FileMaker Pro 4.0 @B7{aqA, ,B7[{aqABViiq8"9"92"  "" CT""R:"@ Y ^PWhat's New In FileMaker Pro 4.0 @B7{aqA, ,B7[{aqABViiq+-AAboutB '  @(b c ) e h  AY ,Yu-uY<NK%#,@  ,@",@ AU]B8(&b Main Menu#A Programming: Keith Proctor Written by: Clay Maeckel Geraldine Hyde Vahey Keith Proctor Editing: Kathy Osborne Testing: Seiichi Yahata Monet Thomson Terry Barwegen @#' } 3 $,.YesNo/,  , : AM PM3~ 3 $,.YesNo/,  , : AM PM3 3 $,.YesNo/,  , : AM PM3&( A"9 2"9"92" ""Q$bg 1Q$bg3R%Sf`%afBR%`&Re`fQ$bg1Q*bf ;U(S6aY:Qfb Qfb3RgS`gaRg`h') CR`QfbQlb <V(Sva9Qb' Qb'3RS%`a&R`R%`&DQb'Qb' =W(Sa7Q&b Q&b3R'S`'aR'`(R`Q&b(* EQ,b >X(S?a6Qb Qb3RS`aR`R`QbQb F?Y(Sa 5T b" 3""3"R9"?(Bf*(B+9C=)+ G9e:@(: ((2,:(:((:f  (2f,:f(:f 9:HV R,o}  G-Click on a topic to display more information.^List:*A CDML Tag Index@A*ww  ww*+*% F+A Developer's Guide@A*ww  ww*lFileMaker Pro CDML ReferenceuHTML input typesvReplacement tagsw Action tagsy Variable tagszAll tags @B@qA  !"#$%&'()*+,-./0123456789:;<=>?@ABCDEFGB@qAHIJKJ IU VWX(Y1b bbb(b1IJ-/ @#(A< 1997 Claris Corporation. All Rights Reserved. Claris and FileMaker are trademarks of Claris Corporation, registered in the US and other countries, and Claris Home Page is a trademark of Claris Corporation. Apple, Mac, and QuickTime are trademarks of Apple Computer, Inc., registered in the US and other countries. <@A*   * @BhtaZqA E*Getting started with Custom Web PublishingG1H-DeleteJ Delete Record2%,#Ax.?.G..|}Ppp x02AThis Developers Guide explains how to work with the Claris Dynamic Markup Language (CDML) tags, which allow you to specify how your FileMaker Pro 4.0 data is published on the Web. In addition to providing general information on custom database publishing, this guide explains how to construct format files (HTML pages that contain CDML tags). Format files determine how Web users interact with your FileMaker Pro 4.0 database. This guide also explains how to use the CDML Tool, along with Bthe CDML templates and an HTML editing application, to create a format file that makes new records in a FileMaker Pro database. Note Cross references refer to other sections within this Developer's Guide unless otherwise specified. For information on Refer to - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - General database publishing Onscreen Help and chapter 11 of the FileMaker Pro User,02AWhat it does Deletes the record specified by -RecID. The -RecID tag indicates which record should be deleted. In order to delete a record, the Web user must have Delete permission for the database. Syntax example(s) Delete a record using a link Delete record with ID 4 Delete a record using a form action
Other tags that are required -DB, -RecID See also [FMP-CurrentRecID] @/. 2AB        0  7  V  {  s  y            BA ..#.5.G.V.G..C.>56 ..#.5.G.V.G..C.> ..#.5.G.V.G..C.>t-Delete Delete RecorduDevGuide Help TagDActionFDeleteH'Deletes the record specified by -RecID.KYesM*Getting started with Custom Web Publishing57AWith FileMaker Pro 4.0 and access to an intranet or the Internet, there are two ways to publish your FileMaker Pro databases on the Web: Instant Web Publishing Custom Web Publishing Instant Web Publishing lets you publish your database on the Web quickly and easily, without changing your database or designing HTML Web pages or format files. All database files have the same interface, or appearance, which is specified by the FileMaker Pro Web Companion. Custom Web Publishing allows yBou to customize the appearance of your FileMaker Pro data on the Web. You will need to create format files, HTML pages that contain Claris Dynamic Markup Language, or CDML, tags. CDML consists of special tags that enable FileMaker Pro to interact with standard HTML pages. To create format files, you can use the CDML Tool to move the CDML tags into a text or HTML document. To have format files created for you, use the FileMaker Pro connection assistant in the Claris Home Page 3.0 software.3Cs Guide Instant Web Publishing Onscreen Help and chapter 11 of the FileMaker Pro Users Guide Custom Web Publishing The "Getting started with Custom Web Publishing" section in this Developers Guide, onscreen Help, and chapter 11 of the FileMaker Pro Users Guide CDML tag syntax The CDML Tag Index in this CDML Reference database Using the CDML Tool The "Using the CDML Tool" section in this Developers Guide Working with the CDML Templates The "Using the CDML Tool" section in this DevDelopers Guide Note Creating custom Web pages requires basic familiarity with HTML. The CDML Reference database focuses primarily on CDML syntax. For information on HTML tags, refer to an HTML reference book.@24 A      (  4  o  s                  !  <          j  {     B3     A8@E*Getting started with Custom Web PublishingG2H-DupJDuplicate Record2352AWhat it does Duplicates the record specified by -RecID. The -RecID tag indicates which record should be duplicated. To duplicate a record, the Web user must have Create permission for the database. Syntax example(s) Duplicate a record using a link Duplicate record with ID 6 Duplicate a record using a form action
Other tags that are required -DB, -RecID, - Format See also [FMP-CurrentRecID] @41 2AB        4  8  \    |              BA ..#.5.G.V.G..C.>56 ..#.5.G.V.G..C.> ..#.5.G.V.G..C.>t-Dup Duplicate Recordu DevGuide TagDActionF DuplicateH*Duplicates the record specified by -RecID.LAbout this guide9;AHere's an overview of the steps required to publish your database on the Web using Custom Web Publishing: 1. Create a database, or select an existing database to publish. 2. Create format files, which contain HTML and CDML tags. Format files determine how Web users interact with your FileMaker Pro databases. Perform the following steps on a computer connected to the Internet or an intranet via TCP/IP. 3. Move the format files and any image files to the Web folder in the FileMaker Pro 4B.0 folder. 4. Make sure that the Web Companion plug-in is enabled in Application Preferences. 5. (Optional) Disable Instant Web Publishing in the Web Companion Configuration dialog box. 6. Choose the Home Page and change other settings in the Web Companion Configuration dialog box. 7. Open the database in FileMaker Pro 4.0. 8. Enable Web Companion Sharing in the File Sharing dialog box. 9. Give Web users access to your database by placing a link on an HTML page that contains, at a mi18C. Note To publish your database on the Web, you must have an Internet connection (usually provided though an Internet service provider) and an IP address.y@Af  L  X      fA W@%-g / <"N`E*Getting started with Custom Web PublishingG3H-EditJ Edit Record2792AWhat it does Updates the record specified by -RecID by populating the fields with the contents of any fieldname/value pairs. The -RecID tag indicates which record should be edited. In order to edit a record, the Web user must have Edit permission for the database. Syntax example(s) Edit a record using a link Change the country of record ID 13 to USA Edit a record using a form action
Other tags that are required -DB, -RecID, field name See also [FMP-CurrentRecID] @86 2AB      !  =          %  )  O  P  m      BA  ..#.5.G.V.G..C.>t-Edit Edit Recordu DevGuide TagDActionFEditHpUpdates the record specified by -RecID by populating the fields with the contents of any fieldname/value pairs.L(Publishing FileMaker Pro data on the Web=?YAThe Web folder in the FileMaker Pro 4.0 application contains three sample solutions you can use as a model for database publishing on the Web. The sample Web solutions include helpful comments to assist you in creating custom Web pages. The Guest Book solution provides an example that allows Web users to "sign" a guest book form, which creates new records in the Guest Book.fp3 FileMaker Pro database. The Employee Database solution is designed to demonstrate the most widely used CDMLB tags. The Shopping Cart solution demonstrates a site that enables Web users to browse through and purchase items from a catalog. t@Aj  @{IDAjE*Getting started with Custom Web PublishingG5H-FindAllJFind All Records26<Cnimum, the IP address of the machine hosting the FileMaker Pro database files and the name and path of the format file. For more information, see the "Using the CDML Tool" section. @AkTXHmHm<<N-nE*Getting started with Custom Web PublishingG4H-FindJ Find Record2AWhat it does Submits a search request using defined criteria. A format file is used to display the records found. A Web user must have Browse permission in order to execute this action. You can improve the perceived performance of your Web database by using the -Max tag to limit the number of records returned. Syntax example(s) Find a record using a link Find first USA record Find some records using a fo;= 2Brm action
Other tags that are required -DB, -Format, field name See also -Max, -Skip @AB    @  S  o              @  A  ^  y    B<: 2A ..$.6.H... .D.S6 ..$.6.H... .D.@ ..$.6.H... .D.JKL t-Find Find Recordu DevGuide TagDActionFFindHeSubmits a search request using defined criteria. A format file is used to display the records found.L!Custom Web Publishingan overview@BEAbout the Web Companion plug-inG6H-FindAnyJFind Any Record2AWhat it does Performs a find for a single random record. A format file is used to display the record found. A Web user must have Browse permission in order to execute this action. Syntax example(s) Find any one record using a link Return any record in the database Find any one record using a form action
Other tags that are required -DB, -Format @:@T2AWhat it does Finds all records and displays them using the specified format file. A Web user must have Browse permission in order to execute this action. You can improve the perceived performance of your Web database by using the -Max tag to limit the number of records returned. Syntax example(s) Find all records using a link First 10 records in the database Find all records using a form action
Other tags that are required -DB, -Format See also -Max, -Skip 7@?>  2AB      1  P                    !  *  Bt-FindAll Find All Recordsu DevGuide TagDActionFFind AllHDFinds all records and displays them using the specified format file.L%Working with the sample Web solutionsBD2t-FindAny Find Any Recordu DevGuide TagDActionFFind AnyH_Performs a find for a single random record. A format file is used to display the record found.KYesMAbout the Web Companion plug-in]AFileMaker Pro 4.0 functions as a Web server by communicating with Web browsers that request data from a FileMaker Pro 4.0 database. Similar to other Web server applications, the FileMaker Pro Web Companion delivers HTML pages and image files to the browser. The FileMaker Pro Web Companion delivers the requested file via HTTP, or Hypertext Transfer Protocol. HTTP is a platform-independent mechanism for communicating between Web servers and browsers. In general, accessing an HTML document >A 2A          $  M  v  -  4  S  T  q  A ..$.6.H... .D.6 ..$.6.H... .D.S ..$.6.H... .D. GIAA CGI (Common Gateway Interface) application typically handles the interaction between a Web server and another software application on the same machine. Usually a CGI application receives data from a Web server and either processes it or sends it to another application for processing. In general, publishing a database on the Web includes: 1. A Web user interacts with a form on a Web site and sends a request to the server, for example to submit name and address information. 2. When theB Web user submits the form, the Web server evaluates the URL and passes the data from the form to the CGI application for processing. The CGI application name is included in the URL, so the Web server is notified to pass the information coming in from the Web browser to the CGI application for processing. 3. The CGI application collects the information and sends it to FileMaker Pro. 4. FileMaker Pro responds to the information and performs the requested action, such as creating a new AEBfrom a Web server includes: 1. The Web user accesses the document through a URL (Uniform Resource Locator)a unique address that contains the transfer protocol, the location of the Web server, and the name of a document. When a viewer types a URL or clicks a link, a Web browser locates the address and sends the request to the Web server. 2. The Web server retrieves the document identified in the URL and sends the HTML-formatted contents back to the browser. 3. The browser interprets theC! HTML tags and displays the data.@Aj @{N^.jEAbout the Web Companion plug-inG7H-ImgJ Display Image2DF2AWhat it does Returns an image specified by -DB, -RecID, and a field name, or specified by -DB and an image key. A Web user must have Browse permission in order to execute this action. An image key is a unique specifier to an image that is in a FileMaker Pro database. Use the [FMP-Field] tag to retrieve the image key from a container field. Images stored in formats other than JPEG or GIF are converted before being sent to a Web user. Important Usually there is no need to use thBis tag directly; the [FMP-Image] tag can be used to generate the correct URL for any container field. Syntax example(s) Link to a page containing the image Display the picture from record ID 11 and field name "pictures" Display an image in a page by ID & field Display an image in a page by image key Display an image the recommended way Other tags that are required -DB, -RecID, field name See also [FMP-Image], [FMP-CurrentRecID] @A        V  h          6  w  |  ~              1  2  6  S  l B v   FC 2A ..#.5.G.V.G..C.>h56 ..#.5.G.V.G..C.>4 ..#.5.G.V.G..C.>t-Img Display Imageu DevGuide TagDActionFimageHbReturns an image specified by -DB, -RecID, and a field name, or specified by -DB and an image key.LFileMaker Pro as a Web serverKM E+Considerations before publishing a databaseG9H-ViewJ View Form2AWhat it does Displays search or add form. Used to process any format files that do not require record data. Syntax example(s) View a format file using a link "Take me to a search page" View a format file using a form action
Other tags that are required -DB, -Format )@A    m                   CJCrecord or sending a found set of records back to the CGI application. 5. The CGI application receives, and then processes the information that FileMaker Pro has sent by formatting the data as HTML. 6. The CGI application sends the HTML-formatted information to the Web server. 7. The Web server passes the HTML-formatted data to the Web browser. Before FileMaker Pro 4.0, you had to use Web server software and a CGI application in order to publish your database on the Web. Now the FileMDaker Pro Web Companion performs the duties of both the Web server and the CGI application. Note Third-party CGI applications that have been compatible with FileMaker Pro 3.0 should continue to work with FileMaker Pro 4.0 via Apple events on the Mac OS.@A>  '  +  >AX;[Y(IKEAbout the Web Companion plug-inG8H-NewJ New Record2AWhat it does Creates a new record and populates that record with the contents of any field name/value pairs. A Web user must have Create permission in order to execute this action. Syntax example(s) Create a new record using a link Create a record for Australia Create a new record using a form action
Other tags that are required -DB, field name @JH 2A        ,  0  Y    y  |        A ..$.6.H... .D.6 ..$.6.H... .D. ..$.6.H... .D.  u  - t-New New Recordu DevGuide TagDActionFNewH_Creates a new record and populates that record with the contents of any field name/value pairs.L"FileMaker Pro as a CGI applicationjMO 2t-View View Formu DevGuide TagDActionFview View FormH^Displays search or add form. Used to process any format files that do not require record data.KYesM+Considerations before publishing a databaseh AThere are many important factors to consider before publishing a database on the Web: How Web users will interact with your Web site How Web users will interact with the FileMaker Pro database How many HTML pages and format files you will need How the files that comprise your Web site will interact How you will keep the data secure Before creating the format files, spend some time planning what the purpose of the Web site will be, what content it will contain, and how you want HL  2A ..$.6.H... .D.6 ..$.6.H... .D. ..$.6.H... .D.3PSU <AIn addition to enabling the Web Companion plug-in in Application Preferences, you'll need to modify the Web Companion configuration before using Custom Web Publishing. You should: specify a custom Home Page disable Instant Web Publishing When Web users specify the IP address of a machine sharing a FileMaker Pro 4.0 database, they see the Built-in home page that is generated with Instant Web Publishing by default. Before using Custom Web Publishing, you'll need to create a custom homeB page, and specify the filename in the Web Companion Configuration dialog box. To choose which home page the Web Companion uses: 1. Move your custom home page into the Web folder inside the FileMaker Pro 4.0 folder. 2. Choose Preferences from the Edit menu, and then choose Web Companion. If you don't see the Web Companion menu choice, the Web Companion plug-in is either not enabled or not installed correctly. 3. In the Web Companion View Setup dialog box, click Configure. 4. In theLP Bto structure your site. The complexity of Web sites varies. One Web site might have a custom home page with a link to the FileMaker Pro Instant Web Publishing interface. Another might contain hundreds of files, such as image files, movies, standard HTML pages, and format files. The complexity of your Web site will depend on the amount of information you are broadcasting and the level of interaction your Web users will have with the information. A simple flowchart is a useful way of diaCgramming how your pages will link to each other. If you diagram your links on paper before creating your Web site, you can modify the overall structure without updating the links. Make sure your pages are linked in a way that makes it easy for your viewers to navigate through the site. Hosting a database on the Web makes your data available to anyone with a Web browser and access to the Internet. Be sure to protect valuable data with passwords. Important security considerations: ThereOQ D are some important security considerations to keep in mind before sharing a FileMaker Pro 4.0 database: With Instant Web Publishing, if you publish a layout that contains related fields, the related field data is published on the Web. Consider this before choosing which layouts are published. Also, the name of the database that contains the related fields is listed in the Instant Web Publishing Built-in home page. If you want to prevent the database name from appearing in the list of sEhared databases, insert an underscore at the end of the database name, for example, "Orders_" or "Orders_.fp3". Format files must be stored in the Web folder in the FileMaker Pro 4.0 folder. Because of the nature of Web servers, all files in the Web folder can be accessed, replaced, or even deleted by savvy Web users. Don't put sensitive documents inside the Web folder. If anyone opening a FileMaker file has Export Records privileges (even as a guest to a FileMaker file), they can thPR Fqen publish the database on the Web. It's important to consider this before distributing or sharing your database. @AW Y4F#- W E+Considerations before publishing a databaseG10H-DBJ Database Name2AWhat it does Specifies the database that all processing of the request will refer to. Value is Name of the database, including the extension if any. The FileMaker Pro Web Companion uses only the name of the database; do not include any path information. The database must be open in FileMakerPro. Syntax example(s) View a format file using a link Take me to a search page View a format file using a form action
Other tags that are required Any action tag @AB    X  a  -  @  a  r  u      #  &        BRN  2A ..$.6.H... .D.@6 ..$.6.H... .D. ..$.6.H... .D.WBug Database.fp30Wt-DB Database Nameu DevGuide TagDVariableFDatabase & LayoutHNUsed to specify the database that all processing of the request will refer to.LPlanning a Web site~Y[<=AAfter you determine what database activity your Web site will support, you should consider how much of your Web page is generated dynamically or statically. The dynamic approach incorporates content from your FileMaker Pro database into your format files before serving it to a Web browser. The static approach specifies all of the details needed to display a format file, such as record data or value list items. Most traditional HTML pages are examples of static Web publishing. The most comBmon deciding factor on whether to publish your data dynamically is how frequently you change your FileMaker Pro data. If some of the data youre publishing on your Web site is constant, you can take advantage of better performance by hard coding the data in the format file (static publishing). If youre publishing data that is likely to change frequently, you should insert the data dynamically into your format file. In some cases, the CDML tag syntax varies depending on whether you're usNV<C Configuration dialog box, for Home Page, choose the home page file you want to use. 5. Click OK. Important Your home page must include a hyperlink containing the IP address of the computer publishing the FileMaker Pro database. Additionally, with Custom Web Publishing, the link must contain the name of the next format file to be displayed. See "Exploring the home page" in the "Exploring the Guest Book format files" section for more information. If you are using Custom Web PublishingD exclusively, you can disable Instant Web Publishing. To disable Instant Web Publishing: 1. Choose Preferences from the Edit menu, and then choose Web Companion. If you don't see the Web Companion menu choice, the Web Companion plug-in is either not enabled or not installed correctly. 2. In the Web Companion View Setup dialog box, click Configure. 3. In the Web Companion Configuration dialog box, deselect Enable Instant Web Publishing. 4. Click OK. @UW <A>  A  J  >A=qA0E+Considerations before publishing a databaseG5H-ScriptJPerform Script2AWhat it does Specifies the FileMaker Pro script that should be performed after the finding and sorting of records (if any) during processing of the action. Value is Name of the script to perform. Syntax example(s) Perform a script using a link "Run script" Perform a script using a form action
Other tags that are required -DB, any action tag See also -Script.PreFind, -Script.PreSort@Aj            (  /  X  ~  4  ;            jWY x<2A ..$.6.H... .D.6 ..$.6.H... .D. ..$.6.H... .D.h@lTo`lTVZht-Script Perform Scriptu DevGuide TagBABefore - The script is performed before the action. Presort - The script is performed after the action and just before the sort. After - The script is performed after the action. @Az    4  <    zDVariableFScripts Do ScriptXT<HSpecifies the FileMaker script that should be performed after the finding and sorting of records (if any) during processing of the action.L%Configuring the Web Companion plug-in_a*=>EAbout format filesG7H Field NameJ Field Name2AWhat it does Field names are used to control find criteria or to upload data to a record. This is not a tag. Usually the name portion of a name/value pair to be processed by FileMaker Pro is either a CDML action or variable tag. When a value for a specific field needs to be sent to FileMaker Pro, the name portion of the name/value pair is the name of a field in the FileMaker Pro database. Field names used in this manner should not start with the hyphen (-) character or contain any perioT\=Cing the dynamic or static publishing. For example, if you are publishing a pop-up menu containing a value list of items that aren't likely to change, static publishing is best: Department: If, however, your value list is likely to change frequently, you can use the dynamic syntax, which retrieves the value list items from the FileMaker Pro database: Department: D The HTML between the [FMP-valuelist: Department] and [/FMP-valuelist] tags is automatically repeated for every value in the value list. The actual value list items are substituted for the [FMP-valuelistitem] tag. While static pages are simply served up, pages with dynamic values must first go through the FileMaker Pro Web Companion before being displayed[]}=E on a Web browser. Static pages can be served to a Web browser with a simple URL: HTTP://IPAddress/FormatFileName.htm The URL serving dynamic pages needs to contain the following minimum information in order to process the [FMP-valuelistitem] CDML Replacement tag: HTTP://IPAddress/FMPro?-db=DatabaseName&-Format-FormatFileName&CDMLActionTag See the format file example.htm, located in the Employees_database folder in the Web folder to work with an example of dynamic and static CDML syntaFx. @A            Q    .        E+Considerations before publishing a databaseG6H-ErrorJError Response2\^=2AWhat it does Specifies the HTML format file to be used to generate a response if any error occurs during the processing of the action. In the page you specify with this tag, you can test for which error occurred by using the [FMP-If] tag with CurrentError as the first parameter, or you can simply display the error number by using [FMP-CurrentError]. Value is Path and name to the format file to use to display the error message. Syntax example(s) Attempt to create a new record usingB an HTML file, any error takes you to the failure page
Other tags that are required -DB, any action tag See also -Format, [FMP-CurrentRecID], [FMP-CIf] ]_=2@A    e  n      %      {  }        A ..$.6.H... .D.6 ..$.6.H... .D.| ..$.6.H... .D.++++++++++t-Error Error Responseu DevGuide TagDVariableFErrorHySpecifies the HTML format file to be used to generate a response if any error occurs during the processing of the action.^Z5=L&Dynamic vs. static database publishingce>?AFormat files are HTML pages that contain Claris Dynamic Markup Language, or CDML, tags. Typically, a format file performs one type of database transaction. For example, in the Guest Book solution in the Web folder, Web users make new records in a FileMaker Pro database using the gb_new.htm format file. When a record is added successfully, a second format file lets the Web user know the record has been added. A third format file notifies Web users if the new record could not be created. In Baddition to these three format files, the Guest Book solution includes a home page, which is an HTML document that contains a link to the gb_new.htm format file. The number and type of format files you'll need depends on how much your Web users will interact with your FileMaker Pro databases. The most common format file types perform actions, such as: making new records updating existing records deleting records searching for records displaying one record or many records PlacZb>2Bd (.) characters. Name is Name of the field in the database. Value is For the -New and -Edit tags, the value contains the data to be uploaded into a record. Multiple occurrences of a field allow the data to be put into separate repetitions of a repeating field. For the -Find tag, the value is a find request on the specified field. For the -Img tag, the first field name in the URL is the name of the container field to retrieve the image from. The value portion is ignored. For allC other action tags, these name/value pairs are not needed. Syntax example(s) Find a record using a link Find first red record Edit a record using a form action
Other tags that are required -DB, any action tag @A         .  7    *  F  s  x              {  |    b` >2A ..$.6.H... .D.*6 ..$.6.H... .D.{ ..$.6.H... .D.DDDDDD""""""tField Name Field Nameu DevGuide TagD Not a TagFFieldsHLField names are used to control find criteria or to upload data to a record.KYesMAbout format fileshj?@AFormat files can contain: standard HTML elements the HTML FORM tag HTML INPUT tags CDML tags optional elements, such as GIF or JPEG graphics, animated GIFs, AIFF files, JAVA applets, QuickTime movies, tables, and frames Every HTML page and format file contains Header and Body elements. The Header identifies the document as an HTML page and contains the document title. The Body contains most of the page content and, with Custom Web Publishing, the CDML tags. The FORM tag specBifies that a form will be filled out within the HTML document and notifies the Web server to send the contents of the form to FileMaker Pro. Because your Web pages contain some amount of interactivityfor example, capturing Web users name and address information when they "sign" your guest bookyoull need to use the HTML
tag: The ACTION attribute alerts the Web server, in this case FileMaker Pro 4.0, that FileMaker Pro will be processing the form`f.?Ce the Web solution files (format files, HTML pages, and image files) inside the Web folder (or a subfolder inside the Web folder). You might want to remove the sample Web solutions from the Web folder. Use relative links between files to prevent links from breaking. For information on creating relative or absolute links, refer to an HTML reference book. Important All files in the Web folder can be accessed, replaced, or even deleted by savvy Web users. Don't put sensitive documents insiDde the Web folder.@A>  B  K  >AS (@ZH(0 _POEAbout format filesG8H-FormatJ Format File2eg?2AWhat it does Specifies the HTML format file used to generate a successful response during the processing of the action. Value is Path and name to the format file to use to display the response. Syntax example(s) Find any one record using a link, and display that record in "results.htm" Return any record in the database Find any one record using a form action, and display that record in "results.htm"
Other tags that are required -DB, any action tag See also -Error @fh ?2Aj    z       %  A  H      S  Z            jA ..$.6.H... .D.6 ..$.6.H... .D. ..$.6.H... .D..H..t-Format Format Fileu DevGuide TagDVariableFformatgd?HjSpecifies the HTML format file used to generate a successful response during the processing of the action.LPlanning format filespsk@BAIn addition to HTML tags, format files also contain Claris Dynamic Markup Language (CDML) tags, which interact directly with FileMaker Pro. There are 3 types of CDML tags: Action tags, which perform a specific action in FileMaker Pro. For example, the -new tag creates a new record in a FileMaker Pro database. Variable tags, which specify an option for the Action tags. For example the -db tag specifies the database name that Web users will interact with. Replacement tags, which actBY as placeholders and are swapped with data from a FileMaker Pro database. For example, the [FMP-field] is replaced with data from a FileMaker Pro field. CDML tags determine how Web users interact with the FileMaker Pro 4.0 database. For a complete list of all CDML tags and sample syntax, see the CDML Tag Index in this CDML Reference database.G@dk@C. The METHOD determines how the filled-out form is sent to the Web server, and it is typically sent with the POST value. The INPUT tag is another common HTML tag that youll see in a format file. The INPUT tag creates an input element, similar to a field or a button, in the form. The INPUT tag has two commonly used attributes: TYPE and NAME. The TYPE attribute specifies the type of element that will be displayed on a form. For example, a one-line text area that captures a Web users firstD name would be: The TEXT FIELD value in this example inserts a one-lined input area on an HTML page, which corresponds to a FileMaker Pro field. Other input types include radio buttons or text area, which yields a scrolling field. The NAME attribute specifies the field name. You can also use the TYPE=HIDDEN attribute to send CDML tags to FileMaker Pro that wont display in the Web browser. For example, each format file must specify the name of thejl@E_ FileMaker Pro database: The NAME attribute above uses the -db CDML tag, whose VALUE specifies the name of the FileMaker Pro database to work with. For information on the other attributes of the INPUT tag, see the "HTML Input Types" section of the CDML Tag Index in this CDML Reference database. @A  ?  a          A /. /Return any record in the database Find any one record using a form action
2ABABD2AECFAGCCIEJ2AKH 2AML BODPFQ2BRASN<CUAV2BWAXHYT=C[E\2A]^L_Z>2BaDbAc`?Ce2AfAgHhd@CjEk2AlCoq@iBAsr2AutC2BwAxvWCzE{2B|A}yZCEG2ACL~\CEGIKE/2BA]2BA^CA2BA_CA2BA`CEG2AAa2BDAb2AAHc2BAdC2BAeCA2BAAf2Ag2Ah2Ait€2BA€t€2€2AA€2BA€2A€2A€H€2A€2A€2Alp@2CYFindAny" value="Pick One!">
Other tags that are required -DB, any action tag 5@AB        !  4  V                     BA ..$6.6Q.Hl... .D.46Q ..$6.6Q.Hl... .D. ..$6.6Q.Hl... .D.>@ t-Lay Layout Nameu DevGuide TagDVariableFlayoutsoi@HoSpecifies the name of the layout that is used to control which fields are available and how they are displayed.LHTML format file elementsn @HpsuBEAbout format filesG10H-LOPJLogical Operator2AWhat it does Combines the find criteria as an AND or OR find request. Value is Either AND or OR. If the -LOP variable tag is not used, then the find request is assumed to be an AND request. Syntax example(s) Find a record using a link Find United states of America or United Kingdom records Find some records using a form action
Enter a country and click Find to see the results.
Other tags that are required -DB, -Find, -Format, field name See also -Op i@ir BA  P 0PHl uwB2t-LOP Logical Operatoru DevGuide TagDVariableF6Logical Operator (AND/OR) Logical Operator (OR) HiddenH8Combines the find criteria as an AND or OR find request.L CDML tagsCEUsing the CDML ToolG11H-MailBCCJBlind Carbon Copy for Email2AWhat it does Specifies the email address of the person that should be blind carbon copied. Value is An email address. Syntax example(s) Send mail using a form action
Other tags that are required -DB, -MailTo, -MailFrom, -MailSub, -MailHost, -MailFormat, any action tag See also -MailCC @A    ]  f  z        K  L  i      wv C2A ..$.6.H... .D.6 ..$.6.H... .D.K ..$.6.H... .D..$.6.t$-MailBCC Blind Carbon Copy for Emailu DevGuide TagDVariableFbccHMSpecifies the email address of the person that should be blind carbon copied.KYesMUsing the CDML Tool}WZAThe CDML templates provide general structure for several types of format files. The templates contain steps that can be used as a guide for inserting CDML tags. Choose this template To create a format file that - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - Delete Deletes records from a FileMaker Pro database Delete Reply Notifies the Web user that a record has been deleted successfully B Detail Displays information about one record Edit Edits existing records in a FileMaker Pro database Edit Reply Notifies the Web user that a record has been edited successfully New Creates new records in a FileMaker Pro database New Reply Notifies the Web user that a new record has been created Results Displays information about many records, typically after a search Search Searches records in a FileMaker Pro database The following example uses the CDML Tool to create a format filv{WCTML page that youll be creating. 5. In the CDML Tool, copy a template from the Format File (Action) list in the Templates tab. 6. Paste the template text into a blank HTML editing document. 7. From the Tags tab of the CDML Tool, copy and paste additional CDML tags into the appropriate location in the format file. Create one format file to handle each database interaction. For step-by-step instructions, see the next two sections: "Using the CDML templates" and "Adding CDML tags to forDmat files." Important considerations when using the CDML Tool: although FileMaker Pro 4.0 files may be opened by the FileMaker Pro 3.x application, most new features, including the CDML Tool, will only operate with FileMaker Pro 4.0 after changing a selection in a CDML Tool list box, you may need to click the Refresh button to update the list items. if you've modified the CDML Tool in any way, and it no longer generates appropriate CDML syntax, install a new copy from the FileMakez|]WEr Pro 4.0 CD-ROM.@A  X  eWpWEUsing the CDML ToolG49H-MailCCJCarbon Copy for EmailnHelp2AWhat it does Specifies the email address of the person who should be carbon copied. Value is An email address. Syntax example(s) Send mail using a form action
Other tags that are required -DB, -MailTo, -MailFrom, -MailSub, -MailHost, -MailFormat, any action tag See also -MailBCC @A    V  _  s        D  E  b      |y W2A ..$.6.H... .D.6 ..$.6.H... .D.D ..$.6.H... .D..$.6.t-MailCC Carbon Copy for Emailu DevGuide TagDVariableFccHFSpecifies the email address of the person who should be carbon copied.LAbout the CDML ToolaZ\ANote These instructions build on the format file started in the previous section, "Using the CDML templates." To insert Text field tags in the format file that adds records to the Guest Book.fp3 database: 1. In the Tags tab of the CDML Tool, be sure Guest Book.fp3 is the selected file in the Database list. 2. In the Category list, choose Fields (Add) Dynamic. The category determines which CDML tags are displayed. The Fields (Add) Dynamic category displays tags that create field areBas on the format file. 3. In the Tags list, choose Text Field. The Text Field tag inserts a one-line field in the HTML page. Note If the pop-up menu displays blank or inappropriate choices, click the Refresh button. 4. In