The XML definition file for Integration Repositories conforms to the integration-repository Document Type Definition with the URL:
http://www.atg.com/dtds/integrations/integration-repository_1.0.dtd
The definition file includes the following elements:
integration-repository-template tag
The integration-repository-template
tag acts as a container for the Integration Repository definition file. It contains a single header tag and one or more item-descriptor tags.
header tag
The header tag contains information about the Integration Repository definition file. It can contain the following child elements:
name
author
version
description
item-descriptor tag
Each item descriptor in the local repository that is integrated must be defined in the Integration Repository definition file and configured in the item-descriptor
tag. This tag has the following attributes:
Attribute | Description |
---|---|
| The name of the item descriptor being configured. This must match the name of the item descriptor in the local repository. |
| This is the default mapping file that is used when sending a repository item to any of the configured commands. The mapping file controls which properties are sent as input, and what the external names of those properties are. See Mapping. |
| Just as there is a local ID ( |
| If the local repository ID should match the external ID, then this property should be set to |
| This property configures the number of milliseconds that a local item is valid before it should be retrieved from the external system. For example, if this is set to 600000, and you call |
| Each item retrieved from the remote system has a state associated with it in the persistent cache. The state can be one of OK, INVALID, or UNKNOWN. The default value is UNKNOWN. This property identifies which of those states will render the item read-only. This is useful if you timed out on a recent call to |
| This attribute controls the behavior if there is no configured command for a particular operation. If this attribute is true, then the local repository can act on the local repository item without reference to the remote system. For example, if there is no |
item-descriptor Child Tags
The item-descriptor
tag has the child tags described in the following table. The operations defined by these tags are also described in the Command Operations section.
Tag | Description |
---|---|
query | This configures the behavior of the Integration Repository when the Attributes: command view-class query-cache-size query-expire-timeout |
get-item | This configures the behavior of the Integration Repository when Attributes: command use-local-on-failure |
update-item | This configures the behavior of the Integration Repository when Attributes: command mapping-file timeout-response changed-properties-only update-local-with-result ignore-external-id-change |
add-item | This configures the behavior of the Integration Repository when Attributes: command mapping-file timeout-response update-local-with-result |
remove-item | This configures the behavior of the Integration Repository when Attributes: command timeout-response |
derived-properties | If your underlying local repository uses the derived properties feature of the SQL repository and you have set The |
property | The Attributes: A
If |
integration-repository Document Type Definition
<?xml encoding="UTF-8"?> <!-- =============================================================== --> <!-- integration-repository_1.0.dtd - Integration Repository configuration spec --> <!-- @version $Id: //product/DAS/main/Java/atg/dtds/integrations/integration- repository_1.0.dtd#5 $$Change: 294774 $ --> <!-- =============================================================== --> <!-- =============================================================== The following XML attributes have a uniform meaning throughout this DTD: (none yet) =============================================================== --> <!-- =============================================================== --> <!-- integration-repository-configuration - top level element --> <!-- =============================================================== --> <!ENTITY % timeoutresponses "(ROLLBACK|UNKNOWN|INVALID|IGNORE)"> <!ELEMENT integration-repository-template (header?, item-descriptor*)> <!-- The header --> <!ELEMENT header (name?, author*, version?, description?)> <!-- Name of template --> <!ELEMENT name (#PCDATA)> <!-- The author(s) --> <!ELEMENT author (#PCDATA)> <!-- Version string --> <!ELEMENT version (#PCDATA)> <!-- Description string --> <!ELEMENT description (#PCDATA)> <!-- =============================================================== --> <!-- integration-view element: --> <!-- The definition of a view as it appears to code that calls the --> <!-- integration repository. --> <!-- =============================================================== --> <!ELEMENT item-descriptor (query?, get-item?, update-item?, add-item?, remove-item?)> <!ATTLIST item-descriptor name CDATA #REQUIRED mapping-file CDATA #IMPLIED external-id-property CDATA #IMPLIED use-external-id CDATA #IMPLIED local-value-timeout CDATA #IMPLIED read-only-states CDATA #IMPLIED allow-local-operation CDATA #IMPLIED > <!ELEMENT query EMPTY> <!ATTLIST query command CDATA #IMPLIED view-class CDATA #IMPLIED query-cache-size CDATA #IMPLIED query-expire-timeout CDATA #IMPLIED > <!ELEMENT get-item EMPTY> <!ATTLIST get-item command CDATA #IMPLIED use-local-on-failure CDATA #IMPLIED > <!ELEMENT update-item (derived-properties?)> <!ATTLIST update-item command CDATA #IMPLIED mapping-file CDATA #IMPLIED timeout-response %timeoutresponses; "ROLLBACK" changed-properties-only CDATA #IMPLIED update-local-with-result CDATA #IMPLIED ignore-external-id-change CDATA #IMPLIED > <!ELEMENT derived-properties (property+)> <!ELEMENT property EMPTY> <!ATTLIST property name CDATA #REQUIRED referenced-property CDATA #REQUIRED > <!ELEMENT add-item EMPTY> <!ATTLIST add-item command CDATA #IMPLIED mapping-file CDATA #IMPLIED timeout-response %timeoutresponses; "ROLLBACK" update-local-with-result CDATA #IMPLIED > <!ELEMENT remove-item EMPTY> <!ATTLIST remove-item command CDATA #IMPLIED timeout-response %timeoutresponses; "ROLLBACK" >