You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@devlake.apache.org by ab...@apache.org on 2022/07/15 02:02:36 UTC
[incubator-devlake-website] 01/06: feat: team feature user guide
This is an automated email from the ASF dual-hosted git repository.
abeizn pushed a commit to branch main
in repository https://gitbox.apache.org/repos/asf/incubator-devlake-website.git
commit 242cc60ee0adef3c9edf654fc957b7bf7511638d
Author: abeizn <zi...@merico.dev>
AuthorDate: Tue Jul 12 23:27:23 2022 +0800
feat: team feature user guide
---
docs/UserManuals/team-feature-user-guide.md | 125 ++++++++++++++++++++++++++++
static/img/teamflow1.png | Bin 0 -> 63046 bytes
static/img/teamflow2.png | Bin 0 -> 54175 bytes
static/img/teamflow3.png | Bin 0 -> 48454 bytes
static/img/teamflow4.png | Bin 0 -> 49179 bytes
static/img/teamflow5.png | Bin 0 -> 71412 bytes
static/img/teamflow6.png | Bin 0 -> 33273 bytes
static/img/teamflow7.png | Bin 0 -> 94123 bytes
8 files changed, 125 insertions(+)
diff --git a/docs/UserManuals/team-feature-user-guide.md b/docs/UserManuals/team-feature-user-guide.md
new file mode 100644
index 00000000..e798be3b
--- /dev/null
+++ b/docs/UserManuals/team-feature-user-guide.md
@@ -0,0 +1,125 @@
+---
+title: "Team Feature User Guide"
+sidebar_position: 6
+description: >
+ Team Feature User Guide
+---
+## Summary
+This is a brief step-by-step guide to using the team feature.
+
+Notes:
+1. Please convert /xxxpath/*.csv to the absolute path of the csv file you want to upload.
+2 Please replace the 127.0.0.1:8080 in the text with the actual ip and port.
+
+## Step 1 - Construct the teams table.
+a. Api request example, you can generate sample data.
+
+ i. GET request: http://127.0.0.1:8080/plugins/org/teams.csv?fake_data=true (put into the browser can download the corresponding csv file)
+
+ ii. The corresponding curl command.
+```
+curl --location --request GET 'http://127.0.0.1:8080/plugins/org/teams.csv?fake_data=true'
+```
+
+b. The actual api request.
+
+ i. Create the corresponding teams file: teams.csv (Notes: the table header is in capital letters).
+
+ ii. The corresponding curl command.（Quick copy folder path for macOS, Shortcut option + command + c）
+
+```
+curl --location --request PUT 'http://127.0.0.1:8080/plugins/org/teams.csv' --form 'file=@"/xxxpath/teams.csv"'
+```
+
+ iii. After successful execution, the teams table is generated and the data can be seen in the database table teams.
+
+<p align="center"><img src="../../static/img/teamflow3.png" /></p>
+
+## Step 2 - Construct user tables (roster)
+a. Api request example, you can generate sample data.
+
+ i. Get request: http://127.0.0.1:8080/plugins/org/users.csv?fake_data=true (put into the browser can download the corresponding csv file).
+
+ ii. The corresponding curl command.
+```
+curl --location --request GET 'http://127.0.0.1:8080/plugins/org/users.csv?fake_data=true'
+```
+
+b. The actual api request.
+
+ i. Create the csv file (roster) (Notes: the table header is in capital letters: Id,Email,Name).
+
+ ii. The corresponding curl command.
+```
+curl --location --request PUT 'http://127.0.0.1:8080/plugins/org/users.csv' --form 'file=@"/xxxpath/users.csv"'
+```
+
+ iii. After successful execution, the users table is generated and the data can be seen in the database table users.
+
+<p align="center"><img src="../../static/img/teamflow1.png" /></p>
+
+ iv. Generated the team_users table, you can see the data in the team_users table.
+
+<p align="center"><img src="../../static/img/teamflow2.png" /></p>
+
+## Step 3 - Update users if you need
+If there is a problem with team_users association or data in users, just re-put users api interface, i.e. (b in step 2 above)
+
+## Step 4 - Collect accounts
+accounts table is collected by users through devlake. You can see the accounts table information in the database.
+
+<p align="center"><img src="../../static/img/teamflow4.png" /></p>
+
+## Step 5 - Bind accounts and users table relationship
+
+a. api request: the name of the plugin is "org", connctionId is order to keep same with other plugins.
+
+```
+curl --location --request POST '127.0.0.1:8080/pipelines' \
+--header 'Content-Type: application/json' \
+--data-raw '{
+ "name": "test",
+ "plan":[
+ [
+ {
+ "plugin": "org",
+ "subtasks":["connectUserAccountsExact"],
+ "options":{
+ "connectionId":1
+ }
+ }
+ ]
+ ]
+}'
+```
+
+b. After successful execution, the user_accounts table is generated, and you can see the data in table user_accounts.
+
+<p align="center"><img src="../../static/img/teamflow5.png" /></p>
+
+## Step 6 - Get user_accountsr relationship
+After generating the user_accounts relationship, the user needs to confirm whether the data user and accounts match correctly by the GET method that can get the associated data. The main purpose is to check whether the Id in the accounts table is associated with the UserId relationship.
+
+a. http://127.0.0.1:8080/plugins/org/user_accounts.csv (put into the browser to download the file directly)
+
+b. The corresponding curl command.
+```
+curl --location --request GET 'http://127.0.0.1:8080/plugins/org/user_accounts.csv'
+```
+
+<p align="center"><img src="../../static/img/teamflow6.png" /></p>
+
+## Step 7 - Update user_accounts if you need
+If the relationship in the accounts table is not as expected, you can change the relationship in the accounts table. For example, change the UserId in the line Id=github:GithubAccount:1:1234 to 2 in my accounts here, upload the user_accounts.csv file through the api user_account.csv file.
+
+a. The corresponding curl command.
+```
+curl --location --request PUT 'http://127.0.0.1:8080/plugins/org/user_accounts.csv' --form 'file=@"/xxxpath/user_accounts.csv"'
+```
+
+b. You can see that the data in the user_accounts table has been updated.
+
+<p align="center"><img src="../../static/img/teamflow7.png" /></p>
+
+
+**The above is the flow of user usage for the whole team feature.**
diff --git a/static/img/teamflow1.png b/static/img/teamflow1.png
new file mode 100644
index 00000000..cd6880b6
Binary files /dev/null and b/static/img/teamflow1.png differ
diff --git a/static/img/teamflow2.png b/static/img/teamflow2.png
new file mode 100644
index 00000000..12f66c7c
Binary files /dev/null and b/static/img/teamflow2.png differ
diff --git a/static/img/teamflow3.png b/static/img/teamflow3.png
new file mode 100644
index 00000000..e591f282
Binary files /dev/null and b/static/img/teamflow3.png differ
diff --git a/static/img/teamflow4.png b/static/img/teamflow4.png
new file mode 100644
index 00000000..0fb88ad7
Binary files /dev/null and b/static/img/teamflow4.png differ
diff --git a/static/img/teamflow5.png b/static/img/teamflow5.png
new file mode 100644
index 00000000..7c02242f
Binary files /dev/null and b/static/img/teamflow5.png differ
diff --git a/static/img/teamflow6.png b/static/img/teamflow6.png
new file mode 100644
index 00000000..3fee26f9
Binary files /dev/null and b/static/img/teamflow6.png differ
diff --git a/static/img/teamflow7.png b/static/img/teamflow7.png
new file mode 100644
index 00000000..b24d93db
Binary files /dev/null and b/static/img/teamflow7.png differ