{"id":13695895,"url":"https://github.com/microsoftgraph/botframework-csharp-excelbot-rest-sample","last_synced_at":"2025-05-03T13:33:49.193Z","repository":{"id":66157002,"uuid":"68355246","full_name":"microsoftgraph/botframework-csharp-excelbot-rest-sample","owner":"microsoftgraph","description":"[ARCHIVED] Excel Bot is a bot built with the Microsoft Bot Framework that demonstrates how to use Excel with the Microsoft Graph API","archived":true,"fork":false,"pushed_at":"2020-05-11T15:34:19.000Z","size":480,"stargazers_count":29,"open_issues_count":0,"forks_count":16,"subscribers_count":17,"default_branch":"master","last_synced_at":"2024-11-12T23:36:16.850Z","etag":null,"topics":["devxsample"],"latest_commit_sha":null,"homepage":"","language":"C#","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/microsoftgraph.png","metadata":{"files":{"readme":"README-localized/README-es-es.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2016-09-16T05:30:08.000Z","updated_at":"2024-02-02T23:19:54.000Z","dependencies_parsed_at":"2023-02-21T00:16:32.165Z","dependency_job_id":null,"html_url":"https://github.com/microsoftgraph/botframework-csharp-excelbot-rest-sample","commit_stats":null,"previous_names":[],"tags_count":2,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/microsoftgraph%2Fbotframework-csharp-excelbot-rest-sample","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/microsoftgraph%2Fbotframework-csharp-excelbot-rest-sample/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/microsoftgraph%2Fbotframework-csharp-excelbot-rest-sample/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/microsoftgraph%2Fbotframework-csharp-excelbot-rest-sample/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/microsoftgraph","download_url":"https://codeload.github.com/microsoftgraph/botframework-csharp-excelbot-rest-sample/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":252196002,"owners_count":21709751,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["devxsample"],"created_at":"2024-08-02T18:00:34.448Z","updated_at":"2025-05-03T13:33:49.186Z","avatar_url":"https://github.com/microsoftgraph.png","language":"C#","funding_links":[],"categories":["Integrations"],"sub_categories":["Office Graph"],"readme":"---\npage_type: sample\nproducts:\n- office-excel\n- ms-graph\nlanguages:\n- csharp\ndescription: \"El bot de Excel es un bot creado con Microsoft Bot Framework que muestra cómo usar Excel con la API de Microsoft Graph\"\nextensions:\n  contentType: samples \n  technologies:\n  - Microsoft Graph\n  - Microsoft Bot Framework\n  services:\n  - Excel\n  createdDate: 9/15/2016 10:30:08 PM\n---\n\n# Bot de Excel\n\n## Tabla de contenido ##\n\n[Introducción](#introduction)\n\n[Requisitos previos](#prerequisites)\n\n[Clonar o descargar el repositorio](#Cloning-or-downloading-this-repository)\n\n[Configurar el inquilino de Azure AD](#Configure-your-Azure-AD-tenant)\n\n[Registrar el bot](#Register-the-bot)\n\n[Envíenos sus comentarios](#Give-us-your-feedback)\n\n## Introducción\n\u003ca name=\"introduction\"\u003e\u003c/a\u003e\n El bot de Excel es un ejemplo en el que se demuestra cómo usar [Microsoft Graph](https://graph.microsoft.io) y específicamente la [API de REST de Excel](https://graph.microsoft.io/es-es/docs/api-reference/v1.0/resources/excel) para tener acceso a los libros de Excel almacenados en OneDrive para la Empresa mediante una interfaz de usuario de conversación. Esta escrito en C# y usa [Microsoft Bot Framework](https://dev.botframework.com/) y [Language Understanding Intelligent Service (LUIS)](https://www.luis.ai/).\n\n*Nota*: El código de este ejemplo se ha escrito originalmente para un prototipo de experiencia de usuario y no muestra necesariamente cómo crear un código con calidad de producción.\n\n## Requisitos previos\n\u003ca name=\"prerequisites\"\u003e\u003c/a\u003e\n\nPara este ejemplo se necesita lo siguiente:  \n\n- Visual Studio 2017.\n- Una cuenta de Office 365 para empresas. Puede registrarse para obtener una [suscripción de Office 365 Developer](https://msdn.microsoft.com/es-es/office/office365/howto/setup-development-environment) que incluye los recursos que necesita para comenzar a crear aplicaciones de Office 365.\n\n## Clonar o descargar el repositorio\n\u003ca name=\"cloning-downloading-repo\"\u003e\u003c/a\u003e\n\n- Clone este repositorio en una carpeta local.\n\n    ` git clone https://github.com/nicolesigei/botframework-csharp-excelbot-rest-sample.git `\n\n\u003ca name=\"configure-azure\"\u003e\u003c/a\u003e\n## Configurar el inquilino de Azure AD\n\n1. Abra el explorador y vaya al [Centro de administración de Azure Active Directory](https://aad.portal.azure.com). Inicie sesión con **una cuenta profesional o educativa**.\n\n1. Seleccione **Azure Active Directory** en el panel de navegación izquierdo y, después seleccione**registros de aplicaciones** en **Administrar**.\n\n    ![Captura de pantalla de los registros de la aplicación ](readme-images/aad-portal-app-registrations.png)\n\n1. Seleccione **Nuevo registro**. En la página **Registrar una aplicación**, establezca los valores siguientes.\n\n    - Establezca un **Nombre** de preferencia; por ejemplo, `Aplicación de bot de Excel`.\n    - Establezca los **Tipos de cuenta compatibles** en **Cuentas de cualquier directorio organizativo**.\n    - En **URI de redirección**, establezca la primera lista desplegable en `Web` y el valor en http://localhost:3978/callback.\n\n    ![Captura de pantalla de la página Registrar una aplicación](readme-images/aad-register-an-app.PNG)\n\n    \u003e **Nota:** Si está ejecutando de forma local y en Azure, debe agregar dos URL de redirección aquí, una a la instancia local y otra a la aplicación web de Azure.\n    \n1. Haga clic en **Registrar**. En la página de **Aplicación de bot de Excel**, copie el valor de **Id. de aplicación (cliente)** y guárdelo, lo necesitará para configurar la aplicación.\n\n    ![Captura de pantalla del Id. de aplicación del nuevo registro](readme-images/aad-application-id.PNG)\n\n1. Seleccione **Certificados y secretos** en **Administrar**. Seleccione el botón **Nuevo secreto de cliente**. Escriba un valor en **Descripción** y seleccione una de las opciones de **Expirar** y luego seleccione **Agregar**.\n\n    ![Captura de pantalla del diálogo Agregar un cliente secreto](readme-images/aad-new-client-secret.png)\n\n1. Copie el valor del secreto de cliente antes de salir de esta página. Lo necesitará para configurar la aplicación.\n\n    \u003e [¡IMPORTANTE!]\n    \u003e El secreto de cliente no se mostrará otra vez, asegúrese de copiarlo en este momento.\n\n    ![Captura de pantalla del nuevo secreto de cliente agregado](readme-images/aad-copy-client-secret.png)\n\t\u003ca name = \"register-bot\"\u003e\u003c/a\u003e\n## Registrar el bot\n\nRealice estos pasos para configurar el entorno de desarrollo a fin de crear y probar el bot de Excel:\n\n- Descargue e instale [Azure Cosmos DB Emulator](https://docs.microsoft.com/es-es/azure/cosmos-db/local-emulator).\n\n- Realice una copia de **./ExcelBot/PrivateSettings.config.example** en el mismo directorio. Cambie el nombre del archivo a **PrivateSettings.config**.\n- Abra el archivo de solución ExcelBot.sln.\n- Registre el bot en [Bot Framework](https://dev.botframework.com/bots/new).\n- Copie los valores de MicrosoftAppId y MicrosoftAppPassword del bot al archivo PrivateSettings.config\n- Registre el bot para llamar a Microsoft Graph.\n- Copie el **Id. de cliente** y el **secreto** de Azure Active Directory al archivo PrivateSettings.config.\n- Cree un nuevo modelo en el servicio [LUIS](https://www.luis.ai).\n- Importe el archivo LUIS\\\\excelbot.json a LUIS.\n- Entrene y publique el modelo de LUIS.\n- Copie el Id. de modelo y la clave de suscripción de LUIS al archivo Dialogs\\\\ExcelBotDialog.cs.\n- (Opcional) Habilite el chat web para el bot en Bot Framework y copie la plantilla de inserción de web chat en el archivo chat.htm\n- (Opcional) Para que el bot envíe la telemetría a [Visual Studio Application Insights](https://azure.microsoft.com/es-es/services/application-insights/), copie la clave de instrumentación en los siguientes archivos: ApplicationInsights.config, default.htm, loggedin.htm, chat.htm\n- Compile la solución.\n- Presione F5 para iniciar el bot de forma local.\n- Pruebe el bot de forma local mediante [Bot Framework Emulator](https://docs.botframework.com/es-es/tools/bot-framework-emulator).\n- Cree una base de datos de Azure Cosmos DB en Azure que use la API de SQL.\n- Reemplace el nombre de host del bot en el archivo PrivateSettings.config.\n- Reemplace el URI y la clave de la base datos en el archivo PrivateSettings.config.\n- Publique la solución en la aplicación web de Azure.\n- Navegue a la página chat.htm para probar el bot implementado mediante el control de web chat.  \n\n## Envíenos sus comentarios\n\n\u003ca name=\"Give-us-your-feedback\"\u003e\u003c/a\u003e\n\nSu opinión es importante para nosotros.  \n\nRevise el código de ejemplo y háganos saber todas las preguntas y las dificultades que encuentre [enviando un problema](https://github.com/microsoftgraph/botframework-csharp-excelbot-rest-sample/issues) directamente en este repositorio. Incluya los pasos de reproducción, las salidas de la consola y los mensajes de error en cualquier problema que envíe.\n\nEste proyecto ha adoptado el [Código de conducta de código abierto de Microsoft](https://opensource.microsoft.com/codeofconduct/). Para obtener más información, vea [Preguntas frecuentes sobre el código de conducta](https://opensource.microsoft.com/codeofconduct/faq/) o póngase en contacto con [opencode@microsoft.com](mailto:opencode@microsoft.com) si tiene otras preguntas o comentarios.\n\n## Copyright\n\nCopyright (c) 2019 Microsoft. Todos los derechos reservados.\n  \n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmicrosoftgraph%2Fbotframework-csharp-excelbot-rest-sample","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmicrosoftgraph%2Fbotframework-csharp-excelbot-rest-sample","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmicrosoftgraph%2Fbotframework-csharp-excelbot-rest-sample/lists"}