# BMLGRAPHAPI
A biblioteca fornece funcionalidades para interagir com o SharePoint, permitindo o acesso e manipulação de planilhas, identificação de usuários e outras funcionalidades.
# Função obter_planilha()
**Descrição:** Função para retornar uma planilha do SharePoint.\
**Assinatura da função:** obter_planilha(client_id, client_secret, tenant_id, url, aba_sheet=None).\
**Retorno da função:** Dataframe (pd.read_excel()).
# Exemplo de uso: obter_planilha()
```
from main import obter_planilha
client_id = "__TOKEN__"
client_secret = "__TOKEN__"
tenant_id = "__TOKEN__"
planilha_url = "https://xyz.sharepoint.com/sites/${SITE}/${DRIVE}/NOME_DA_TABELA.xlsx"
aba_da_planilha = "__NOME DA ABA__"
planilha = obter_planilha(client_id, client_secret, tenant_id, planilha_url, aba_da_planilha)
print(planilha)
```
# Função obter_workbook()
**Descrição:** Função para retornar um workbook do SharePoint, contendo todas as sheets.\
**Assinatura da função:** obter_workbook(client_id, client_secret, tenant_id, url).\
**Retorno da função:** Workbook (load_workbook(BytesIO(content), read_only = True, data_only = True)).
# Exemplo de uso: obter_workbook()
```
import pandas as pd
from main import obter_planilha
client_id = "__TOKEN__"
client_secret = "__TOKEN__"
tenant_id = "__TOKEN__"
planilha_url = "https://xyz.sharepoint.com/sites/${SITE}/${DRIVE}/NOME_DA_TABELA.xlsx"
workbook = obter_workbook(client_id, client_secret, tenant_id, planilha_url)
aba = "__NOME DA ABA__"
print('Lendo a tabela:', aba)
linhas = workbook[aba].values
colunas = next(linhas)
planilha = pd.DataFrame(linhas, columns=colunas)
print(planilha)
```
# Função obter_id_usuario()
**Descrição:** Função para obter o id do usuário através do email.\
**Assinatura da função:** obter_id_usuario(client_id, client_secret, tenant_id, email).\
**Retorno da função:** id do usuário em formato de string.
# Exemplo de uso: obter_id_usuario()
```
from main import obter_id_usuario
client_id = "__TOKEN__"
client_secret = "__TOKEN__"
tenant_id = "__TOKEN__"
email_do_usuario = "__EMAIL DO USUARIO__"
id_usuario = obter_id_usuario(client_id, client_secret, tenant_id, email_do_usuario)
print(id_usuario)
```
Raw data
{
"_id": null,
"home_page": null,
"name": "bmlgraphapi",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.8",
"maintainer_email": null,
"keywords": "xlsx, sharepoint, tabela, dataframe, dados, graphapi, microsoft",
"author": null,
"author_email": "Brenda Moura <brendamoura@bemol.com.br>",
"download_url": "https://files.pythonhosted.org/packages/87/5e/5df9d231d37ce26f51282f97eaf54e940893f378d7b93892d875b641820b/bmlgraphapi-0.5.tar.gz",
"platform": null,
"description": "# BMLGRAPHAPI\r\n\r\nA biblioteca fornece funcionalidades para interagir com o SharePoint, permitindo o acesso e manipula\u00e7\u00e3o de planilhas, identifica\u00e7\u00e3o de usu\u00e1rios e outras funcionalidades.\r\n\r\n# Fun\u00e7\u00e3o obter_planilha()\r\n\r\n**Descri\u00e7\u00e3o:** Fun\u00e7\u00e3o para retornar uma planilha do SharePoint.\\\r\n**Assinatura da fun\u00e7\u00e3o:** obter_planilha(client_id, client_secret, tenant_id, url, aba_sheet=None).\\\r\n**Retorno da fun\u00e7\u00e3o:** Dataframe (pd.read_excel()).\r\n\r\n# Exemplo de uso: obter_planilha()\r\n\r\n```\r\nfrom main import obter_planilha\r\n\r\nclient_id = \"__TOKEN__\"\r\nclient_secret = \"__TOKEN__\"\r\ntenant_id = \"__TOKEN__\"\r\nplanilha_url = \"https://xyz.sharepoint.com/sites/${SITE}/${DRIVE}/NOME_DA_TABELA.xlsx\"\r\naba_da_planilha = \"__NOME DA ABA__\"\r\n\r\nplanilha = obter_planilha(client_id, client_secret, tenant_id, planilha_url, aba_da_planilha)\r\n\r\nprint(planilha)\r\n```\r\n\r\n# Fun\u00e7\u00e3o obter_workbook()\r\n\r\n**Descri\u00e7\u00e3o:** Fun\u00e7\u00e3o para retornar um workbook do SharePoint, contendo todas as sheets.\\\r\n**Assinatura da fun\u00e7\u00e3o:** obter_workbook(client_id, client_secret, tenant_id, url).\\\r\n**Retorno da fun\u00e7\u00e3o:** Workbook (load_workbook(BytesIO(content), read_only = True, data_only = True)).\r\n\r\n# Exemplo de uso: obter_workbook()\r\n\r\n```\r\nimport pandas as pd\r\nfrom main import obter_planilha\r\n\r\nclient_id = \"__TOKEN__\"\r\nclient_secret = \"__TOKEN__\"\r\ntenant_id = \"__TOKEN__\"\r\nplanilha_url = \"https://xyz.sharepoint.com/sites/${SITE}/${DRIVE}/NOME_DA_TABELA.xlsx\"\r\n\r\nworkbook = obter_workbook(client_id, client_secret, tenant_id, planilha_url)\r\n\r\naba = \"__NOME DA ABA__\"\r\n\r\nprint('Lendo a tabela:', aba)\r\n\r\nlinhas = workbook[aba].values\r\ncolunas = next(linhas)\r\n\r\nplanilha = pd.DataFrame(linhas, columns=colunas)\r\n\r\nprint(planilha)\r\n```\r\n\r\n# Fun\u00e7\u00e3o obter_id_usuario()\r\n\r\n**Descri\u00e7\u00e3o:** Fun\u00e7\u00e3o para obter o id do usu\u00e1rio atrav\u00e9s do email.\\\r\n**Assinatura da fun\u00e7\u00e3o:** obter_id_usuario(client_id, client_secret, tenant_id, email).\\\r\n**Retorno da fun\u00e7\u00e3o:** id do usu\u00e1rio em formato de string.\r\n\r\n# Exemplo de uso: obter_id_usuario()\r\n\r\n```\r\nfrom main import obter_id_usuario\r\n\r\nclient_id = \"__TOKEN__\"\r\nclient_secret = \"__TOKEN__\"\r\ntenant_id = \"__TOKEN__\"\r\nemail_do_usuario = \"__EMAIL DO USUARIO__\"\r\n\r\nid_usuario = obter_id_usuario(client_id, client_secret, tenant_id, email_do_usuario)\r\n\r\nprint(id_usuario)\r\n```\r\n",
"bugtrack_url": null,
"license": null,
"summary": "Pacote para obter tabelas xlsx do SharePoint atrav\u00e9s de seu link",
"version": "0.5",
"project_urls": null,
"split_keywords": [
"xlsx",
" sharepoint",
" tabela",
" dataframe",
" dados",
" graphapi",
" microsoft"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "e09771d360759b6ebb3c8a4781180778796bbed77e737f23f094621ee174f476",
"md5": "ae029ddae7553b08dbc3f8f378d2fd4e",
"sha256": "9cc8d74d079b1f2f0730eb7aa60f435bb09a0967fadf6bad93d8bca297cc54d4"
},
"downloads": -1,
"filename": "bmlgraphapi-0.5-py3-none-any.whl",
"has_sig": false,
"md5_digest": "ae029ddae7553b08dbc3f8f378d2fd4e",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8",
"size": 3793,
"upload_time": "2024-06-05T14:25:36",
"upload_time_iso_8601": "2024-06-05T14:25:36.545960Z",
"url": "https://files.pythonhosted.org/packages/e0/97/71d360759b6ebb3c8a4781180778796bbed77e737f23f094621ee174f476/bmlgraphapi-0.5-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "875e5df9d231d37ce26f51282f97eaf54e940893f378d7b93892d875b641820b",
"md5": "e2997a88939b79235d2f359fce7d778d",
"sha256": "ed3faab09864e2afe9a77d4c7da8393b312b9f5d540a3424adc97ca94129db30"
},
"downloads": -1,
"filename": "bmlgraphapi-0.5.tar.gz",
"has_sig": false,
"md5_digest": "e2997a88939b79235d2f359fce7d778d",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8",
"size": 3414,
"upload_time": "2024-06-05T14:25:38",
"upload_time_iso_8601": "2024-06-05T14:25:38.441086Z",
"url": "https://files.pythonhosted.org/packages/87/5e/5df9d231d37ce26f51282f97eaf54e940893f378d7b93892d875b641820b/bmlgraphapi-0.5.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-06-05 14:25:38",
"github": false,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"lcname": "bmlgraphapi"
}