Commit 732ba7ea authored by Xueyun Qian's avatar Xueyun Qian

erp5_user_tutorial: text improvements

parent 48ecb4ab
......@@ -6,7 +6,9 @@
by <a href="http://www.osoe-project.org/contact">OSOE Project</a>.
</footer>
<details open="open">
<p>Now you have access to your ERP5, we are going to show you how to create persons in ERP5, thanks to the «&nbsp;base&nbsp;» area of the application. These persons can be either you, your co-workers, your clients, your suppliers, etc. Every person you interact with can be stored in ERP5. Here we will use an example of adding people into ERP5</p>
<p>This visual guide is part of a collection of documents created by the One Student One ERP (OSOE) project in collaboration with Institut Mines Telecom, Telecom Bretagne, Dresden University of Technology and the South Westfalia University of Applied Sciences. It can be used to teach modern ERP theory and practice to undergraduate students or professionals.</p><p>
<b>Copyright:</b> You are free to copy, distribute, display, and perform the work under the following conditions: you must attribute the work in the manner specified by the author or licensor; you may not use this work for any commercial purposes including training, consulting, advertising, self-advertising, publishing, etc.; you may not alter, transform, or build upon this work. For any reuse or distribution, you must make clear to others the license terms of this work. Any of these conditions can be waived if you get permission from the copyright holder through a commercial license or an educational license. For more information, contact info@nexedi.com
</p>
</details>
<test>
<table style="display: none;" class="test">
......@@ -33,7 +35,7 @@
</tbody>
</table>
</test>
</section><section>
</section><section class="">
<h1>Agenda</h1>
<ul>
<li>How to create a person</li>
......@@ -45,11 +47,14 @@
<tbody></tbody>
</table>
</test>
<details open="open">
<p>Now that you have access to your ERP5, the first step is to understand how to create persons in the application. Persons can either be you, your co-workers, your clients, your suppliers, etc. Every person you interact with can be entered and saved in ERP5. Here we will show an example of how to add people into ERP5.</p>
</details>
</section><section class="illustration">
<h1>Example</h1>
<img type="image/svg+xml" src="http://img.erp5.cn/user-Howto.Add.People.John.Scott.Doh.Example?format=png" alt="Add people in ERP5 example: John Scott Doh" title="Add people in ERP5 example: John Scott Doh">
<details open="open">
<p>As you can see on the picture, we are going to create a person named John Doh, with the information above.</p>
<p>As you can see on the picture, we are going to create a person named John Doe, with the information above.</p>
</details>
<test>
<table style="display: none;" class="test">
......@@ -60,7 +65,7 @@
<h1>Click on the “New” tab</h1>
<img title="Add people: Click on the 'New' tab" type="image/svg+xml" src="http://img.erp5.cn/user-Howto.Add.People.Menu.New?format=png" alt="Add people: Click on the 'New' tab">
<details open="open">
<p>After you log in your ERP5 instance, in the ERP5 home page, click on “new” in the tab menu, you will see the Base area on the first line. The Base area gathers the person and organisation creation functions. This is also in this module that you will be able to add a currency for example.</p>
<p>After logging into your ERP5 instance on the ERP5 home page, click on “new” in the tab menu; you will then see the Base section on top. The Base section includes functions to create people and organizations. Furthermore, it includes functions such as the one which enables you to add a currency.</p>
</details>
<test>
<table style="display: none;" class="test">
......@@ -71,7 +76,7 @@
<h1>Click on “Persons”</h1>
<img type="image/svg+xml" title="Add people: Click on 'Person'" alt="Add people: Click on 'Person'" src="http://img.erp5.cn/user-Howto.Add.People.Menu.Persons?format=png">
<details open="open">
<p>Click on “person” to create a person. This will open the View page of a new Person's document where you will have to fill with the required information.</p>
<p>Click on “person” to create a person. This will open the View page of a new Person's document where you will have to fill in the required information.</p>
</details>
<test>
<table style="display: none;" class="test">
......@@ -93,7 +98,7 @@
<h1>Reach the person creation page</h1>
<img title="Person creation page" type="image/svg+xml" src="http://img.erp5.cn/user-Howto.Add.People.Action.Tab.Screenshot?format=png" alt="Person creation page">
<details open="open">
<p>The person creation page helps you store any specific information about a person, whether it is personal or financial, or even his/her picture. <strong>Note:</strong> If you are using the ERP5 Virtual Machine, you can find a picture of John Doe in your home folder. As you can see, there are different tabs on the person creation page. All those tabs gather the required information about the person, and it is possible to add some more details with the "Action" menu on top of the page, as we will see later in this tutorial.</p>
<p>The person creation page enables you to store any specific information about a person, whether it is personal or financial. You can even add a picture to the information records. Note: If you are using the ERP5 Virtual Machine, you can find a picture of John Doe in your home folder. As you can see, there are different tabs on the person creation page which gather the required information about the person. Later in this tutorial, you will see that it is possible to add more details through the "Action" menu on top of the page.</p>
</details>
<test>
<table style="display: none;" class="test">
......@@ -115,7 +120,10 @@
<h1>Fill the “View” page and save</h1>
<img title="Add people: Fill the 'View' tab and save" src="http://img.erp5.cn/user-Howto.Add.People.View.And.Save?format=png" type="image/svg+xml" alt="Add people: Fill the 'View' tab and save">
<details open="open">
<p>Now let's refer back to our example: one of your company's contact is John Doh, the marketing manager of Z Company, a client of your company. Fill out the “view” page with those basic information of Mr Doh, then you can store his information in ERP5, by clicking on the Save button.</p><p>Note that after entering all information in the current form, you should always save them before switching to another tab or document.</p>
<p>
Now let's refer back to our example: one of your company's contacts is John Doe, the marketing manager of Z Company, a client of your company. Fill out the “view” page with Mr. Doe's basic information, then save the information in ERP5, by clicking on the Save button.
Note that after entering all the information in the current tab, you should always save before switching to another tab or document.
</p>
</details>
<test>
<table style="display: none;" class="test">
......@@ -182,7 +190,11 @@
<h1>Create the related organisation</h1>
<img title="Create the related organisation" alt="Create the related organisation" type="image/svg+xml" src="http://img.erp5.cn/user-Howto.Add.People.Create.The.Related.Organisation?format=png">
<details open="open">
<p>Now that you have saved the information about John Doh, we see that there seems to be a problem with the organisation Z Company. Indeed, as John Doh is the first person of Z Company to be stored in ERP5, the organisation does not exist yet, unless you have created it before thanks to the organisation creation function, which obviously is not the case here.</p><p>We will now solve this problem by creating the organisation - Z Company. To do that, just open the item list circled in red, and choose “Add organisation”.</p><p>Note that you cannot see it but your organisation has been created in the “organisation” section.</p>
<p>
Now that you have saved the information about John Doe, the system shows that there is a problem with the organisation Z Company. Since John Doe is the first person from Z Company to be stored in the ERP5 system, the organization does not yet exist.
We will now solve this problem by creating the organisation - Z Company. To do this, open the item list circled in red and select “Add organisation”.
Note: Although you cannot yet see it, your organization has been created in the “organisation” section.
</p>
</details>
<test>
<table style="display: none;" class="test">
......@@ -219,10 +231,7 @@
<h1>Fill the “Details” page</h1>
<img title="Add people: Fill the 'Details' tab" alt="Add people: Fill the 'Details' tab" src="http://img.erp5.cn/user-Howto.Create.New.Persons.Details?format=png" type="image/svg+xml">
<details open="open">
<p>
When you are done with the “view” tab, <strong>fill the other tabs.</strong>
For example, you can fill out the “details” tab with the information: The middle name of John Doh is Scott; John is married and has two children. You can also add a profile photo to it.
</p>
<p>When you are done working on the “view” tab, move on to filling in the other tabs. For example, you can fill in the “details” tab with the following information: The middle name of John Doe is Scott; John is married and has two children. Furthermore, you can also add a profile photo.</p>
</details>
<test>
<table style="display: none;" class="test">
......@@ -254,7 +263,10 @@
<h1>About the other tabs</h1>
<img type="image/svg+xml" title="Add people: Other tabs in the 'Details' page" alt="Add people: Other tabs in the 'Details' page" src="http://img.erp5.cn/user-Howto.Add.People.Details.Other.Tabs?format=png">
<details open="open">
<p>As you can see, some tabs like “assignment” for instance, do not allow to enter data. Indeed, the only way to specify this information to ERP5, is to use the “Action” item list and choose “Add assignment”. But it is important to notice that the tabs circled in red on the picture, are tabs that will automatically be updated by the application whenever necessary. This subject will be treated in a specific tutorial.</p><p>Remember that these tabs provide the general information about the person you are creating, but you can add different properties using the "Action" menu on top of the page. For example, the « view» tab allows you to set the person's email address. But sometimes, a person can have several email addresses. The "Action" menu makes it possible for example to add an other email address; simply choose “add email”.</p>
<p>
As you can see, in some tabs like “assignment” for instance, it is not possible to enter data directly. The only way to edit this information on the ERP5 system is to use the “Action” item list and select “Add assignment”. However, it is important to note that the tabs circled in red on the picture, will be automatically updated by the application whenever necessary. This will be covered in another tutorial.
Remember that these tabs provide the general information about the person you are creating, but you can add different properties using the "Action" menu on top of the page. For example, the « view» tab allows you to set a person's email address. But sometimes, a person can have several email addresses. The "Action" menu makes it possible to add another email address; simply select “add email”.
</p>
</details>
<test>
<table style="display: none;" class="test">
......@@ -304,7 +316,10 @@
<h1>How to Validate a Person (3)</h1>
<img type="image/svg+xml" alt="Validate new person (3): Check the update status" title="Validate new person (3): Check the update status" src="http://img.erp5.cn/user-Howto.Add.People.Validate.3.Status.Changed?format=png">
<details open="open">
<p>Check the update status which has been changed from "Draft" to "Validated".</p><p>Thanks to this function, your data will be validated, which means that your co-workers can be confident in accuracy of the information.</p>
<p>
Check the updated status which has been changed from "Draft" to "Validated".
With this function, your data will be validated, which means that your co-workers can be confident in the accuracy of the information.
</p>
</details>
<test>
<table style="display: none;" class="test">
......@@ -334,7 +349,7 @@
<h1>How to Check the Creation (1)</h1>
<img title="Check person creation (1): Click on the 'Modules' tab" alt="Check person creation (1): Click on the 'Modules' tab" type="image/svg+xml" src="http://img.erp5.cn/user-Howto.Add.People.Check.Creation.1.Modules.Persons?format=png">
<details open="open">
<p>Now that the person has been created, defined and validated, we are going to check that everything worked fine.</p><p>This is a 3 step procedure: As a first step, browse the “ERP5 modules” item list on the top of the page, and choose “persons”. The aim of this action is to lead you to the person module which displays each person who has been created in ERP5.</p>
<p>Now that the person has been created, defined and validated, we are going to check that everything worked fine.</p><p>This is a 3 step procedure: As a first step, browse the “ERP5 modules” item list on the top of the page, and select “persons”. The aim of this action is to lead you to the person module which displays each person who has been created in ERP5.</p>
</details>
<test>
<table style="display: none;" class="test">
......@@ -356,7 +371,7 @@
<h1>How to Check the Creation (2)</h1>
<img title="Check person creation (2): Click on 'Persons'" alt="Check person creation (2): Click on 'Persons'" type="image/svg+xml" src="http://img.erp5.cn/user-Howto.Add.People.Check.Creation.2.Persons.List?format=png">
<details open="open">
<p>The second step is only to check that you are located in the person general menu and that the new person you created is on the Persons List.</p>
<p>The second step is to check whether the new person you created has been added onto the Persons List in the Person Module.</p>
</details>
<test>
<table style="display: none;" class="test">
......
Markdown is supported
0%
or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment