Les exemples et les échantillons de ce document sont réservés à l’environnement AEM Forms sur JEE.
À propos du service Repository
Le service Repository fournit du stockage de ressources et des services de gestion à AEM Forms. Lorsque des développeurs créent une application AEM Forms, ils peuvent déployer les ressources dans le référentiel plutôt que dans le système de fichiers. Les actifs peuvent être constitués de formulaires XML, de formulaires PDF (y compris de formulaires Acrobat), de fragments de formulaire, d’images, de profils, de stratégies, de fichiers SWF, DDX et WSDL, de schémas XML et de données de test.
Prenons l’exemple de l’application Forms suivante nommée Applications/FormsApplication :
Notez qu’un fichier nommé Loan.xdp se trouve dans le dossier Forms. Pour accéder à cette conception de formulaire, vous devez spécifier le chemin d’accès complet (y compris la version) : Applications/FormsApplication/1.0/FormsFolder/Loan.xdp
.
Pour plus d’informations sur la création d’une application Forms à l’aide de Workbench, voir Aide de Workbench.
Le chemin d’accès à une ressource située dans le référentiel AEM Forms est le suivant :
Applications/Application-name/Application-version/Folder.../Filename
Les valeurs suivantes présentent quelques exemples de valeurs URI :
Vous pouvez parcourir le référentiel AEM Forms à l’aide d’un navigateur web. Pour parcourir le référentiel, saisissez l’URL suivante dans un navigateur web https://[server name]:[server port]/repository
. Vous pouvez vérifier les résultats de démarrage rapide associés à la section Utilisation du référentiel AEM Forms à l’aide d’un navigateur web. Par exemple, si vous ajoutez du contenu au référentiel AEM Forms, vous pouvez afficher le contenu dans un navigateur web. (Voir Démarrage rapide (mode SOAP) : écrire une ressource en utilisant l’API Java.)
L’API Repository fournit un certain nombre d’opérations que vous pouvez utiliser pour stocker et récupérer des informations du référentiel. Par exemple, vous pouvez obtenir une liste des ressources ou récupérer des ressources spécifiques stockées dans le référentiel lorsqu’une ressource est nécessaire dans le cadre du traitement d’une application.
L’API Repository ne peut pas être utilisée pour interagir avec Content Services (obsolète). Pour interagir avec Content Services (obsolète), utilisez l’API Document Management.
À l’aide de l’API Repository Service, vous pouvez accomplir les tâches suivantes :
Avec l’API Repository, vous ne pouvez pas gérer le contrôle d’accès aux ressources, rechercher des ressources ou définir des relations de ressources à l’aide d’un référentiel ECM.
Lorsqu’un PDF chiffré est écrit dans le référentiel, la fonction d’extraction de relation automatisée ne peut pas être utilisée. Dans le cas contraire, un PDF chiffré peut être stocké dans le référentiel et récupéré ultérieurement. Le récupérateur peut choisir de déchiffrer le PDF une fois qu’il a été récupéré dans le référentiel.
Pour plus d’informations sur le service Repository, voir Références des services pour AEM Forms.
Les dossiers (collections de ressources) sont utilisés pour stocker des objets (fichiers ou ressources) dans des regroupements organisés. Les dossiers peuvent contenir des ressources et d’autres dossiers, également appelés sous-dossiers. Les ressources ne peuvent être stockées que dans un seul dossier à la fois.
Les fichiers héritent des listes de contrôle d’accès (ACL) des dossiers et les sous-dossiers héritent des ACL de leurs dossiers parents. Par conséquent, les dossiers parents doivent exister avant de pouvoir créer des dossiers enfants. L’IDE permet d’interagir uniquement dossier par dossier, et non fichier par fichier. Vous ne pouvez pas modifier les dossiers et il n’est pas nécessaire de le faire : un dossier ne contient pas de données lui-même. Il s’agit plutôt uniquement d’un conteneur pour les ressources qui contiennent des données. La liste de contrôle d’accès par défaut est une autorisation de niveau système, ce qui signifie que les utilisateurs doivent disposer d’autorisations de niveau système (lecture, écriture, traversée, gestion des listes de contrôle d’accès) jusqu’à ce qu’une personne leur donne des autorisations pour un dossier particulier. Les listes de contrôle d’accès ne fonctionnent que dans l’IDE.
Pour plus d’informations sur le service Repository, voir Références des services pour AEM Forms.
Pour créer un dossier, procédez comme suit :
Inclure les fichiers de projet
Incluez les fichiers nécessaires dans votre projet de développement. Si vous créez une application cliente à l’aide de Java, incluez les fichiers JAR nécessaires. Si vous utilisez des services web, incluez les fichiers proxy.
Créer le client de service
Avant de pouvoir créer par programmation une collection de ressources, vous devez établir une connexion et fournir des informations d’identification. Pour ce faire, créez un client de service.
Créer le dossier
Appelez la méthode du service Repository pour créer la collection de ressources et renseigner les informations d’identification dans la collection de ressources, y compris son UUID, son nom de dossier et sa description.
Écrire le dossier dans le référentiel
Appelez la méthode du service Repository pour écrire la collection de ressources, en spécifiant l’URI du dossier cible.
Voir également
Créer des dossiers à l’aide de l’API Java
Créer des dossiers à l’aide de l’API Web Service
Inclusion des fichiers de bibliothèque Java d’AEM Forms
Réglage des propriétés de la connexion
Démarrages rapides de l’API Repository Service
Créez un dossier à l’aide de l’API Repository Service (Java) :
Inclure les fichiers du projet
Incluez des fichiers de projet dans le chemin de classe du projet Java.
Création du client de service
Créez un objet ResourceRepositoryClient
en utilisant son constructeur et en transmettant un objet ServiceClientFactory
contenant des propriétés de connexion.
Création du dossier
Pour créer une collection de ressources, vous devez d’abord créer un objet com.adobe.repository.infomodel.bean.RepositoryInfomodelFactoryBean
.
Appelez la méthode newResourceCollection
de l’objet repositoryInfomodelFactoryBean
et transmettez les paramètres suivants :
com.adobe.repository.infomodel.Id
à affecter à la ressource.com.adobe.repository.infomodel.Lid
à affecter à la ressource.java.lang.String
contenant le nom de la collection de ressources. Par exemple, FormsFolder
.La méthode renvoie un objet com.adobe.repository.infomodel.bean.ResourceCollection
représentant le nouveau dossier.
Définissez la description du dossier à l’aide de la méthode setDescription
et transmettez le paramètre suivant :
String
qui décrit la collection de ressources. Dans cet exemple, "test Folder"
est utilisé .
.Écriture du dossier dans le référentiel
Appelez la méthode writeResource
de l’objet ResourceRepositoryClient
et transmettez l’URI du dossier et l’objet ResourceCollection
. Par exemple, l’URI du dossier peut être la valeur suivante : /Applications/FormsApplication/1.0/
.
La méthode renvoie une instance du nouvel objet com.adobe.repository.infomodel.bean.Resource
créé. Par exemple, vous pouvez récupérer la valeur d’identifiant de la nouvelle ressource en appelant la méthode getId
de l’objet com.adobe.repository.infomodel.bean.Resource
.
Voir également
Démarrage rapide (mode SOAP) : créer un dossier à l’aide de l’API Java.
Inclusion des fichiers de bibliothèque Java d’AEM Forms
Réglage des propriétés de la connexion
Créez un dossier à l’aide de l’API Repository Service (Web Service) :
Inclure les fichiers du projet
Création du client de service
À l’aide de l’assemblage client .NET Microsoft, créez un objet RepositoryServiceService
en appelant son constructeur par défaut. Définissez sa propriété Credentials
à l’aide d’un objet System.Net.NetworkCredential
contenant le nom d’utilisateur et le mot de passe.
Création du dossier
Créez le dossier à l’aide du constructeur par défaut pour la classe ResourceCollection
et transmettez les paramètres suivants :
Id
, créé en appelant le constructeur par défaut pour la classe Id
et affecté au champ id
de l’objet Resource
.Lid
, créé en appelant le constructeur par défaut pour la classe Lid
et affecté au champ lid
de l’objet Resource
.name
de l’objet Resource
. Le nom utilisé dans cet exemple est "testfolder"
.description
de l’objet Resource
. La description utilisée dans cet exemple est "test folder"
.Écriture du dossier dans le référentiel
Appelez la méthode writeResource
de l’objet RepositoryServiceService
et transmettez les paramètres suivants :
ResourceCollection
représentant le dossier.null
pour les deux autres paramètres.Voir également
Appeler AEM Forms en utilisant le codage Base64
Vous pouvez créer des ressources à un emplacement donné dans le référentiel. La taille de fichier naturelle est soumise aux restrictions de la base de données et au délai d’expiration de la session. Pour la configuration par défaut, les fichiers sont limités à 25 Mo. Pour augmenter ou réduire la taille maximale du fichier, vous devez modifier la configuration de la base de données.
L’écriture de ressources équivaut à stocker des données dans le référentiel. Une fois que vous avez écrit une ressource dans le référentiel, elle devient accessible à tous les clients de l’écosystème de référentiel. Lorsque vous écrivez des ressources, telles que des schémas XML, des fichiers XDP et des fichiers XSD, dans le référentiel, le contenu est analysé en fonction du type MIME. Si le type MIME est pris en charge, l’analyseur détermine s’il existe une relation implicite avec d’autres contenus. Par exemple, si une feuille de style en cascade (CSS) comporte une URL relative qui fait référence à une page CSS commune, il est prévu que vous envoyiez également la page CSS commune dans le référentiel. La relation entre les deux ressources est stockée en tant que relation en attente pendant une période non ajustable de 30 jours. Lorsque vous envoyez la page CSS commune au référentiel au cours de la période de 30 jours, la relation est formée.
Lorsque vous créez une ressource, la liste de contrôle d’accès (ACL) est héritée du dossier parent. Le dossier racine dispose d’autorisations au niveau du système jusqu’à la création d’une ressource ou d’un dossier initial, auquel cas les autorisations ACL par défaut sont accordées à la ressource ou au dossier.
Vous pouvez écrire des ressources par programmation à l’aide de l’API Java ou Web Service Repository Service.
Pour plus d’informations sur le service Repository, voir Références des services pour AEM Forms.
Pour écrire une ressource, procédez comme suit :
Inclure les fichiers de projet
Incluez les fichiers nécessaires dans votre projet de développement. Si vous créez une application cliente à l’aide de Java, incluez les fichiers JAR nécessaires. Si vous utilisez des services web, incluez les fichiers proxy.
Création du client du service
Avant de pouvoir lire une ressource par programmation, vous devez établir une connexion et fournir des informations d’identification. Pour ce faire, créez un client de service.
Spécifier l’URI du dossier cible pour la ressource
Créez une chaîne contenant l’URI de la ressource à lire. La syntaxe comprend des barres obliques, comme dans cet exemple : « /chemin/dossier ».
Créer la ressource
Appelez la méthode du service Repository pour créer la ressource et renseignez la ressource avec des informations d’identification, y compris son UUID, son nom et sa description.
Définir le contenu de la ressource
Appelez la méthode du service Repository pour créer le contenu de la ressource et stocker ce contenu dans la ressource.
Écrire la ressource dans le dossier cible
Appelez la méthode du service Repository pour écrire la ressource, en spécifiant l’URI du dossier cible.
Voir également
Écrire des ressources à l’aide de l’API Java
Écrire des ressources à l’aide de l’API Web Service
Inclusion des fichiers de bibliothèque Java d’AEM Forms
Réglage des propriétés de la connexion
Démarrages rapides de l’API Repository Service
Écrivez une ressource à l’aide de l’API Repository Service (Java) :
Inclure les fichiers du projet
Incluez les fichiers JAR client dans le chemin de classe de votre projet Java.
Création du client de service
Créez un objet ResourceRepositoryClient
en utilisant son constructeur et en transmettant un objet ServiceClientFactory
contenant des propriétés de connexion.
Spécifiez l’URI du dossier cible pour la ressource.
Spécifiez l’URI du dossier cible pour la ressource. Dans ce cas, comme la ressource appelée testResource
est stockée dans le dossier nommé testFolder
, l’URI du dossier est "/testFolder"
. L’URI est stocké en tant qu’objet java.lang.String
.
Création de la ressource
Pour créer une ressource, vous devez d’abord créer un objet com.adobe.repository.infomodel.bean.RepositoryInfomodelFactoryBean
.
Appelez la méthode newResource
de l’objet RepositoryInfomodelFactoryBean
, qui crée un objet com.adobe.repository.infomodel.bean.Resource
. Dans cet exemple, les paramètres suivants sont fournis :
com.adobe.repository.infomodel.Id
, créé en appelant le constructeur par défaut pour la classe Id
.com.adobe.repository.infomodel.Lid
, créé en appelant le constructeur par défaut pour la classe Lid
.java.lang.String
contenant le nom de fichier de la ressource.Pour spécifier la description de la ressource, appelez la méthode setDescription
de l’objet Resource
et transmettez une chaîne contenant la description. Dans cet exemple, la description est "test resource"
.
Définition du contenu de la ressource
Pour créer du contenu pour la ressource, appelez la méthode newResourceContent
de l’objet RepositoryInfomodelFactoryBean
, qui renvoie un objet com.adobe.repository.infomodel.bean.ResourceContent
. Ajoutez du contenu à l’objet ResourceContent
. Pour ce faire, dans cet exemple, les tâches suivantes doivent être réalisées :
setDataDocument
de l’objet ResourceContent
et transmission de l’objet com.adobe.idp.Document
setSize
de l’objet ResourceContent
et transmission de la taille en octets de l’objet Document
Ajoutez le contenu à la ressource en appelant la méthode setContent
de l’objet Resource
et en transmettant l’objet ResourceContent
. Pour plus d’informations, voir Référence de l’API pour AEM Forms.
Enregistrer la ressource dans le dossier cible
Appelez la méthode writeResource
de l’objet ResourceRepositoryClient
et transmettez l’URI du dossier, ainsi que l’objet Resource
.
Voir également
Démarrage rapide (mode SOAP) : écrire une ressource en utilisant l’API Java.
Inclusion des fichiers de bibliothèque Java d’AEM Forms
Réglage des propriétés de la connexion
Écrivez une ressource à l’aide de l’API Repository Service (Web Service) :
Inclure les fichiers du projet
Création du client de service
À l’aide de l’assemblage client Microsoft .NET, créez un objet RepositoryServiceService
en appelant son constructeur par défaut. Définissez sa propriété Credentials
à l’aide de l’objet System.Net.NetworkCredential
contenant le nom d’utilisateur et le mot de passe.
Spécifiez l’URI du dossier cible pour la ressource.
Spécifiez l’URI du dossier cible pour la ressource. Dans ce cas, comme la ressource appelée testResource
est stockée dans le dossier nommé testFolder
, l’URI du dossier est "/testFolder"
. Si vous utilisez un langage compatible avec Microsoft .NET Framework (par exemple, C#), stockez lʼURI dans un objet System.String
.
Création de la ressource
Pour créer une ressource, appelez le constructeur par défaut de la classe Resource
. Dans cet exemple, les informations suivantes sont stockées dans lʼobjet Resource
:
com.adobe.repository.infomodel.Id
, qui est créé en appelant le constructeur par défaut de la classe Id
et affecté au champ id
de lʼobjet Resource
.com.adobe.repository.infomodel.Lid
, qui est créé en appelant le constructeur par défaut de la classe Lid
et affecté au champ lid
de lʼobjet Resource
.name
de lʼobjet Resource
. Le nom utilisé dans cet exemple est "testResource"
.description
de lʼobjet Resource
. La description utilisée dans cet exemple est "test resource"
.Définition du contenu de la ressource
Pour créer le contenu de la ressource, appelez le constructeur par défaut de la classe ResourceContent
. Ajoutez ensuite du contenu à lʼobjet ResourceContent
. Pour ce faire, dans cet exemple, les tâches suivantes doivent être réalisées :
BLOB
contenant un document au champ dataDocument
de lʼobjet ResourceContent
.BLOB
au champ size
de lʼobjet ResourceContent
.Ajoutez le contenu à la ressource en affectant lʼobjet ResourceContent
au champ content
de lʼobjet Resource
.
Enregistrer la ressource dans le dossier cible
Appelez la méthode writeResource
de lʼobjet RepositoryServiceService
et transmettez lʼURI du dossier, ainsi que lʼobjet Resource
. Transmettez null
comme valeur pour les deux autres paramètres.
Voir également
Appeler AEM Forms en utilisant le codage Base64
Vous pouvez découvrir des ressources en les répertoriant. Une requête est exécutée sur le référentiel pour rechercher toutes les ressources associées à une collection de ressources donnée.
Une fois vos ressources organisées, vous pouvez inspecter la structure que vous avez créée en visualisant une branche particulière de la structure, comme vous le feriez dans un système d’exploitation.
La liste des ressources fonctionne par relation : les ressources sont membres de dossiers. L’appartenance est représentée par une relation de type « membre de ». Lorsque vous répertoriez les ressources dʼun dossier donné, vous recherchez les ressources qui sont associées à un dossier donné par la relation « membre de ». Les relations sont directionnelles : un membre d’une relation possède une source qui est un membre de la cible. La source est la ressource ; la cible est le dossier parent.
Pour plus d’informations sur le service Repository, consultez la section Références des services pour AEM Forms.
Pour répertorier les ressources, procédez comme suit :
Inclusion des fichiers de projet
Incluez les fichiers nécessaires dans votre projet de développement. Si vous créez une application cliente à l’aide de Java, incluez les fichiers JAR nécessaires. Si vous utilisez des services web, incluez les fichiers proxy.
Créer le client de service
Avant de pouvoir créer par programmation une collection de ressources, vous devez établir une connexion et fournir des informations d’identification. Pour ce faire, créez un client de service.
Spécification du chemin dʼaccès au dossier
Créez une chaîne contenant le chemin dʼaccès au dossier comportant les ressources. La syntaxe comprend des barres obliques, comme dans l’exemple suivant : « /chemin/dossier ».
Récupération de la liste des ressources
Appelez la méthode du service Repository pour récupérer la liste des ressources, en spécifiant le chemin du dossier cible.
Voir également
Liste des ressources à l’aide de l’API Java
Liste des ressources à l’aide de l’API de service Web
Inclusion des fichiers de bibliothèque Java d’AEM Forms
Réglage des propriétés de la connexion
Démarrages rapides de l’API Repository Service
Répertoriez les ressources à l’aide de l’API du service Repository (Java) :
Inclure les fichiers du projet
Incluez les fichiers JAR client dans le chemin de classe de votre projet Java.
Création du client de service
Créez un objet ResourceRepositoryClient
à l’aide de son constructeur et en transmettant un objet ServiceClientFactory
contenant des propriétés de connexion.
Définition du chemin du dossier
Spécifiez l’URI de la collection de ressources à interroger. Dans ce cas, son URI est "/testFolder"
. L’URI est stocké en tant qu’objet java.lang.String
.
Récupération de la liste des ressources
Appelez la méthode listMembers
de l’objet ResourceRepositoryClient
et transmettez l’URI du dossier.
La méthode renvoie un java.util.List
des objets com.adobe.repository.infomodel.bean.Resource
qui constituent la source d’un com.adobe.repository.infomodel.bean.Relation
de type Relation.TYPE_MEMBER_OF
et qui ont l’URI de collecte de ressources comme cible. Vous pouvez effectuer une itération sur cette List
pour récupérer chacune des ressources. Dans cet exemple, le nom et la description de chaque ressource s’affichent.
Voir également
Démarrage rapide (mode SOAP) : inscription de ressources à l’aide de l’API Java
Inclusion des fichiers de bibliothèque Java d’AEM Forms
Réglage des propriétés de la connexion
Inscription de ressources à l’aide de l’API du service Repository (service Web) :
Inclure les fichiers du projet
Création du client de service
À l’aide de l’assemblage client Microsoft .NET, créez un objet RepositoryServiceService
en appelant son constructeur par défaut. Définissez sa propriété Credentials
à l’aide d’un objet System.Net.NetworkCredential
contenant le nom d’utilisateur et le mot de passe.
Définition du chemin du dossier
Spécifiez une chaîne contenant l’URI du dossier à interroger. Dans ce cas, son URI est "/testFolder"
. Lorsque vous utilisez un langage conforme au framework Microsoft .NET (C#, par exemple), stockez l’URI dans un objet System.String
.
Récupération de la liste des ressources
Appelez la méthode listMembers
de l’objet RepositoryServiceService
et transmettez l’URI du dossier en tant que premier paramètre. Transmettez null
pour les deux autres paramètres.
La méthode renvoie un tableau d’objets qui peuvent être convertis en objets Resource
. Vous pouvez effectuer une itération sur le tableau d’objets pour récupérer chacune des ressources associées. Dans cet exemple, le nom et la description de chaque ressource s’affichent.
Voir également
Appeler AEM Forms en utilisant le codage Base64
Vous pouvez récupérer des ressources à partir d’un emplacement donné dans le référentiel afin de lire leur contenu et leurs métadonnées. Le workflow est dirigé par un formulaire d’initialisation. Le processus a toutes les permissions nécessaires pour lire le formulaire. Le système récupère le formulaire de données et lit le contenu du référentiel. Le référentiel donne accès au contenu et aux métadonnées (la possibilité de savoir que la ressource existe).
Le référentiel dispose des quatre types d’autorisations suivants :
Les utilisateurs ne peuvent exécuter des processus que si lʼautorisation leur en a été accordée. Les utilisateurs d’un IDE doivent disposer d’autorisations de parcours et de lecture pour se synchroniser avec le référentiel. Les listes de contrôle d’accès ne s’appliquent quʼau moment de la conception, car l’exécution se produit dans le contexte du système.
Vous pouvez lire les ressources par programmation à l’aide de l’API Java du service Repository ou de l’API de service web.
Pour plus d’informations sur le service Repository, consultez la section Référence des services pour AEM Forms.
Pour lire une ressource, procédez comme suit :
Inclure les fichiers de projet
Incluez les fichiers nécessaires dans votre projet de développement. Si vous créez une application cliente à l’aide de Java, incluez les fichiers JAR nécessaires. Si vous utilisez des services web, incluez les fichiers proxy.
Création du client du service
Avant de pouvoir lire une ressource par programmation, vous devez établir une connexion et fournir des informations d’identification. Pour ce faire, créez un client de service.
Spécifier l’URI de la ressource à lire
Créez une chaîne contenant l’URI de la ressource à lire. La syntaxe comprend des barres obliques, comme dans cet exemple : « /path/resource ».
Lire la ressource
Appelez la méthode du service Repository pour lire la ressource, en spécifiant l’URI.
Voir également
Lire les ressources à l’aide de l’API Java
Lire les ressources à l’aide de l’API de service web
Inclusion des fichiers de bibliothèque Java d’AEM Forms
Réglage des propriétés de la connexion
Démarrages rapides de l’API Repository Service
Lire une ressource à l’aide de l’API du service Repository (Java) :
Inclure les fichiers du projet
Incluez les fichiers JAR client dans le chemin de classe de votre projet Java.
Création du client de service
Créez un objet ResourceRepositoryClient
en utilisant son constructeur et en transmettant un objet ServiceClientFactory
qui contient les propriétés de connexion.
Spécifier l’URI de la ressource à lire
Spécifiez une valeur de chaîne qui représente l’URI de la ressource à récupérer. Par exemple, si la ressource s’appelle testResource et se trouve dans un dossier nommé testFolder, spécifiez /testFolder/testResource
.
Lire la ressource
Appelez la méthode readResource
de l’objet ResourceRepositoryClient
et transmettez l’URI de la ressource comme paramètre. Cette méthode renvoie une instance Resource
qui représente la ressource.
Voir également
Démarrage rapide (mode SOAP) : lire une ressource à lʼaide de l’API Java
Inclusion des fichiers de bibliothèque Java d’AEM Forms
Réglage des propriétés de la connexion
Lire une ressource à l’aide de l’API du service Repository (service web) :
Inclure les fichiers du projet
Création du client de service
À l’aide de l’assemblage client Microsoft .NET, créez un objet RepositoryServiceService
en appelant son constructeur par défaut. Définissez sa propriété Credentials
en utilisant un objet System.Net.NetworkCredential
contenant le nom d’utilisateur et le mot de passe.
Spécifier l’URI de la ressource à lire
Spécifiez une chaîne contenant l’URI de la ressource à récupérer. Dans ce cas, comme la ressource nommée testResource
se trouve dans le dossier au nom de testFolder
, son URI est "/testFolder/testResource"
. Si vous utilisez un langage compatible avec Microsoft .NET Framework (par exemple, C#), stockez l’URI dans un objet System.String
.
Lire la ressource
Appelez la méthode readResource
de l’objet RepositoryServiceService
et transmettez l’URI de la ressource comme premier paramètre. Transmettez null
pour les deux autres paramètres.
Voir également
Appeler AEM Forms en utilisant le codage Base64
Vous pouvez récupérer et mettre à jour le contenu des ressources dans le référentiel. Lorsque vous mettez à jour des ressources, le contrôle d’accès à ces ressources reste inchangé entre les versions. Lorsque vous effectuez une mise à jour, vous avez la possibilité d’incrémenter la version majeure. Si vous ne choisissez pas d’incrémenter la version majeure, la version mineure est automatiquement mise à jour.
Lorsque vous mettez à jour une ressource, la nouvelle version est créée en fonction des attributs de ressource spécifiés. Lorsque vous mettez à jour une ressource, vous spécifiez deux paramètres importants : l’URI cible et une instance de ressource contenant toutes les métadonnées mises à jour. Il est important de noter que même si vous ne modifiez pas un attribut donné (par exemple, le nom), cet attribut reste obligatoire dans lʼinstance que vous transmettez. Les relations créées lors de l’analyse du contenu sont ajoutées à la version spécifique et ne sont pas transférées, sauf indication contraire.
Par exemple, si vous mettez à jour un fichier XDP qui contient des références à d’autres ressources, ces références supplémentaires seront également enregistrées. Supposons que la version 1.0 de form.xdp possède deux références externes : un logo et une feuille de style. Vous mettez à jour le fichier form.xdp, de sorte quʼil possède maintenant trois références : un logo, une feuille de style et un fichier de schéma. Lors de la mise à jour, le référentiel ajoute la troisième relation (au fichier de schéma) à sa table de relations en attente. Une fois que le fichier de schéma est présent dans le référentiel, la relation est automatiquement formée. Cependant, si la version 2.0 de form.xdp n’utilise plus le logo, la version 2.0 de form.xdp nʼaura pas de relation avec le logo.
Toutes les opérations de mise à jour sont de nature atomique et transactionnelle. Par exemple, si deux utilisateurs lisent la même ressource et décident tous deux de mettre à jour la version 1.0 vers la version 2.0, lʼun dʼeux réussira et lʼautre échouera, lʼintégrité du référentiel sera maintenue et les deux utilisateurs recevront un message confirmant le succès ou lʼéchec. Si la transaction n’est pas validée, elle sera restaurée en cas de défaillance de la base de données et expirera ou sera restaurée en fonction du serveur d’applications.
Vous pouvez mettre à jour les ressources par programmation à l’aide de l’API Java du service Repository ou de l’API de service web.
Pour plus d’informations sur le service Repository, consultez la section Références des services pour AEM Forms.
Pour mettre à jour une ressource, procédez comme suit :
Inclusion des fichiers de projet
Incluez les fichiers nécessaires dans votre projet de développement. Si vous créez une application cliente à l’aide de Java, incluez les fichiers JAR nécessaires. Si vous utilisez des services web, incluez les fichiers proxy.
Création du client du service
Avant de pouvoir lire une ressource par programmation, vous devez établir une connexion et fournir des informations d’identification. Pour ce faire, créez un client de service.
Récupération de la ressource à mettre à jour
Lisez la ressource. Pour plus d’informations, consultez la section Lecture des ressources.
Mise à jour de la ressource
Définissez les nouvelles informations dans la ressource et appelez la méthode du service Repository pour mettre à jour la ressource : spécifiez l’URI, la ressource mise à jour et la manière dont les informations de version doivent être mises à jour.
Voir également
Mise à jour des ressources à l’aide de l’API Java
Mise à jour des ressources à l’aide de l’API de service web
Inclusion des fichiers de bibliothèque Java d’AEM Forms
Réglage des propriétés de la connexion
Démarrages rapides de l’API Repository Service
Pour mettre à jour une ressource à l’aide de l’API du service Repository (Java), procédez comme suit :
Inclure les fichiers du projet
Incluez les fichiers JAR client dans le chemin de classe de votre projet Java.
Création du client de service
Créez un objet ResourceRepositoryClient
en utilisant son constructeur et en transmettant un objet ServiceClientFactory
qui contient les propriétés de connexion.
Récupérer la ressource à mettre à jour
Spécifier lʼURI de la ressource pour récupérer et lire la ressource. Dans cet exemple, l’URI de la ressource est "/testFolder/testResource"
.
Mettre à jour la ressource
Mettez à jour les informations de lʼobjet Resource
. Pour mettre à jour la description dans cet exemple, appelez la méthode setDescription
de lʼobjet Resource
et transmettez la nouvelle chaîne de description comme paramètre.
Appelez ensuite la méthode updateResource
de lʼobjet ServiceClientFactory
et transmettez les paramètres suivants :
java.lang.String
contenant l’URI de la ressource.Resource
contenant les informations de la ressource mise à jour.boolean
indiquant s’il faut mettre à jour la version majeure ou mineure. Dans cet exemple, une valeur de true
est transmise pour indiquer que la version majeure doit être incrémentée.Voir également
Didacticiel de mise en route (mode SOAP) : mise à jour d’une ressource en utilisant l’API Java
Inclusion des fichiers de bibliothèque Java d’AEM Forms
Réglage des propriétés de la connexion
Pour mettre à jour une ressource en utilisant l’API Repository (service web), procédez comme suit :
Inclure les fichiers du projet
Création du client de service
À l’aide de l’assemblage client Microsoft .NET, créez un objet RepositoryServiceService
en appelant son constructeur par défaut. Définissez sa propriété Credentials
à l’aide d’un objet System.Net.NetworkCredential
contenant le nom d’utilisateur et le mot de passe.
Récupérer la ressource à mettre à jour
Indiquez l’URI de la ressource à récupérer et lisez la ressource. Dans cet exemple, l’URI de la ressource est "/testFolder/testResource"
. Pour plus d’informations, voir Lire les ressources.
Mettre à jour la ressource
Mettez à jour les informations de l’objet Resource
. Pour mettre à jour la description dans cet exemple, saisissez une nouvelle valeur dans le champ description
de lʼobjet Resource
.
Appelez la méthode updateResource
de lʼobjet RepositoryServiceService
et transmettez les paramètres suivants :
System.String
contenant l’URI de la ressource.Resource
contenant les informations de la ressource mise à jour.boolean
indiquant s’il faut mettre à jour la version majeure ou mineure. Dans cet exemple, une valeur de true
est transmise pour indiquer que la version majeure doit être incrémentée.null
pour les deux paramètres restants.Voir également
Appeler AEM Forms en utilisant le codage Base64
Vous pouvez construire des requêtes utilisées pour rechercher des ressources dans le référentiel, y compris l’historique, les ressources associées et les propriétés.
Vous pouvez récupérer les ressources associées pour déterminer les dépendances entre un formulaire et ses fragments. Par exemple, si vous disposez d’un formulaire, vous pouvez déterminer les fragments ou les ressources externes qu’il utilise. Si vous disposez d’une image, vous pouvez également découvrir les formulaires qui l’utilisent. Vous pouvez également rechercher des ressources associées à l’aide du filtrage basé sur les propriétés. Par exemple, vous pouvez rechercher tous les formulaires qui utilisent une image avec un nom spécifié, ou trouver toute image utilisée par un formulaire avec un nom spécifié. Vous pouvez également effectuer une recherche à l’aide des propriétés des ressources. Par exemple, vous pouvez effectuer une requête pour trouver tous les formulaires ou ressources dont le nom commence par une chaîne de caractères donnée qui peut inclure les caractères génériques « % » et « _ ». Gardez à lʼesprit que les recherches basées sur les propriétés ne sont pas basées sur les relations : ces recherches partent du principe que vous avez des connaissances spécifiques sur une ressource donnée.
Instructions de requête
Une requête contient une ou plusieurs instructions associées à des conditions de façon logique. Une instruction est constituée d’un opérande gauche, d’un opérateur et d’un opérande droit. De plus, vous pouvez spécifier l’ordre de tri à utiliser pour les résultats de la recherche. Lʼordre de tri contient des informations équivalentes à une clause SQL ORDER BY
et est composé dʼéléments qui contiennent les attributs sur lesquels la recherche a été basée, ainsi quʼune valeur indiquant si lʼordre ascendant ou descendant doit être utilisé.
Vous pouvez rechercher des ressources par programmation à l’aide de l’API Java du service Repository. Actuellement, il n’est pas possible d’utiliser l’API de service web pour rechercher des ressources.
Comportement de tri
L’ordre de tri n’est pas respecté lors de l’appel de la méthode searchProperties
de lʼobjet ResourceRepositoryClient
et de la spécification dʼun ordre de tri. Prenons lʼexemple suivant : vous créez une ressource avec trois propriétés personnalisées, dont les noms d’attribut sont name
, secondName
et asecondName
. Ensuite, vous créez un élément d’ordre de tri sur le nom de l’attribut et définissez la valeur ascending
sur true
.
Ensuite, vous appelez la méthode searchProperties
de lʼobjet ResourceRepositoryClient
et transmettez l’ordre de tri. La recherche renvoie la bonne ressource, avec les trois propriétés. Toutefois, les propriétés ne sont pas triées par nom d’attribut. Elles sont retournées dans l’ordre dans lequel elles ont été ajoutées : name
, secondName
et asecondName
.
Pour plus d’informations sur le service Repository, consultez la section Références des services pour AEM Forms.
Pour rechercher des ressources, procédez comme suit :
Inclusion des fichiers du projet
Incluez les fichiers nécessaires dans votre projet de développement. Si vous créez une application cliente à l’aide de Java, incluez les fichiers JAR nécessaires. Si vous utilisez des services web, incluez les fichiers proxy.
Création du client du service
Avant de pouvoir lire une ressource par programmation, vous devez établir une connexion et fournir des informations d’identification. Pour ce faire, créez un client de service.
Définition du dossier cible de la recherche
Créez une chaîne contenant le chemin d’accès de base à partir duquel effectuer la recherche. La syntaxe comprend des barres obliques, comme dans cet exemple : « /chemin/dossier ».
Spécifier les attributs utilisés dans la recherche
Vous pouvez baser la recherche sur les attributs contenus dans les ressources. Spécifiez les valeurs des attributs sur lesquels effectuer la recherche.
Créer la requête utilisée dans la recherche
Créez une requête à l’aide d’instructions et de conditions. Chaque instruction spécifie l’attribut sur lequel baser la recherche, la condition à utiliser et la valeur d’attribut à utiliser dans la recherche.
Créer l’ordre de tri des résultats de recherche
L’ordre de tri est constitué d’éléments dont chacun contient l’un des attributs utilisés dans la recherche et une valeur indiquant si l’ordre croissant ou décroissant doit être utilisé.
Rechercher des ressources
Recherchez les ressources à l’aide du dossier, de la requête et de l’ordre de tri. Indiquez en outre la profondeur de la recherche et une limite supérieure du nombre de résultats à renvoyer.
Récupérer des ressources à partir du résultat de la recherche
Parcourez la liste des ressources renvoyée et extrayez les informations en vue d’un traitement ultérieur.
Voir également
Recherche de ressources à l’aide de l’API Java
Inclusion des fichiers de bibliothèque Java d’AEM Forms
Réglage des propriétés de la connexion
Démarrages rapides de l’API Repository Service
Recherchez une ressource à l’aide de l’API Repository Service (Java) :
Inclure les fichiers du projet
Incluez les fichiers JAR client dans le chemin de classe de votre projet Java.
Création du client de service
Créez un objet ResourceRepositoryClient
en utilisant son constructeur et en transmettant un objet ServiceClientFactory
contenant des propriétés de connexion.
Définition du dossier cible de la recherche
Spécifiez l’URI du chemin d’accès de base à partir duquel exécuter la recherche. Dans cet exemple, l’URI de la ressource est /testFolder
.
Spécification des attributs utilisés dans la recherche
Spécifiez les valeurs des attributs sur lesquels effectuer la recherche. Les attributs existent dans un objet com.adobe.repository.infomodel.bean.Resource
. Dans cet exemple, la recherche sera effectuée sur l’attribut name. Par conséquent, un java.lang.String
contenant le nom de l’objet Resource
est utilisé, lequel est testResource
dans ce cas.
Création de la requête utilisée dans la recherche
Pour créer une requête, créez un objet com.adobe.repository.query.Query
en appelant le constructeur par défaut pour la classe Query
et ajoutez des instructions à la requête.
Pour créer une instruction, appelez le constructeur pour la classe com.adobe.repository.query.Query.Statement
et transmettez les paramètres suivants :
Resource.ATTRIBUTE_NAME
est utilisée.Query.Statement
. Dans cet exemple, la valeur statique Query.Statement.OPERATOR_BEGINS_WITH
est utilisée.String
contenant la valeur "testResource"
, est utilisé.Indiquez l’espace de nommage de l’opérande gauche en appelant la méthode setNamespace
de l’objet Query.Statement
et en transmettant l’une des valeurs statiques contenues dans la classe com.adobe.repository.infomodel.bean.ResourceProperty
. Dans cet exemple, la valeur ResourceProperty.RESERVED_NAMESPACE_REPOSITORY
est utilisée.
Ajoutez chaque instruction à la requête en appelant la méthode addStatement
de l’objet Query
et en transmettant l’objet Query.Statement
.
Créer lʼordre de tri des résultats de la recherche
Pour spécifier l’ordre de tri utilisé dans les résultats de la recherche, créez un objet com.adobe.repository.query.sort.SortOrder
en appelant le constructeur par défaut de la classe SortOrder
et ajoutez des éléments à l’ordre de tri.
Pour créer un élément pour l’ordre de tri, appelez l’un des constructeurs de la classe com.adobe.repository.query.sort.SortOrder.Element
. Dans cet exemple, comme le nom de la ressource sert de base à la recherche, la valeur statique Resource.ATTRIBUTE_NAME
est utilisée comme premier paramètre et lʼordre croissant (une valeur boolean
de true
) est spécifié comme deuxième paramètre.
Ajoutez chaque élément à lʼordre de tri en appelant la méthode addSortElement
de l’objet SortOrder
et en transmettant l’objet SortOrder.Element
.
Rechercher les ressources
Pour rechercher des resources
en fonction des propriétés des attributs, appelez la méthode searchProperties
de l’objet ResourceRepositoryClient
et transmettez les paramètres suivants :
String
contenant le chemin d’accès de base à partir duquel exécuter la recherche. Dans ce cas, la valeur "/testFolder"
est utilisée.com.adobe.repository.infomodel.bean.ResourceCollection.DEPTH_INFINITE
est utilisé pour indiquer que le chemin d’accès de base et tous ses dossiers doivent être utilisés.int
indiquant la première ligne à partir de laquelle sélectionner le jeu de résultats non paginés. Dans cet exemple, 0
est spécifié.int
indiquant le nombre maximal de résultats à renvoyer. Dans cet exemple, 10
est spécifié.La méthode renvoie une liste java.util.List
d’objets Resource
dans lʼordre de tri spécifié.
Récupérer les ressources à partir des résultats de recherche
Pour récupérer les ressources contenues dans les résultats de recherche, il faut itérer au sein de List
et convertir chaque objet en Resource
afin d’extraire ses informations. Dans cet exemple, le nom de chaque ressource est affiché.
Voir également
Démarrage rapide (mode SOAP) : rechercher des ressources à l’aide de l’API Java
Inclusion des fichiers de bibliothèque Java d’AEM Forms
Réglage des propriétés de la connexion
Vous pouvez spécifier des relations entre les ressources dans le référentiel. Il existe trois types de relations :
Vous pouvez créer vos propres relations personnalisées. Par exemple, si vous stockez un fichier HTML dans le référentiel et qu’il utilise une image, vous pouvez spécifier une relation personnalisée pour relier le fichier HTML avec l’image (puisque normalement seuls les fichiers XML sont associés aux images à l’aide d’une relation de dépendance définie par le référentiel). Un autre exemple de relation personnalisée est celui où vous souhaitez créer une vue différente du référentiel avec une structure de graphique cyclique au lieu d’une structure dʼarborescence. Vous pourriez définir un graphique circulaire ainsi quʼune visionneuse pour parcourir ces relations. Enfin, vous pouvez indiquer qu’une ressource remplace une autre ressource, même si les deux ressources sont complètement différentes. Dans ce cas, vous pouvez définir un type de relation en dehors de la plage réservée et créer une relation entre ces deux ressources. Votre application serait le seul client capable de détecter et de traiter la relation, et elle pourrait être utilisée pour effectuer des recherches sur cette relation.
Vous pouvez spécifier par programmation les relations entre les ressources à lʼaide de l’API Java ou de service web du service Repository.
Pour plus d’informations sur le service Repository, voir Références des services pour AEM Forms.
Pour définir une relation entre deux ressources, procédez comme suit :
Inclure les fichiers de projet
Incluez les fichiers nécessaires dans votre projet de développement. Si vous créez une application cliente à l’aide de Java, incluez les fichiers JAR nécessaires. Si vous utilisez des services web, incluez les fichiers proxy.
Création du client du service
Avant de pouvoir lire une ressource par programmation, vous devez établir une connexion et fournir des informations d’identification. Pour ce faire, créez un client de service.
Spécifier les URI des ressources à relier
Créez des chaînes contenant les URI de la ressource à relier. La syntaxe comprend des barres obliques, comme dans cet exemple : « /chemin/ressource ».
Créer la relation
Appelez la méthode de service Repository pour créer et spécifier le type de relation.
Voir également
Créer des ressources de relation à l’aide de l’API Java
Créer des ressources de relation à l’aide de l’API Web Service
Inclusion des fichiers de bibliothèque Java d’AEM Forms
Réglage des propriétés de la connexion
Démarrages rapides de l’API Repository Service
Créez des ressources de relation à l’aide de l’API Java Repository Service et effectuez les tâches suivantes :
Inclure les fichiers du projet
Incluez les fichiers JAR client dans le chemin de classe de votre projet Java.
Création du client de service
Créez un objet ResourceRepositoryClient
en utilisant son constructeur et en transmettant un objet ServiceClientFactory
contenant des propriétés de connexion.
Spécification des URI des ressources à relier
Spécifiez les URI des ressources à relier. Dans ce cas, comme les ressources sont appelées testResource1
et testResource2
et se trouvent dans le dossier nommé testFolder
, leurs URI sont "/testFolder/testResource1"
et "/testFolder/testResource2"
. Les URI sont stockés en tant qu’objets java.lang.String
. Dans cet exemple, les ressources sont d’abord écrites dans le référentiel et leurs URI sont récupérés. Pour plus d’informations sur l’écriture d’une ressource, voir Écriture de ressources.
Création de la relation
Appelez la méthode createRelationship
de l’objet ResourceRepositoryClient
et transmettez les paramètres suivants :
com.adobe.repository.infomodel.bean.Relation
. Dans cet exemple, une relation de dépendance est établie en spécifiant la valeur Relation.TYPE_DEPENDANT_OF
.boolean
indiquant si la ressource cible est automatiquement mise à jour vers l’identifiant basé sur com.adobe.repository.infomodel.Id
de la nouvelle ressource HEAD. Dans cet exemple, en raison de la relation de dépendance, la valeur true
est spécifiée.Vous pouvez également récupérer une liste des ressources associées pour une ressource donnée en appelant la méthode getRelated
de l’objet ResourceRepositoryClient
et en transmettant les paramètres suivants :
"/testFolder/testResource1"
) est spécifiée.boolean
indiquant si la ressource spécifiée est la ressource source dans la relation. Dans cet exemple, la valeur true
est spécifiée, car c’est le cas.Relation
. Dans cet exemple, une relation de dépendance est spécifiée en utilisant la même valeur que celle utilisée précédemment : Relation.TYPE_DEPENDANT_OF
.La méthode getRelated
renvoie un java.util.List
des objets de Resource
à travers lesquels vous pouvez effectuer une itération pour récupérer chacune des ressources associées, en projetant les objets contenus dans le List
vers Resource
comme vous le faites. Dans cet exemple, testResource2
doit se trouver dans la liste des ressources renvoyées.
Voir également
Créer des relations entre les ressources
Démarrage rapide (mode SOAP) : créer des relations entre les ressources à l’aide de l’API Java.
Inclusion des fichiers de bibliothèque Java d’AEM Forms
Réglage des propriétés de la connexion
Créez des ressources de relation à l’aide de l’API Repository (Web Service) :
Inclure les fichiers du projet
Création du client de service
À l’aide de l’assemblage client Microsoft .NET, créez un objet RepositoryServiceService
en appelant son constructeur par défaut. Définissez sa propriété Credentials
à l’aide de l’objet System.Net.NetworkCredential
contenant le nom d’utilisateur et le mot de passe.
Spécification des URI des ressources à relier
Spécifiez les URI des ressources à relier. Dans ce cas, comme les ressources sont nommées testResource1
et testResource2
et se trouvent dans le dossier nommé testFolder
, leurs URI sont "/testFolder/testResource1"
et "/testFolder/testResource2"
. Lors de l’utilisation d’un langage conforme à Microsoft .NET Framework (C#, par exemple), les URI sont stockés sous la forme d’un objet System.String
. Dans cet exemple, les ressources sont d’abord écrites dans le référentiel et leurs URI sont récupérés. Pour plus d’informations sur l’écriture d’une ressource, voir Écriture de ressources.
Création de la relation
Appelez la méthode createRelationship
de l’objet RepositoryServiceService
et transmettez les paramètres suivants :
3
.boolean
indiquant si le type de relation a été spécifié. Dans cet exemple, la valeur true
est spécifiée.boolean
indiquant si la ressource cible est automatiquement mise à jour vers l’identificateur basé sur Id
de la nouvelle ressource HEAD. Dans cet exemple, en raison de la relation de dépendance, la valeur true
est spécifiée.boolean
indiquant si la cible HEAD a été spécifiée. Dans cet exemple, la valeur true
est spécifiée.null
pour le dernier paramètre.Vous pouvez également récupérer une liste des ressources associées pour une ressource donnée en appelant la méthode getRelated
de l’objet RepositoryServiceService
et en transmettant les paramètres suivants :
"/testFolder/testResource1"
) est spécifiée.boolean
indiquant si la ressource spécifiée est la ressource source dans la relation. Dans cet exemple, la valeur true
est spécifiée parce que c’est le cas.boolean
indiquant si la ressource source a été spécifiée. Dans cet exemple, la valeur true
est fournie.3
.null
pour les deux paramètres restants.La méthode getRelated
renvoie un tableau d’objets qui peuvent être convertis en objets Resource
par l’intermédiaire desquels vous pouvez effectuer une itération pour récupérer chacune des ressources associées. Dans cet exemple, testResource2
doit se trouver dans la liste des ressources renvoyées.
Voir également
Créer des relations entre les ressources
Appeler AEM Forms en utilisant le codage Base64
Vous pouvez verrouiller une ressource ou un ensemble de ressources pour une utilisation exclusive par un utilisateur particulier ou une utilisation partagée entre plusieurs utilisateurs. Un verrou partagé est une indication que quelque chose va se produire avec la ressource, mais cela n’empêche personne d’autre de prendre des mesures avec cette ressource. Un verrou partagé doit être considéré comme un mécanisme de signalisation. Un verrou exclusif signifie que l’utilisateur qui a verrouillé la ressource va la modifier. Le verrou garantit que personne d’autre ne peut le faire jusqu’à ce que l’utilisateur n’ait plus besoin d’accéder à la ressource et ait libéré le verrou. Si un administrateur de référentiel déverrouille une ressource, tous les verrous exclusifs et partagés de cette ressource sont automatiquement supprimés. Ce type d’action est destiné aux situations dans lesquelles un utilisateur n’est plus disponible et n’a pas déverrouillé la ressource.
Lorsqu’une ressource est verrouillée, une icône de verrouillage s’affiche lorsque vous affichez l’onglet Ressources situé dans Workbench, comme illustré ci-dessous.
Vous pouvez contrôler l’accès aux ressources par programmation à l’aide de l’API Java Repository Service ou de l’API Web Service.
Pour plus d’informations sur le service Forms, voir Références des services pour AEM Forms.
Pour verrouiller et déverrouiller des ressources, procédez comme suit :
Inclure les fichiers de projet
Incluez les fichiers nécessaires dans votre projet de développement. Si vous créez une application cliente à l’aide de Java, incluez les fichiers JAR nécessaires. Si vous utilisez des services web, incluez les fichiers proxy.
Création du client du service
Avant de pouvoir lire une ressource par programmation, vous devez établir une connexion et fournir des informations d’identification. Pour ce faire, créez un client de service.
Spécifier l’URI de la ressource à verrouiller
Créez une chaîne contenant l’URI de la ressource à verrouiller. La syntaxe comprend des barres obliques, comme dans cet exemple : « /path/resource ».
Verrouiller la ressource
Appelez la méthode du service Repository pour verrouiller la ressource, en spécifiant l’URI, le type et la profondeur de verrouillage.
Récupérer les verrous pour la ressource
Appelez la méthode du service Repository pour récupérer les verrous de la ressource, en spécifiant l’URI.
Déverrouiller la ressource
Appelez la méthode de service Repository pour déverrouiller la ressource, en spécifiant l’URI.
Voir également
Verrouiller les ressources à l’aide de l’API Java
Verrouiller les ressources à lʼaide de l’API de service web
Inclusion des fichiers de bibliothèque Java d’AEM Forms
Réglage des propriétés de la connexion
Démarrages rapides de l’API Repository Service
Verrouiller les ressources à l’aide de l’API du service Repository (Java) :
Inclure les fichiers du projet
Incluez les fichiers JAR client dans le chemin de classe de votre projet Java.
Création du client de service
Créez un objet ResourceRepositoryClient
en utilisant son constructeur et en transmettant un objet ServiceClientFactory
qui contient les propriétés de connexion.
Spécifiez l’URI de la ressource à verrouiller.
Spécifiez l’URI de la ressource à verrouiller. Dans ce cas, comme la ressource nommée testResource
se trouve dans le dossier du nom de testFolder
, son URI est "/testFolder/testResource"
. L’URI est stocké comme un objet java.lang.String
.
Verrouiller la ressource
Appelez la méthode lockResource
de l’objet ResourceRepositoryClient
et transmettez les paramètres suivants :
com.adobe.repository.infomodel.bean.Lock.SCOPE_EXCLUSIVE
.Lock.DEPTH_ZERO
.La version surchargée de la méthode lockResource
qui nécessite quatre paramètres renvoie une exception. Veillez à utiliser la méthode lockResource
qui nécessite trois paramètres, comme indiqué dans cette présentation.
Récupérer les verrouillages de la ressource
Appelez la méthode getLocks
de l’objet ResourceRepositoryClient
et transmettez l’URI de la ressource comme paramètre. La méthode renvoie une liste d’objets verrouillés par laquelle vous pouvez effectuer une itération. Dans cet exemple, le propriétaire, le niveau et la portée du verrouillage sont imprimés pour chaque objet en appelant les méthodes getOwnerUserId
, getDepth
et getType
de chaque objet verrouillé, respectivement.
Déverrouiller la ressource
Appelez la méthode unlockResource
de l’objet ResourceRepositoryClient
et transmettez l’URI de la ressource comme paramètre. Pour plus d’informations, consultez la section Référence de l’API AEM Forms.
Voir également
Démarrage rapide (mode SOAP) : verrouiller une ressource à l’aide de l’API Java
Inclusion des fichiers de bibliothèque Java d’AEM Forms
Réglage des propriétés de la connexion
Pour verrouiller les ressources à l’aide de l’API du service Repository (service web), procédez comme suit :
Inclure les fichiers du projet
Création du client de service
À l’aide de l’assemblage client Microsoft .NET, créez un objet RepositoryServiceService
en appelant son constructeur par défaut. Définissez sa propriété Credentials
en utilisant un objet System.Net.NetworkCredential
contenant le nom d’utilisateur et le mot de passe.
Spécifiez l’URI de la ressource à verrouiller.
Spécifiez une chaîne contenant l’URI de la ressource à verrouiller. Dans ce cas, comme la ressource nommée testResource
se trouve dans le dossier testFolder
, son URI est "/testFolder/testResource"
. Si vous utilisez un langage conforme à Microsoft .NET Framework (C#, par exemple), stockez l’URI dans un objet System.String
.
Verrouiller la ressource
Appelez la méthode lockResource
de l’objet RepositoryServiceService
et transmettez les paramètres suivants :
11
.2
.int
indiquant le nombre de secondes avant l’expiration du verrouillage. Dans cet exemple, la valeur de 1000
est utilisée.null
pour le dernier paramètre.Récupérer les verrouillages de la ressource
Appelez la méthode getLocks
de l’objet RepositoryServiceService
et transmettez l’URI de la ressource comme premier paramètre et null
comme deuxième paramètre. La méthode renvoie un tableau object
contenant des objets Lock
par lesquels vous pouvez effectuer une itération. Dans cet exemple, le propriétaire, la profondeur et la portée du verrou sont imprimés pour chaque objet en accédant à chaque ownerUserId
de l’objet Lock
, les champs depth
et type
, respectivement.
Déverrouiller la ressource
Appelez la méthode unlockResource
de l’objet RepositoryServiceService
et transmettez l’URI de la ressource comme premier paramètre et null
pour le deuxième paramètre.
Voir également
Appeler AEM Forms en utilisant le codage Base64
Vous pouvez supprimer des ressources par programmation d’un emplacement donné dans le référentiel à l’aide de l’API Java du service de référentiel (SOAP).
Lorsque vous supprimez une ressource, la suppression est en principe permanente, bien que, dans certains cas, les référentiels ECM puissent stocker les versions de la ressource en fonction de leurs mécanismes d’historique. Par conséquent, lors de la suppression d’une ressource, il est important de s’assurer que vous n’aurez plus besoin de cette dernière. La suppression d’une ressource est généralement motivée par la nécessité d’augmenter l’espace disponible dans la base de données. Vous pouvez supprimer une version d’une ressource, mais en le faisant, vous devez spécifier l’identificateur de la ressource, et non son identificateur logique (LID) ou son chemin d’accès. Si vous supprimez un dossier, tous éléments y contenus, notamment les sous-dossiers et les ressources, seront automatiquement supprimés.
Les ressources connexes ne sont pas supprimées. Par exemple, si un formulaire utilise le fichier logo.gif et que vous supprimez logo.gif, une relation est stockée dans le tableau de relation en attente. Alternativement, en ce qui concerne l’obsolescence de la version, définissez l’état de l’objet de la dernière version sur obsolète.
Une opération de suppression n’est pas compatible avec les transactions dans les systèmes ECM. Par exemple, si vous tentez de supprimer 100 ressources et que l’opération échoue sur la 50e ressource, les 49 premières instances seront supprimées, mais ce ne sera pas le cas pour le reste. Dans le cas contraire, le comportement par défaut est la restauration (non-engagement).
Lors de l’utilisation de la méthode com.adobe.repository.bindings.dsc.client.ResourceRepositoryClient.deleteResources()
avec le référentiel ECM (EMC Documentum Content Server et IBM FileNet P8 Content Manager), la transaction ne sera pas restaurée si la suppression échoue pour l’une des ressources spécifiées, ce qui signifie que les fichiers qui ont été supprimés ne peuvent pas être restaurés.
Pour plus d’informations sur le service Repository, voir Références des services pour AEM Forms.
Pour supprimer une ressource, procédez de la manière suivante :
Inclure des fichiers de projet
Incluez les fichiers nécessaires dans votre projet de développement. Si vous créez une application cliente à l’aide de Java, incluez les fichiers JAR nécessaires. Si vous utilisez des services web, incluez les fichiers proxy.
Création du client du service
Avant de pouvoir lire une ressource par programmation, vous devez établir une connexion et fournir des informations d’identification. Pour ce faire, créez un client de service.
Spécifier l’URI de la ressource à supprimer
Créez une chaîne contenant l’URI de la ressource à supprimer. La syntaxe comprend des barres obliques, comme dans l’exemple suivant : « /chemin/ressource ». Si la ressource à supprimer est un dossier, la suppression sera récursive.
Supprimer la ressource
Appelez la méthode du service Repository pour supprimer la ressource, en spécifiant l’URI.
Voir également
Supprimer des ressources à l’aide de l’API Java
Suppression des ressources à l’aide de l’API de service web
Inclusion des fichiers de bibliothèque Java d’AEM Forms
Réglage des propriétés de la connexion
Démarrages rapides de l’API Repository Service
Supprimez une ressource à l’aide de l’API de référentiel (Java) :
Inclure les fichiers du projet
Incluez les fichiers JAR client dans le chemin de classe de votre projet Java.
Création du client de service
Créez un objet ResourceRepositoryClient
en utilisant son constructeur et en transmettant un objet ServiceClientFactory
contenant des propriétés de connexion.
Spécification de l’URI de la ressource à supprimer
Spécifiez l’URI de la ressource à récupérer. Dans ce cas, puisque la ressource désignée par testResourceToBeDeleted se trouve dans le dossier nommé testFolder, son URI est /testFolder/testResourceToBeDeleted
. L’URI est stocké en tant qu’objet java.lang.String
. Dans cet exemple, la ressource est d’abord écrite dans le référentiel, puis son URI est récupéré. Pour plus d’informations sur l’écriture d’une ressource, voir Écriture de ressources.
Suppression de la ressource
Appelez la méthode deleteResource
de l’objet ResourceRepositoryClient
et transmettez l’URI de la ressource en tant que paramètre.
Voir également
Démarrage rapide (mode SOAP) : rechercher des ressources à l’aide de l’API Java
Inclusion des fichiers de bibliothèque Java d’AEM Forms
Réglage des propriétés de la connexion
Pour supprimer une ressource en utilisant l’API Repository (service web), procédez comme suit :
Inclure les fichiers du projet
Création du client de service
À l’aide de l’assemblage client Microsoft .NET, créez un objet RepositoryServiceService
en appelant son constructeur par défaut. Définissez sa propriété Credentials
en utilisant un objet System.Net.NetworkCredential
contenant le nom dʼutilisateur et le mot de passe.
Spécification de l’URI de la ressource à supprimer
Spécifiez l’URI de la ressource à récupérer. Dans ce cas, comme la ressource nommée testResourceToBeDeleted
se trouve dans le dossier testFolder
, son URI est "/testFolder/testResourceToBeDeleted"
. Dans cet exemple, la ressource est d’abord écrite dans le référentiel, puis son URI est récupéré. Pour plus d’informations sur l’écriture d’une ressource, voir Écriture de ressources.
Suppression de la ressource
Appelez la méthode deleteResources
de lʼobjet RepositoryServiceService
et transmettez un tableau System.String
contenant lʼURI de la ressource comme premier paramètre. Transmettez null
pour le deuxième paramètre.
Voir également
Appeler AEM Forms en utilisant le codage Base64