Réserver une Démo
Pré. Proc.

Capacité de Query

Les clients peuvent interroger un modèle et récupérer les ressources qui correspondent à un critère spécifique. Dans Enterprise Architect , l'URI de base pour accéder à la capacité de Query est :

<protocole>://<serveur>/<nom_modèle>/oslc/am/qc/

Une string requête exprimant les critères spécifiques doit être ajoutée à l'URI de base et adressée au modèle à l'aide d'une requête HTTP GET. Si l'URI devient trop long (par exemple, il dépasse 1000 caractères), il est recommandé d'utiliser une requête HTTP POST, avec la string de requête dans le corps POST. La réponse à cette requête sera au format RDF/XML. Actuellement, Enterprise Architect prend en supporte les requêtes sur les propriétés de Paquetage , d'élément et de diagramme uniquement (et non sur les fonctionnalités telles que les attributs, les opérations et les scénarios).

Enterprise Architect en supporte ces paramètres de capacité de Query pour spécifier les critères :

  • oslc.where - spécifie les conditions que les ressources doivent satisfaire et est similaire à la clause WHERE d'une instruction SQL
  • oslc.select - spécifie les propriétés de la ressource à récupérer et est similaire à la clause SELECT d'une instruction SQL
Ces paramètres peuvent être utilisés séparément ou en combinaison pour spécifier les critères de récupération des ressources.

Éléments du XML de réponse

Élément

Description

oslc_am:Ressource

Représente une ressource OSLC Architecture Management 2.0 et ses propriétés (telles que définies dans la forme de ressource). L'attribut 'rdf:about' sur cet élément spécifie l'URL pour accéder à la ressource. Le format de cette URL est :

<protocole>://<serveur>/<nom_modèle>/oslc/am/resource/<GUID de ressource avec préfixe>/

Éléments avec le préfixe d'espace de noms 'dcterms'

Les propriétés standard du Dublin Core Metadata Element Set.

Éléments avec le préfixe d'espace de noms 'foaf'

Les propriétés standard du vocabulaire Friend of a Friend (FOAF).

Éléments avec le préfixe d'espace de noms 'ss'

Les propriétés personnalisées d' Enterprise Architect .

Exemple

Récupérez toutes les ressources de type Acteur dans le modèle :

  • URL : http://localhost:480/firebird_model/oslc/am/qc/?oslc.where=dcterms:type="Actor" & useridentifier={72825AF9-E116-48f1-9DF8-77815E66B1A7}
La réponse est comme indiqué.

<rdf:RDF>

<rdf:Description rdf:about="http://mybuildvm:2480/firebird_model/oslc/am/qc/">

<rdfs:membre>

<oslc_am:Resource rdf:about="http://localhost:480/firebird_model/oslc/am/resource/el_{9EAD1087-BC1A-4b04-804F-748713D10E42}/">

<rdf:type rdf:resource="http://open-services.net/ns/am#Resource"/>

<!--Nom de la ressource-->

<dcterms:title>A1</dcterms:title>

<!-- Type d'architecte d'entreprise pour la ressource-->

<dcterms:type>Acteur</dcterms:type>

<!--GUID de la ressource-->

<dcterms:identifier>el_{9EAD1087-BC1A-4b04-804F-748713D10E42}</dcterms:identifier>

<!--Auteur de la ressource-->

<dcterms : créateur>

<foaf:Personne>

<foaf:name>Sparx</foaf:name>

</foaf:Personne>

</dcterms:creator>

<!--Date de création de la ressource-->

<dcterms:created>2020-06-21 09:40:58</dcterms:created>

<!--Date de modification de la ressource-->

<dcterms:modified>2020-07-12 15:43:28</dcterms:modified>

<!--État de la ressource-->

<ss:status>Proposé</ss:status>

<!--Complexité de la Ressource-->

<ss:complexity>Facile</ss:complexity>

<!--Phase de la Ressource-->

<ss:phase>1.0</ss:phase>

<!--Version de la ressource-->

<ss:version>1.0</ss:version>

<!--Type de ressource-->

<ss:resourcetype>Élément</ss:resourcetype>

<!--GUID du Paquetage qui contient cet acteur-->

<ss:parentresourceidentifier>pk_{56DF19B4-7035-40d2-9030-21D3383562A6}</ss:parentresourceidentifier>

<!--Utilisez ce lien pour récupérer les Fonctionnalités de cet Acteur-->

<ss : fonctionnalités rdf:resource="http://localhost:480/firebird_model/oslc/am/ fonctionnalités /el_{9EAD1087-BC1A-4b04-804F-748713D10E42}/ " />

<!--Utilisez ce lien pour récupérer les Connecteurs de cet Acteur-->

<ss:nestedresources rdf:resource="http://localhost:480/firebird_model/oslc/am/nestedresources/el_{9EAD1087-BC1A-4b04-804F-748713D10E42}/ " />

</oslc_am:Resource>

</rdfs:membre>

</rdf:Description>

</rdf:RDF>

Notes

  • Cette facilité est disponible via le Pro Cloud Server , avec une licence valide
  • La requête GET pour récupérer la ressource/la fonctionnalité de ressource Fonctionnalité sera pas traitée par le Pro Cloud Server à moins que le jeton d'authentification de l'utilisateur ne soit transmis avec la requête (via la chaîne de requête ' string ' dans l'URL)

Apprenez Plus