Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà. # Guida introduttiva AppFabric alla produttività (anteprima) per gli sviluppatori di applicazioni | | | --- | | La funzionalità AWS AppFabric per la produttività è disponibile in anteprima ed è soggetta a modifiche. | Questa sezione aiuta gli sviluppatori di app a integrarsi AWS AppFabric per la produttività (anteprima) nelle loro applicazioni. AWS AppFabric for productivity consente agli sviluppatori di creare esperienze di app più complete per i propri utenti generando informazioni e azioni basate sull'intelligenza artificiale da e-mail, eventi del calendario, attività, messaggi e altro ancora su più applicazioni. [Per un elenco delle applicazioni supportate, consulta AWS AppFabric Applicazioni supportate.](https://aws.amazon.com/appfabric/supported-applications/) AppFabric for productivity offre agli sviluppatori di app la possibilità di creare e sperimentare in un ambiente sicuro e controllato. Quando inizi a utilizzare AppFabric for productivity per la prima volta, crei AppClient e registri un singolo utente di test. Questo approccio è progettato per aiutarti a comprendere e testare il flusso di autenticazione e comunicazione tra l'applicazione e AppFabric. Dopo aver eseguito il test con un singolo utente, puoi inviare la tua applicazione AppFabric per la verifica prima di espandere l'accesso ad altri utenti (vedi[Fase 5. Richiedi AppFabric di verificare la tua candidatura](#request_verification)). AppFabric verificherà le informazioni sulle applicazioni prima di consentirne l'adozione su larga scala per proteggere gli sviluppatori di app, gli utenti finali e i relativi dati, aprendo la strada a un'espansione dell'adozione da parte degli utenti in modo responsabile. **Topics** + [Prerequisiti](#getting-started-prerequisites) + [Passaggio 1. Crea un piano AppFabric per la produttività AppClient](#create_appclient) + [Passaggio 2. Autentica e autorizza la tua applicazione](#authorize_data_access) + [Fase 3. Aggiungi l'URL del portale AppFabric utente alla tua applicazione](#end_user_portal) + [Passaggio 4. Utilizzalo AppFabric per far emergere informazioni e azioni tra app](#surface_insights_actions) + [Fase 5. Richiedi AppFabric di verificare la tua candidatura](#request_verification) + [Gestisci AppFabric per la produttività AppClients](manage-appclients.md) + [Risolvi i problemi per la AppClients produttività AppFabric](ahead-app-dev-errors.md) ## Prerequisiti Prima di iniziare, devi creare un Account AWS. Per ulteriori informazioni, consulta [Registrati per un Account AWS](prerequisites.md#sign-up-for-aws). È inoltre necessario creare almeno un utente con accesso alla policy `"appfabric:CreateAppClient"` IAM elencata di seguito, che consente all'utente di registrare l'applicazione con AppFabric. Per ulteriori informazioni sulla concessione delle autorizzazioni per le funzionalità AppFabric per la produttività, consulta. [AppFabric per la produttività, esempi di policy IAM](security_iam_id-based-policy-examples.md#appfabric-for-productivity-policy-examples) Avere un utente amministrativo è vantaggioso, ma non è obbligatorio per la configurazione iniziale. Per ulteriori informazioni, consulta [Crea un utente con accesso amministrativo](prerequisites.md#create-an-admin). AppFabric for productivity è disponibile solo negli Stati Uniti orientali (Virginia settentrionale) durante l'anteprima. Assicurati di trovarti in questa regione prima di iniziare i passaggi seguenti. ## Passaggio 1. Crea un piano AppFabric per la produttività AppClient Prima di poter iniziare a raccogliere AppFabric informazioni sulla produttività all'interno della tua applicazione, devi creare un AppFabric AppClient. An AppClient è essenzialmente la porta di accesso AppFabric alla produttività, poiché funge da client OAuth applicativo sicuro che consente una comunicazione sicura tra l'applicazione e AppFabric. Quando ne crei uno AppClient, ti verrà fornito un AppClient ID, un identificatore univoco fondamentale per garantire che AppFabric sappia che funziona con la tua applicazione e con la tua Account AWS. AppFabric for productivity offre agli sviluppatori di app la possibilità di creare e sperimentare in un ambiente sicuro e controllato. Quando inizi a utilizzare AppFabric for productivity per la prima volta, crei AppClient e registri un singolo utente di test. Questo approccio è progettato per aiutarti a comprendere e testare il flusso di autenticazione e comunicazione tra l'applicazione e AppFabric. Dopo aver eseguito il test con un singolo utente, puoi inviare la tua applicazione AppFabric per la verifica prima di espandere l'accesso ad altri utenti (vedi[Fase 5. Richiedi AppFabric di verificare la tua candidatura](#request_verification)). AppFabric verificherà le informazioni sulle applicazioni prima di consentirne l'adozione su larga scala per proteggere gli sviluppatori di app, gli utenti finali e i relativi dati, aprendo la strada a un'espansione dell'adozione da parte degli utenti in modo responsabile. Per creare un AppClient, utilizza l'operazione AWS AppFabric `CreateAppClient` API. Se è necessario aggiornare il file AppClient after, è possibile utilizzare l'operazione `UpdateAppClient` API per modificare solo gli URL di reindirizzamento. Se devi modificare uno qualsiasi degli altri parametri associati al tuo, AppClient come AppName o description, devi eliminarli AppClient e crearne uno nuovo. Per ulteriori informazioni, consulta [CreateAppClient](API_CreateAppClient.md). È possibile registrare l'applicazione con AWS i servizi utilizzando l'`CreateAppClient`API utilizzando diversi linguaggi di programmazione, tra cui Python, Node.js, Java, C\#, Go e Rust. Per ulteriori informazioni, consulta [Request signature examples](https://docs.aws.amazon.com/IAM/latest/UserGuide/signature-v4-examples.html) nella *IAM User Guide*. È necessario utilizzare le credenziali della versione 4 della firma dell'account per eseguire questa operazione API. Per ulteriori informazioni sulla versione 4 della firma, consulta [Signing AWS API request](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_aws-signing.html) nella *IAM User Guide*. **Campi di richiesta** + `appName`- Il nome dell'applicazione che verrà visualizzato agli utenti nella pagina di consenso del portale AppFabric utenti. La pagina di consenso richiede agli utenti finali l'autorizzazione a visualizzare AppFabric informazioni dettagliate all'interno dell'applicazione. Per i dettagli sulla pagina di consenso, consulta[Passaggio 2. Fornisci il consenso affinché l'app mostri approfondimenti](getting-started-users-productivity.md#provide-consent). + `description`- Una descrizione dell'applicazione. + `redirectUrls`- L'URI a cui reindirizzare gli utenti finali dopo l'autorizzazione. È possibile aggiungere fino a 5 URL di reindirizzamento. Ad esempio, `https://localhost:8080`. + `starterUserEmails`- Un indirizzo email utente a cui sarà consentito l'accesso per ricevere gli approfondimenti fino alla verifica dell'applicazione. È consentito un solo indirizzo e-mail. Ad esempio, `anyuser@example.com` + `customerManagedKeyIdentifier`(opzionale) - L'ARN della chiave gestita dal cliente (generata da KMS) da utilizzare per crittografare i dati. Se non specificato, verrà utilizzata la chiave AWS AppFabric gestita. Per ulteriori informazioni sulle chiavi Chiavi di proprietà di AWS gestite dal cliente, consulta [Customer keys and AWS keys](https://docs.aws.amazon.com/kms/latest/developerguide/concepts.html#key-mgmt) nella *AWS Key Management Service Developer Guide*. **Campi di risposta** + `appClientArn`- L'Amazon Resource Name (ARN) che include l' AppClient ID. Ad esempio, l' AppClient ID è`a1b2c3d4-5678-90ab-cdef-EXAMPLE11111`. + `verificationStatus`- Lo stato AppClient della verifica. + `pending_verification`- La verifica di AppClient è ancora in corso con AppFabric. Fino alla AppClient verifica, solo un utente (specificato in`starterUserEmails`) può utilizzare il AppClient. L'utente vedrà una notifica nel portale AppFabric utente, introdotta in[Fase 3. Aggiungi l'URL del portale AppFabric utente alla tua applicazione](#end_user_portal), che indica che l'applicazione non è verificata. + `verified`- Il processo di verifica è stato completato con successo AppFabric e ora AppClient è completamente verificato. + `rejected`- Il processo di verifica per AppClient è stato rifiutato da AppFabric. AppClient Non può essere utilizzato da altri utenti finché il processo di verifica non viene riavviato e completato con successo. ``` curl --request POST \ --header "Content-Type: application/json" \ --header "X-Amz-Content-Sha256: " \ --header "X-Amz-Security-Token: {{}}" \ --header "X-Amz-Date: 20230922T172215Z" \ --header "Authorization: AWS4-HMAC-SHA256 ..." \ --url https://appfabric.{{}}.amazonaws.com/appclients/ \ --data '{ "appName": "Test App", "description": "This is a test app", "redirectUrls": ["https://localhost:8080"], "starterUserEmails": ["anyuser@example.com"], "customerManagedKeyIdentifier": "arn:aws:kms:{{}}:{{}}:key/{{}}" }' ``` Se l'operazione riesce, il servizio restituisce una risposta HTTP 200. ``` { "appClientConfigSummary": { "appClientArn": "arn:aws:appfabric:{{}}:{{}}:appclient/a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", "verificationStatus": "pending_verification" } } ``` ## Passaggio 2. Autentica e autorizza la tua applicazione Consenti alla tua applicazione di integrare in modo sicuro gli AppFabric approfondimenti stabilendo un flusso di autorizzazione OAuth 2.0. Innanzitutto, è necessario creare un codice di autorizzazione che verifichi l'identità dell'applicazione. Per ulteriori informazioni, consulta [Autorizza](API_Authorize.md). Quindi scambierete questo codice di autorizzazione con un token di accesso, che concede all'applicazione le autorizzazioni per recuperare e visualizzare AppFabric informazioni all'interno dell'applicazione. Per ulteriori informazioni, consulta [Token](API_Token.md). Per ulteriori informazioni sulla concessione dell'autorizzazione all'autorizzazione di un'applicazione, consulta. [Consenti l'accesso per autorizzare le applicazioni](security_iam_id-based-policy-examples.md#security_iam_id-based-policy-examples-productivity-token) 1. Per creare un codice di autorizzazione, utilizzate l'operazione AWS AppFabric `oauth2/authorize` API. **Campi di richiesta** + `app_client_id`(obbligatorio): l' AppClient ID per il file Account AWS creato nel [passaggio 1. Crea un AppClient](#create_appclient). Ad esempio, `a1b2c3d4-5678-90ab-cdef-EXAMPLE11111`. + `redirect_uri`(obbligatorio): l'URI a cui reindirizzare gli utenti finali dopo l'autorizzazione utilizzata nel [passaggio 1. Crea un AppClient](#create_appclient). Ad esempio, `https://localhost:8080`. + `state`(obbligatorio): un valore univoco per mantenere lo stato tra la richiesta e il callback. Ad esempio, `a8904edc-890c-1005-1996-29a757272a44`. ``` GET https://productivity.appfabric.{{}}.amazonaws.com/oauth2/authorize?app_client_id=a1b2c3d4-5678-90ab-cdef-EXAMPLE11111\ redirect_uri=https://localhost:8080&state=a8904edc-890c-1005-1996-29a757272a44 ``` 1. Dopo l'autenticazione, verrai reindirizzato all'URI specificato con un codice di autorizzazione restituito come parametro di query. Ad esempio, dove`code=mM0NyJ9.MEUCIHQQgV3ChXGs2LRwxLtpsgya3ybfPYXfX-sxTAdRF-gDAiEAxX7BYKlD9krG3J2VtprOjVXZ0FSUX9whdekqJ-oampc`. ``` https://localhost:8080/?code=mM0NyJ9.MEUCIHQQgV3ChXGs2LRwxLtpsgya3ybfPYXfX-sxTAdRF-gDAiEAxX7BYKlD9krG3J2VtprOjVXZ0FSUX9whdekqJ-oampc&state=a8904edc-890c-1005-1996-29a757272a44 ``` 1. Scambia questo codice di autorizzazione con un token di accesso utilizzando l'operazione AppFabric `oauth2/token` API. Questo token viene utilizzato per le richieste API ed è inizialmente valido `starterUserEmails` fino alla AppClient verifica. Dopo AppClient la verifica, questo token può essere utilizzato per qualsiasi utente. È necessario utilizzare le credenziali della versione 4 della firma dell'account per eseguire questa operazione API. Per ulteriori informazioni sulla versione 4 della firma, consulta [Signing AWS API request](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_aws-signing.html) nella *IAM User Guide*. **Campi di richiesta** + `code`(obbligatorio) - Il codice di autorizzazione che hai ricevuto dopo l'autenticazione nell'ultimo passaggio. Ad esempio, `mM0NyJ9.MEUCIHQQgV3ChXGs2LRwxLtpsgya3ybfPYXfX-sxTAdRF-gDAiEAxX7BYKlD9krG3J2VtprOjVXZ0FSUX9whdekqJ-oampc`. + `app_client_id`(obbligatorio) - L' AppClient ID per il file Account AWS creato nel [passaggio 1. Crea un AppClient](#create_appclient). Ad esempio, `a1b2c3d4-5678-90ab-cdef-EXAMPLE11111`. + `grant_type`(obbligatorio): il valore deve essere`authorization_code`. + `redirect_uri`(obbligatorio): l'URI a cui reindirizzare gli utenti dopo l'autorizzazione utilizzata nel [passaggio 1. Crea un AppClient](#create_appclient). Deve essere lo stesso URI di reindirizzamento utilizzato per creare un codice di autorizzazione. Ad esempio, `https://localhost:8080`. **Campi di risposta** + `expires_in`- Quanto tempo prima della scadenza del token. Il tempo di scadenza predefinito è di 12 ore. + `refresh_token`- Il token di aggiornamento ricevuto dalla richiesta iniziale /token. + `token`- Il token ricevuto dalla richiesta iniziale /token. + `token_type`- Il valore sarà`Bearer`. + `appfabric_user_id`- L'id AppFabric utente. Viene restituito solo per le richieste che utilizzano il tipo di `authorization_code` concessione. ``` curl --location \ "https://appfabric.{{}}.amazonaws.com/oauth2/token" \ --header "Content-Type: application/json" \ --header "X-Amz-Content-Sha256: " \ --header "X-Amz-Security-Token: {{}}" \ --header "X-Amz-Date: 20230922T172215Z" \ --header "Authorization: AWS4-HMAC-SHA256 ..." \ --data "{ \"code\": \"mM0NyJ9.MEUCIHQQgV3ChXGs2LRwxLtpsgya3ybfPYXfX-sxTAdRF-gDAiEAxX7BYKlD9krG3J2VtprOjVXZ0FSUX9whdekqJ-oampc", \"app_client_id\": \"a1b2c3d4-5678-90ab-cdef-EXAMPLE11111\", \"grant_type\": \"authorization_code\", \"redirect_uri\": \"https://localhost:8080\" }" ``` Se l'operazione riesce, il servizio restituisce una risposta HTTP 200. ``` { "expires_in": 43200, "refresh_token": "apkaeibaerjr2example", "token": "apkaeibaerjr2example", "token_type": "Bearer", "appfabric_user_id" : "{{}}" } ``` ## Fase 3. Aggiungi l'URL del portale AppFabric utente alla tua applicazione Gli utenti finali devono autorizzarsi AppFabric ad accedere ai dati delle loro applicazioni che vengono utilizzati per generare approfondimenti. AppFabric elimina la complessità per gli sviluppatori di app di gestire questo processo creando un portale utente dedicato (una schermata pop-up) per consentire agli utenti finali di autorizzare le proprie app. Quando gli utenti saranno pronti a dare AppFabric impulso alla produttività, verranno indirizzati al portale utenti che consente loro di connettersi e gestire le applicazioni utilizzate per generare approfondimenti e azioni tra app. Una volta effettuato l'accesso, gli utenti possono connettere le applicazioni a AppFabric per aumentare la produttività e poi tornare all'applicazione per esplorare le informazioni e le azioni da intraprendere. Per integrare l'applicazione con AppFabric una maggiore produttività, è necessario aggiungere un AppFabric URL specifico all'applicazione. Questo passaggio è fondamentale per consentire agli utenti di accedere al portale AppFabric utenti direttamente dall'applicazione. 1. Accedi alle impostazioni dell'applicazione e individua la sezione per aggiungere il reindirizzamento URLs. 1. Dopo aver trovato l'area appropriata, aggiungi il seguente AppFabric URL come URL di reindirizzamento all'applicazione: ``` https://userportal.appfabric.{{}}.amazonaws.com/eup_login ``` Dopo aver aggiunto l'URL, l'applicazione verrà configurata per indirizzare gli utenti al portale AppFabric utenti. Qui, gli utenti possono accedere, connettersi e gestire le applicazioni utilizzate AppFabric per generare informazioni sulla produttività. ## Passaggio 4. Utilizzalo AppFabric per far emergere informazioni e azioni tra app Dopo che gli utenti hanno collegato le loro applicazioni, puoi utilizzare le informazioni acquisite dagli utenti per migliorarne la produttività riducendo il cambio di app e contesto. AppFabric genera informazioni dettagliate per un utente solo in base a ciò a cui l'utente è autorizzato a accedere. AppFabric archivia i dati dell'utente in un Account AWS file di proprietà di AppFabric. Per informazioni su come vengono AppFabric utilizzati i tuoi dati, consulta[Elaborazione dei dati in AppFabric](productivity-data-processing.md). Puoi utilizzare i seguenti strumenti basati sull'intelligenza artificiale APIs per generare e far emergere informazioni e azioni a livello di utente all'interno delle tue app: + `ListActionableInsights`— Per ulteriori informazioni, consulta la sezione [Actionable](#productivity-actionable-insights) Insights di seguito. + `ListMeetingInsights`— Per ulteriori informazioni, consulta la sezione [Preparazione delle riunioni](#productivity-meeting-insights) più avanti in questa guida. ### Informazioni utilizzabili () `ListActionableInsights` L'`ListActionableInsights`API aiuta gli utenti a gestire al meglio la loro giornata facendo emergere informazioni fruibili basate sulle attività delle loro applicazioni, tra cui e-mail, calendario, messaggi, attività e altro ancora. Gli approfondimenti restituiti mostreranno anche collegamenti incorporati agli artefatti utilizzati per generare le informazioni, aiutando gli utenti a visualizzare rapidamente quali dati sono stati utilizzati per generare le informazioni. Inoltre, l'API può restituire azioni suggerite in base alle informazioni e consentire agli utenti di eseguire azioni tra app dall'interno dell'applicazione. In particolare, l'API si integra con piattaforme come AsanaGoogle Workspace,Microsoft 365, e consente Smartsheet agli utenti di inviare e-mail, creare eventi di calendario e creare attività. I modelli di linguaggio di grandi dimensioni (LLMs) possono precompilare i dettagli relativi a un'azione consigliata (come il corpo dell'e-mail o il nome dell'attività), che gli utenti possono personalizzare prima dell'esecuzione, semplificando il processo decisionale e migliorando la produttività. Analogamente all'esperienza degli utenti finali per l'autorizzazione delle applicazioni, AppFabric utilizza lo stesso portale dedicato per consentire agli utenti di visualizzare, modificare ed eseguire azioni tra app. Per eseguire azioni, è AppFabric necessario ISVs reindirizzare gli utenti a un portale AppFabric utenti in cui possono visualizzare i dettagli delle azioni ed eseguirle. Ogni azione generata da AppFabric ha un URL univoco. Questo URL è disponibile nella risposta della risposta dell'`ListActionableInsights`API. Di seguito è riportato un riepilogo delle azioni supportate tra app e in quali app: + Invia e-mail (Google Workspace,Microsoft 365) + Crea un evento del calendario (Google Workspace,Microsoft 365) + Crea attività (Asana,Smartsheet) **Campi di richiesta** + `nextToken`(opzionale) - Il token di impaginazione per recuperare il prossimo set di approfondimenti. + `includeActionExecutionStatus`- Un filtro che accetta l'elenco degli stati di esecuzione delle azioni. Le azioni vengono filtrate in base ai valori di stato trasmessi. Valori possibili: `NOT_EXECUTED` \| `EXECUTED` **Intestazione della richiesta** + L'intestazione di autorizzazione deve essere passata con il `Bearer Token ` valore. **Campi di risposta** + `insightId`- L'ID univoco per l'analisi generata. + `insightContent`- Ciò restituisce un riepilogo dell'analisi e dei collegamenti incorporati agli artefatti utilizzati per generare l'analisi. Nota: si tratterebbe di un contenuto HTML contenente link incorporati (tag). + `insightTitle`- Il titolo dell'intuizione generata. + `createdAt`- Quando è stata generata l'intuizione. + `actions`- Un elenco di azioni consigliate per l'analisi generata. Oggetto d'azione: + `actionId`- L'id univoco per l'azione generata. + `actionIconUrl`- L'URL dell'icona dell'app in cui si suggerisce di eseguire l'azione. + `actionTitle`- Il titolo dell'azione generata. + `actionUrl`- L'URL univoco per l'utente finale per visualizzare ed eseguire l'azione nel AppFabric portale utenti. Nota: per l'esecuzione di azioni, le app ISV reindirizzeranno gli utenti al portale AppFabric utenti (schermata pop-up) utilizzando questo URL. + `actionExecutionStatus`- Un enum che indica lo stato dell'azione. I valori possibili sono: \| `EXECUTED` `NOT_EXECUTED` + `nextToken`(opzionale) - Il token di impaginazione per recuperare il prossimo set di approfondimenti. È un campo opzionale che, se restituito nullo, significa che non ci sono più approfondimenti da caricare. Per ulteriori informazioni, consulta [ActionableInsights](API_ActionableInsights.md). ``` curl -v --location \ "https://productivity.appfabric.{{}}.amazonaws.com"\ "/actionableInsights" \ --header "Authorization: Bearer {{}}" ``` Se l'operazione riesce, il servizio restituisce una risposta HTTP 200. ``` 200 OK { "insights": [ { "insightId": "7tff3412-33b4-479a-8812-30EXAMPLE1111", "insightContent": "You received an email from James regarding providing feedback for upcoming performance reviews.", "insightTitle": "New feedback request", "createdAt": 2022-10-08T00:46:31.378493Z, "actions": [ { "actionId": "5b4f3412-33b4-479a-8812-3EXAMPLE2222", "actionIconUrl": "https://d3gdwnnn63ow7w.cloudfront.net/eup/123.svg", "actionTitle": "Send feedback request email", "actionUrl": "https://userportal.appfabric.us-east-1.amazonaws.com/action/action_id_1" "actionExecutionStatus": "NOT_EXECUTED" } ] }, { "insightId": "2dff3412-33b4-479a-8812-30bEXAMPLE3333", "insightContent":"Steve sent you an email asking for details on project. Consider replying to the email.", "insightTitle": "New team launch discussion", "createdAt": 2022-10-08T00:46:31.378493Z, "actions": [ { "actionId": "74251e31-5962-49d2-9ca3-1EXAMPLE1111", "actionIconUrl": "https://d3gdwnnn63ow7w.cloudfront.net/eup/123.svg", "actionTitle": "Reply to team launch email", "actionUrl": "https://userportal.appfabric.us-east-1.amazonaws.com/action/action_id_2" "actionExecutionStatus": "NOT_EXECUTED" } ] } ], "nextToken": null } ``` ### Preparazione della riunione () `ListMeetingInsights` L'`ListMeetingInsights`API aiuta gli utenti a prepararsi al meglio per le riunioni imminenti riassumendo lo scopo della riunione e facendo emergere elementi pertinenti trasversali alle app come e-mail, messaggi e altro. Gli utenti possono prepararsi rapidamente per le riunioni ora e non perdere tempo a passare da un'app all'altra per trovare contenuti. **Campi di richiesta** + `nextToken`(opzionale) - Il token di impaginazione per recuperare il prossimo set di approfondimenti. **Intestazione della richiesta** + L'intestazione di autorizzazione deve essere passata con il `Bearer Token` valore. **Campi di risposta** + `insightId`- L'ID univoco per l'analisi generata. + `insightContent`- La descrizione dell'intuizione che evidenzia i dettagli in formato stringa. Ad esempio, perché questa intuizione è importante. + `insightTitle`- Il titolo dell'intuizione generata. + `createdAt`- Quando è stata generata l'intuizione. + `calendarEvent`- L'evento o la riunione importante del calendario su cui l'utente dovrebbe concentrarsi. Oggetto Calendar Event: + `startTime`- L'ora di inizio dell'evento. + `endTime`- L'ora di fine dell'evento. + `eventUrl`- L'URL dell'evento del calendario sull'app ISV. + `resources`- L'elenco contenente le altre risorse relative alla generazione dell'analisi. Oggetto risorsa: + `appName`- Il nome dell'app a cui appartiene la risorsa. + `resourceTitle`- Il titolo della risorsa. + `resourceType`- Il tipo di risorsa. I valori possibili sono: `EMAIL` \| `EVENT` \| `MESSAGE` \| `TASK` + `resourceUrl`- L'URL della risorsa nell'app. + `appIconUrl`- L'URL dell'immagine dell'app a cui appartiene la risorsa. + `nextToken`(opzionale) - Il token di impaginazione per recuperare il prossimo set di approfondimenti. È un campo opzionale che, se restituito nullo, significa che non ci sono più approfondimenti da caricare. Per ulteriori informazioni, consulta [MeetingInsights](API_MeetingInsights.md). ``` curl --location \ "https://productivity.appfabric.{{}}.amazonaws.com"\ "/meetingContexts" \ --header "Authorization: Bearer {{}}" ``` Se l'operazione riesce, il servizio restituisce una risposta HTTP 201. ``` 200 OK { "insights": [ { "insightId": "74251e31-5962-49d2-9ca3-15EXAMPLE4444" "insightContent": "Project demo meeting coming up soon. Prepare accordingly", "insightTitle": "Demo meeting next week", "createdAt": 2022-10-08T00:46:31.378493Z, "calendarEvent": { "startTime": { "timeInUTC": 2023-10-08T10:00:00.000000Z, "timeZone": "UTC" }, "endTime": { "timeInUTC": 2023-10-08T11:00:00.000000Z, "timeZone": "UTC" }, "eventUrl": "http://someapp.com/events/1234", } "resources": [ { "appName": "SOME_EMAIL_APP", "resourceTitle": "Email for project demo", "resourceType": "EMAIL", "resourceUrl": "http://someapp.com/emails/1234", "appIconUrl":"https://d3gdwnnn63ow7w.cloudfront.net/eup/123.svg" } ] }, { "insightId": "98751e31-5962-49d2-9ca3-15EXAMPLE5555" "insightContent": "Important code complete task is now due. Consider updating the status.", "insightTitle": "Code complete task is due", "createdAt": 2022-10-08T00:46:31.378493Z, "calendarEvent":{ "startTime": { "timeInUTC": 2023-10-08T10:00:00.000000Z, "timeZone": "UTC" }, "endTime": { "timeInUTC": 2023-10-08T11:00:00.000000Z, "timeZone": "UTC" }, "eventUrl": "http://someapp.com/events/1234", }, "resources": [ { "appName": "SOME_TASK_APPLICATION", "resourceTitle": "Code Complete task is due", "resourceType": "TASK", "resourceUrl": "http://someapp.com/task/1234", "appIconUrl": "https://d3gdwnnn63ow7w.cloudfront.net/eup/123.svg" } ] } ], "nextToken": null } ``` ### Fornisci feedback per le tue intuizioni o le tue azioni Utilizza il funzionamento dell' AppFabric `PutFeedback`API per fornire feedback sugli approfondimenti e sulle azioni generati. Puoi incorporare questa funzionalità nelle tue app per fornire un modo per inviare una valutazione di feedback (da 1 a 5, dove maggiore è la valutazione, migliore è) per un determinato InsightId o ActionId. **Campi di richiesta** + `id`- L'identificatore dell'oggetto per il quale viene inviato il feedback. Può essere il InsightId o il ActionId. + `feedbackFor`- Il tipo di risorsa per cui viene inviato il feedback. Valori possibili: `ACTIONABLE_INSIGHT` \| `MEETING_INSIGHT` \| `ACTION` + `feedbackRating`- Valutazione del feedback da `1` a`5`. Un punteggio più alto è, meglio è. **Campi di risposta** + Non ci sono campi di risposta. Per ulteriori informazioni, consulta [PutFeedback](API_PutFeedback.md). ``` curl --request POST \ --url "https://productivity.appfabric.{{}}.amazonaws.com"\ "/feedback" \ --header "Authorization: Bearer {{}}" \ --header "Content-Type: application/json" \ --data '{ "id": "1234-5678-9012", "feedbackFor": "ACTIONABLE_INSIGHT" "feedbackRating": 3 }' ``` Se l'operazione riesce, il servizio invia una risposta HTTP 201 con un corpo HTTP vuoto. ## Fase 5. Richiedi AppFabric di verificare la tua candidatura A questo punto, hai aggiornato l'interfaccia utente dell'applicazione per incorporare informazioni e azioni AppFabric tra app e hai ricevuto informazioni dettagliate per un singolo utente. Dopo esserti soddisfatto dei test e aver voluto estendere la tua esperienza AppFabric arricchita ad altri utenti, puoi inviare la tua candidatura AppFabric per la revisione e la verifica. AppFabric verificherà le informazioni sulle applicazioni prima di consentirne l'adozione su larga scala per proteggere gli sviluppatori di app, gli utenti finali e i relativi dati, aprendo la strada a un'espansione dell'adozione da parte degli utenti in modo responsabile. **Avvia il processo di verifica** Inizia il processo di verifica inviando un'email a [appfabric-appverification@amazon.com](mailto:appfabric-appverification@amazon.com) e richiedendo che la tua app venga verificata. Includi i seguenti dettagli nella tua email: + Il tuo Account AWS ID + Il nome dell'applicazione per cui richiedi la verifica + Il tuo AppClient ID + Le tue informazioni di contatto Inoltre, fornisci le seguenti informazioni, se disponibili, per aiutarci a valutare la priorità e l'impatto: + Numero stimato di utenti a cui intendi concedere l'accesso + La data di lancio prevista **Nota** Se hai un Account AWS manager o un responsabile dello sviluppo dei AWS partner, copiali nella tua email. L'inclusione di questi contatti può aiutare a velocizzare il processo di verifica. **Criteri di verifica** Prima di iniziare il processo di verifica, devi soddisfare i seguenti criteri: + È necessario utilizzare un valore valido Account AWS per AppFabric la produttività Inoltre, soddisfi almeno uno di questi criteri: + La tua organizzazione è un AWS partner AWS Partner Network con almeno un livello «AWS Select». Per ulteriori informazioni, consulta [AWS Partner Services Tiers.](https://aws.amazon.com/partners/services-tiers/) + La tua organizzazione avrebbe dovuto spendere almeno 10.000 dollari in AppFabric servizi negli ultimi tre anni. + La tua candidatura deve essere elencata nel Marketplace AWS. Per ulteriori informazioni, consulta il [AWS Marketplace](https://aws.amazon.com/marketplace). **Attendi l'aggiornamento dello stato della verifica** Dopo aver esaminato la tua richiesta, risponderemo via e-mail e lo stato della tua richiesta AppClient cambierà da `pending_verification` a`verified`. Se la tua richiesta viene rifiutata, dovrai riavviare la procedura di verifica.