README_ja.md

Unit/Cell Manager

概要

Unit Manager and Cell ManagerはPersoniumのセル単位での管理を行う事が出来るGUIツールです。

Name	Contents
Unit Manager	Personium Unit 上のセルを管理するGUIツールです。 ユニットユーザーを利用することでユニットに存在するすべてのセルに対する操作が可能です。
Cell Manager	ユーザーセルにセットアップし、セットアップされたセルを管理するGUIツールです。

セットアップ

Unit Manager セットアップ手順

本書ではUnit Manager のセットアップ手順を説明します。 Cell Manager を利用したい方はCell Managerセットアップ手順を参照してください。 この手順では以下の情報を使用します。環境に合わせて修正してください。

• {UnitFQDN}　　 ：Personium Unit URL
• {AccessToken}　：トランスセルトークン

1. unit-manager.zip をダウンロードします。

2. Cell作成APIを実行し、自身のPersonium Unitにapp-uc-unit-managerセルを作成します。

   # curl "https://{UnitFQDN}/__ctl/Cell" -X POST -i \
   -H 'Authorization: Bearer {AccessToken}' -H 'Accept: application/json' \
   -d '{"Name":"app-uc-unit-manager"}'

3. Cellスナップショットファイル登録更新APIを実行し、作成したセルにzipファイルをアップロードします。

   # curl \
   "https://app-uc-unit-manager.{UnitFQDN}/__snapshot/app-uc-unit-manager.zip" \
   -X PUT -i -H 'Authorization: Bearer {AccessToken}' \
   -H 'Accept: application/json' \
   -T "{zip格納フォルダ}/app-uc-unit-manager_cell.zip"

4. CellインポートAPIを実行し、セルインポートを実行します。

   # curl "https://app-uc-unit-manager.{UnitFQDN}/__import" -X POST -i \
   -H 'Authorization: Bearer {AccessToken}' \
   -d '{"Name":"app-uc-unit-manager"}

5. ファイル取得APIを実行し、login.js ファイルをダウンロードします。

   # curl "https://app-uc-unit-manager.{UnitFQDN}/__/html/js/login.js" -X GET \
   -H 'Authorization: Bearer {AccessToken}' -o '/tmp/login.js'

6. テキストエディタを利用し、login.js を編集します。 ファイルに記載されているFQDNdemo.personium.ioを自身のPersonium Unit のFQDN に変更してください。
   *変更する前は以下のように記載されています。

   • login.js

     ～～略～～
     login.openManagerWindow = function(managerInfo) {
         let appUnitFQDN = 'demo.personium.io';
         let managerUrl = '';
         $.ajax({
             type: "GET",
             url: "https://" + appUnitFQDN + "/",
             headers: {
                 'Accept': 'application/json'
             },
             success: function(unitObj, status, xhr) {
                 let ver = xhr.getResponseHeader("x-personium-version");
     
     ～～略～～
     

7. ファイル登録更新APIを実行し、変更したlogin.js をアップロードします。

   # curl "https://app-uc-unit-manager.{UnitFQDN}/__/html/js/login.js" -X PUT \
   -i -H 'Authorization: Bearer {AccessToken}' -H 'Accept: application/json' \
   -T '/tmp/login.js'

8. 以下のURLにアクセスし、ユニットマネージャが表示されることを確認します。

   https://app-uc-unit-manager.{UnitFQDN}/__/html/login.html

アクセス手順

1. 以下にアクセスする。

    https://app-uc-unit-manager.{UnitFQDN}/__/html/login.html
   

必要な情報

1. Personium Unitもしくは一般セル
2. セル名（Unitセルもしくは一般セル）
3. 上記のセルの管理者アカウントのログイン情報（ID/パスワード）

操作方法

以下にフォルダの作成、ファイルのアップロードを行い、ファイルとフォルダを削除する手順を示します。

YouTube デモビデオ

1. 必要な情報を入力し、Unit/Cell Managerにログイン。
2. [main]をクリックしてmain boxの配下を表示。
3. "Create"ボタン上にホバーし、表示されたポップアップメニューの"Folder"を選択。
   "Create Folder"ダイアログが表示される。
4. フォルダ名を入力し、右下の「create」ボタンをクリック。
5. 新規作成したフォルダのアンカーをクリックして、フォルダの配下を表示。
6. "Upload"ボタンをクリックして、ファイルをupload。
7. Uploadしたファイルをチェックし、ゴミ箱アイコンをクリックしてファイルを削除。
8. パンくずリストでmain boxの配下に戻る。
9. 作成したフォルダをチェックし、ゴミ箱アイコンをクリックしてフォルダを削除。

License

Personium Unit Manager is licensed under the Apache License, Version 2.0. See LICENSE