Bien démarrer avec Adobe Connect Web Services

Rechercher
Connect

Connect

Ouvrir l’application

Apprendre les concepts clés et les bases pour bien démarrer avec les API Adobe Connect Web Service.

Pour bien démarrer avec Adobe Connect Web Service, vous devez comprendre trois concepts clés :

  • Principals, qui sont des utilisateurs et des groupes

  • Les SCO (Shareable Content Objects) représentent des réunions, cours et contenu pouvant être créés sur Adobe Connect. Les SCO (prononcé sko, qui rime avec snow) sont compatibles avec la norme standard de l’industrie Shareable Content Object Reference Model (SCORM) et peuvent être utilisés avec un Learning Management System (LMS).

  • Autorisations, qui définissent comment les principals agissent sur les objets

Ce chapitre décrit les tâches de base que vous pouvez effectuer avec Web Services, sans tenir compte des applications Adobe Connect pour les lesquells vous avez une licence. Plusieurs tâches sont décrites comme si vous les exécutiez dans un navigateur. Si vous souhaitez appeler à partir d'un application, traduisez la requête XML vers le langage dans lequel vous travaillez (poir voir comment faire cela en Java™, consultez Envoyer des requêtes XML).

Rechercher un principal-id

Un principal est un utilisateur ou un groupe possédant des autorisations précises pour interagir avec un SCO sur le serveur. Vous pouvez créer des utilisateurs et des groupes pour votre entreprise et modifier leurs autorisations.

Adobe Connect possède également des groupes prédéfinis : Administrateurs, Administrateurs limités, Auteurs, Gestionnaires de formation, Gestionnaires d’événements, Élèves, Hôtes de réunion, et Hôtes de séminaire. Vous pouvez ajouter des utilisateurs et des groupes à des groupes prédéfinis, mais vous ne pouvez pas modifier les autorisations des groupes prédéfinis.

Remarque :

Les groupes prédéfinis disponibles dépendent de votre compte.

Chaque utilisateur et groupe Adobe Connect possède un principal-id. Dans d’autres appels API, le principal-id est appelé group-id ou user-id pour le distinguer d’autres valeurs. La valeur de l’ID qui identifie un utilisateur ou un groupe est toujours la même, peu importe son nom.

Obtenir le principal-id d’un utilisateur ou d’un groupe

  1. Appelez principal-list avec un filtre :

     https://example.com/api/xml?action=principal-list&filter-name=jazz doe

    Il est conseillé d’utiliser filter-name, filter-login, ou filter-email pour une correspondance exacte. Faites attention à filter-like-name, il peut affecter la performance du serveur.

  2. Analysez les éléments principaldans la réponse pour chercher le principal-id :

     <principal principal-id=&quot;2006282569&quot; account-id=&quot;624520&quot; type=&quot;user&quot; 
         has-children=&quot;false&quot; is-primary=&quot;false&quot; is-hidden=&quot;false&quot;> 
     <name>jazz doe</name>  
     <login>jazzdoe@example.com</login>  
     <email>jazzdoe@newcompany.com</email>  
 </principal>

Obtenir le principal-id de l’utilisateur actuel

  1. Appelez common-info après la connexion de l’utilisateur  :

     https://example.com/api/xml?action=common-info

  2. Analysez les éléments utilisateur dans la réponse pour chercher l’user-id :

     <user user-id=&quot;2007124930&quot; type=&quot;user&quot;> 
         <name>jazz doe</name>  
         <login>jazz@doe.com</login>  
 </user>

    Ici le principal-id est appelé user-id, car il représente toujours un utilisateur authentifié par Adobe Connect. Un groupe ne peut pas se connecter au serveur. Vous pouvez passer la valeur user-id comme principal-id dans d’autres actions.

Liste des principals ou des invités

Un principal avec un type d’utilisateur est un utilisateur Adobe Connect enregistré, tandis q’un utilisateur avec un type d’invité rentre dans une salle de réunion en tant qu’invité. Le serveur capture des informations sur l’invité et lui donne un principal-id.

Lister tous les principals sur le serveur

  1. Appelez principal-list sans paramètres :

     https://example.com/api/xml?action=principal-list

    Cet appel retourne tous les utilisateurs Adobe Connect , préparez-vous à avoir une grande réponse.

  2. Analyser les éléments principal dans la réponse pour rechercher les valeurs souhaitées :

     <principal principal-id=&quot;2006282569&quot; account-id=&quot;624520&quot; type=&quot;user&quot; 
         has-children=&quot;false&quot; is-primary=&quot;false&quot; is-hidden=&quot;false&quot;> 
     <name>jazz doe</name>  
     <login>jazzdoe@example.com</login>  
     <email>jazzdoe@newcompany.com</email>  
 </principal>

Lister tous les invités sur le serveur

  1. Appelez report-bulk-users, en filtrant pour un type d’invité :

     https://example.com/api/xml?action=report-bulk-users&filter-type=guest

  2. Analysez les éléments row dans la réponse :

     <row principal-id=&quot;51157227&quot;> 
     <login>joy@acme.com</login>  
     <name>joy@acme.com</name>  
     <email>joy@acme.com</email>  
     <type>guest</type>  
 </row>

Lister tous les utilisateurs qui font un rapport à un gestionnaire spécifique

Lorsque vous appelez principal-info avec un principal-id, la réponse affiche le principal. Si le principal est un utilisateur avec un gestionnaire affecté dans Adobe Connect, la réponse montre également des données sur le gestionnaire du principal dans élément gestionnaire :

 <manager account-id=&quot;624520&quot; disabled=&quot;&quot; has-children=&quot;false&quot; is-hidden=&quot;false&quot; is-primary=&quot;false&quot; principal-id=&quot;2006282569&quot;        type=&quot;user&quot;> 
     <ext-login>jazzdoe@example.com</ext-login>  
     <login>jazzdoe@example.com</login>  
     <name>jazz doe</name>  
     <email>joy@example.com</email>  
     <first-name>jazz</first-name>  
     <last-name>doe</last-name>  
     <x-2006293620>23456</x-2006293620>  
     <x-2007017651>chicago</x-2007017651>  
 </manager>

Vous pouvez utiliser le principal-id du gestionnaire avec la principal-list pour lister tous les utilisateurs affectés au gestionnaire.

  1. Appelez principal-list, en filtrant sur manager-id :

     https://example.com/api/xml?action=principal-list    &filter-manager-id=2006282569

  2. Analysez la réponse pour chercher les éléments principal :

     <principal principal-id=&quot;2006258745&quot; account-id=&quot;624520&quot; type=&quot;user&quot; has-children=&quot;false&quot; is-primary=&quot;false&quot; is-hidden=&quot;false&quot; manager-id=&quot;2006282569&quot;> 
     <name>Pat Lee</name>  
     <login>plee@mycompany.com</login>  
     <email>plee@mycompany.com</email>  
 </principal>

Création d’un utilisateur

Pour créer un nouvel utilisateur, vous devez avoir les privilèges Administrateur. Adobe vous conseille de créer un utilisateur appartenant au groupe administrateurs pour votre application à utiliser pour réaliser des appels API nécéssitant un privilège Administrateur .

Créez un nouvel utilisateur et envoyez un e-mail de bienvenue

  1. Dans votre application, connectez-vous en tant qu’utilisateur Administrateur.

    Consultez Se connecter à partir d’une application pour voir différentes façons de se connecter.

  2. Appelez principal-update avec au moins les paramètres suivants :

     https://example.com/api/xml?action=principal-update 
         &first-name=jazz&last-name=doe&login=jazz99@doe.com&password=hello 
         &type=user&send-email=true&has-children=0&email=jazz99@doe.com

    Le type doit être user, has-children doit être 0 oufalse, send-email doit être true, et email doit avoir une adresse e-mail valide.

    Le serveur envoie un e-mail de bienvenue avec les informations de connexion à l’adresse e-mail de l’utilisateur.

  3. Analysez l’élément principal dans la réponse pour chercher le principal-id de l'utilisateur :

     <principal type=&quot;user&quot; principal-id=&quot;2007184341&quot; has-children=&quot;0&quot; 
         account-id=&quot;624520&quot;> 
     <login>jammdoe@example.com</login>  
     <ext-login>jammdoe@example.com</ext-login>  
     <name>jamm doe</name>  
 </principal>

Créez un nouvel utilisateur sans utiliser d’adresse e-mail comme ID de connexion

  1. Dans Adobe Connect Central, accédez à Administration > Utilisateurs et groupes > Modifier les stratégies de connexion et de mots de passe. Assurez-vous que Utiliser l’adresse e-mail comme connexion est bien paramétré sur Non.

  2. Dans votre application, connectez-vous en tant qu’utilisateur Administrateur.

  3. Appelez principal-update pour créer un nouveau utilisateur, en passant les paramètres login et email :

     https://example.com/api/xml?action=principal-update&first-name=jazz 
     &last-name=doe&login=jazz&email=jazzdoe@company.com 
     &password=nothing&type=user&has-children=0

  4. Analysez la réponse pour chercher le principal-id du nouvel utilisateur :

     <principal type=&quot;user&quot; principal-id=&quot;2007184341&quot; has-children=&quot;0&quot; 
             account-id=&quot;624520&quot;> 
     <login>jazzdoe@example.com</login>  
     <ext-login>jazzdoe@example.com</ext-login>  
     <name>jazz doe</name>  
 </principal>

    Dans la réponse, ext-login a la meêm valeur que login par défaut, jusqu’à ce que l’utilisateur réussisse à se connecter en utilisant l’authentification externe (voir Se connecter en utilisant l’authentification des en-têtes HTTP).

Mettre à jours les utilisateurs

Après avoir créé des utilisateurs, vous devez régulièrement mettre leurs informations à jour. Vours pouvez mettre à jour les champs standard qu’Adobe Connect définit pour les utilisateurs en appelant principal-update avec leprincipal-id de l’utilisateur. Le champ standard comprend email, login, first-name, et last-name.

Si vous avez défini des champs personnalisés pour le principal, utilisez acl-field-update pour les mettre à jour.

Vous avez besoin des privilèges Administrateurs pour mettre à jours des utilisateurs, votre application doit donc d’abord se connecter en tant qu’utilisateur au groupe admins. Vous pouvez vous connecter en tant que l’utilisateur en question, puis demander au l’utilisateur de mettre à jour son profil.

Mettre à jour les informations utilisateur standard

  1. Connectez-vous en tant qu’utilisateur Administrateur.

  2. Appelez principal-list avec un filtre pour obtenir le principal-id de l’utilisateur (voir Trouver un principal-id).

  3. Appelez principal-update pour mettre à jour l’utilisateur :

     https://example.com/api/xml?action=principal-update 
     &principal-id=2006282569&email=jazzdoe@newcompany.com

  4. Analyser la réponse pour chercher le code de statut ok.

Mettre à jour les valeurs de champ personnalisé pour un utilisateur

  1. Connectez-vous en tant qu’utilisateur Administrateur .

  2. Appelez custom-fields pour obtenir le field-id du champ de personnalisation :

     https://example.com/api/xml?action=custom-fields

  3. Obtenez le principal-id, sco-id, ou account-id que vous souhaitez mettre à jour.

    Cette valeur est l’acl-id que vous passez à acl-field-update.

  4. Appelez acl-field-update pour mettre à jour la valeur du champ de personnalisation :

     https://example.com/api/xml?action=acl-field-update&field-id=x-2007396975&acl-id=2006258745&value=44444

Création de champs personnalisés

Les champs personnalisés sont des champs de données supplémentaires que vous définissez. Vous pouvez définir jusquà huit champs personnalisés sur un principal ou un SCO en utilisant custom-field-update.

Après avoir défini le champ personnalisé, par défaut vour pouvez paramétrer sa valeur soit en modifiant la valeur dans Adobe Connect Central, soit en appelant custom-field-update.

Pour préciser que la valeur ne peut être mise à jour qu’avec l’API, appelez custom-field-update avec le paramètre object-type=object-type-read-only.

Définissez un champ personnalisé et attribuez-le à un utilisateur

  1. Tout d’abord, créez le champ avec custom-field-update : 

     https://example.com/api/xml?action=custom-field-update 
     &object-type=object-type-principal&permission-id=manage 
     &account-id=624520&name=Location&comments=adobe%20location 
     &field-type=text&is-required=true&is-primary=false&display-seq=9

    Le champ name definie le champ nom tel que l’affiche votre application, utilisez la bonne orthographe et les bonnes majuscules. Le champ personnalisé dans cet exemple est défini pour tous les principals Adobe Connect.

  2. Analysez l’élément field dans la réponse pour chercher le field-id :

     <field field-id=&quot;2007184366&quot; object-type=&quot;object-type-principal&quot; 
         display-seq=&quot;9&quot; account-id=&quot;624520&quot; is-primary=&quot;false&quot;  
         permission-id=&quot;manage&quot; is-required=&quot;true&quot; field-type=&quot;text&quot;> 
 <comments>test</comments>  
 <name>Country</name>  
 </field>

  3. Obtenez le principal-id de l’utilisateur (voir Rechercher un principal-id).

  4. Appelez acl-field-update pour configurer la valeur du champ, en passant un field-id,leprincipal-id de l’utilisateur comme un acl-id, et une valeur :

     https://example.com/api/xml?action=acl-field-update 
     &acl-id=2006258745&field-id=2007017474&value=San%20Francisco

  5. Analyser la réponse pour chercher le code de statut ok.

Créer des groupes

Pour ajouter des utilisateurs dans des groupes, vous devez appeler principal-update en tant qu’ utilisateur Administrateur de votre application.

Ajouter un utilisateur au groupe

  1. Se connecter en tant qu’utilisateur Administrateur de votre application.

  2. (Facultatif) Si un utilisateur n’dxiste pas, créez-le avec principal-update.

     https://example.com/api/xml?action=principal-update 
     &first-name=jazzwayjazz&last-name=doe&login=jazz@doe.com 
     &password=nothing&type=user&has-children=0

  3. (Facultatif) Analysez la réponse pour le principal-id du nouvel utilisateur.

  4. Si l’utilisateur existe déjà, appelez principal-list pour obtenir le principal-id de l’utilisateur  :

     https://example.com/api/xml?action=principal-list&filter-type=user

  5. Analysez la réponse pour chercher le principal-id :

     <principal principal-id=&quot;5611980&quot; account-id=&quot;624520&quot; type=&quot;user&quot;  
         has-children=&quot;false&quot; is-primary=&quot;false&quot; is-hidden=&quot;false&quot;> 
     <name>Joy Black</name>  
     <login>joy@acme.com</login>  
     <email>joy@acme.com</email>  
 </principal>

  6. Appelez principal-list de nouveau pour obtenir leprincipal-id du groupe :

     https://example.com/api/xml?action=principal-list&filter-type=group

  7. Appelez group-membership-update avec is-member=true pour ajouter l’utilisateur au groupe :

     https://example.com/api/xml?action=group-membership-update 
     &group-id=4930296&principal-id=2006258745&is-member=true

    • Le principal-id est le principal-id de l’utilisateur.

    • Le group-id est le principal-id du groupe.

    • Le paramètre is-member doit être true.

Vérifiez si un utilisateur spécifique fait partie d’un groupe

  1. Appelez principal-list avec un group-id, filter-is-member, et un filtre qui identifie le principale :

     https://example.com/api/xml?action=principal-list&group-id=624523 
         &filter-is-member=true&filter-like-name=bob

  2. Analysez un élément principal dans la réponse. Une réponse réussie ressemble à ceci :

     <principal-list> 
     <principal principal-id=&quot;624660&quot; account-id=&quot;624520&quot; type=&quot;user&quot;  
             has-children=&quot;false&quot; is-primary=&quot;false&quot; is-hidden=&quot;false&quot;> 
         <name>Bill Jones</name>  
         <login>bjones@acme.com</login>  
         <email>bjones@acme.com</email>  
         <is-member>true</is-member>  
     </principal> 
 </principal-list>

    Si l’utilisateut n’est pas membre d’un groupe, l’élément principal-list est vide :

     <?xml version=&quot;1.0&quot; encoding=&quot;utf-8&quot; ?>  
 <results> 
     <status code=&quot;ok&quot; />  
     <principal-list />  
 </results>

Vérifiez quels utilisateurs font partie d’un groupe.

  1. Pour obtenir leprincipal-id du groupe, appelez principal-list avec des filtres :

     https://example.com/api/xml?action=principal-list&filter-type=group 
         &filter-name=developers

    Avec filter-type et filter-name, principal-list devrait retourner une correspondance unique.

  2. Analysez la réponse pour chercher le principal-id :

     <principal principal-id=&quot;2007105030&quot; account-id=&quot;624520&quot;  
         type=&quot;group&quot; has-children=&quot;true&quot; is-primary=&quot;false&quot;  
         is-hidden=&quot;false&quot;> 
     <name>developers</name>  
     <login>developers</login>  
     <is-member>false</is-member>  
 </principal>

  3. Appelez de nouveau principal-list, avec le principal-id en tant que group-id et filter-is-member=true :

     https://example.com/api/xml?action=principal-list&group-id=2007105030 
         &filter-is-member=true

  4. Analysez la réponse pour chercher les éléments principal :

     <principal principal-id=&quot;5698354&quot; account-id=&quot;624520&quot; type=&quot;group&quot;  
             has-children=&quot;true&quot; is-primary=&quot;false&quot; is-hidden=&quot;false&quot;> 
     <name>Bob Jones</name>  
     <login>bobjones@acme.com</login>  
     <is-member>true</is-member>  
 </principal>

Lister tous les groupes auxquels appartient un utilisateur

  1. Appelez principal-list avec le principal-id de l'utilisateur et filter-is-member=true :

     https://example.com/api/xml?action=principal-list 
     &principal-id=2006258745&filter-is-member=true

  2. Analysez la réponse pour chercher les éléments principal :

     <principal principal-id=&quot;5698354&quot; account-id=&quot;624520&quot; type=&quot;group&quot;  
             has-children=&quot;true&quot; is-primary=&quot;false&quot; is-hidden=&quot;false&quot;> 
     <name>Bob Jones</name>  
     <login>bobjones@acme.com</login>  
     <is-member>true</is-member>  
 </principal>

Rechercher des SCO

Tous les objects sur Adobe Connect sont des Objets de contenu partageable, ou SCO. Le mot Partageable vient des systèmes de gestion de la formation dans lesquels le contenu est transformé en cours ou en programmes et partagé entre eux.

Sur le serveur, un SCO peut être tout type d’objet combiné avec d’autres objets de contenu dans un cours ou un programme. Cours, programmes, présentations, et autres types de contenu sont des SCO. Les réunion, événements, dossiers, arborescences, liens, fichiers graphiques, ou tout autre objet sont également des SCO.

Chaque SCO possède un identificateur entier unique appelé sco-id. Le sco-id est unique dans l’ensemble du serveur. Sur un compte hébergé Adobe Connect, le sco-id est unique pour tous les comptes.

Chaque SCO a également un type, tel quecontenu, cours, réunion, etc. Vous pouvez voir les valeurs sco-id et type dans la réponse des actions sco-info et autres :

 <sco account-id=&quot;624520&quot; disabled=&quot;&quot; display-seq=&quot;0&quot; folder-id=&quot;2006258747&quot; 
         icon=&quot;producer&quot; lang=&quot;en&quot; max-retries=&quot;&quot; sco-id=&quot;2006334909&quot; 
         source-sco-id=&quot;&quot; type=&quot;content&quot; version=&quot;1&quot;>

Caractéristiques des SCO

Lorsque vous étudiez les réponses XML de différents appels, vous remarquez plus de caractéristiques des SCO :

  • Un identifiant SCO est appelé sco-id dans certaines actions, mais il peu également être appelé folder-id, acl-id, ou un autre nom dans d’autres actions. C’est le même ID unique.

  • Chaque SCO peut être accédé par plusieurs principals, soit des utilisateurs, soit des groupes. Les principals spécifiques ayant accès à un SCO sont définis dans des listes de contrôle d’accès, ou ACL (access control lists).

  • Chaque SCO possède un URL unique (par exemple http://example.com) et un chemin URL (par exemple /f2006123456/). Vous pouvez les concaténer pour former l’URL complète qui accède au SCO.

  • Chaque SCO possède un chemin de navigation qui décrit où il se situe dans la hiérarchie de dossier.

  • Chaque SCO possède une autorisation définie pour chaque principal qui peut y accéder.

  • Certains SCO ont des champs de description, des chaînes de texte vous donnant des informations sur le SCO.

Vous devez souvent rechercher l’ID d’un SCO ou des informations sur le SCO. Les SCO sont rangés dans une hiérarchie de dossiers spécifique où les dossiers ont des noms indiquant s’ils sont au niveau supérieurs, s’ils contiennent du contenu ou des modèles partagés, ou s’ils conservent du contenu et des modèles utilisateur.

Lorsque vous appelez sco-shortcuts, cela renvoie une liste de dossiers. Remarquez que les dossiers possèdent des types différents :

 <?xml version=&quot;1.0&quot; encoding=&quot;utf-8&quot; ?>  
 <results> 
     <status code=&quot;ok&quot; />  
     <shortcuts> 
         <sco tree-id=&quot;624530&quot; sco-id=&quot;2006258751&quot; type=&quot;my-meeting-templates&quot;> 
             <domain-name>http://example.com</domain-name>  
         </sco> 
         <sco tree-id=&quot;624530&quot; sco-id=&quot;2006258750&quot; type=&quot;my-meetings&quot;> 
             <domain-name>http://example.com</domain-name>  
         </sco> 
         <sco tree-id=&quot;624529&quot; sco-id=&quot;624529&quot; type=&quot;meetings&quot;> 
             <domain-name>http://example.com</domain-name>  
         </sco> 
         <sco tree-id=&quot;624530&quot; sco-id=&quot;624530&quot; type=&quot;user-meetings&quot;> 
             <domain-name>http://example.com</domain-name>  
         </sco> 
         ... 
     </shortcuts> 
 </results>

Les dossiers montrés dans cet exemple sont pour des réunions, mais des dossiers de types différents de SCO ont un schéma semblable. Chaque type de dossier contient certains types d’objets, avec certains privilèges d’accès , comme suit :

contenu, cours, réunions, événements, séminaires

Ce sont des dossiers partagés, comme par exemple Réunions partagées, Formation partagée, etc. L’administrateur Adobe Connect a accès à ce dossier. L’Administrateur peut donner une autorisation de gestion à tout utilisateur, mais uniquement des membres du groupe prédéfini associé au dossier peuvent y créer de nouveau contenu et de nouvelles réunions.

user-content, user-meetings, user-courses, user-events

Ces dossiers peuvent contenir un dossier pour chaque utilisateut pouvant y créer du contenu (par exemple, un dossier pour chaque hôte de réunion ou développeur de formation).

my-courses, my-events, my-meetings, my-meeting-templates, my-content

Les utilisateurs créent leur propre contenu dans ces dossiers et ont l’autorisation de gestion sur ce contenu. Par exemple, des hôtes de réunion créent des réunion dans leur dossier my-meetings et ont une autorisation de Gestion pour ces réunions.

shared-meeting-templates

Ce dossier se trouve dans le dossier Réunions paratgées, il contient les modèles de réunion et hérite des autorisations de Réunions partagées.

Vous pouvez faire la liste des contenus de n’importe quel dossier pour obtenir des informations sur un SCO spécifique. Lorsque vous devez chercher un SCO mais que vous ne possédez pas de sco-id, naviguez dans les dossiers à l’aide de sco-shortcuts et sco-expanded-contents. N’utilisez pas sco-search, il ne retourne qu’un certain type de SCO.

Rechercher un SCO lorsque vous ne connaissez pas le sco-id

  1. Appelez sco-shortcuts pour obtenir une liste de dossiers racine sur Adobe Connect :

     https://example.com/api/xml?action=sco-shortcuts

  2. Analyser la réponse pour chercher un type du dossier racine qui contient logiquement le SCO, par exemple, my-courses pour un cours créé par l’utilisateur.

  3. Analysez l’élément sco ontenu pour trouver un sco-id :

     <sco tree-id=&quot;4930295&quot; sco-id=&quot;2006258748&quot; type=&quot;my-courses&quot;> 
     <domain-name>http://example.com</domain-name>  
 </sco>

  4. Créez un appel pour sco-expanded-contents afin de lister les contenus d’un dossier, en ajoutant un filtre de correspondance exacte, si possible :

     https://example.com/api/xml?action=sco-expanded-contents 
     &sco-id=2006258748&filter-name=All About Web Communities

    Vous avez plusieurs choix de filtres :

    • Un filtre de correspondanc exacte sur name ou url-path (comme filter-name ou filter-url-path), si vous connaissez le nom ou l’URL du SCO.

    • Un filtre de date supérieur à inférieur à (filter-gt-date ou filter-lt-date) sur date-begin, date-created, ou date-modified, si vous connaissez une de ces dates.

    • Un filtre de nom partiel (comme filter-like-name), si vous ne connaissez pas le nom SCO exact. Cependant, l’utilisation de ce filtre peut avoir un impact sur la performance du système.

  5. Analysez la réponse pour chercher le sco-id :

     <sco depth=&quot;1&quot; sco-id=&quot;2006745671&quot; folder-id=&quot;2006258748&quot; type=&quot;folder&quot; 
         icon=&quot;folder&quot; lang=&quot;en&quot; source-sco-id=&quot;2006745669&quot; display-seq=&quot;0&quot; 
         source-sco-type=&quot;14&quot;> 
     <name>A Day in the Life Resources</name>  
     <url-path>/f28435879/</url-path>  
     <date-created>2006-06-12T14:47:59.903-07:00</date-created>  
     <date-modified>2006-06-12T14:47:59.903-07:00</date-modified>  
 </sco>

Obtenir des informations sur un SCO

  1. Appelez sco-info avec le sco-id :

     https://example.com/api/xml?action=sco-info&sco-id=2006745669

  2. Analysez la réponse pour chercher name, url-path, ou tout autre valeur :

     <sco account-id=&quot;624520&quot; disabled=&quot;&quot; display-seq=&quot;0&quot;  
         folder-id=&quot;2006258748&quot; icon=&quot;curriculum&quot; lang=&quot;en&quot; max-retries=&quot;&quot; 
         sco-id=&quot;2006745669&quot; source-sco-id=&quot;&quot; type=&quot;curriculum&quot; version=&quot;0&quot;> 
     <date-begin>2006-06-12T14:45:00.000-07:00</date-begin>  
     <date-created>2006-06-12T14:47:59.903-07:00</date-created>  
     <date-modified>2006-06-12T14:47:59.903-07:00</date-modified>  
     <name>A Day in the Life</name>  
     <url-path>/day/</url-path>  
 </sco>

Contruisez l’URL d’un SCO

  1. Appelez sco-shortcuts :

     https://example.com/api/xml?action=sco-shortcuts

  2. Analysez la réponse pour chercher la valeur domain-name dans n’importe quel élément sco :

     <sco tree-id=&quot;624530&quot; sco-id=&quot;2006258750&quot; type=&quot;my-meetings&quot;> 
     <domain-name>http://example.com</domain-name>  
 </sco>

  3. Appelez sco-info avec le sco-id :

     https://example.com/api/xml?action=sco-info&sco-id=2006334909

  4. Analysez la réponse pour chercher le url-path :

     <sco account-id=&quot;624520&quot; disabled=&quot;&quot; display-seq=&quot;0&quot;  
         folder-id=&quot;2006258747&quot; icon=&quot;producer&quot; lang=&quot;en&quot;  
         max-retries=&quot;&quot; sco-id=&quot;2006334909&quot; source-sco-id=&quot;&quot;  
         type=&quot;content&quot; version=&quot;1&quot;> 
     <date-created>2006-05-11T12:00:02.000-07:00</date-created>  
     <date-modified>2006-05-16T15:22:25.703-07:00</date-modified>  
     <name>Test Quiz</name>  
     <url-path>/quiz/</url-path>  
     <passing-score>10</passing-score>  
     <duration>15100.0</duration>  
     <section-count>6</section-count>  
 </sco>

    Le url-path possède une barre oblique initiale et finale. Vous pouvez récupérer l’url-path à partir de report-my-meetings, report-my-training, ou tout autre appel qui le retourne.

  5. Concaténez url-path avec domain-name :

     http://example.com/f2006258748/

Téléchargement de fichiers

Vous pouvez télécharger des fichiers zip à partir d’Adobe Connect vers l’ordinateur local d’un utilisateur. Un fichier zip est un SCO. Pour le télécharger, vous devez contruire une URL de téléchargement pour le fichier zip, qui ressemble à ceci :

 http://server-domain/url-path/output/url-path.zip?download=zip

Vous connaissez déjà probablement le nom de domaine de votre serveur (tel que example.com). Si ce n’est pas le cas, vous pouvez l’obtenir en appelant sco-shortcuts.

Téléchargez un fichier zip à partir du serveur

  1. Appelez sco-shortcuts :

     https://example.com/api/xml?action=sco-shortcuts

  2. Extraiyez une valeur domain-name de la réponse :

     http://example.com

  3. Appelez sco-info avec le sco-id du fichier zip :

     https://example.com/api/xml?action=sco-info&sco-id=2006258747

    Le SCO est le fichier zip complet.

  4. Analysez la réponse pour chercher l’élément url-path :

     <sco account-id=&quot;624520&quot; disabled=&quot;&quot; display-seq=&quot;0&quot; folder-id=&quot;624522&quot; 
         icon=&quot;folder&quot; lang=&quot;en&quot; max-retries=&quot;&quot; sco-id=&quot;2006258747&quot;  
         source-sco-id=&quot;&quot; type=&quot;folder&quot; version=&quot;1&quot;> 
     <date-created>2006-04-18T10:21:47.020-07:00</date-created>  
     <date-modified>2006-04-18T10:21:47.020-07:00</date-modified>  
     <name>joy@acme.com</name>  
     <url-path>/f124567890/</url-path>  
 </sco>

  5. Contruisez une URL de téléchargement, par exemple :

     https://example.com/quiz/output/quiz.zip?download=zip

    Assurez-vous de supprimer la barre oblique de la valeur url-path avant d’y ajouter .zip (donc si vous avez une valeur /quiz.zip, ne saisissez pas /quiz/.zip).

Vérification des autorisations

Les autorisations définissent les façons d’interagir d’un principal avec un SCO.

Le mappage d’autorisations, indiquant les autorisations d’un principal pour un SCO en particulier, est appelé liste de contrôle d’accès ou ACL. Un ACL comporte trois informations :

  • L’ID d’un principal (un principal-id).

  • L’ID d’un SCO, compte, ou principal. Dans les appels d’autorisation, cela s’appelle acl-id. Dans d’autres appels, l’ID peut être appelé sco-id, account-id, ou principal-id.

  • Un mot-clé indiquant le niveau d’autorisation du principal , qui est l'une des valeurs valides dans permission-id.

Vérifiez que l’autorisation d’un principal sur un SCO

  1. Appelez permissions-info avec un acl-id et un principal-id :

     https://example.com/api/xml?action=permissions-info&acl-id=2006334909 
     &principal-id=2006258745

    Pour vérifier les autorisations d’un SCO, le acl-id est un sco-id. L’acl-id peut aussi être un principal-id ou un account-id.

  2. Analyser la réponse pour chercher un permission-id :

     <?xml version=&quot;1.0&quot; encoding=&quot;utf-8&quot; ?>  
 <results> 
     <status code=&quot;ok&quot; />  
     <permission acl-id=&quot;2007035246&quot; permission-id=&quot;view&quot;  
             principal-id=&quot;2006258745&quot; />  
 </results>

    Si un principal ne possède pas d’ autorisation explicite pour accéder au SCO (en d’autres termes, sipermission-id=""), l’autorisation du principal sur l’objet parent du SCO s’applique.

Vérifiez toutes les autorisations des principaux sur un SCO

  1. Appelez permissions-info avec un acl-id, mais pas un principal-id :

     https://example.com/api/xml?action=permissions-info&acl-id=2006293572

  2. Parcourez les éléments principal et analysez-les pour trouver des valeurs permission-id :

     <principal principal-id=&quot;2596608&quot; is-primary=&quot;false&quot; type=&quot;user&quot;  
                 has-children=&quot;false&quot; permission-id=&quot;view&quot;> 
         <name>Jay Arnold</name>  
         <login>jay@example.com</login>  
 </principal>

    Les valeurs d’autorisations valides sont listées dans permission-id.

 Adobe

Recevez de l’aide plus rapidement et plus facilement

Nouvel utilisateur ?

Liens rapides

Voir toutes vos formules Gérer vos formules
Afficher les liens rapides
Masquer les liens rapides
Adobe MAX 2024

Adobe MAX
La conférence sur la créativité

Du 14 au 16 octobre à Miami Beach et en ligne

S’inscrire

Adobe MAX

La conférence sur la créativité

Du 14 au 16 octobre à Miami Beach et en ligne

S’inscrire
Adobe MAX 2024

Adobe MAX
La conférence sur la créativité

Du 14 au 16 octobre à Miami Beach et en ligne

S’inscrire

Adobe MAX

La conférence sur la créativité

Du 14 au 16 octobre à Miami Beach et en ligne

S’inscrire

Mentions légales    |    Politique de confidentialité en ligne