Introducción a los servicios web de Adobe Connect

Conozca los conceptos clave y conozca los conceptos básicos para empezar a usar las API de servicios web de Adobe Connect.

Para comenzar a utilizar los servicios web de Adobe Connect, debe comprender tres conceptos clave:

  • Principales, que son usuarios y grupos

  • SCO, que son objetos de contenido que se pueden compartir y representan reuniones, cursos y prácticamente cualquier contenido que se pueda crear en Adobe Connect. SCO (pronunciado sko, que rima con snow que es «nieve» en inglés) son compatibles con la especificación estándar del modelo de referencia de objetos de contenido compartibles (SCORM) y se pueden utilizar con un sistema de gestión de aprendizaje (LMS).

  • Permisos, que definen cómo pueden actuar los principales en los objetos

En este capítulo se describen las tareas básicas que puede realizar con los servicios web, independientemente de las aplicaciones de Adobe Connect cuya licencia haya adquirido. Muchas tareas se describen como si las estuviera ejecutando en un explorador. Si desea realizar la llamada desde una aplicación, traduzca la solicitud XML al idioma en el que esté trabajando (para ver un ejemplo de cómo hacerlo en Java™, consulte Enviar solicitudes XML).

Buscar un principal-id

Un principal es un usuario o grupo que tiene un permiso definido para interactuar con un SCO en el servidor. Puede crear usuarios y grupos para su organización y modificar sus permisos.

Adobe Connect también tiene grupos integrados: Administradores, Administradores limitados, Autores, Responsables de formación, Responsables de eventos, Alumnos, Anfitriones de reuniones y Anfitriones de seminarios. Puede agregar usuarios y grupos a grupos integrados, pero no puede modificar los permisos de los grupos integrados.

Nota:

Los grupos integrados disponibles dependen de su cuenta.

Cada usuario y grupo de Adobe Connect tiene un principal-id. En algunas llamadas de API, el principal-id se denomina group-id o user-id para distinguirlo de otros valores. El valor del ID que identifica a un usuario o grupo es siempre el mismo, independientemente de su nombre.

Obtener el principal-id de un usuario o grupo

  1. Llamar principal-list con un filtro:

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

    Es mejor utilizar filter-name, filter-login, o filter-email para una coincidencia exacta. Ten cuidado con filter-like-name, ya que puede afectar al rendimiento del servidor.

  2. Analizar los elementos principales de la respuesta para la 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>

Obtener el principal-id del usuario actual

  1. Llamar common-info después de que el usuario haya iniciado sesión:

     https://example.com/api/xml?action=common-info
  2. Analizar los elementos usuario en la respuesta para la user-id:

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

    Aquí, el principal-id se llama user-id, porque siempre representa a un usuario autenticado en Adobe Connect. Un grupo no puede iniciar sesión en el servidor. Puedes pasar el user-id valor como principal-id en otras acciones.

Lista de principales o invitados

Un principal con un tipo de usuario es un usuario registrado de Adobe Connect, mientras que un usuario con tipo de huésped ha entrado en una sala de reuniones como invitado. El servidor captura información sobre el invitado y le da un principal-id.

Enumerar todos los principales del servidor

  1. Llamar principal-list sin parámetros:

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

    Esta llamada devuelve todos los usuarios de Adobe Connect, así que prepárate para una respuesta grande.

  2. Analizar los elementos principales en la respuesta para los valores que desee:

     <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>

Mostrar todos los invitados en el servidor

  1. Llamar report-bulk-users, filtrar por un tipo de invitado:

     https://example.com/api/xml?action=report-bulk-users&filter-type=guest
  2. Analizar los elementos fila en la respuesta:

     <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>

Mostrar todos los usuarios que informan a un administrador específico

Cuando llame principal-info con una principal-id, la respuesta muestra el principal. Si el principal es un usuario que tiene un responsable asignado en Adobe Connect, la respuesta también muestra datos sobre el responsable del principal en un elemento administrador:

 <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>

Puede utilizar el principal-id con principal-list para mostrar todos los usuarios asignados al administrador.

  1. Llamar principal-list, filtrar manager-id:

     https://example.com/api/xml?action=principal-list    &filter-manager-id=2006282569
  2. Analizar la respuesta para los elementos 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>

Creación de usuarios

Para crear un nuevo usuario, necesita privilegios de administrador. Adobe recomienda crear un usuario que pertenezca al grupo administradores para que la aplicación lo utilice para realizar llamadas de API que requieran privilegios de administrador.

Crear un nuevo usuario y enviar un correo electrónico de bienvenida

  1. En la aplicación, inicie sesión como usuario administrador.

    Consulte Iniciar sesión desde una aplicación para varias formas de iniciar sesión.

  2. Llamar principal-update con al menos estos parámetros:

     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

    El tipo debe ser usuario, has-children debe ser 0 o false, send-email debe ser verdaderoy email debe tener una dirección de correo electrónico válida.

    El servidor envía un correo electrónico de bienvenida con información de inicio de sesión a la dirección de correo electrónico del usuario.

  3. Analizar el elemento principal de la respuesta para el principal-id:

     <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>

Crear un nuevo usuario sin utilizar una dirección de correo electrónico como ID de inicio de sesión

  1. En Adobe Connect Central, navegue hasta Administración > Usuarios y Grupos > Editar directivas de inicio de sesión y contraseña. Asegúrese de que Usar dirección de correo electrónico como inicio de sesión esté establecido en No.

  2. En la aplicación, inicie sesión como usuario administrador.

  3. Llamar principal-update para crear el nuevo usuario, pasando ambos parámetros login y 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. Analizar la respuesta para el principal-id del nuevo usuario:

     <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>

    En la respuesta, ext-login tiene el mismo valor que login de forma predeterminada, hasta que el usuario inicie sesión correctamente mediante autenticación externa (consulte Iniciar sesión con la autenticación de encabezado HTTP).

Actualizar usuarios

Una vez creados los usuarios, a menudo es necesario actualizar su información. Puede actualizar los campos estándar definidos por Adobe Connect para los usuarios llamando principal-update con el perfil del usuario principal-id. Los campos estándar incluyen email, login, first-namey last-name.

Si ha definido campos personalizados para principal, utilice acl-field-update para actualizarlas.

Necesita privilegios de administrador para actualizar usuarios, por lo que la aplicación debe iniciar sesión primero como usuario en el administradores grupo. No puede iniciar sesión como usuario y luego hacer que el usuario actualice su propio perfil.

Actualizar información de usuario estándar

  1. Inicie sesión como administrador.

  2. Llamar principal-list con un filtro para obtener la principal-id (consulte Buscar un principal-id).

  3. Llamar principal-update para actualizar el usuario:

     https://example.com/api/xml?action=principal-update 
         &principal-id=2006282569&email=jazzdoe@newcompany.com
  4. Analizar la respuesta para obtener un código de estado de ok.

Actualizar valores de campo personalizados para un usuario

  1. Inicie sesión como usuario administrador.

  2. Llamar custom-fields para obtener la field-id del campo personalizado:

     https://example.com/api/xml?action=custom-fields
  3. Obtenga el principal-id, sco-id, o account-id desea actualizar.

    Este valor es el acl-id se pasa a acl-field-update.

  4. Llamar acl-field-update para actualizar el valor del campo personalizado:

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

Creación de campos personalizados

Los campos personalizados son campos de datos adicionales que se definen. Puede definir hasta ocho campos personalizados en un principal o un SCO mediante custom-field-update.

Una vez definido el campo personalizado, puede establecer su valor de forma predeterminada editando el valor en Adobe Connect Central o llamando al custom-field-update.

Para especificar que el valor solo se pueda actualizar a través de la API, llame al custom-field-update con el parámetro object-type=object-type-read-only.

Definir un campo personalizado y establecerlo para un usuario

  1. En primer lugar, cree el campo con 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

    El campo name define el nombre del campo tal y como lo muestra la aplicación, por lo que debe utilizar la ortografía y el uso de mayúsculas y minúsculas adecuadas. El campo personalizado de este ejemplo se define para todos los principales de Adobe Connect.

  2. Analizar el elemento field en la respuesta para el 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. Obtenga el principal-id del usuario (ver Buscar un principal-id).

  4. Llamar acl-field-update para establecer el valor del campo, pasando una field-id, el del usuario principal-id como acl-id y un valor:

     https://example.com/api/xml?action=acl-field-update 
         &acl-id=2006258745&field-id=2007017474&value=San%20Francisco
  5. Analizar la respuesta para obtener un código de estado de ok.

Crear grupos

Para añadir usuarios a grupos, debe llamar principal-update como usuario administrador de la aplicación.

Añadir un usuario a un grupo

  1. Inicie sesión como el usuario administrador de la aplicación.

  2. (Opcional) Si el usuario aún no existe, créelo con 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. (Opcional) Analice la respuesta para el nuevo principal-id del usuario.

  4. Si el usuario ya existe, llame al principal-list para obtener el principal-id del usuario:

     https://example.com/api/xml?action=principal-list&filter-type=user
  5. Analizar la respuesta para el 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. Llamar principal-list de nuevo para obtener el principal-id del grupo:

     https://example.com/api/xml?action=principal-list&filter-type=group
  7. Llamar group-membership-update con is-member=true para añadir el usuario al grupo:

     https://example.com/api/xml?action=group-membership-update 
         &group-id=4930296&principal-id=2006258745&is-member=true
    • La principal-id es el principal-id del usuario.

    • El group-id es el principal-id del grupo.

    • El parámetro is-member debe ser true.

Comprobar si un usuario específico está en un grupo

  1. Llamar principal-list con una group-id, filter-is-membery un filtro que identifica el principal:

     https://example.com/api/xml?action=principal-list&group-id=624523 
             &filter-is-member=true&filter-like-name=bob
  2. Analizar para un elemento principal en la respuesta. Una respuesta satisfactoria se ve así:

     <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 el usuario no es miembro del grupo, el elemento principal-list está vacío:

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

Comprobar qué usuarios están en un grupo

  1. Para obtener los principal-id, llamar principal-list con filtros:

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

    Con filter-type y filter-name, principal-list debe devolver una coincidencia única.

  2. Analizar la respuesta para el 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. Llamar principal-list de nuevo, con el principal-id como group-id y filter-is-member=true:

     https://example.com/api/xml?action=principal-list&group-id=2007105030 
             &filter-is-member=true
  4. Analice la respuesta para los elementos 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>

Enumerar todos los grupos a los que pertenece un usuario

  1. Llamar principal-list con el principal-id del usuario y filter-is-member=true:

     https://example.com/api/xml?action=principal-list 
         &principal-id=2006258745&filter-is-member=true
  2. Analizar la respuesta para los elementos 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>

Buscar SCO

Todos los objetos de Adobe Connect son objetos de contenido compartible o SCO. La palabra Compartible proviene de sistemas de gestión de aprendizaje en los que el contenido se combina en cursos o planes de estudio y se comparte entre ellos.

En el servidor, un SCO puede ser cualquier objeto de contenido que se combine con otros objetos de contenido en un curso o programa. Los cursos, planes de estudio, presentaciones y otros tipos de contenido son SCO. Las reuniones, eventos, carpetas, árboles, vínculos, archivos gráficos o cualquier otro objeto también son SCO.

Cada SCO tiene un identificador entero único denominado sco-id. El sco-id es único en todo el servidor. En una cuenta alojada en Adobe Connect, el sco-id es único en todas las cuentas.

Cada SCO también tiene un tipo, como content, course, meeting, etc. Puede ver los valores sco-id y tipo en la respuesta de sco-info u otras acciones:

 <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;>

Características de los SCO

Cuando se estudian las respuestas XML de varias llamadas, se observan más características de los SCO:

  • El identificador de un SCO se denomina sco-id en algunas acciones, pero también se puede llamar folder-id, acl-idu otro nombre en otras acciones. Es el mismo ID único.

  • A cada SCO pueden acceder varios principales, ya sean usuarios o grupos. Los principales específicos que pueden acceder a un SCO se definen en listas de control de acceso o ACL.

  • Cada SCO tiene una dirección URL única, con dos partes: un nombre de dominio (como http://example.com) y una ruta URL (como /f2006123456/). Puede concatenarlos para formar la dirección URL completa que accede al SCO.

  • Cada SCO tiene una ruta de navegación que describe su ubicación en la jerarquía de carpetas.

  • Cada SCO tiene un permiso definido para cada principal que puede acceder a él.

  • Algunos SCO tienen campos de descripción, que son cadenas de texto que proporcionan información sobre el SCO.

A menudo necesita encontrar el ID de un SCO o alguna información sobre él. Los SCO se organizan en una jerarquía de carpetas específica en la que las carpetas tienen nombres que indican si se encuentran en el nivel superior, si contienen contenido o plantillas compartidas o si contienen contenido y plantillas de usuario.

Cuando llame sco-shortcuts, devuelve una lista de carpetas. Observe que las carpetas tienen diferentes tipos:

 <?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>

Las carpetas que se muestran en este ejemplo son para reuniones, pero las carpetas para otros tipos de SCO siguen un patrón similar. Cada tipo de carpeta almacena ciertos tipos de objetos, con ciertos privilegios de acceso, de la siguiente manera:

contenido, cursos, reuniones, eventos, seminarios

Se trata de carpetas compartidas, como Reuniones compartidas, Formación compartida, etc. El administrador de Adobe Connect tiene acceso a esta carpeta. El administrador puede asignar el permiso Administrar a cualquier usuario, pero solo los miembros del grupo integrado asociado a la carpeta pueden crear contenido nuevo o reuniones en ella.

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

Estas carpetas contienen una carpeta para cada usuario que puede crear contenido en ellas (por ejemplo, una carpeta para cada anfitrión de la reunión o desarrollador de formación).

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

Los usuarios crean su propio contenido en estas carpetas y tienen permiso de administración sobre el contenido. Por ejemplo, los anfitriones de reuniones crean reuniones en su carpeta my-meeting y tener permiso de administrador en esas reuniones.

shared-meeting-templates

Esta carpeta se encuentra dentro de la carpeta Reuniones compartidas, contiene plantillas de reunión y hereda permisos de Reuniones compartidas.

Puede enumerar el contenido de cualquier carpeta para obtener información sobre un SCO específico. Cuando necesita buscar un SCO pero no tiene un sco-id, desplazarse por las carpetas mediante sco-shortcuts y sco-expanded-contents. No utilizar sco-search, ya que devuelve sólo determinados tipos de SCO.

Buscar un SCO cuando no conozca el sco-id

  1. Llamar sco-shortcuts para obtener una lista de carpetas raíz en Adobe Connect:

     https://example.com/api/xml?action=sco-shortcuts
  2. Analizar la respuesta de un tipo de la carpeta raíz que contendría lógicamente el SCO, por ejemplo, my-courses para un curso creado por el usuario.

  3. Analizar el elemento sco resultante para 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. Crear una llamada a sco-expanded-contents para mostrar el contenido de la carpeta, agregando un filtro de coincidencia exacta, si es posible:

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

    Tiene varias opciones de filtros:

    • Un filtro de coincidencia exacta en name o url-path (como filter-name o filter-url-path), si conoce el nombre o la dirección URL del SCO.

    • Un filtro de fecha mayor que o menor que (filter-gt-date o filter-lt-date) en date-begin, date-created, o date-modified, si conoces alguna de esas fechas.

    • Un filtro de nombre parcial (como filter-like-name), si no conoce el nombre exacto del SCO. Sin embargo, el uso de este filtro puede afectar al rendimiento del sistema.

  5. Analizar la respuesta para el 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>

Obtener información sobre un SCO

  1. Llamar sco-info con el sco-id:

     https://example.com/api/xml?action=sco-info&sco-id=2006745669
  2. Analizar la respuesta para name, url-path, o cualquier otro valor:

     <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>

Construir la URL a un SCO

  1. Llamar sco-shortcuts:

     https://example.com/api/xml?action=sco-shortcuts
  2. Analizar la respuesta para el valor domain-name en cualquier elemento 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. Llamar sco-info con el sco-id:

     https://example.com/api/xml?action=sco-info&sco-id=2006334909
  4. Analizar la respuesta para el 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>

    La url-path tiene barras diagonales iniciales y finales. Puedes tomar el url-path desde report-my-meetings, report-my-training, o cualquier llamada que lo devuelva.

  5. Concatenar la url-path con el domain-name:

     http://example.com/f2006258748/

Descargar archivos

Puede descargar archivos zip de Adobe Connect en el equipo local de un usuario.< Un archivo zip es un SCO. Para descargarlo, debe crear una dirección URL de descarga al archivo zip, que tendrá el siguiente aspecto:

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

Probablemente ya conozca el nombre de dominio del servidor (por ejemplo, example.com). Si no lo hace, puede obtenerlo llamando sco-shortcuts.

Descargar un archivo zip del servidor

  1. Llamar sco-shortcuts:

     https://example.com/api/xml?action=sco-shortcuts
  2. Extraer cualquier valor domain-name de la respuesta:

     http://example.com
  3. Llamar sco-info con el sco-id del archivo zip:

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

    El SCO es el archivo zip completo.

  4. Analizar la respuesta para el elemento 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. Cree la URL de descarga, por ejemplo:

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

    Asegúrese de eliminar la barra diagonal final del valor url-path antes de añadir .zip a é (por lo que tiene un valor como /quiz.zip, no /quiz/.zip).

Compruebe los permisos

Los permisos definen las formas en las que un principal puede interactuar con un SCO.

Una asignación de permisos, que indica los permisos que tiene un principal para un SCO determinado, se denomina lista de control de acceso o ACL. Una LCA consta de tres datos:

  • El ID de un principal (a principal-id).

  • El ID de una SCO, cuenta o principal sobre la que se actúa. En las llamadas de autorización, se denomina acl-id. En otras llamadas, el ID podría denominarse sco-id, account-id, o principal-id.

  • Palabra clave que indica el nivel de permiso que tiene el principal, que es uno de los valores válidos en permission-id.

Comprobar el permiso que tiene un principal en una SCO

  1. Llamar permissions-info con ambos acl-id y principal-id:

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

    Para comprobar los permisos en un SCO, el acl-id es un sco-id. El acl-id también puede ser un principal-id o account-id.

  2. Analizar la respuesta de 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 no tiene un permiso explícito para el SCO (en otras palabras, si permission-id=""), se aplican los permisos del principal en el objeto principal del SCO.

Comprobar los permisos de todos los principales en un SCO

  1. Llamar permissions-info con un acl-id, pero no principal-id:

     https://example.com/api/xml?action=permissions-info&acl-id=2006293572
  2. Iterar a través de los elementos principal y analizarlos para valores 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>

    Los valores de permiso válidos se enumeran en permission-id.

Logotipo de Adobe

Inicia sesión en tu cuenta

[Feedback V2 Badge]