System Integration This property defines the entity and the operations related to the entity. Catalog Entities contain the following elements: Table 15. Catalog Element Description Advanced Mode Turn on if you want to edit the Catalog in XML format. This property is an XML string in this format: <Catalog> <Entity Name="entityName" System="systemName" Service="serviceName" Default="true/false"> <Properties> <Property Name="propertyName" Type="typeName" Value="propertyValue" /> <Property Name="propertyName" Type="typeName" Value="propertyValue" /> </Properties> <Operation Name="operationName" Method="methodName" Default="True/False" > <Parameter Source="sourceType" SessionName="sessionName" SourceName="sourceName" Type="parameterType" Name="parameterName" Usage="usageType" Value="value" /> <Parameter Source="sourceType" SessionName="sessionName" SourceName="sourceName" Type="parameterType" Name="parameterName" Usage="usageType" Value="value" /> </Operation> </Entity> <Entity> ..</Entity></Catalog> System Allows you to specify the system name that is defined in the System Integration configuration file. If the system name does not exist in the System Integration configuration file, you will get an error. Service Allows you to specify the service name that is defined in the System Integration configuration file. The service name that you specify here must belong to system that you specify in the System attribute. If the service name does not exist in the System Integration configuration file, you will get an error. Name Allows you to specify the name of the entity which must be unique within this Catalog. The name does not have to match with any name in your external system. However, it is recommended that you use a descriptive name for your entity. This field is mandatory. Set Session Name Allows you to enter name of the session variable where the edited or newly created item is stored when it is saved, or the item that is being displayed or edited is stored when it is loaded. Reset Session Names Allows you to reset (set to NULL) the value of the session variable whose name is specified in this attribute. Specify multiple names by separating them with commas. Default Allows you to define this entity as the default for the list form. If this element is not specified, the first entity that is listed in the catalog becomes the default entity. The default operation of the default entity is the operation that is used to retrieve the data when the list form is loaded for the first time in edit or display mode. You can add operations to your entities by configuring the following elements: Table 16. Operations Element Description Name Allows you to specify the name of the operation. This name does not have to match with any name in your external system. This name is used to refer to this operation in the Action property. This field is mandatory. Method Allows you to specify the real name of the operation in your external system. For example, it may refer to the name of a web service method. Or it may refer to the name of a stored procedure in your SQL Server database. Default Allows you to define this operation as the default. The default operation is the first operation that is called to retrieve the entity to be displayed or edited. If this attribute is not specified, the first operation listed in the entity becomes the default operation. You can define parameters for the operation by configuring the following elements: Table 17. Parameters Element Description Name Allows you to specify the name of the parameter. Source Allows you to define the source of this parameter. The source can be one of the following: • DefaultValue — the value of the parameter that is the default • NullValue — the value of the parameter is blank • FixedValue — the value of the parameter that is defined in the Value attribute • HttpRequest — the value of the parameter that is retrieved from the HTTP parameters in the page URL. The name of the HTTP parameter is defined in the SourceName attribute. As an example, say the current page URL is http://mysite.com/default.aspx?ProductType=Hardware. If the SourceName attribute is ProductType, the value of the ProductType HTTP parameter, which is Hardware, is used as the value of the parameter. • Input — the value of the parameter that is retrieved from one of the input fields in the form. You specify the name of the input field in the SourceName attribute. Additionally, you can retrieve the current user information as the value of the parameter. You can specify one of the following name in the SourceName attribute to retrieve the current user information: • RowFromAnotherWebPart — the value of the parameter that is retrieved from the row that is consumed from another web part. You specify the name of the field that is consumed in the SourceName attribute. • Session — the value of the parameter that is retrieved from the row that is stored in the session. You specify the name of the session in the SessionName attribute. You specify the name of the field that is consumed in the SourceName attribute. • ComplexType — the value of the parameter is an object based on the Type attribute and Member definition inside the Parameter. Array and nested complex types are supported. • Array — the value of the parameter is an array of values • XML — the value of the parameter that is dynamically built when the condition is execute at runtime Usage Allows you to define the direction for this parameter. The options are In, Out, InOut, or ReturnValue. You can define one or more Property elements. Table 18. Properties Element Description Name Allows you to specify the name of the property. Refer to the documentation for the DAO Provider to your external system will tell you the name of the property that you must define. Type Allows you to specify type of value that is specified in the Value attribute. Example: System.String. Value Allows you to specify the value of the property.