Änderungen von Dokument 08 Schnittstelle ONYX Reporter

Zuletzt geändert von Carina Enke am 13.02.2024

Von 340.1 nach 341.1 Von 370.1 nach 371.1

Von Version 341.1

bearbeitet von Carina Enke
am 15.10.2018

Änderungskommentar: Mittels Scroll Versions veröffentlicht aus dem Bereich ONYXintern und Version 1.12.

Auf Version 370.1

bearbeitet von sandra_riediger
am 15.12.2014

Änderungskommentar: Es gibt keinen Kommentar für diese Version

Rohform
Im Layout

Zusammenfassung

Seiteneigenschaften (2 geändert, 0 hinzugefügt, 0 gelöscht)
Objekte (1 geändert, 0 hinzugefügt, 0 gelöscht)
- Confluence.Code.ConfluencePageClass[0]

Details

Seiteneigenschaften

Dokument-Autor

@@ -1,1 +1,1 @@
--XWiki.carina
++XWiki.sandra_riediger

Inhalt

@@ -1,16 +2,4 @@
--{{sv-translation language="de"}}
  {{layout}}
--{{layout-section ac:type="single"}}
--{{layout-cell}}
--
--
--(% class="removedPlaceholderWrapper" %)
--
--
--
--{{/layout-cell}}
--{{/layout-section}}
--
  {{layout-section ac:type="two_right_sidebar"}}
  {{layout-cell}}
  ====== Inhalt: ======
@@ -17,11 +17,34 @@
--{{toc maxLevel="5" outline="true" absoluteUrl="true" style="square"/}}
++{{toc style="square" maxLevel="5" outline="true" absoluteUrl="true"/}}
  {{/layout-cell}}
  {{layout-cell}}
++|=(% colspan="1" %)(% colspan="1" %)
++(((
++Programmversion
++)))|(% colspan="1" %)(% colspan="1" %)
++(((
++)))
++|=(((
++Status
++)))|(((
++(% class="status-macro aui-lozenge aui-lozenge-error" %)ENTWURF
++)))
++|=(((
++Aufgaben
++)))|(((
++
++
++
++)))
++|=(((
++JIRA
++)))|(((
++
++)))
  {{/layout-cell}}
  {{/layout-section}}
@@ -61,7 +61,7 @@
  == Anmeldung des LMS ==
--{{code language="xml" title="Anmeldung des LMS"}}
++{{code title="Anmeldung des LMS" language="xml"}}
  @WebMethod(operationName = „armSite")
  public String armSite(
  @WebParam(name = „version") final Integer version,
@@ -126,7 +126,7 @@
  == Initialisierung durch LMS ==
--{{code language="xml" title="Initialisierung durch LMS"}}
++{{code title="Initialisierung durch LMS" language="xml"}}
  @WebMethod(operationName = „initiateSite")
  public String initiateSite(
  @WebParam(name = „version") final Integer version,
@@ -247,7 +247,7 @@
  == Abfrage von Lernerresultaten durch LMS ==
--{{code language="xml" title="Abfrage von Lernerresultaten durch LMS"}}
++{{code title="Abfrage von Lernerresultaten durch LMS" language="xml"}}
   @WebMethod(operationName = „getResultValues")
  public HashMapWrapper getResultValues(
     @WebParam(name = „version") final Integer version,
@@ -299,7 +299,7 @@
  == Abfrage von Ergebnisvariablen durch LMS ==
--{{code language="xml" title="Abfrage von Ergebnisvariablen durch LMS"}}
++{{code title="Abfrage von Ergebnisvariablen durch LMS" language="xml"}}
   @WebMethod(operationName = „getResultVariables")
  public HashMapWrapper getResultVariables(
  @WebParam(name = „version") final Integer version,
@@ -336,7 +336,7 @@
  == Wrapper ==
--Da die Übertragung von Maps und Listen über JAX-WS Probleme machen kann, müssen diese gewrappt werden.
++Da die Übertragung von Maps und Listen über JAX-WS Probleme macht (clientseitig gefüllte Listen werden leer über den WS versandt und kommen daher auch leer serverseitig an), müssen diese gewrappt werden.
  === Wrapper für die HashMap<String, String> ===
@@ -362,357 +362,7 @@
  {{layout-cell}}
  ====== relevante Links: ======
--* [[doc:ONYX Player Interface]]
++* [[doc:Schnittstelle ONYX WebPlayer]]
  {{/layout-cell}}
  {{/layout-section}}
  {{/layout}}
--{{/sv-translation}}
--
--{{sv-translation language="en"}}
--{{layout}}
--{{layout-section ac:type="two_equal"}}
--{{layout-cell}}
--====== Content: ======
--
--
--
--{{toc maxLevel="5" outline="true" absoluteUrl="true" style="square"/}}
--{{/layout-cell}}
--
--{{layout-cell}}
--
--{{/layout-cell}}
--{{/layout-section}}
--
--{{layout-section ac:type="single"}}
--{{layout-cell}}
--== General information ==
--
--The API to the ONYX WebReporter enables the communication between the LMS and the Reporter. Therefore, a couple of commands will be executed:
--
--|(((
--armSite
--)))|(((
--Registration of sequence requests at the ONYX Reporter
--)))
--|(((
--initiateSite
--)))|(((
--Initiates the Reporter session (transmission of the CP).
--)))
--|(((
--disarmSite
--)))|(((
--Release of all Reporter resources for this session.
--)))
--|(((
--getResultValues
--)))|(((
--Returns all (requested) results for the test. Condition: There is only one student in the list transmitted with initiateSite.
--)))
--|(% colspan="1" %)(% colspan="1" %)
--(((
--getResultVariables
--)))|(% colspan="1" %)(% colspan="1" %)
--(((
--Returns all (requested) outcome variables for the test. No armSite, initiateSite, or disarmSite is required.
--)))
--
--== Login through the LMS ==
--
--{{code language="xml" title="Login through the LMS"}}
--@WebMethod(operationName = „armSite")
--public String armSite(
--@WebParam(name = „version") final Integer version,
--@WebParam(name = „userId") final String userId,
--@WebParam(name = „optionalRole") final Integer role,
--@WebParam(name = „secretToShare") final String secretToShare,
--@WebParam(name = „optionalUserLastName") final String userLastName,
--@WebParam(name = „optionalUserFirstName") final String userFirstName,
--@WebParam(name = „additionalParams") final HashMapWrapper additionalParams) {
--}
--{{/code}}
--
--=== Parameter armSite ===
--
--|(((
--version
--)))|(((
--Requested version: 1
--)))
--|(((
--userId
--)))|(((
--UserId of the requested Reporter user
--)))
--|(((
--optionalRole
--)))|(((
--Optional. User role. 0 = student, 1 = tutor
--)))
--|(((
--secretToShare
--)))|(((
--A secret string that allows the server and client to encrypt their communication. Must remain the same for any further communication.
--)))
--|(((
--optionalUserLastName
--)))|(((
--Optional. Last name of the user.
--)))
--|(% colspan="1" %)(% colspan="1" %)
--(((
--optionalUserFirstName
--)))|(% colspan="1" %)(% colspan="1" %)
--(((
--Optional. First name of the user.
--)))
--|(% colspan="1" %)(% colspan="1" %)
--(((
--additionalParams
--)))|(% colspan="1" %)(% colspan="1" %)
--(((
--Reserved for future use.
--)))
--
--=== ReturnValue armSite ===
--
--|(((
--String
--)))|(((
--Session ID which has to be used to mark any other Reporter call.
--)))
--
--== Initialisation through LMS ==
--
--{{code language="xml" title="Initialisation through LMS"}}
--@WebMethod(operationName = „initiateSite")
--public String initiateSite(
--@WebParam(name = „version") final Integer version,
--@WebParam(name = „sessionId") final String sessionId,
--@WebParam(name = „secretToShare") final String secretToShare,
--@WebParam(name = „students") final ArrayList<ResultsForStudent> students,
--@WebParam(name = „optionalContentPackage") final byte[] contentPackage,
--@WebParam(name = „additionalParams") final HashMapWrapper additionalParams) {
--}
--{{/code}}
--
--=== Parameter initiateSite ===
--
--|(((
--version
--)))|(((
--Requested version: 1
--)))
--|(% colspan="1" %)(% colspan="1" %)
--(((
--sessionId
--)))|(% colspan="1" %)(% colspan="1" %)
--(((
--SessionId, as returned by armSite.
--)))
--|(((
--secretToShare
--)))|(((
--A secret string that allows the server and client to encrypt their communication. Must remain the same for any further communication.
--)))
--|(((
--students
--)))|(((
--List of students and their results. See below.
--)))
--|(((
--optionalContentPackage
--)))|(((
--Optional. Content package (zipped) as byte array.
--)))
--|(((
--additionalParams
--)))|(((
--Reserved for future use.
--)))
--
--=== ReturnValue initiateSite ===
--
--|(((
--String
--)))|(((
--Absolute URL of the Reporter site for the IFrame. The URL has to be amended by the LMS with the following URL parameters:
--
--* sid: Session ID, as returned by armSite
--* (((
--uid: Student ID, as registrated in the initiateSite at the ONYX Reporter
--)))
--)))
--
--{{code language="xml"}}
--public class ResultsForStudent {
--   private String studentId = „";
--   private String firstname = „";
--   private String lastname = „";
--   private String groupname = „";
--   private String tutorname = „";
--   private File contentFile = null;
--   private byte[] resultsFile = null;
--}
--{{/code}}
--
--== Logout through the LMS ==
--
--
--
--{{code}}
--@WebMethod(operationName = „disarmSite")
--public Boolean disarmSite(
--@WebParam(name = „version") final Integer version,
--@WebParam(name = „sessionId") final String sessionId,
--@WebParam(name = „secretToShare") final String secretToShare,
--@WebParam(name = „additionalParams") final HashMapWrapper additionalParams) {
--}
--{{/code}}
--
--
--
--=== Parameter disarmSite ===
--
--|(((
--version
--)))|(((
--Requested version: 1
--)))
--|(% colspan="1" %)(% colspan="1" %)
--(((
--sessionId
--)))|(% colspan="1" %)(% colspan="1" %)
--(((
--SessionId, as returned by armSite.
--)))
--|(((
--secretToShare
--)))|(((
--A secret string that allows the server and client to encrypt their communication. Must remain the same for any further communication.
--)))
--|(((
--additionalParams
--)))|(((
--Reserved for future use.
--)))
--
--=== ReturnValue disarmSite ===
--
--|(((
--Boolean
--)))|(((
--True in the case of success, otherwise false.
--)))
--
--== Request of learner results through the LMS ==
--
--{{code language="xml" title="Request of learner results through the LMS"}}
-- @WebMethod(operationName = „getResultValues")
--public HashMapWrapper getResultValues(
--   @WebParam(name = „version") final Integer version,
--   @WebParam(name = „sessionId") final String sessionId,
--   @WebParam(name = „secretToShare") final String secretToShare,
--   @WebParam(name = „requestedValues") final HashMap<String, String>
--        requestedValues,
--   @WebParam(name = „additionalParams") final HashMapWrapper additionalParams) {
--}
--{{/code}}
--
--=== Parameter getResultValues ===
--
--|(((
--version
--)))|(((
--Requested version: 1
--)))
--|(% colspan="1" %)(% colspan="1" %)
--(((
--sessionId
--)))|(% colspan="1" %)(% colspan="1" %)
--(((
--SessionId, as returned by armSite.
--)))
--|(((
--secretToShare
--)))|(((
--A secret string that allows the server and client to encrypt their communication. Must remain the same for any further communication.
--)))
--|(((
--requestedValues
--)))|(((
--Can be empty, in which case all result variables are returned. If keys are included, only the keys will be returned.
--)))
--|(((
--additionalParams
--)))|(((
--Reserved for future use.
--)))
--
--=== ReturnValue getResultValues ===
--
--|(((
--HashMap<String, String>
--)))|(((
--Map of result variables, key is the variable name, value is the respective variable's value (HashMap is wrapped)
--)))
--
--== Request of result variables through the LMS ==
--
--{{code language="xml" title="Request of result variables through the LMS"}}
-- @WebMethod(operationName = „getResultVariables")
--public HashMapWrapper getResultVariables(
--@WebParam(name = „version") final Integer version,
--@WebParam(name = „contentPackage") final byte[] contentPackage,
--@WebParam(name = „additionalParams") final HashMapWrapper additionalParams) {
--}
--{{/code}}
--
--=== Parameter getResultVariables ===
--
--|(((
--version
--)))|(((
--Requested version: 1
--)))
--|(((
--contentPackage
--)))|(((
--Content package (zipped) as byte array.
--)))
--|(((
--additionalParams
--)))|(((
--Reserved for future use.
--)))
--
--=== ReturnValue getResultVariables ===
--
--|(((
--HashMap<String, String>
--)))|(((
--Map of result variables, key is the variable name, value is the respective variable's value (HashMap is wrapped)
--)))
--
--== Wrapper ==
--
--Since the transmission of maps and lists via JAX-WS can cause problems, they have to be wrapped.
--
--=== Wrapper for HashMap<String, String> ===
--
--HashMapWrapper.java:
--
--[[image:attach:HashMapWrapperjava.png]]
--
--[[image:attach:HashMapWrapperjava2.png]]
--
--=== Wrapper for the ArrayList<ResultsForStudent> ===
--
--ResultsForStudentsWrapper.java:
--
--[[image:attach:ResultsForStudentsWrapperjava.png]]
--{{/layout-cell}}
--{{/layout-section}}
--{{/layout}}
--{{/sv-translation}}

Confluence.Code.ConfluencePageClass[0]

id

@@ -1,1 +1,1 @@
--182518281
++3342791

url

@@ -1,1 +1,1 @@
--https://www.bps-system.de/help/display/SOV/wiki/spaces/ONYX/pages/182518281/Schnittstelle ONYX Reporter
++https://www.bps-system.de/help/display/SOV/wiki/spaces/ONYX/pages/3342791/Schnittstelle ONYX Reporter

Änderungen von Dokument 08 Schnittstelle ONYX Reporter

Zusammenfassung

Details

Suchen

ONYXGlobal

ONYXMenü

Zuletzt besucht