Guida introduttiva AppFabric alla produttività (anteprima) per gli sviluppatori di applicazioni - AWS AppFabric
PrerequisitiFase 1: Crea un piano AppFabric per la produttività AppClientFase 2: Autentica e autorizza la tua applicazioneFase 3. Aggiungi l'URL del portale AppFabric utente all'applicazioneFase 4. Utilizzalo AppFabric per far emergere informazioni e azioni tra appFase 5. Richiedi AppFabric di verificare la tua candidatura

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.

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 (vediFase 5. Richiedi AppFabric di verificare la tua candidatura). 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.

Argomenti

Prerequisiti

Prima di iniziare, devi creare un Account AWS. Per ulteriori informazioni, consulta Registrati per un Account 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 Avere un utente amministrativo è vantaggioso, ma non è obbligatorio per la configurazione iniziale. Per ulteriori informazioni, consulta Crea un utente con accesso amministrativo.

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.

{
    "Statement": [
        {
            "Effect": "Allow",
            "Action": [
                "appfabric:CreateAppClient"
            ],
            "Resource": ["arn:aws:appfabric:*:*:appclient/*"]
        }
    ],
    "Version": "2012-10-17"
}

Fase 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é funziona come un client applicativo OAuth 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 (vediFase 5. Richiedi AppFabric di verificare la tua candidatura). 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 crearne uno 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.

È possibile registrare l'applicazione con AWS i servizi utilizzando l'CreateAppClientAPI utilizzando diversi linguaggi di programmazione, tra cui Python, Node.js, Java, C#, Go e Rust. Per ulteriori informazioni, consulta Request signature examples 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 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, consultaFase 2: Fornisci il consenso affinché l'app mostri approfondimenti.

  • 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 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 instarterUserEmails) può utilizzare il AppClient. L'utente vedrà una notifica nel portale AppFabric utente, introdotta inFase 3. Aggiungi l'URL del portale AppFabric utente alla tua applicazione, 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: <sha256_payload>" \
  --header "X-Amz-Security-Token: <security_token>" \
  --header "X-Amz-Date: 20230922T172215Z" \
  --header "Authorization: AWS4-HMAC-SHA256 ..." \
  --url https://appfabric.<region>.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:<region>:<account>:key/<key>"
}'

Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.

{
    "appClientConfigSummary": {
        "appClientArn": "arn:aws:appfabric:<region>:<account>:appclient/a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
        "verificationStatus": "pending_verification"
    }
}

Fase 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. 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.

Per ulteriori informazioni sulla concessione dell'autorizzazione all'autorizzazione di un'applicazione, consulta. Consenti l'accesso per autorizzare le applicazioni

  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. 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. 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.<region>.amazonaws.com/oauth2/authorize?app_client_id=a1b2c3d4-5678-90ab-cdef-EXAMPLE11111\
redirect_uri=https://localhost:8080&state=a8904edc-890c-1005-1996-29a757272a44

  2. Dopo l'autenticazione, verrai reindirizzato all'URI specificato con un codice di autorizzazione restituito come parametro di query. Ad esempio, dovecode=mM0NyJ9.MEUCIHQQgV3ChXGs2LRwxLtpsgya3ybfPYXfX-sxTAdRF-gDAiEAxX7BYKlD9krG3J2VtprOjVXZ0FSUX9whdekqJ-oampc.

    https://localhost:8080/?code=mM0NyJ9.MEUCIHQQgV3ChXGs2LRwxLtpsgya3ybfPYXfX-sxTAdRF-gDAiEAxX7BYKlD9krG3J2VtprOjVXZ0FSUX9whdekqJ-oampc&state=a8904edc-890c-1005-1996-29a757272a44

  3. 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 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. Ad esempio, a1b2c3d4-5678-90ab-cdef-EXAMPLE11111.

    • grant_type(obbligatorio): il valore deve essereauthorization_code.

    • redirect_uri(obbligatorio): l'URI a cui reindirizzare gli utenti dopo l'autorizzazione utilizzata nel passaggio 1. Crea un 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.<region>.amazonaws.com/oauth2/token" \
--header "Content-Type: application/json" \
--header "X-Amz-Content-Sha256: <sha256_payload>" \
--header "X-Amz-Security-Token: <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" : "<userId>"
}

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 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 l'aggiunta di URL di reindirizzamento.

  2. Dopo aver trovato l'area appropriata, aggiungi il seguente AppFabric URL come URL di reindirizzamento all'applicazione:

    https://userportal.appfabric.<region>.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à.

Fase 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, consultaElaborazione dei dati.

Puoi utilizzare le seguenti API basate sull'intelligenza artificiale per generare e far emergere informazioni e azioni a livello di utente all'interno delle tue app:

Informazioni utilizzabili () ListActionableInsights

L'ListActionableInsightsAPI 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 linguistici di grandi dimensioni (LLM) possono precompilare dettagli all'interno di 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 con cui gli utenti finali autorizzano le applicazioni, AppFabric utilizza lo stesso portale dedicato per consentire agli utenti di visualizzare, modificare ed eseguire azioni tra app. Per l'esecuzione delle azioni, AppFabric richiede agli ISV di reindirizzare gli utenti a un portale AppFabric utenti dove 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'ListActionableInsightsAPI.

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 (<a>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 eseguire 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.

curl -v --location \
  "https://productivity.appfabric.<region>.amazonaws.com"\
"/actionableInsights" \
  --header "Authorization: Bearer <token>"

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'ListMeetingInsightsAPI 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'analisi 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.

curl --location \
  "https://productivity.appfabric.<region>.amazonaws.com"\
"/meetingContexts" \
  --header "Authorization: Bearer <token>"

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 azioni

Utilizza il funzionamento dell' AppFabric PutFeedbackAPI per fornire feedback sulle informazioni e sulle azioni generate. 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 a5. Un punteggio più alto è, meglio è.

Campi di risposta

  • Non ci sono campi di risposta.

Per ulteriori informazioni, consulta PutFeedback.

curl --request POST \
  --url "https://productivity.appfabric.<region>.amazonaws.com"\
"/feedback" \
  --header "Authorization: Bearer <token>" \
  --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 e richiedendo la verifica della tua app.

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 priorità e 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 ad accelerare 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.

  • 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.

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 averified. Se la tua richiesta viene rifiutata, dovrai riavviare la procedura di verifica.