文件列表:

LICENSE (18026, 2021-07-05)
composer.json (1221, 2021-07-05)
controller (0, 2021-07-05)
controller\RestTestCenter.php (8494, 2021-07-05)
docs (0, 2021-07-05)
docs\overview_sync.png (42835, 2021-07-05)
docs\swagger.json (5856, 2021-07-05)
docs\sync_delivery.png (12496, 2021-07-05)
docs\sync_delivery.puml (265, 2021-07-05)
docs\sync_flow.png (20228, 2021-07-05)
docs\sync_flow.puml (544, 2021-07-05)
docs\sync_results.png (13031, 2021-07-05)
docs\sync_results.puml (283, 2021-07-05)
docs\sync_users.png (9395, 2021-07-05)
docs\sync_users.puml (212, 2021-07-05)
manifest.php (1495, 2021-07-05)
model (0, 2021-07-05)
model\form (0, 2021-07-05)
model\form\TestCenterForm.php (2232, 2021-07-05)
model\import (0, 2021-07-05)
model\import\TestCenterMapper.php (2139, 2021-07-05)
model\import\UniqueFieldException.php (922, 2021-07-05)
model\routing (0, 2021-07-05)
model\routing\ApiRoute.php (1132, 2021-07-05)
model\service (0, 2021-07-05)
model\service\TaoOfflineTestCenterFormService.php (2707, 2021-07-05)
model\service\TestCenterService.php (2051, 2021-07-05)
scripts (0, 2021-07-05)
scripts\tools (0, 2021-07-05)
scripts\tools\PostSetup (0, 2021-07-05)
scripts\tools\PostSetup\Client (0, 2021-07-05)
scripts\tools\PostSetup\Client\DetachDeliveryCreateListeners.php (1797, 2021-07-05)
scripts\tools\PostSetup\Client\SwitchLockoutOff.php (1351, 2021-07-05)
scripts\tools\byOrganisationId (0, 2021-07-05)
... ...

# TAO Offline Extension     > TAO Offline Capability offers schools the possibility to take assessments in environments with unstable internet connections. It uses Virtual Machines (VM) and a Central Server (CS). The assessment is performed on the VMs that contain a TAO installation as well as the tests. At the end the results of the test will be synchronized with the Central Server. ## Installation instructions These instructions assume that you already have a TAO installation on your system. If you don't, go to [package/tao](https://github.com/oat-sa/package-tao) and follow the installation instructions. Add the extension to your TAO composer and to the autoloader: ```shell composer require oat-sa/extension-tao-offline ``` Install the extension on the CLI from the project root: **Linux:** ```shell sudo php tao/scripts/installExtension oat-sa/extension-tao-offline ``` **Windows:** ```shell php tao\scripts\installExtension oat-sa/extension-tao-offline ``` As a system administrator you can also install it through the TAO Extension Manager: - Settings (the gears on the right-hand side of the menu) -> Extension manager - Select _taoOffline_ on the right-hand side, check the box and hit _install_ ## Synchronization and Encryption ### Synchronization The synchronization process is based upon two actors, the Client Server, which is installed on a Virtual Machine, and the Central Server. #### Setting up the Client Server The following script needs to be run on a TAO instance in order to create a Client Server: ```shell sudo -u www-data php index.php '\oat\taoOffline\scripts\tools\setup\SetupClientServer' ``` On systems where [extension-tao-encryption](https://github.com/oat-sa/extension-tao-encryption) is installed, the script will set it up with encryption. Point the instance to a specific server by executing the following command: ```shell sudo -u www-data php index.php '\oat\taoSync\scripts\tool\RegisterHandShakeRootURL' --rootUrl=http://tao-central.dev/ ``` #### Setting up the Central Server Run the following to turn a TAO instance into a Central Server. ```shell sudo -u www-data php index.php 'oat\taoOffline\scripts\tools\setup\SetupCentralServer' ``` Again, instances with `taoEncryption` will benefit from encryption. #### Types of available synchronizations * Central Server to VM * Test Centers * Users * Deliveries * Eligibilities * LTI Consumers * VM to Central Server * Test Sessions * Results * Result Logs * LTI Users #### Overview of the workflow  ##### Sequence Diagram  #### Synchronizing users with encryption Every user has been assigned an application key that is used to decrypt the delivery content. Properties that are excluded from the synchronization process can be found under `excludedProperties` in the configuration file `config/taoSync/syncService.conf.php`. Properties that are encrypted are defined inside `config/taoEncryption/encryptUserSyncFormatter.conf.php`.  #### Synchronizing deliveries with encryption During the synchronization of the deliveries, the test package is sent to the client. The client then imports the test and generates a delivery. _Note: If you are synchronizing a delivery that already exists on the VM a new import of the test will be created._  ##### Synchronizing results with encryption The `chunkSize` of a result is an essential configuration parameter that needs to be set in advance; the default is `10`. It can be set depending on the number of variables included in a result. If you have, for example, a test with 100 items (which means about 400 variables), the total request will contain about 4000 variables. This scenario is likely to overload the server. In this case, reducing the `chunkSize` to a smaller value is advised. The statuses of a result that needs to be sent can be configured under `statusExecutionsToSync` in `config/taoSync/resultService.conf.php`. Each request to the server will include the number of results. The process will stop after all results have been sent.  #### Synchronizing results - Logs Each result log is synchronized with the Central Server to maintain a history of the test. The number of logs sent per request is defined in the configuration inside `config/taoSync/SyncDeliveryLogService.conf.php`.

近期下载者：

相关文件：

评论：[我要评论] [举报此文件]

收藏者：