Workflow Solutions InfoImage InfoPath Integration Reference Guide UNISYS © 2007 Unisys Corporation. All rights reserved. June 2007 Printed in USA 8206 3603-000 NO WARRANTIES OF ANY NATURE ARE EXTENDED BY THIS DOCUMENT. Any product or related information described herein is only furnished pursuant and subject to the terms and conditions of a duly executed agreement to purchase or lease equipment or to license software. The only warranties made by Unisys, if any, with respect to the products described in this document are set forth in such agreement. Unisys cannot accept any financial or other responsibility that may be the result of your use of the information in this document or software material, including direct, special, or consequential damages. You should be very careful to ensure that the use of this information and/or software material complies with the laws, rules, and regulations of the jurisdictions with respect to which it is used. The information contained herein is subject to change without notice. Revisions may be issued to advise of such changes and/or additions. Notice to Government End Users: This is commercial computer software or hardware documentation developed at private expense. Use, reproduction, or disclosure by the Government is subject to the terms of Unisys standard commercial license for the products, and where applicable, the restricted/limited rights provisions of the contract data rights clauses. Correspondence regarding this publication can be submitted through the normal support process for the product in question as a UCF. For documentation problem, use the "USER-DOC" component in the UCF. Visit http://www.support.unisys.com/EPA/TXT/IIF-WELCOME?PLA=IIF&FORM=HTML-UNISYS Unisys and InfoImage are registered trademarks of Unisys Corporation in the United States and other countries. All other brands and products referenced in this document are acknowledged to be the trademarks or registered trademarks of their respective holders. Contents Section 1. Getting Started Purpose ............................................................................................................. 1–1 Audience ........................................................................................................... 1–1 Prerequisites .................................................................................................... 1–1 Scope ................................................................................................................. 1–1 Introduction to InfoPath.................................................................................1–2 InfoPath Integration in InfoImage ................................................................1–2 Section 2. Forms Overview...........................................................................................................2–1 Importing an InfoImage Form.......................................................................2–1 Using Sample Forms...................................................................................... 2–5 Deploying Forms ............................................................................................ 2–5 Form Files......................................................................................................... 2–5 InfoImage Form Files ................................................................. 2–5 InfoPath Form Files..................................................................... 2–6 Section 3. Form Conversion Conversion of InfoPath Form (XSN) to InfoImage Form (FRM) .............3–1 Conversion of InfoImage Form (FRM) to InfoPath Form (XSN) ............ 3–3 InfoImage and InfoPath Form Controls ..................................................... 3–4 Mapping of Supported Field Properties ................................ 3–4 Mapping of Supported Field Attributes ................................. 3–5 Mapping of Supported Data Types ........................................ 3–6 Unsupported Data Types ............................................................................. 3–6 Supported InfoImage Form Functions ................................... 3–7 Unsupported InfoImage Form Functions .............................. 3–7 Supported InfoPath Form Functions....................................... 3–8 Limitations .................................................................................... 3–8 InfoPath to InfoImage Form Format........................................................... 3–8 InfoImage to InfoPath Conversion............................................................ 3–10 Unsupported Controls of InfoPath Form .............................. 3–11 Glossary 8206 3603-000 ..................................................................................................... 1 iii Contents iv 8206 3603-000 Section 1 Getting Started This section provides the following information: • A brief description of this document’s purpose, audience, prerequisites and scope. • An introduction to InfoPath and its capabilities. Purpose The purpose of this guide is to provide instructions and supporting information for the conversion of forms between InfoPath and InfoImage formats. Audience This guide is intended for InfoImage system administrators and others who create, configure, and manage forms using InfoPath and InfoImage Forms Creator. Prerequisites The InfoPath developer should be familiar with the concepts and operation of the InfoImage Forms Creator. Refer to the Technical Overview Guide for a high-level overview of InfoImage Workflow Domain Subsystem processes and InfoImage components. Following are the required components: • Microsoft Office InfoPath 2003/2007 Service Pack 1 • InfoImage Forms Creator Scope This guide is not intended to provide instructions for the Microsoft Office InfoPath 2003/2007. For information on this product, see the appropriate user guides or online help. 8206 3603-000 1–1 Getting Started Introduction to InfoPath InfoPath 2003/2007, part of Microsoft Office 2003, enables you to build and deploy solutions to address the needs of your Enterprise. It is a rich-client application for enabling people to efficiently gather structured information as part of their business processes. InfoPath provides a dynamic forms-based environment that allows business data to be collected and managed in XML. InfoPath allows reuse and repurpose of information collected across business processes. The information captured in InfoPath forms can be shared with any process that makes use of an XML (Extensible Markup Language) schema. By building Web services with Visual Studio .NET and deploying on the Windows Server System, InfoPath can be integrated into your business processes. InfoPath Integration in InfoImage InfoPath Integration offers a business solution that enables you to convert the forms created in InfoPath to InfoImage forms format, which can then be introduced to Workflow for processing. This component also enables the conversion of InfoImage forms to InfoPath forms. Using this component, users can create and save forms interchangeably with a limited set of controls supported on InfoPath forms. This allows the users to use the rich and user-friendly interface provided by Microsoft InfoPath to design the forms. Using InfoImage Forms Creator, you can, • Import InfoPath forms (XSN) • Export InfoImage forms (FRM) to InfoPath Using InfoPath, you can, • Import InfoImage forms (FRM) For InfoPath Integration installation information, refer to the Installation and Configuration Guide. For the InfoPath Integration registry settings, refer to the Registry Reference Manual. 1–2 8206 3603-000 Section 2 Forms Overview This section explains the various options available to convert forms in InfoPath and InfoImage Forms Creator. In addition, it also provides information on sample files, deploying form and form files. InfoPath Integration supports any 5.x InfoImage forms for conversion. Importing an InfoImage Form You can import an InfoImage form using InfoPath. The InfoImage form (FRM) is converted to an InfoPath form (XSN) format. To import an InfoImage form, 1. In InfoPath 2003/2007, open the Design a Form task pane in design mode on the File menu. 2. Click Import Form. 8206 3603-000 2–1 Forms 3. In the Import Wizard, select "Unisys InfoImage Importer v7.0" in the list box and click Next. 4. In the "Select the file to import" box, type the InfoImage form name or click Browse to locate the InfoImage form to import. 5. Click Finish. 2–2 8206 3603-000 Forms 6. When the form is imported successfully, click Close on the dialog box. The InfoImage form (*.frm) is converted into an InfoPath form file (*.xsn) and is displayed in the InfoPath design mode. 7. Click Save As to save the form with the required file name and location. 8206 3603-000 2–3 Forms Note: While converting, if any unsupported controls are detected in the form, an error/warning message will be displayed. Example: Information Message This message is displayed when an InfoPath form is imported in InfoImage Forms Creator. Press "Yes" to continue with the conversion. A similar message is displayed when you import an InfoImage form in InfoPath. Example: Warning Message Press "Yes" to proceed with the conversion or "No" to exit the conversion. Example: Error Message For more information on error messages, refer to section Form Conversion in the Troubleshooting Guide. You can import the form again after correcting it for the unsupported controls. Refer to the Conversion of InfoImage Form (FRM) to InfoPath Form (XSN) for more details. For information on exporting to InfoImage forms, refer to the Forms Creator Help. Using InfoImage Forms Creator, you can import an InfoPath form. 2–4 8206 3603-000 Forms Using Sample Forms InfoImage product installation automatically creates the InfoPath Integration directory structure and copies sample forms into the UeWI\SAMPLES\InfoPathIntegration directory. Working samples are provided, that you may customize to meet your requirements. Note: While performing a custom installation, you can choose to install sample forms. Feature Sample Files InfoPath to InfoImage Conversion *.xsn InfoImage to InfoPath Conversion *.frm VB script file for forms containing user exits *.vbs Deploying Forms To install the new form, refer to the Central Administration Console Online Help for detailed instructions. Form Files InfoImage Form Files The following table summarizes the various InfoImage form files and their extensions/suffixes: File InfoImage Form 8206 3603-000 Suffix .FRM Description Applies to all query and non-query forms (index) of InfoImage. It provides the structure for the data in the form. • This is the one and only input file for conversion to InfoPath. • In case of User Exit, VB script file is also required as an input file. 2–5 Forms InfoPath Form Files The following table summarizes the various InfoPath form files and their extensions/suffixes: File Suffix Description Form Definition .XSF A manifest file in XML format that contains information about all of the other files and components, including XML Schemas, business logic used in an InfoPath form. Form Template .XSN A compressed file format that defines the data structure, appearance, and behavior of a form. Stylesheet .XSL Extensible Style sheet Language (XSL) is an XML vocabulary that defines the format of the data in the resulting document. It is used to transform XML data by means of a style sheet that defines presentation rules. XML .XML An acronym for Extensible Markup Language that is used by designers to create customized tags that enable the definition, transmission, validation, and interpretation of data between applications and between organizations. The output format that stores the field values. XML Schema 2–6 .XSD An XML schema is a specification that defines the structure of an XML document, including element names and data types, the form definition and means of data validation in a form. 8206 3603-000 Section 3 Form Conversion This section provides information on form conversion process and mapping of controls. Note: InfoPath Integration supports 5.2.1 or higher InfoImage forms for conversion. Conversion of InfoPath Form (XSN) to InfoImage Form (FRM) On import of InfoPath form (in InfoImage Forms Creator), the IIFConverter is invoked for conversion of InfoPath form (XSN). The IIFConverter reads the input form (*.xsn) and converts into the output form (*.frm). The following steps are involved in conversion process: • Extracts the InfoPath form (*.xsn) file • Reads the default view (*.xsl) from the XSF file • Reads the XSL file for the controls in the View • Checks for the controls, and displays error message for any unsupported controls • Creates the InfoImage form (*.frm) file During the conversion process, the following files are extracted from *.xsn cabinet file: File Type Description *.xsf XML manifest that describes the files that make up the solution. *.xsl XSLT style sheet that describes how each of the InfoPath Views should be rendered. *.xsd XML Schema files for the form and each of the data sources used. *.xml Defines the data format in a form. *.vbs Custom Visual Basic script written by the developer. The InfoPathToInfoImageConversion.log file is produced by the InfoPath-InfoImage converter. This log file contains all the error messages found during conversion and is 8206 3603-000 3–1 Form Conversion located in the path set by TEMP/TMP Environment variable. If the path is not set, it will be created under user profile Temp path. 3–2 8206 3603-000 Form Conversion Conversion of InfoImage Form (FRM) to InfoPath Form (XSN) On import of InfoImage form (using InfoPath) or export of InfoImage form (using InfoImage Forms Creator), the IFPConverter is invoked to convert an InfoImage form to an InfoPath form. The IFPConverter reads the input form (*.frm) and converts into the output form (*.xsn). The following steps are involved in the conversion process: • Reads InfoImage form (*.frm) file • Generates HTML format of the FRM file • Creates InfoPath Framework files • Checks for the controls and displays error message for any unsupported controls • Creates InfoPath form (*.xsn) for the supported controls and attributes • Opens the manifest.xsf in InfoPath (in the design mode) In addition to the *.xsn file, during the conversion process, the XSF, XSL, XSD, XML, VBS files are also created. The InfoImageToInfoPathConversion.log file is produced by the InfoImage-InfoPath converter. This log file contains all the error messages found during conversion and is located in the path set by TEMP/TMP Environment variable. If the path is not set, it will be created under user profile Temp path. 8206 3603-000 3–3 Form Conversion InfoImage and InfoPath Form Controls InfoImage supports: • Standard InfoPath controls: Text Box, Drop-Down List Box, Check Box, Rich Text Box • InfoPath Data types: Text (string), Whole Number (integer), Decimal (double), True/False (boolean), and, Date (date) To avoid conversion errors, use only supported InfoPath controls and attributes when designing forms in either InfoPath or InfoImage. There may be other limitations that are not discussed in this guide. Error messages are displayed if the conversion process detects unsupported controls and attributes. For more information on error messages, refer to the Troubleshooting Guide. Mapping of Supported Field Properties The following table lists the supported field properties and mapping of InfoImage Controls to InfoPath Controls. Field Definitions of InfoImage Form Control Properties of InfoPath Form Name Data tab ë Field Name Width Size tab ë Width Display tab • 'Limit text box to <number> characters' 3–4 Height Size tab ë Height Type Standard Controls Default Data tab ë Default Value ë Value Copy Data tab ë Rules Prompt Data source attribute ë Default value Help Advanced tab ë Screen Tip Formula Data tab ë Rules 8206 3603-000 Form Conversion Mapping of Supported Field Attributes The following table provides the mapping of the supported attributes of InfoImage form fields to InfoPath form attributes. InfoImage Form Field Attributes InfoPath Form Field Attributes Required Data tab ë Validation & Rules ë 'Cannot be blank' Display Only Display tab ë 'Read-only' Right Justify Display tab ë 'Alignment' ë Right Uppercase Data tab ë Rules Autoclear Data source attribute ë Right-click 'Add' (for Data Type True/False (Boolean) ë Name and Default value Group Tab Advanced tab ë Access Key Autoextend Display tab ë Limit text box to Retain Zeros Data tab ë Data type (Whole Number (integer)) or Decimal (double) ë Format ë None Scratch Tools ë Form Options ë Open and Save tab ë Rules Data source attribute ë Right-click 'Add' (for Data Type True/False (Boolean) ë Name and Default value Autoadvance Data source attribute ë Right-click 'Add' (for Data Type True/False (Boolean) ë Name and Default value No Echo Data source attribute ë Right-click 'Add' (for Data Type True/False (Boolean) ë Name and Default value Formula Data tab ë Rules Background Color Background Color is supported. (Options • Form Background) Note: If individual lines in a page have different background color, the background color for the first line will be applied to the current page in the converted form. Font Color All colors are supported. (Options • Font) Field Border Color If field borders have different colors, the bottom border color will be applied to all the borders in the converted form. Label and Text Regardless of the font provided for Label and Text fields, it will be replaced with the following font specifications in the converted InfoPath or InfoImage forms: 8206 3603-000 • Font: Courier • Style: Regular • Size: 8 (InfoImage form) or 10 (InfoPath form) 3–5 Form Conversion Mapping of Supported Data Types The following table provides the mapping of supported InfoImage data types to InfoPath controls and its data types: Data Type of InfoImage Form Controls of InfoPath Form text Text Box ë Text (string) number Text Box ë Whole Number (integer) currency Text Box ë Whole Number (integer) or Decimal (double) ë 'Currency' format date 10-character, in mm/dd/yyyy format Text Box ë Date (date) percent Text Box ë Whole Number (integer) or Decimal (double) ë 'Percentage' format decimal Text Box ë Decimal (double) checkbox Check Box memo field Rich Text Box Value List (Field • Attributes • Values) Drop-Down List Box Note: Except for yes/no, checkbox, signature, memo, percent/currency dropdown data types Note: Most Controls on an InfoPath 2003/2007 form are associated with, or bound, to a data source. Unsupported Data Types The following table provides mapping of the unsupported data types of InfoImage form to InfoPath controls and its data types: Data Type of InfoImage Form 3–6 Controls of InfoPath Form yes/no No equivalent control signature No equivalent control currency dropdown No equivalent control percent dropdown No equivalent control 8206 3603-000 Form Conversion Supported InfoImage Form Functions The following InfoImage functions are supported in InfoPath form format. Function Conversion Multi Page Line break will be added as a separator in a multi-page form. Range Supports only the 'less than' and 'greater than' condition value. (Attribute • Range) User Exit/Script Supports the 'Field Exit' type. (Attribute • User Exit/Script) On conversion, the script file is saved with the same name as of the form name. In InfoPath, the script is mapped to Properties ë Data Validation ë Event ë On After Change Supports the following message boxes: • Default • vbYesNo • vbOkCancel • vbYesNoCancel Unsupported InfoImage Form Functions The following InfoImage functions are not supported: • Binding - binds a form field to an image page • Image - associates image pages with a form • Table - defines fields as columns in a table • View - restricts user access to fields on the form, such as Read/Write, Read Only Tip: Design the forms using the supported controls, attributes, and functions to avoid errors during conversion. For InfoImage Forms Creator limitations, refer to the System Internals Guide. 8206 3603-000 3–7 Form Conversion Supported InfoPath Form Functions The following InfoPath functions are supported in InfoImage form format. Function Conversion Views Supports only the default view. Script Supports only the VB script file (*.vbs). Visible Rows On conversion, maximum of 18 rows are visible in a single page form on a 15-inch monitor. Limitations There are some restrictions for control attributes during form conversion from InfoPath to InfoImage and vice versa. It is recommended that you read the following limitations before designing a form in InfoPath or InfoImage to avoid errors during conversion. InfoPath to InfoImage Form Format Following are some of the restrictions for designing the InfoPath form, which will be later converted to InfoImage form format. Drop-Down List Box The actual value of a Drop-Down List Box is used for InfoPath form conversion and the display value is ignored. Font InfoPath form with any Font characteristics will be converted to 'Courier' font in the converted InfoImage form. Formula For successful InfoPath form conversion, the rule (action) in a formula can support up to five dependent fields. Group Tab The different set of groups in an InfoPath form is converted to a single group in the InfoImage form. Label Color 3–8 8206 3603-000 Form Conversion Label color in an InfoPath form will be converted to Automatic (black) color in an InfoImage form. Memo field Height of a Rich Text Box in an InfoPath form should be a minimum of 84 pixels (4 rows). Page Size When the converted InfoImage form is viewed on a PC with a 15-inch monitor, it displays a maximum of 18 rows (in a normal window) or 31 rows (in a maximized window) per page, although all the rows in the InfoPath form are converted. This is due to the limitation of InfoImage Forms Creator, wherein the form page size is based on the hardware (monitor size). Range In an InfoPath form, only 'less than' and 'greater than' condition is supported. Condition value must be an actual value and not a reference to a field's value. User Exit Scripts • You can write custom VB script for user exit using only the FViewer_Load() and FViewer_FieldExit() functions, which are called by all controls having User Exit property in InfoImage. Refer to the Client Work Manager Interface Integration Guide for details on writing form user exits for data exchange. Note: Java Script and VBA are not supported by InfoPath. • For compatibility and conversion of scripts, a variable starting with "IFP_" is added to the script name. These variables are later deleted when the form is converted back to InfoImage form format. Caution The InfoPath user, 1. Should not use these variables for any operations. 2. Should not add variables starting with "IFP_". Views If an InfoPath form has multiple Views, on conversion to InfoImage only the default View is retained and other Views are ignored. 8206 3603-000 3–9 Form Conversion InfoImage to InfoPath Conversion Following are some of the restrictions for designing the InfoImage form, which will be later converted to InfoPath form format. Attribute Name The attributes names for controls are case-sensitive. The following is the list of the attributes that are stored as XML attributes: Attribute Name Attribute in XML Attribute Name Attribute in XML PROMPT prompt AUTO CLEAR autoClear SCRATCH scratch RETAIN ZERO retainZero NO ECHO noEcho AUTO ADVANCE autoAdvance REQUIRED required DISPLAY ONLY displayOnly Note: While designing the form in InfoPath, make sure to use the exact case for attribute names to avoid loss of data during form conversion. Checkbox Checkbox background color in an InfoImage form is not supported during conversion to InfoPath form. Border color is supported. Default Values In addition to the default value for a field, other standard default values such as Date, Time, and Username are also supported. For successful InfoImage form to InfoPath form conversion, • Text control with default value for Username, Date and Time are supported. • Date control with default value for Date is supported. • Text combo box with default value for Username is supported. Date and Time is not supported. • Date combo box with default value for Date is not supported. • Default value for Range From and Range To are not supported. Font InfoImage form with any Font characteristics will be converted to 'Courier' font, tenpoint size, in the converted InfoPath form. 3–10 8206 3603-000 Form Conversion Memo InfoImage form with copy property set for a memo field is ignored during conversion to InfoPath form. Retain Zeros Retain zeros is not supported for currency while converting an InfoImage form to an InfoPath form. Unsupported Controls of InfoPath Form The following InfoPath controls and properties are not supported in InfoImage: • • Standard controls − Button − Date Picker − List Box − Optional Button − Section Properties of Text Box, Drop-Down Box, and Check Box − Date and Time (dateTime) − Hyperlink (AnyURI) − Time (time) • Repeating and optional controls • File and picture controls • Advanced controls • Custom controls 8206 3603-000 3–11 Glossary F Form A set of structured data associated with a workitem, used to maintain standard information about that workitem. Forms can be created using InfoImage Forms Creator or InfoPath. Forms Creator An InfoImage software component used to create, design, and manipulate forms and form views. Form Definition (.XSF) A manifest file in XML format that contains information about all of the other files and components, including XML Schemas, and business logic used in a form. Form Template (.XSN) A compressed file format that defines the data structure, appearance, and behavior of a form. Form Viewer An InfoImage program to displays forms. It runs in standalone mode to test new forms. I InfoPath Microsoft Office InfoPath 2003/2007 is a Microsoft Office System program that allows users to design and fill out business forms. U UeWI Acronym for Unisys e-Workflow & Imaging. A suite of Unisys products that enables the automation of document processing using electronic media. 8206 3603-000 Glossary–1 Glossary V View This is based on the Extensible Stylesheet Language (XSL) that allows transformation and presentation of structured form data. A form-specific display setting that can be saved with a form template and applied to form data when the form is being filled out. Users can switch between views to choose the amount of data shown in the form. X XML An acronym for Extensible Markup Language that is used by designers to create customized tags that enable the definition, transmission, validation, and interpretation of data between applications and between organizations. The output format that stores the field values. XML Schema (.XSD) An XML schema is a specification that defines the structure of an XML document, including element names and data types, the form definition and means of data validation in a form. XSL Extensible Stylesheet Language (XSL) is an XML vocabulary that defines the format of the data in the resulting document. It is used to transform XML data by means of a style sheet that defines presentation rules. A World Wide Web Consortium (W3C) standard defining style sheets for (and in) XML. Glossary–2 8206 3603-000