Teambition是一個跨平臺的團隊協作和專案管理工具，相當於國外的Trello。使用Teambition可以像使用白板與便籤紙一樣來管理專案進度，如下圖所示。
Teambition雖然便於管理專案，但是如果直接在Teambition上面建立一個專案對應的任務，卻容易陷入面對茫茫白板，不知道如何拆分任務的尷尬境地。如下圖所示。
面對這個空蕩蕩的視窗，應該新增哪些任務進去？直接用腦子現想，恐怕容易出現顧此失彼或者乾脆漏掉了任務的情況。
當我要開始一個專案的時候，我一般不會直接開啟Teambition就寫任務，而是使用一個大綱工具——Workflowy來梳理思路，切分任務。等任務已經切分好了，在謄寫到Teambition中，如下圖所示。
但這樣就出現了一個問題：首先在Workflowy上面把需要做的任務寫好。然後再開啟Teambition，把這些任務又謄寫到Teambition中。為了減少“謄寫”這一步重複勞動，於是就有了TeamFlowy這個小工具。它的作用是自動謄寫Workflowy中的特定條目到Teambition中。
功能介紹
TeamFlowy是一個Python指令碼，執行以後，它會登入Workflowy賬號，讀取上面所有的條目。名為[Teambition]的條目是任務開始的標記，這個條目下面的一級條目會作為任務被新增到Teambition中。如果任務下面還有二級條目，這些二級條目會作為子任務被新增到任務中。由於Teambition是按照專案-Stage-任務-子任務的形式組織一個工程（其中Stage對應了Teambition中工程下面的皮膚，例如：“待處理”，“進行中”，“完成”。）不會存在子任務的子任務，所以Workflowy中[Teambition]這個條目下面最多出現二級縮排。如下圖所示。
實現原理
Workflowy
獲取Workflowy上面的條目，需要進行三步操作：
- 登入Workflowy
- 獲取所有條目對應的JSON字串
- 提取需要新增到Teambition中的條目
登入Workflowy
開啟Chrome監控登入Wokrflowy的過程，可以看到登入Workflowy需要訪問的介面為：https://workflowy.com/accounts/login/。使用HTTP POST方式傳送請求，提交的資料包括username，password和一個不知道用途的next。如下圖所示。
使用Python的第三方網路模組requests向這個模組傳送POST請求，提交使用者名稱和密碼即可實現登入。其程式碼如下：
login_url = `https://workflowy.com/accounts/login/`
session = requests.Session()
session.post(login_url,
data={`username`: `12345@qq.com`,
`password`: `8888888`,
`next`: ``})複製程式碼獲取所有條目
使用requests的session登入Workflowy以後，Cookies會被自動儲存到session這個物件裡面。於是使用session繼續訪問Workfowy就可以以登入後的身份檢視自己的各個條目。
通過Chrome可以看到獲取所有條目的介面為https://workflowy.com/get_initialization_data?client_version=18，介面返回的資料是一個包含所有條目的超大型JSON字串，如下圖所示。
使用Python的json模組可以解析這個JSON字串為字典，並獲取所有條目，程式碼如下：
outline_url = `https://workflowy.com/get_initialization_data?client_version=18`
outlines_json = session.get(outline_url).text
outlines_dict = json.loads(outlines_json)
project_list = outlines_dict.get(`projectTreeData`, {})
.get(`mainProjectTreeInfo`, {})
.get(`rootProjectChildren`, [])複製程式碼提取任務與子任務
所有的條目層層巢狀在列表-字典結構中，其基本的形態如下：
{
"ch": [子條目],
"lm": 308496,
"id": "957996b9-67ce-51c7-a796-bfbee44e3d3f",
"nm": "AutoEmo"
}複製程式碼其中的nm為這個條目的名字。如果一個條目有子條目，那麼ch列表中就會有很多個字典，每個字典的都是這個結構，如果一個條目沒有子條目，那麼就沒有ch這個key。這樣一層一層巢狀下去：
{
"ch": [
{
"lm": 558612,
"id": "5117e20b-25ba-ba91-59e1-790c0636f78e",
"nm": "準備並熟背一段自我介紹，在任何需要自我介紹的場合都有用"
},
{
"lm": 558612,
"id": "4894b23e-6f47-8028-a26a-5fb315fc4e6f",
"nm": "姓名，來自哪裡，什麼工作",
"ch": [
{"lm": 5435246,
"id": "4894b23e-6f47-8028-a26a-5fbadfasdc4e6f",
"nm": "工作經驗"}
]
}
],
"lm": 558612,
"id": "ea282a1c-94f3-1a44-c5b3-7907792e9e6e",
"nm": "自我介紹"
}複製程式碼由於條目和子條目的結構是一樣的，那麼就可以使用遞迴來解析每一個條目。由於需要新增到Teambition的任務，從名為[Teambition]的條目開始，於是可以使用下面這樣一個函式來解析：
task_dict = {}
def extract_task(sections, task_dict, target_section=False):
for section in sections:
name = section[`nm`]
if target_section:
task_dict[name] = [x[`nm`] for x in section.get(`ch`, [])]
continue
if name == `[Teambition]`:
target_section = True
sub_sections = section.get(`ch`, [])
extract_task(sub_sections, task_dict, target_section=target_section)複製程式碼下圖所示為一段需要新增到Teambition中的條目，執行這段函式以後，得到的結果為：
{`登入Workflowy`: [], `獲取需要新增到Teambition的內容`: [`獲取任務`, `獲取子任務`], `除錯Teambition API`: [], `新增任務到Teambition`: []}複製程式碼
Teambition
將任務新增到Teambition，需要使用Teambition的Python SDK登入Teambition並呼叫API新增任務。Teambition的Python SDK在使用OAuth2獲取access_token的時候有一個坑，需要特別注意。
登入Teambition
設定Teambition應用
Teambition 是使用OAuth2來進行許可權驗證的，所以需要獲取access_token。
首先開啟Teambition的開發者中心並單擊新建應用，如下圖所示。
應用名稱可以隨便寫。建立好應用以後，可以看到應用的資訊，需要記錄Client ID和Client Secret，如下圖所示。
點選左側的OAuth2配置，填寫回撥URL，如下圖所示。這裡的這個URL其實使用任何一個可以訪問的網站的域名都可以，這裡以我的部落格地址為例。
使用Python獲取access_token
首先在Python中安裝Teambition的SDK：
pip install teambition複製程式碼接下來，在Python中獲取授權URL：
from teambition import Teambition
tb_client_id = `7bfae080-a8dc-11e7-b543-77a936726657`
tb_client_secret = `9830fc8c-81b3-45ed-b3c0-e039ab8f2d8b`
tb = Teambition(tb_client_id,
tb_client_secret)
authorize_url = tb.oauth.get_authorize_url(`https://kingname.info`)
print(authorize_url)複製程式碼程式碼執行以後，會得到一段形如下面這段URL的授權URL：
https://account.teambition.com/oauth2/authorize?client_id=7bfae080-a8dc-11e7-b543-77a936726657&redirect_uri=https://kingname.info&state=&lang=zh複製程式碼在電腦瀏覽器中人工訪問這個URL，會出現下面這樣的頁面。
單擊授權並登入，可以看到瀏覽器上面的網址變為形如：https://kingname.info/?code=Pn7ebs4sZh3NYOz2FvVJQ4uu，此時，需要記錄code=後面的這一串字串Pn7ebs4sZh3NYOz2FvVJQ4uu。
接下來就是Teambition的SDK的坑點了，根據Teambition官方文件的說法，要獲取access_token，只需要如下兩段程式碼：
code = `Pn7ebs4sZh3NYOz2FvVJQ4uu` #前面瀏覽器中的字串
tb.oauth.fetch_access_token(code)
# 上面的程式碼完成授權，接下來直接使用tb.xxxx就可以操作任務了。複製程式碼但實際上，上面這一段程式碼一定會報錯。提示grant invaild。要解決這個問題，就必需使用Teambition的HTTP 介面來人工獲取access_token。
code = `Pn7ebs4sZh3NYOz2FvVJQ4uu` #前面瀏覽器中的字串
fetch_result_dict = session.post(`https://account.teambition.com/oauth2/access_token`,
data={`client_id`: tb_client_id,
`client_secret`: tb_client_secret,
`code`: code,
`grant_type`: `code`}).json()
tb_access_token = fetch_result_dict.get(`access_token`, ``)複製程式碼此時得到的access_token是一段非常長的字串。接下來，重新初始化tb變數：
tb = Teambition(tb_client_id,
tb_client_secret,
access_token=tb_access_token)複製程式碼初始化以後，使用tb這個變數，就可以對工程和任務進行各種操作了。
Teambition的簡單使用
要在某個工程裡面建立任務，就需要知道工程的ID。首先在Teambition中手動建立一個工程，在瀏覽器中開啟工程，URL中可以看到工程的ID，如下圖所示。
有了工程ID以後，就可以使用下面的程式碼建立任務：
def create_task(task_name, sub_task_list):
tasklist = tb.tasklists.get(project_id=`59d396ee1013d919f3348675`)[0]
tasklist_id = tasklist[`_id`]
todo_stage_id = tasklist[`stageIds`][0]
task_info = tb.tasks.create(task_name, tasklist_id=tasklist_id, stage_id=todo_stage_id)
if sub_task_list:
task_id = task_info[`_id`]
for sub_task_name in sub_task_list:
tb.subtasks.create(sub_task_name, task_id=task_id)
print(f`task: {task_name} with sub tasks: {sub_task_list} added.`)複製程式碼這段程式碼首先使用tb.tasklists.get()根據工程ID獲得任務組的ID和待處理這個皮膚的ID，接下來呼叫tb.tasks.create()介面新增任務。從新增任務返回的資訊裡面拿到任務的ID，再根據任務ID，呼叫tb.subtasks.create()新增子任務ID。
效果測試
上面的程式碼實現了TeamFlowy的基本邏輯。執行TeamFlowy指令碼以後，[Teambition]這個條目下面的任務被成功的新增到了Teambition中，如下圖所示。
將程式碼組合起來並進行完善，讓程式碼更容易使用，完整的程式碼可以檢視github.com/kingname/Te…。完整的程式碼執行效果如下圖所示。
