Ce fichier définit tous les objets à relier aux objets Alfabet. Ce fichier définit aussi les objets à importer et à synchroniser, de même que la connexion pour l'échange des données.
Paramètres utilisateur
Définit la connexion à l'API Alfabet RESTful pour l'échange des données.
<user
name=""
token="T66JADHPYTWW3A7U2ACUFYUZZU7BPCFL"
accessmode="httpclient"/>
accessmode
Mode d'accès de l'utilisateur. Le paramètre par défaut est httpclient.
token
Clé d'authentification de l'utilisateur. Cette valeur dépend du nom d'utilisateur. Informations d'identification, URL du service Web et URL d'interface utilisateur peuvent aussi être spécifiées dans le dialogue de propriété Intégration Alfabet de la base de données connexe.
Si aucun nom d'utilisateur n'est saisi (configuration par défaut) et que la clé pour le serveur Alfabet définie dans le fichier de configuration Web pour l'application Web Alfabet est saisie comme clé d'authentification, tous les utilisateurs ont un accès en lecture et en écriture à tous les objets Alfabet.
Si un nom d'utilisateur est saisi, seul cet utilisateur a accès aux objets Alfabet en fonction des droits accordés.
Vous trouverez plus d'informations sur les jetons et l'autorisation dans le manuel Alfabet Interface for RESTful Web Services que vous pouvez télécharger depuis Empower.
name
Le nom d'utilisateur pour l'API Alfabet RESTful. Si l'API RESTful du système Alfabet est configurée pour un accès anonyme, il vous suffit de saisir le jeton relié. Si l'API RESTful est configuré pour qu'un utilisateur y ait accès, vous devez saisir le nom de l'utilisateur et le mot de passe. Informations d'identification, URL du service Web et URL d'interface utilisateur peuvent aussi être spécifiées dans le dialogue de propriété Intégration Alfabet de la base de données connexe.
utilisateur
Contrôle la connexion à l'API Alfabet RESTful pour l'échange des données. Le nom d'utilisateur, la clé d'authentification et le mode d'accès doivent être spécifiés. Informations d'identification, URL du service Web et URL d'interface utilisateur peuvent aussi être spécifiées dans le dialogue de propriété Intégration Alfabet de la base de données connexe.
Par défaut, un exemple de clé d'authentification est défini. Le nom d'utilisateur n'est pas saisi. Dans cet accès anonyme, tous les utilisateurs ont par défaut un accès en lecture et en écriture à tous les objets Alfabet.
Saisissez la clé du serveur Alfabet comme valeur pour la balise token. Cette valeur dépend du nom d'utilisateur. Saisissez le nom d'utilisateur comme valeur pour la balise token. Ainsi, seul cet utilisateur a accès aux objets Alfabet pour lesquels il dispose de droits.
Vous trouverez plus d'informations sur les jetons et l'autorisation dans le manuel Alfabet Interface for RESTful Web Services que vous pouvez télécharger depuis Empower.
Lors de l'accès à l'API Alfabet RESTful, les données de connexion sont transmises avec l'en-tête HTTP. Assurez-vous que la transmission est codée.
Mappage individuel
Dans la section <!-- Single object mapping -->, vous pouvez relier individuellement des éléments ARIS à des éléments Alfabet.
<!-- Single object mapping -->
<object
aristype="OT_APPL_SYS_TYPE"
table="APPLICATION" >
table
Nom de base de données Alfabet qui contient les éléments à relier, par exemple "APPLICATION".
Les valeurs table doivent être exactement les mêmes que dans le fichier ARIS-ALFABET-mapping.xml.
aristype
Nom API ARIS d'un type d'objet, d'un type de modèle ou d'un type de symbole.
Il définit le type d'élément ARIS à fournir pour le mappage des éléments individuels pendant l'intégration Alfabet. Les types de symboles peuvent être utilisés pour gérer les types d'objets. Vous pouvez définir de multiples types d'éléments ARIS pour la même table Alfabet. Il est recommandé que vous définissiez chaque type d'élément ARIS dans une entrée <objet> distincte.
Les valeurs aristype doivent être exactement les mêmes que dans le fichier ARIS-ALFABET-mapping.xml.
Si vous souhaitez modifier le type d'objet Type d'application par défaut (OT_APPL_SYS_TYPE), assurez-vous que tous les types d'attributs nécessaires à l'intégration Alfabet pour le type d'objet que vous souhaitez utiliser à la place sont disponibles.
Par défaut, il s'agit des types Nom (AT_NAME), Description (AT_DESC), Version actuelle (AT_REL_3) et ALFABET-Lien 1 (AT_ALFA_LINK_1). Dans ce cas, entrez également tous les attributs Alfabet.
Vous pouvez bien sûr modifier les attributs des types d'objets à utiliser ou transférer d'autres attributs. Si vous ne souhaitez pas utiliser le type d'attribut Version actuelle (AT_REL_3) pour la version actuelle (Version), veuillez adapter les deux fichiers de configuration en conséquence.
Propriété XML object
Chaque élément object définit un élément ARIS spécifique à fournir pendant l'intégration Alfabet. Ainsi, chaque type d'élément ARIS doit être défini dans un élément object différent.
<condition property="ObjectState"
value="Active" />
Valeur
Valeur de la propriété de classe Alfabet spécifie à utiliser pour filtrer les éléments de table.
Dans cet exemple, la valeur de propriété ObjectState est Active. La valeur spécifiée de cette propriété de classe Alfabet sert comme filtre. Seuls les éléments de table de base de données Alfabet de la valeur spécifiée peuvent être mappés.
Propriété de condition
Nom de propriété de classe Alfabet, par exemple ObjectState.
La valeur spécifiée de cette propriété de classe Alfabet sert comme filtre. Seuls les éléments de table de base de données Alfabet de la valeur spécifiée peuvent être mappés.
Vous saisissez une seule propriété de condition pour le filtrage.
Par défaut, l'attribut Nom sera écrasé lors de l'échange de données.
Si vous reliez un objet ARIS avec un objet Alfabet, le nom de l'objet Alfabet sera utilisé à l'avenir. Le nom d'objet est écrasé dans ARIS.
Propriétés XML attr
Définit le traitement des attributs.
Si au moins un sous-élément attr est géré, cela restreint la liste des attributs importés vers ARIS à la liste des éléments attr listés ici.
Par défaut, l'attribut Description/Définition sera écrasé lors de l'échange de données.
Si vous reliez un objet ARIS avec un objet Alfabet, la description de l'objet Alfabet sera utilisé à l'avenir. L'attribut Description/Définition est écrasé dans ARIS.
aris
Nom API ARIS du type d'attribut ARIS. Ce nom est utilisé comme identifiant pour l'attribut du fichier ARIS-ALFABET-mapping.xml.
Par défaut, les types Nom (AT_NAME), Description (AT_DESC), Version actuelle (AT_REL_3) et Alfabet Lien 1 (AT_ALFA_LINK_1) sont utilisés. Vous pouvez bien sûr modifier les attributs des types d'objets à utiliser ou transférer d'autres attributs. Si vous ne souhaitez pas utiliser le type d'attribut Version actuelle (AT_REL_3) pour la version actuelle (Version), veuillez adapter les deux fichiers de configuration en conséquence.
Si vous avez modifié le type d'objet ARIS par défaut (OT_APPL_SYS_TYPE), assurez-vous que tous les types d'attributs nécessaires à l'intégration Alfabet pour le type d'objet que vous souhaitez utiliser à la place sont disponibles.
<attr aris="AT_REL_3" />
Par défaut, l'attribut Version actuelle sera écrasé lors de l'échange de données.
Si vous reliez un objet ARIS avec un objet Alfabet, la version de propriété de l'objet Alfabet sera mise à jour.
<link
attribute="AT_ALFA_LINK_1"
title="AT_ALFA_NAVI1"
defaultvalue="Navigate to Application in Alfabet" >
defaultvalue
Texte par défaut non localisé pour le texte du titre du lien.
Ce texte est affiché pour toutes les langues qui ne sont pas indiquées explicitement dans la propriété XML title locale. Le titre est protégé en écriture dans ARIS et est géré pendant la connexion à Alfabet ou le rapport de synchronisation ARIS-Alfabet.
titre
Nom API pour le type d'attribut de l'attribut titre de lien ARIS à utiliser. Par défaut, le type d'attribut Alfabet Navigation 1 sera utilisé pour conserver le texte du titre du lien.
Le texte est saisi dans la propriété XML defaultvalue. Ce texte est affiché pour toutes les langues qui ne sont pas indiquées explicitement dans la propriété XML title locale. Le titre est protégé en écriture dans ARIS et est saisi pendant la connexion à Alfabet ou le rapport de synchronisation ARIS-Alfabet.
- Attribut
Nom API pour le type d'attribut de l'attribut de lien ARIS à utiliser pour naviguer vers l'objet Alfabet. Par défaut, le type d'attribut Alfabet Lien 1 (AT_ALFA_LINK_1) sera utilisé pour enregistrer l'URL vers l'objet Alfabet.
Lien
Crée des attributs de lien ARIS renvoyant d'ARIS à Alfabet.
<title locale="1033"
value="Navigate to Application in Alfabet" />
Valeur
Texte de titre localisé.
locale
Identificateur de paramètres régionaux (LCID) de la langue dans laquelle est transféré le titre de lien.
Par défaut, les données sont transférées en anglais (1033). Si vous vous êtes connecté à la base de données ARIS en français, par exemple, les valeurs anglaises seront écrites avec les attributs français.
</link>
</object>
<dialog-columns alfatype="APPLICATION">
dialog-columns alfatype
Définit la table Alfabet à afficher dans le dialogue Sélectionner objet Alfabet.
Dans cet exemple, la table Alfabet APPLICATION est la source. Tous les objets Alfabet de cette table sont affichés.
<column alfabet="Version"/>
Colonne alfabet
Définit les colonnes et le contenu à afficher dans le dialogue Sélectionner objet Alfabet.
Dans cet exemple, Version est le nom de propriété à utiliser comme titre de colonne. Toutes les valeurs de cette propriété s'afficheront dans cette colonne. Version désigne l'élément subordonné attr de la table APPLICATION, qui est listée dans le fichier de configuration. Vous pouvez utiliser toutes les autres propriétés, par exemple Statut.
<newlink url="ExternalAccess.aspx?AccessType=ExternalAccess&UserType=Named&View=GraphicView:APP_CaptureApplications_Ex"/>-->
newlink url
Définit le lien vers Alfabet pour créer de nouveaux objets Alfabet. Ce lien Créer objet Alfabet est offert dans le dialogue Sélectionner objet Alfabet.
Ne modifiez pas cette valeur :
"ExternalAccess.aspx?AccessType=ExternalAccess&UserType=Named&View=GraphicView:APP_CaptureApplications_Ex"
La valeur représente la partie statique du lien. Le lien sera assemblé avec cela et la valeur URL d'interface utilisateur que vous avez définie lorsque vous avez relié la base de données ARIS au système Alfabet.
</dialog-columns>
Importation en série depuis Alfabet
Dans la section <!-- Bulk mapping -->, vous pouvez configurer la synchronisation Alfabet et la fonctionnalité importation en série.
<sync
table="APPLICATION"
cxnhandling="ignore" > <!-- values for cxnhandling = ignore, create, createAllowForce-->
cxnhandling
Définit le traitement des liaisons par défaut des liaisons affectées pour cette table. Ce paramètre peut être écrasé en spécifiant les sous-éléments cxn.
Il y a trois valeurs possibles :
Les liaisons non listées ne sont pas importées. C'est le paramètre par défaut, si aucun attribut cxnhandling n'est géré.
Les liaisons sont créées si soit l'objet source soit l'objet cible de la liaison existait déjà avant que l'élément lui-même ait été importé/synchronisé.
Les liaisons sont créées en fonction de la spécification dans le fichier ARIS-ALFABET-mapping.xml. Si le mappage force l'existence de l'objet source ou cible correspondant, la liaison est importée selon la spécification dans le fichier ARIS-ALFABET-mapping.xml.
table
Nom de base de données Alfabet qui contient les éléments à relier, par exemple "APPLICATION".
Les valeurs table doivent être exactement les mêmes que dans le fichier ARIS-ALFABET-mapping.xml.
sync
Chaque élément sync définit une table Alfabet spécifique à synchroniser. Ainsi, chaque table doit être définie dans un élément sync distinct. La synchronisation Alfabet peut être lancée manuellement ou via un rapport contrôlé. Tous les objets et liaisons qui ne sont pas encore disponibles dans ARIS seront importés et liés aux éléments Alfabet correspondants. Si vous ne configurez pas cette section, la fonctionnalité ne sera pas disponible dans ARIS.
<condition property="ObjectState"
value="Active" />
Valeur
Valeur de la propriété de classe Alfabet spécifie à utiliser pour filtrer les éléments de table.
Dans cet exemple, la valeur de propriété ObjectState est Active. La valeur spécifiée de cette propriété de classe Alfabet sert comme filtre. Seuls les éléments de table de base de données Alfabet de la valeur spécifiée peuvent être mappés.
Propriété de condition
Nom de propriété de classe Alfabet, par exemple ObjectState.
La valeur spécifiée de cette propriété de classe Alfabet sert comme filtre. Seuls les éléments de table de base de données Alfabet de la valeur spécifiée peuvent être mappés.
Vous saisissez une seule propriété de condition pour le filtrage.
Par défaut, l'attribut Nom sera écrasé lors de l'échange de données.
Si vous reliez un objet ARIS avec un objet Alfabet, le nom de l'objet Alfabet sera utilisé à l'avenir. Le nom d'objet est écrasé dans ARIS.
Propriétés XML attr
Définit le traitement des attributs.
Si au moins un sous-élément attr est géré, cela restreint la liste des attributs importés vers ARIS à la liste des éléments attr listés ici.
Par défaut, l'attribut Description/Définition sera écrasé lors de l'échange de données.
Si vous reliez un objet ARIS avec un objet Alfabet, la description de l'objet Alfabet sera utilisé à l'avenir. L'attribut Description/Définition est écrasé dans ARIS.
aris
Nom API ARIS du type d'attribut ARIS. Ce nom est utilisé comme identifiant pour l'attribut du fichier ARIS-ALFABET-mapping.xml.
Par défaut, les types Nom (AT_NAME), Description (AT_DESC), Version actuelle (AT_REL_3) et Alfabet Lien 1 (AT_ALFA_LINK_1) sont utilisés. Vous pouvez bien sûr modifier les attributs des types d'objets à utiliser ou transférer d'autres attributs. Si vous ne souhaitez pas utiliser le type d'attribut Version actuelle (AT_REL_3) pour la version actuelle (Version), veuillez adapter les deux fichiers de configuration en conséquence.
Si vous avez modifié le type d'objet ARIS par défaut (OT_APPL_SYS_TYPE), assurez-vous que tous les types d'attributs nécessaires à l'intégration Alfabet pour le type d'objet que vous souhaitez utiliser à la place sont disponibles.
<attr aris="AT_REL_3" />
Par défaut, l'attribut Version actuelle sera écrasé lors de l'échange de données.
Si vous reliez un objet ARIS avec un objet Alfabet, la version de propriété de l'objet Alfabet sera mise à jour.
<cxn
property="NextVersion"
cxnhandling="createAllowForce" />
cxnhandling
Définit pour cette table comment les liaisons affectées doivent être traitées par défaut. Ce paramètre peut être écrasé en spécifiant les sous-éléments cxn.
Il y a trois valeurs possibles :
La liaison n'est pas importée.
Les liaisons sont créées si soit l'objet source soit l'objet cible de la liaison existait déjà avant que l'élément lui-même ait été importé/synchronisé.
Les liaisons sont créées en fonction de la spécification dans le fichier ARIS-ALFABET-mapping.xml. Si le mappage force l'existence de l'objet source ou cible correspondant, la liaison est importée selon la spécification dans le fichier ARIS-ALFABET-mapping.xml.
C'est le paramètre par défaut, si aucun attribut cxnhandling n'est défini.
propriété
Nom de la propriété Alfabet définissant cette liaison. La propriété doit être de type Référence ou ReferenceArray.
Pour plus d'informations, reportez-vous au Manuel de référence Alfabet Documentation of the Alfabet Meta-Model.
cxn
Définit exactement quelles liaisons mappées dans le fichier ARIS-ALFABET-mapping.xml doivent être importées/synchronisées.
<link
attribute="AT_ALFA_LINK_1"
title="AT_ALFA_NAVI1"
defaultvalue="Navigate to Application in Alfabet" >
defaultvalue
Texte par défaut non localisé pour le texte du titre du lien.
Ce texte est affiché pour toutes les langues qui ne sont pas indiquées explicitement dans la propriété XML title locale. Le titre est protégé en écriture dans ARIS et est géré pendant la connexion à Alfabet ou le rapport de synchronisation ARIS-Alfabet.
titre
Nom API pour le type d'attribut de l'attribut titre de lien ARIS à utiliser. Par défaut, le type d'attribut Alfabet Navigation 1 sera utilisé pour conserver le texte du titre du lien.
Le texte est saisi dans la propriété XML defaultvalue. Ce texte est affiché pour toutes les langues qui ne sont pas indiquées explicitement dans la propriété XML title locale. Le titre est protégé en écriture dans ARIS et est saisi pendant la connexion à Alfabet ou le rapport de synchronisation ARIS-Alfabet.
- Attribut
Nom API pour le type d'attribut de l'attribut de lien ARIS à utiliser pour naviguer vers l'objet Alfabet. Par défaut, le type d'attribut Alfabet Lien 1 (AT_ALFA_LINK_1) sera utilisé pour enregistrer l'URL vers l'objet Alfabet.
Lien
Crée des attributs de lien ARIS renvoyant d'ARIS à Alfabet.
<title locale="1033"
value="Navigate to Application in Alfabet" />
Valeur
Texte de titre localisé.
locale
Identificateur de paramètres régionaux (LCID) de la langue dans laquelle est transféré le titre de lien.
Par défaut, les données sont transférées en anglais (1033). Si vous vous êtes connecté à la base de données ARIS en français, par exemple, les valeurs anglaises seront écrites avec les attributs français.
</link>
</sync>