|
1 | 1 | # Using the AtomicServer GUI |
2 | 2 |
|
3 | | -## Creating the first Agent on AtomicData.dev |
4 | | - |
5 | | -Before you can create new things on AtomicData.dev, you'll need an _Agent_. |
6 | | -This is your virtual User, which can create, sign and own things. |
7 | | - |
8 | | -Simply open the [demo invite](https://atomicdata.dev/invites/1) and press accept. |
9 | | - |
10 | | -Copy the `secret` from the user settings page and save it somewhere safe, like in a password manager. |
11 | | - |
12 | | -## Using your local AtomicServer |
13 | | - |
14 | 3 | After [running the server](installation.md), open it in your browser. |
15 | 4 | By default, that's at [`http://localhost:9883`](http://localhost:9883). |
16 | | -<!-- (Fun fact: `⚛` is HTML entity code for the Atom icon: ⚛.) --> |
| 5 | +> Fun fact: `⚛` is HTML entity code for the Atom icon: ⚛ |
17 | 6 |
|
18 | 7 | The first screen should show you your main [_Drive_](https://atomicdata.dev/classes/Drive). |
19 | | -You can think of this as your root folder. |
| 8 | +You can think of this as the root of the server. |
20 | 9 | It is the resource hosted at the root URL, effectively being the home page of your server. |
21 | 10 |
|
22 | | -There's an instruction on the screen about the `/setup` page. |
23 | | -Click this, and you'll get a screen showing an [_Invite_](https://atomicdata.dev/classes/Invite). |
24 | | -Normally, you could `Accept as new user`, but **since you're running on `localhost`, you won't be able to use the newly created Agent on non-local Atomic-Servers**. |
25 | | - |
26 | | -Therefore, it may be best to create an Agent on some _other_ running server, such as the [demo Invite on AtomicData.dev](https://atomicdata.dev/invites/1). |
27 | | -And after that, copy the Secret from the `User settings` panel from AtomicData.dev, go back to your `localhost` version, and press `sign in`. |
28 | | -Paste the Secret, and voila! You're signed in. |
29 | | - |
30 | | -Now, again go to `/setup`. This time, you can `Accept as {user}`. |
31 | | -After clicking, your Agent has gotten `write` rights for the Drive! |
32 | | -You can verify this by hovering over the description field, clicking the edit icon, and making a few changes. |
33 | | -You can also press the menu button (three dots, top left) and press `Data view` to see your agent after the `write` field. |
34 | | -Note that you can now edit every field. |
35 | | -You can also fetch your data now as various formats. |
36 | | - |
37 | | -Try checking out the other features in the menu bar, and check out the `collections`. |
| 11 | +In the sidebar you will see a list of resources in the current drive. |
| 12 | +At the start these will be: |
38 | 13 |
|
39 | | -Again, check out the [README](https://github.com/atomicdata-dev/atomic-server) for more information and guides! |
| 14 | +- The setup invite that's used to configure the root agent. |
| 15 | +- A resource named `collections`. This is a group of collections that shows collections for all classes in the server, essentially a list of all resources. |
| 16 | +- The default ontology. Ontologies are used to define new classes and properties and show to relation between them. |
40 | 17 |
|
41 | | -Now, let's create some data. |
| 18 | + |
42 | 19 |
|
43 | | -## Creating your first Atomic Data |
| 20 | +## Creating an agent |
| 21 | +To create data in AtomicServer you'll need an agent. |
| 22 | +An agent is like a user account, it signs the changes (commits) you make to data so that others can verify that you made them. |
| 23 | +Agents can be used on any AtomicServer as long as they have permission to do so. |
44 | 24 |
|
45 | | -Now let's create a [_Table_](https://atomicdata.dev/classes/Table). |
46 | | -A Class represents an abstract concept, such as a `BlogPost` (which we'll do here). |
47 | | -We can do this in a couple of ways: |
| 25 | +If your AtomicServer is not reachable from the outside we recommend you create an agent on a public server like [atomicdata.dev](https://atomicdata.dev) as an agent created on a local server can only be used on that server. |
| 26 | +The server that hosts your agent cannot do anything on your behalf because your private key is not stored on the server. They can however delete your agent making it unusable. |
48 | 27 |
|
49 | | -- Press the `+ icon` button on the left menu (only visible when logged in), and selecting Class |
50 | | -- Opening [Class](https://atomicdata.dev/classes/Class) and pressing `new class` |
51 | | -- Going to the [Classes Collection](https://atomicdata.dev/classes/) and pressing the plus icon |
| 28 | +To create an agent on atomicdata.dev you can use the [demo invite](https://atomicdata.dev/invites/1). |
| 29 | +If you want to create the agent on your own server you can use the `/setup` invite that was created when you first started the server. |
52 | 30 |
|
53 | | -The result is the same: we end up with a form in which we can fill in some details. |
| 31 | +Click the "Accept as new user" button and navigate to the User Settings page. |
| 32 | +Here you'll find the agent secret. This secret is what you use to login so keep it somewhere safe, like in a password manager. If you lose it you won't be able to recover your account. |
54 | 33 |
|
55 | | -Let's add a shortname (singular), and then a description. |
56 | | -After that, we'll add the `required` properties. |
57 | | -This form you're looking at is constructed by using the `required` and `recommended` Properties defined in `Class`. |
58 | | -We can use these same fields to generate our BlogPost resource! |
59 | | -Which fields would be required in a `BlogPost`? |
60 | | -A `name`, and a `description`, probably. |
| 34 | +### Setting up the root Agent |
| 35 | +Next, we'll set up the root Agent that has write access to the Drive. |
| 36 | +If you've chosen to create an Agent on this server using the `/setup` invite, you can skip this step. |
61 | 37 |
|
62 | | -So click on the `+ icon` under `requires` and search for these Properties to add them. |
| 38 | +Head to the `setup` page by selecting it in the sidebar. |
| 39 | +You'll see a button that either says `Accept as <Your agent>` or `Accept as new user`. |
| 40 | +If it says 'as new user`, click on login, paste your secret in the input field and return to the invite page. |
63 | 41 |
|
64 | | -Now, we can skip the `recommended` properties, and get right to saving our newly created `BlogPost` class. |
65 | | -So, press save, and now look at what you created. |
| 42 | +After clicking the accept button you'll be redirected to the home page and you will have write access to the Drive. |
| 43 | +You can verify this by hovering over the description field, clicking the edit icon, and making a few changes. |
| 44 | +You can also press the menu button (three dots, top left) and press `Data view` to see your agent after the `write` field. |
| 45 | +Note that you can now edit every field. |
66 | 46 |
|
67 | | -Notice a couple of things: |
| 47 | +The `/setup`-invite can only be used once use and will therefore not work anymore. |
| 48 | +If you want to re-enable the invite to change the root agent you can start AtomicServer with the `--initialize` flag. |
68 | 49 |
|
69 | | -- Your Class has its own URL. |
70 | | -- It has a `parent`, shown in the top of the screen. This has impact on the visibility and rights of your Resource. We'll get to that [later in the documentation](../hierarchy.md). |
| 50 | +## Creating your first Atomic Data |
71 | 51 |
|
72 | | -Now, go to the navigation bar, which is by default at the bottom of the window. Use its context menu to open the `Data View`. |
73 | | -This view gives you some more insight into your newly created data, and various ways in which you can serialize it. |
| 52 | +Now that everything is up and running you can start creating some resources. |
| 53 | +To create a new resource, click the + button in the sidebar. |
| 54 | +You will be presented with a list of resource types to choose from like Tables, Folders, Documents etc. |
| 55 | +You can also create your own types by using ontologies. |
0 commit comments