Azure AD (Entra ID)

Configura la sottoscrizione agli eventi

Se hai attivato la sottoscrizione all'evento, inserisci i seguenti valori nella sezione Dettagli sottoscrizione all'evento:

1. Inserisci i dettagli di autenticazione.
   1. ID client: l'ID client utilizzato per richiedere i token di accesso.
   2. Client secret: il client secret utilizzato per richiedere token di accesso.
   3. Versione del secret:seleziona una versione del secret.
   4. Client state: il secret di Secret Manager contenente lo stato del client. Viene utilizzato per l'autenticazione delle notifiche di modifica.
2. Tenant Azure: il tenant Microsoft Online utilizzato per accedere ai dati. Se non specifichi un tenant, viene utilizzato quello predefinito.
3. (Facoltativo) Seleziona Attiva arricchimento dei dati se vuoi che vengano aggiunte ulteriori informazioni alla risposta del sistema di backend.

   Le informazioni aggiuntive sono specifiche dell'entità per cui hai configurato l'evento. Per ulteriori informazioni, vedi Arricchimento dei dati nelle notifiche degli eventi.

4. Seleziona Attiva connettività privata per una connettività sicura tra l'applicazione di backend e la connessione. Se selezioni questa opzione, devi eseguire passaggi di configurazione aggiuntivi dopo aver creato la connessione. Per saperne di più, vedi Connettività privata per la sottoscrizione di eventi.
5. Inserisci la configurazione della coda di messaggi non recapitabili. Se configuri la coda dei messaggi non recapitabili, la connessione scrive gli eventi non elaborati nell'argomento Pub/Sub specificato. Inserisci i seguenti dettagli:
   1. ID progetto messaggi non recapitabili : l'ID progetto Google Cloud in cui hai configurato l'argomento Pub/Sub messaggi non recapitabili.
   2. Argomento messaggi non recapitabili : l'argomento Pub/Sub in cui vuoi scrivere i dettagli dell'evento non elaborato.
6. Se vuoi utilizzare un proxy per connetterti al backend (per la sottoscrizione di eventi), inserisci i seguenti dettagli:
1. Tipo di SSL proxy: il tipo di SSL da utilizzare per la connessione al server proxy. Seleziona uno dei seguenti tipi di autenticazione:
   • Sempre: la connessione è sempre abilitata per SSL per la sottoscrizione di eventi.
   • Mai: la connessione non è abilitata per SSL per la sottoscrizione di eventi.
2. Proxy Auth Scheme (Schema di autenticazione proxy): seleziona il tipo di autenticazione per l'autenticazione con il server proxy. Sono supportati i seguenti tipi di autenticazione:
   • Basic: autenticazione HTTP di base.
3. Utente proxy: inserisci il nome utente da utilizzare per l'autenticazione con il server proxy.
4. Password proxy: seleziona il secret di Secret Manager della password dell'utente.
5. Versione del secret: seleziona la versione del secret.
6. Nella sezione Server proxy, inserisci i dettagli del server proxy.
   1. Fai clic su + Aggiungi destinazione e poi seleziona Tipo di destinazione come Indirizzo host.
   2. Inserisci il nome host o l'indirizzo IP del server proxy e il numero di porta del server proxy.

Entità, operazioni e azioni

Tutti i connettori di integrazione forniscono un livello di astrazione per gli oggetti dell'applicazione connessa. Puoi accedere agli oggetti di un'applicazione solo tramite questa astrazione. L'astrazione ti viene mostrata come entità, operazioni e azioni.

• Entità : un'entità può essere considerata un oggetto o una raccolta di proprietà nell'applicazione o nel servizio connesso. La definizione di un'entità varia da un connettore all'altro. Ad esempio, in un connettore di database, le tabelle sono le entità, in un connettore del file server, le cartelle sono le entità e in un connettore del sistema di messaggistica, le code sono le entità.

  Tuttavia, è possibile che un connettore non supporti o non abbia entità, nel qual caso l'elenco Entities sarà vuoto.

• Operazione : un'operazione è l'attività che puoi eseguire su un'entità. Puoi eseguire una delle seguenti operazioni su un'entità:
  • Elenca
  • Scarica
  • Crea
  • Aggiorna
  • Elimina

  Selezionando un'entità dall'elenco disponibile, viene generato un elenco di operazioni disponibili per l'entità. Per una descrizione dettagliata delle operazioni, consulta le operazioni sulle entità dell'attività Connettori. Tuttavia, se un connettore non supporta alcuna delle operazioni sulle entità, queste operazioni non supportate non sono elencate nell'elenco Operations.

• Azione: un'azione è una funzione di prima classe resa disponibile per l'integrazione tramite l'interfaccia del connettore. Un'azione ti consente di apportare modifiche a una o più entità e varia da connettore a connettore. In genere, un'azione ha alcuni parametri di input e un parametro di output. Tuttavia, è possibile che un connettore non supporti alcuna azione, nel qual caso l'elenco Actions sarà vuoto.

Azioni

Questa sezione elenca alcune delle azioni supportate dal connettore. Per capire come configurare le azioni, consulta Esempi di azioni.

Azione AddGroupMember

Questa azione aggiunge un membro a un gruppo.

Parametri di input dell'azione AddGroupMember

Per un esempio su come configurare questa azione, consulta Esempi di azioni.

Azione RemoveGroupMember

Questa azione rimuove un membro da un gruppo.

Parametri di input dell'azione RemoveGroupMember

Per un esempio su come configurare questa azione, vedi Esempi.

Azione AddGroupMember(account ospite)

Questa azione aggiunge un membro a un gruppo.

Parametri di input dell'azione AddGroupMember

Per un esempio su come configurare questa azione, vedi Esempi.

Azione RemoveGroupMember (account ospite)

Questa azione rimuove un membro da un gruppo

Parametri di input dell'azione RemoveGroupMember

Per un esempio su come configurare questa azione, vedi Esempi.

Azione AddUserApplicationRoleAssignment

Questa azione aggiunge un utente a un'assegnazione di ruolo applicazione.

Parametri di input dell'azione AddUserApplicationRoleAssignment

Per un esempio su come configurare questa azione, vedi Esempi.

Azione RemoveUserApplicationRoleAssignment

Questa azione rimuove un utente da un'assegnazione di ruolo dell'applicazione.

Parametri di input dell'azione RemoveUserApplicationRoleAssignment

Per un esempio su come configurare questa azione, vedi Esempi.

Azione AddGroupApplicationRoleAssignment

Questa azione aggiunge un gruppo a un'assegnazione di ruolo dell'applicazione./p>

Parametri di input dell'azione AddGroupApplicationRoleAssignment

Per un esempio su come configurare questa azione, vedi Esempi.

Azione RemoveGroupApplicationRoleAssignment

Questa azione rimuove un gruppo da un'assegnazione di ruolo applicazione.

Parametri di input dell'azione RemoveGroupApplicationRoleAssignment

Per un esempio su come configurare questa azione, vedi Esempi.

Azione ActivateDirectoryRole

Questa azione attiva un ruolo della directory.

Parametri di input dell'azione ActivateDirectoryRole

Per un esempio su come configurare questa azione, vedi Esempi.

Azione VerifyDomain

Questa azione verifica un dominio.

Parametri di input dell'azione VerifyDomain

Per un esempio su come configurare questa azione, vedi Esempi.

Azione ChangePassword

Questa azione modifica la password di un utente.

Parametri di input dell'azione ChangePassword

Per un esempio su come configurare questa azione, vedi Esempi.

Azione ResetPassword

Questa azione reimposta la password di un utente.

Parametri di input dell'azione ResetPassword

Per un esempio su come configurare questa azione, vedi Esempi.

Azione AssignLicense

Questa azione assegna una licenza a un utente.

Parametri di input dell'azione AssignLicense

Per un esempio su come configurare questa azione, vedi Esempi.

Azione RemoveLicense

Questa azione rimuove la licenza assegnata a un utente.

Parametri di input dell'azione RemoveLicense

Per un esempio su come configurare questa azione, vedi Esempi.

Azione FetchAdditionalUserFields

Questa azione recupera i campi degli attributi obbligatori.

Parametri di input dell'azione FetchAdditionalUserFields

Per un esempio su come configurare questa azione, vedi Esempi.

Azione AddGroupOwner

Questa azione aggiunge un proprietario a un gruppo.

Parametri di input dell'azione AddGroupOwner

Per un esempio su come configurare questa azione, vedi Esempi.

Azione RemoveGroupOwner

Questa azione rimuove un proprietario del gruppo.

Parametri di input dell'azione RemoveGroupOwner

Per un esempio su come configurare questa azione, vedi Esempi.

Azione InviteExternalUser

Questa azione invita un utente esterno all'organizzazione.

Parametri di input dell'azione InviteExternalUser

Per un esempio su come configurare questa azione, vedi Esempi.

Azione AddPhoneAuthenticationMethod

Questa azione consente agli utenti di eseguire attività specifiche

Parametri di input dell'azione AddPhoneAuthenticationMethod

Per un esempio su come configurare questa azione, vedi Esempi.

Azione RemovePhoneAuthenticationMethod

Questa azione rimuove il metodo di autenticazione telefonica per un utente.

Parametri di input dell'azione RemovePhoneAuthenticationMethod

Per un esempio su come configurare questa azione, vedi Esempi.

Azione UpdatePhoneAuthenticationMethod

Questa azione aggiorna il metodo di autenticazione telefonica per un utente.

Parametri di input dell'azione UpdatePhoneAuthenticationMethod

Per un esempio su come configurare questa azione, vedi Esempi.

Azione AddPrivilegedRole

Questa azione aggiunge un ruolo con privilegi per un utente.

Parametri di input dell'azione AddPrivilegedRole

Per un esempio su come configurare questa azione, vedi Esempi.

Azione RemovePrivilegedRole

Questa azione rimuove il ruolo con privilegi per un utente.<

Parametri di input dell'azione RemovePrivilegedRole

Azione RetrieveUserPhoto

Questa azione recupera una foto dell'utente.

Parametri di input dell'azione RetrieveUserPhoto

Per un esempio su come configurare questa azione, vedi Esempi.

Azione UpdateUserPhoto

Questa azione aggiorna la foto di un utente.

Parametri di input dell'azione UpdateUserPhoto

Per un esempio su come configurare questa azione, vedi Esempi.

Azione RemoveUserPhoto

Questa azione rimuove una foto dell'utente.

Parametri di input dell'azione RemoveUserPhoto

Per un esempio su come configurare questa azione, vedi Esempi.

Azione AssignManager

Questa azione assegna un responsabile a un determinato utente.

Parametri di input dell'azione AssignManager

Per un esempio su come configurare questa azione, vedi Esempi.

Azione RemoveManager

Questa azione rimuove il responsabile assegnato a un utente.

Parametri di input dell'azione RemoveManager

Per un esempio su come configurare questa azione, vedi Esempi.

Azione RetrieveManagerChain

Questa azione recupera un responsabile di un utente.

Parametri di input dell'azione RetrieveManagerChain

Per un esempio su come configurare questa azione, vedi Esempi.

Azione AddProfileCardProperty

Questa azione aggiunge una nuova ProfileCardProperty per un'organizzazione.

Parametri di input dell'azione AddProfileCardProperty

Per un esempio su come configurare questa azione, vedi Esempi.

La seguente tabella elenca le autorizzazioni richieste per eseguire le operazioni List e Get su profilecardproperties:

La seguente tabella elenca le autorizzazioni richieste per eseguire l'azione Create (Crea) su profilecardproperties:

Azione RemoveProfileCardProperty

Questa azione rimuove una ProfileCardProperty per un'organizzazione.

Parametri di input dell'azione RemoveProfileCardProperty

Per un esempio su come configurare questa azione, vedi Esempi.

Esempi di azioni

Questa sezione descrive come eseguire alcune delle azioni in questo connettore.

Esempio - AddGroupMember

1. Nella finestra di dialogo Configure connector task, fai clic su Actions.
2. Seleziona l'azione AddGroupMember, quindi fai clic su Fine.
3. Nella sezione Input attività dell'attività Connettori, fai clic su connectorInputPayload e poi inserisci un valore simile al seguente nel campo Default Value:

   {
     "MemberId": "5408040c-fb7d-4c36-8b67-3b66e9edaad3",
     "GroupId": "0f6e79a7-3578-48b4-9dde-decfbb7bb100"
     }
     

Questa azione restituisce il messaggio di conferma di AddGroupMember. Se l'azione ha esito positivo, il parametro di risposta connectorOutputPayload dell'attività AddGroupMember ha un valore simile al seguente:

[{
  "Success": "True"
  }]
  

Esempio: RemoveGroupMember

1. Nella finestra di dialogo Configure connector task, fai clic su Actions.
2. Seleziona l'azione RemoveGroupMember, quindi fai clic su Fine.
3. Nella sezione Input attività dell'attività Connettori, fai clic su connectorInputPayload e poi inserisci un valore simile al seguente nel campo Default Value:

   {
     "MemberId": "5408040c-fb7d-4c36-8b67-3b66e9edaad3",
     "GroupId": "0f6e79a7-3578-48b4-9dde-decfbb7bb100"
     }
     

Se l'azione ha esito positivo, il parametro RemoveGroupMember della risposta connectorOutputPayload ha un valore simile al seguente:

[{
  "Success": "True"
  }]
  

Esempio: AddGroupMember(Guest Account)

1. Nella finestra di dialogo Configure connector task, fai clic su Actions.
2. Seleziona l'azione AddGroupMember, quindi fai clic su Fine.
3. Nella sezione Input attività dell'attività Connettori, fai clic su connectorInputPayload e poi inserisci un valore simile al seguente nel campo Default Value:

   {
     "MemberId": "735fac93-32df-45c9-b6a3-beee95270a6a",
     "GroupId": "0f6e79a7-3578-48b4-9dde-decfbb7bb100"
     }
     

Se l'azione ha esito positivo, il parametro AddGroupMember della risposta connectorOutputPayload ha un valore simile al seguente:

[{
  "Success": "True"
  }]
  

Esempio: RemoveGroupMember(Guest Account)

1. Nella finestra di dialogo Configure connector task, fai clic su Actions.
2. Seleziona l'azione RemoveGroupMember, quindi fai clic su Fine.
3. Nella sezione Input attività dell'attività Connettori, fai clic su connectorInputPayload e poi inserisci un valore simile al seguente nel campo Default Value:

   {
     "MemberId": "735fac93-32df-45c9-b6a3-beee95270a6a",
     "GroupId": "0f6e79a7-3578-48b4-9dde-decfbb7bb100"
     }
     

Se l'azione ha esito positivo, il parametro RemoveGroupMember della risposta connectorOutputPayload ha un valore simile al seguente:

[{
  "Success": "True"
  }]
  

Esempio: AddUserApplicationRoleAssignment

1. Nella finestra di dialogo Configure connector task, fai clic su Actions.
2. Seleziona l'azione AddUserApplicationRoleAssignment, quindi fai clic su Fine.
3. Nella sezione Input attività dell'attività Connettori, fai clic su connectorInputPayload e poi inserisci un valore simile al seguente nel campo Default Value:

   {
     "UserId": "3558ca6e-2c2e-41d3-a854-bf9249a3c913",
     "ResourceId": "3a914726-ab97-49a0-ab7d-4f742fbc271e",
     "AppRoleId": "820afb79-d975-4da7-8f29-0e2c0cff1217"
     }
     

Se l'azione ha esito positivo, il parametro AddUserApplicationRoleAssignment della risposta connectorOutputPayload ha un valore simile al seguente:

[{
  "Success": "True"
  }]
  

Esempio: RemoveUserApplicationRoleAssignment

1. Nella finestra di dialogo Configure connector task, fai clic su Actions.
2. Seleziona l'azione RemoveUserApplicationRoleAssignment, quindi fai clic su Fine.
3. Nella sezione Input attività dell'attività Connettori, fai clic su connectorInputPayload e poi inserisci un valore simile al seguente nel campo Default Value:

   {
     "UserId": "3558ca6e-2c2e-41d3-a854-bf9249a3c913",
     "AppRoleAssignmentId": "bspYNS4s00GoVL-SSaPJE0xC2--0GxxIu8uS4aeindU"
     }
     

Se l'azione ha esito positivo, il parametro RemoveUserApplicationRoleAssignment della risposta connectorOutputPayload ha un valore simile al seguente:

[{
  "Success": "True"
  }]
  

Esempio - AddGroupApplicationRoleAssignment

1. Nella finestra di dialogo Configure connector task, fai clic su Actions.
2. Seleziona l'azione AddGroupApplicationRoleAssignment, quindi fai clic su Fine.
3. Nella sezione Input attività dell'attività Connettori, fai clic su connectorInputPayload e poi inserisci un valore simile al seguente nel campo Default Value:

   {
     "ResourceId": "3a914726-ab97-49a0-ab7d-4f742fbc271e",
     "AppRoleId": "820afb79-d975-4da7-8f29-0e2c0cff1217",
     "GroupId": "0f6e79a7-3578-48b4-9dde-decfbb7bb100"
     }
     

Se l'azione ha esito positivo, il parametro AddGroupApplicationRoleAssignment della risposta connectorOutputPayload ha un valore simile al seguente:

[{
  "Success": "True"
  }]
  

Esempio - RemoveGroupApplicationRoleAssignment

1. Nella finestra di dialogo Configure connector task, fai clic su Actions.
2. Seleziona l'azione RemoveGroupApplicationRoleAssignment, quindi fai clic su Fine.
3. Nella sezione Input attività dell'attività Connettori, fai clic su connectorInputPayload e poi inserisci un valore simile al seguente nel campo Default Value:

   {
     "GroupId": "0f6e79a7-3578-48b4-9dde-decfbb7bb100",
     "AppRoleAssignmentId": "p3luD3g1tEid3t7Pu3uxAMT7DwI3p29HlrxMuZ143eU"
     }
     

Se l'azione ha esito positivo, il parametro RemoveGroupApplicationRoleAssignment della risposta connectorOutputPayload ha un valore simile al seguente:

[{
  "Success": "True"
  }]
  

Esempio - ActivateDirectoryRole

1. Nella finestra di dialogo Configure connector task, fai clic su Actions.
2. Seleziona l'azione ActivateDirectoryRole, quindi fai clic su Fine.
3. Nella sezione Input attività dell'attività Connettori, fai clic su connectorInputPayload e poi inserisci un valore simile al seguente nel campo Default Value:

    {
     "RoleTemplateId": "f023fd81-a637-4b56-95fd-791ac0226033"
     } 
     

Se l'azione ha esito positivo, il parametro ActivateDirectoryRole della risposta connectorOutputPayload ha un valore simile al seguente:

[{
  "id": "c865d9cb-57da-416c-97a3-753e733da678",
  "roleTemplateId": "f023fd81-a637-4b56-95fd-791ac0226033",
  "displayName": "Service Support Administrator",
  "description": "Can read service health information and manage support tickets."
  }]
  

Esempio - VerifyDomain

1. Nella finestra di dialogo Configure connector task, fai clic su Actions.
2. Seleziona l'azione VerifyDomain, quindi fai clic su Fine.
3. Nella sezione Input attività dell'attività Connettori, fai clic su connectorInputPayload e poi inserisci un valore simile al seguente nel campo Default Value:

   {
     "Id": "eternalsolarsolutions.com"
     } 
     

Se l'azione ha esito positivo, il parametro VerifyDomain della risposta connectorOutputPayload ha un valore simile al seguente:

[{
  "Success": "True"
  }]
  

Esempio: ChangePassword

1. Nella finestra di dialogo Configure connector task, fai clic su Actions.
2. Seleziona l'azione ChangePassword, quindi fai clic su Fine.
3. Nella sezione Input attività dell'attività Connettori, fai clic su connectorInputPayload e poi inserisci un valore simile al seguente nel campo Default Value:

   {
     "NewPassword": "XXX@9876",
     "CurrentPassword": "XXX@123"
     }
     

Se l'azione ha esito positivo, il parametro ChangePassword della risposta connectorOutputPayload ha un valore simile al seguente:

[{
  "Success": "True"
  }]
  

Esempio: ResetPassword

1. Nella finestra di dialogo Configure connector task, fai clic su Actions.
2. Seleziona l'azione ResetPassword, quindi fai clic su Fine.
3. Nella sezione Input attività dell'attività Connettori, fai clic su connectorInputPayload e poi inserisci un valore simile al seguente nel campo Default Value:

   {
     "Password": "XXX@9876",
     "UserId": "3558ca6e-2c2e-41d3-a854-bf9249a3c913"
     }
     

Se l'azione ha esito positivo, il parametro ResetPassword della risposta connectorOutputPayload ha un valore simile al seguente:

[{
  "Success": "True"
  }]
  

Esempio: AssignLicense

1. Nella finestra di dialogo Configure connector task, fai clic su Actions.
2. Seleziona l'azione AssignLicense, quindi fai clic su Fine.
3. Nella sezione Input attività dell'attività Connettori, fai clic su connectorInputPayload e poi inserisci un valore simile al seguente nel campo Default Value:

   {
     "UserID": "3558ca6e-2c2e-41d3-a854-bf9249a3c913",
     "UserPrincipalName": "Gcp_test@z8474.onmicrosoft.com",
     "AddLicenseSkuId": "6ec92958-3cc1-49db-95bd-bc6b3798df71"
     }
     

Se l'azione ha esito positivo, il parametro AssignLicense della risposta connectorOutputPayload ha un valore simile al seguente:

[{
  "Success": "True"
  }]
  

Esempio: RemoveLicense

1. Nella finestra di dialogo Configure connector task, fai clic su Actions.
2. Seleziona l'azione AssignLicense, quindi fai clic su Fine.
3. Nella sezione Input attività dell'attività Connettori, fai clic su connectorInputPayload e poi inserisci un valore simile al seguente nel campo Default Value:

   {
     "UserID": "3558ca6e-2c2e-41d3-a854-bf9249a3c913",
     "UserPrincipalName": "Gcp_test@z8474.onmicrosoft.com",
     "RemoveLicenses": "6ec92958-3cc1-49db-95bd-bc6b3798df71"
     }
     

Se l'azione ha esito positivo, il parametro RemoveLicense della risposta connectorOutputPayload ha un valore simile al seguente:

[{
  "Success": "True"
  }]
  

Esempio - FetchAdditionalUserFields

1. Nella finestra di dialogo Configure connector task, fai clic su Actions.
2. Seleziona l'azione FetchAdditionalUserFields, quindi fai clic su Fine.
3. Nella sezione Input attività dell'attività Connettori, fai clic su connectorInputPayload e poi inserisci un valore simile al seguente nel campo Default Value:

   {
     "UserId": "9630c9d7-cf15-4406-8d21-598e41a058cc"
     } 
     

Se l'azione ha esito positivo, il parametro FetchAdditionalUserFields della risposta connectorOutputPayload ha un valore simile al seguente:

[{
    "id": "9630c9d7-cf15-4406-8d21-598e41a058cc",
    "deleteddatetime": null,
    "accountenabled": "true",
    "agegroup": null,
    "businessphones": "",
    "city": null,
    "companyname": null,
    "consentprovidedforminor": null,
    "country": null,
    "createddatetime": "2024-04-12T10:24:42Z",
    "creationtype": null,
    "department": null,
    "displayname": "Azure_AD_Test",
    "employeehiredate": null,
    "employeeid": null,
    "employeeleavedatetime": null,
    "employeetype": null,
    "externaluserstate": null,
    "externaluserstatechangedatetime": null,
    "faxnumber": null,
    "givenname": null,
    "imaddresses": "",
    "isresourceaccount": null,
    "jobtitle": null,
    "lastpasswordchangedatetime": "2024-05-14T05:07:15Z",
    "legalagegroupclassification": null,
    "mail": null,
    "mailnickname": "Azure_AD_Test",
    "mobilephone": null,
    "officelocation": null,
    "onpremisesdistinguishedname": null,
    "onpremisesdomainname": null,
    "onpremisesimmutableid": null,
    "onpremiseslastsyncdatetime": null,
    "onpremisessamaccountname": null,
    "onpremisessecurityidentifier": null,
    "onpremisessyncenabled": null,
    "onpremisesuserprincipalname": null,
    "othermails": "",
    "passwordpolicies": null,
    "postalcode": null,
    "preferreddatalocation": null,
    "preferredlanguage": null,
    "proxyaddresses": "",
    "securityidentifier": "S-1-12-1-2519779799-1141296917-2388205965-3428360257",
    "showinaddresslist": null,
    "signinsessionsvalidfromdatetime": "2024-05-14T05:07:15Z",
    "state": null,
    "streetaddress": null,
    "surname": null,
    "usagelocation": "IN",
    "userprincipalname": "Azure_AD_Test@z8474.onmicrosoft.com",
    "usertype": "Member",
    "aboutme": null,
    "birthday": "0001-01-01T08:00:00Z",
    "hiredate": "0001-01-01T08:00:00Z",
    "interests": "",
    "mysite": null,
    "pastprojects": "",
    "preferredname": "",
    "responsibilities": "",
    "schools": "",
    "skills": "",
    "assignedlicenses": "",
    "assignedplans": "[\r\n  {\r\n    \"assignedDateTime\": \"2024-05-16T10:17:45Z\",\r\n    \"capabilityStatus\": \"Deleted\",\r\n    \"service\": \"DynamicsNAV\",\r\n    \"servicePlanId\": \"3f2afeed-6fb5-4bf9-998f-f2912133aead\"\r\n  }\r\n]",
  "authorizationinfo_certificateuserids": "",
  "identities": "[\r\n  {\r\n    \"signInType\": \"userPrincipalName\",\r\n    \"issuer\": \"z8474.onmicrosoft.com\",\r\n    \"issuerAssignedId\": \"Azure_AD_Test@z8474.onmicrosoft.com\"\r\n  }\r\n]",
  "licenseassignmentstates": "",
  "onpremisesextensionattributes_extensionattribute1": null,
  "onpremisesextensionattributes_extensionattribute2": null,
  "onpremisesextensionattributes_extensionattribute3": null,
  "onpremisesextensionattributes_extensionattribute4": null,
  "onpremisesextensionattributes_extensionattribute5": null,
  "onpremisesextensionattributes_extensionattribute6": null,
  "onpremisesextensionattributes_extensionattribute7": null,
  "onpremisesextensionattributes_extensionattribute8": null,
  "onpremisesextensionattributes_extensionattribute9": null,
  "onpremisesextensionattributes_extensionattribute10": null,
  "onpremisesextensionattributes_extensionattribute11": null,
  "onpremisesextensionattributes_extensionattribute12": null,
  "onpremisesextensionattributes_extensionattribute13": null,
  "onpremisesextensionattributes_extensionattribute14": null,
  "onpremisesextensionattributes_extensionattribute15": null,
  "onpremisesprovisioningerrors": "",
  "provisionedplans": "",
  "serviceprovisioningerrors": "",
  "customsecurityattributes": "{\r\n  \"ConnectorTesting\": {\r\n    \"@odata.type\": \"#microsoft.graph.customSecurityAttributeValue\",\r\n    \"FavouriteSport\": \"cricket\",\r\n    \"FavouriteMovie\": \"3 idiots\"\r\n  }\r\n}",
  "signinactivity_lastsignindatetime": "2024-05-14T07:04:51Z",
  "signinactivity_lastsigninrequestid": "ed35b322-d0d9-4fcb-8e71-f9ee7e065e00",
  "signinactivity_lastnoninteractivesignindatetime": "2024-05-15T09:00:02Z",
  "signinactivity_lastnoninteractivesigninrequestid": "0d4ce88b-710a-440f-a612-f590954d6800",
  "signinactivity_lastsuccessfulsignindatetime": "2024-05-15T06:45:42Z",
  "signinactivity_lastsuccessfulsigninrequestid": "64643e9d-3468-4e4d-b7c3-8bd316956600"
  }  
  

Esempio - AddGroupOwner

1. Nella finestra di dialogo Configure connector task, fai clic su Actions.
2. Seleziona l'azione AddGroupOwner, quindi fai clic su Fine.
3. Nella sezione Input attività dell'attività Connettori, fai clic su connectorInputPayload e poi inserisci un valore simile al seguente nel campo Default Value:

   {
     "GroupId": "0f6e79a7-3578-48b4-9dde-decfbb7bb100",
     "OwnerId": "9630c9d7-cf15-4406-8d21-598e41a058cc"
     }
     

Se l'azione ha esito positivo, il parametro AddGroupOwner response dell'attività connectorOutputPayload ha un valore simile al seguente:

[{
  "Success": "True"
  }]
  

Esempio: RemoveGroupOwner

1. Nella finestra di dialogo Configure connector task, fai clic su Actions.
2. Seleziona l'azione RemoveGroupOwner, quindi fai clic su Fine.
3. Nella sezione Input attività dell'attività Connettori, fai clic su connectorInputPayload e poi inserisci un valore simile al seguente nel campo Default Value:

   {
     "GroupId": "0f6e79a7-3578-48b4-9dde-decfbb7bb100",
     "OwnerId": "9630c9d7-cf15-4406-8d21-598e41a058cc"
     }
     

Se l'azione ha esito positivo, il parametro RemoveGroupOwner della risposta connectorOutputPayload ha un valore simile al seguente:

[{
  "Success": "True"
  }]
  

Esempio - InviteExternalUser

1. Nella finestra di dialogo Configure connector task, fai clic su Actions.
2. Seleziona l'azione InviteExternalUser, quindi fai clic su Fine.
3. Nella sezione Input attività dell'attività Connettori, fai clic su connectorInputPayload e poi inserisci un valore simile al seguente nel campo Default Value:

   {
     "UserEmailAddress": "taleprajyot97@gmail.com",
     "RedirectURL": "https://www.example.com"
     }
     

Questa azione restituisce il messaggio di conferma di InviteExternalUser. Se l'azione ha esito positivo, il parametro InviteExternalUserresponseconnectorOutputPayload dell'attività ha un valore simile al seguente:

[{
  "Success": "True",
  "Id": "70905aef-361f-4cb1-8d04-41f9e377ebd3",
  "ReedemURL": "https://login.microsoftonline.com/redeem?rd=https%3a%2f%2finvitations.microsoft.com%2fredeem%2f%3ftenant%3d9b25e811-f983-4982-82e4-263c1ca48112%26user%3d70905aef-361f-4cb1-8d04-41f9e377ebd3%26ticket%3dx5aOZc%25252bE9XslKcOdb101qLnoe2V%25252b8%25252beeFlNhYA5WvTg%25253d%26ver%3d2.0",
  "InvitedUserId": "d5eeb199-a544-4985-b726-e3073751050c"
  }]
  

Esempio: AddPhoneAuthenticationMethod

1. Nella finestra di dialogo Configure connector task, fai clic su Actions.
2. Seleziona l'azione AddPhoneAuthenticationMethod, quindi fai clic su Fine.
3. Nella sezione Input attività dell'attività Connettori, fai clic su connectorInputPayload e poi inserisci un valore simile al seguente nel campo Default Value:

   {
     "PhoneType": "mobile",
     "UserID": "93e42f0d-74d7-445b-b15a-dd6ceb013d81",
     "PhoneNumber": "+91 9898989890"
     }
     

Se l'azione ha esito positivo, il parametro connectorOutputPayload della risposta AddPhoneAuthenticationMethod dell'attività ha un valore simile al seguente:

[{
  "Success": "True"
  }]
  

Esempio: RemovePhoneAuthenticationMethod

1. Nella finestra di dialogo Configure connector task, fai clic su Actions.
2. Seleziona l'azione RemovePhoneAuthenticationMethod, quindi fai clic su Fine.
3. Nella sezione Input attività dell'attività Connettori, fai clic su connectorInputPayload e poi inserisci un valore simile al seguente nel campo Default Value:

   {
     "PhoneType": "mobile",
     "UserID": "93e42f0d-74d7-445b-b15a-dd6ceb013d81",
     "PhoneNumber": "+91 9898989890"
     }
     

Se l'azione ha esito positivo, il parametro connectorOutputPayload della risposta RemovePhoneAuthenticationMethod dell'attività ha un valore simile al seguente:

[{
  "Success": "True"
  }]
  

Esempio: UpdatePhoneAuthenticationMethod

1. Nella finestra di dialogo Configure connector task, fai clic su Actions.
2. Seleziona l'azione UpdatePhoneAuthenticationMethod, quindi fai clic su Fine.
3. Nella sezione Input attività dell'attività Connettori, fai clic su connectorInputPayload e poi inserisci un valore simile al seguente nel campo Default Value:

   {
     "securityComplianceNotificationPhones": "9899999999",
     "securityComplianceNotificationMails": "abc@gmail.com"
     }
     

Se l'azione ha esito positivo, il parametro UpdatePhoneAuthenticationMethod della risposta connectorOutputPayload ha un valore simile al seguente:

[{
  "Success": "True"
  }]
  

Esempio - AddPrivilegedRole

1. Nella finestra di dialogo Configure connector task, fai clic su Actions.
2. Seleziona l'azione AddPrivilegedRole, quindi fai clic su Fine.
3. Nella sezione Input attività dell'attività Connettori, fai clic su connectorInputPayload e poi inserisci un valore simile al seguente nel campo Default Value:

   {
     "PrincipalId": "8cbe82b6-0dd5-4f10-bf67-82bf88ac6cb8",
     "RoleDefinitionId": "729827e3-9c14-49f7-bb1b-9608f156bbb8",
     "Justification": "Add Privileged Role",
     "ScheduleInfo": "{\n\"StartDateTime\" : \"2022-09-09T21:31:27.91Z\",\n\"Expiration\"    : {\n\"Type\"        : \"Eligible\"}\n}"
     }
     

Se l'azione ha esito positivo, il parametro di risposta connectorOutputPayload dell'attività AddPrivilegedRole ha un valore simile al seguente:ç

[{
  "Success": "True"
  }]
  

Esempio: RemovePrivilegedRole

1. Nella finestra di dialogo Configure connector task, fai clic su Actions.
2. Seleziona l'azione RemovePrivilegedRole, quindi fai clic su Fine.
3. Nella sezione Input attività dell'attività Connettori, fai clic su connectorInputPayload e poi inserisci un valore simile al seguente nel campo Default Value:

   {
     "PrincipalId": "8cbe82b6-0dd5-4f10-bf67-82bf88ac6cb8",
     "RoleDefinitionId": "729827e3-9c14-49f7-bb1b-9608f156bbb8",
     "Justification": "Removing Privileage Role"
     }
     

Se l'azione ha esito positivo, il parametro RemovePrivilegedRole della risposta connectorOutputPayload ha un valore simile al seguente:

[{
  "Success": "True"
  }]
  

Esempio: RetrieveUserPhoto

1. Nella finestra di dialogo Configure connector task, fai clic su Actions.
2. Seleziona l'azione RetrieveUserPhoto, quindi fai clic su Fine.
3. Nella sezione Input attività dell'attività Connettori, fai clic su connectorInputPayload e poi inserisci un valore simile al seguente nel campo Default Value:

   {
     "UserId": "8e22c728-c523-436b-8f46-3b21cc1b5f80"
     } 
     

Se l'azione ha esito positivo, il parametro RetrieveUserPhoto della risposta connectorOutputPayload ha un valore simile al seguente:

[{
    "Status": "Success",
    "FileData": "77+9UE5HDQoaCgAAAA1JSERSAAADUgAAAjYIBgAAAFo077+977+9AAAAAXNSR0IA77+977+9HO+/vQAAAARnQU1BAADvv73vv70L77+9YQUAAAAJcEhZcwAADu+/vQAADu+/vQHvv71v77+9ZAAA77+977+9SURBVHhe77+977+9ZXwcV9K+LWlmZCbvv71O77+977+977+9ZO+/vcmG77+9Ge+/vThmZmZm77+9OO+/vcmG77+977+9MTMzM++/vS0z77+977+977+9eu+/ve+/vXTvv71o77+9KAvvv73vv73vv71w77+9DjRO77+977+9Vl3vv70677+9KWsrR2zvv71zEe+/ve+/vUTvv73vv717KGrvv709EO+/ve+/vWjvv71RG01777+977+9Me+/ve+/vWjvv73vv719OmJLyqfZuu+/vRHvv71ZK++/vQ7Uj9iJ77+977+9du+/vUXEslrvv73vv73vv70uzbzvv70pFu+/vUrvv709Yl4P77+9eu+/vSDvv73vv71n77+977+977+9Gu+/ve+/vV3vv71sP2Vm77+977+9be+/vWbvv707RmxV77+9VFvvv70u77+9Fu+/ve+/vdqi77+9aTbvv71N77+977+9Re+/ve+/vWPvv70tYe+/vRXvv73vv70677+9bu+/vTRbS++/ve+/ve+/vWxkP1vvv71FbWt377+977+9LdW277+977+977+977+977+9ae+/ve+/vXvvv73vv73vv70Z77+9Xe+/vSLvv73vv70X77+977+9E++/vT1ob1/vv71+ae+/ve+/vWx3by1P77+9XT3vv71sL++/ve+/ve+/vWbvv73vv73vv71m77+9F+e0s2vvv712dErvv73vv73vv73vv73vv73vv71p77+977+9Le+/vW/vv73vv71oZ0vvv73vv70577+9R3tb77+92b7vv70R77+977+9KmIHKQ/vv73vv73agdapdu+/vU3vv73vv73vv73vv73vv71zXe+/ve+/ve+/ve+/ve+/vRTvv70777+977+977+96pqK77+9LO+/vXN077+9PO+/ve+/ve+/vVp2f++/vdOgNO+/ve+/veyBlO+/ve+/vQdQ77+9cO+/vTc477+9bBDvv71S77+977+977+977+9Zu+/ve+/vW8I77+977+977+9ZQ8paFnvv70LWnxwYe+/ve+/vVEWNBvvv71O77+977+9eQMKW++/vV8x77+977+9FO+/vd6k77+977+9LmHvv70eRS3erQBiG++/vXXvv71DzLI577+9LO+/vT3vv73vv71077+9Ze+/ve+/ve+/vTcebe+/vWbvv73vv71E77+9UEPvv71r77+9NMus77+9Zu+/ve+/vUVsXe+/ve+/ve+/ve+/ve+/vWZr77+9c29qRG0177+9VdWi77+977+9eu+/ve+/ve+/vUlfTe+/ve+/vW/vv73NujVTbX3vv73vv73vv73vv70V77+9He+/ve+/vXUj77+977+9AdeeMe+/ve+/ve+/ve+/ve+/ve+/vQHvv73vv70Y77+9aFcj77+9Y2Pvv700Zjtpb2vvv73vv73vv73vv73ZmHvXnHvvv70Y77+904Lvv73vv70y77+977+9EO+/ve+/vRjvv73vv71077+9dDvbs++/ve+/vXsX4bqU77+9Wu+/vVsH77+977+977+977+9P1vvv73vv70y77+9fO+/ve+/vV8pZd6rJe+/vXvvv70cy6Yef++/ve+/vWXvv71U1LJf77+9Wg3vv73vv71j1otF77+9NO+/ve+/vQTvv73vv70A77+9SO+/vWZHD++/vQ3vv71ta++/ve+/ve+/veO+rmDvv73vv73vv71c77+9cD1+77+9Hu+/ve+/vSpG77+977+9Y++/ve+/vWfvv73vv73vv70zMXvvv73vv73vv73
  ...[too long to view on UI. Please use the API to view the full content.]
  

Esempio: UpdateUserPhoto

1. Nella finestra di dialogo Configure connector task, fai clic su Actions.
2. Seleziona l'azione UpdateUserPhoto, quindi fai clic su Fine.
3. Nella sezione Input attività dell'attività Connettori, fai clic su connectorInputPayload e poi inserisci un valore simile al seguente nel campo Default Value:

   {
     "UserId": "9630c9d7-cf15-4406-8d21-598e41a058cc",
     "Content": "iVBORw0KGgoAAAANSUhEUgAAA1IAAAI2CAIAAADVVi6oAAAgAElEQVR4AZy9d3Rc1dX3r3POHVmWrG6ckIQHN0gCCYEkT/IkJA89lARc1Xsf1ZlR78W2iis4BFuybMAFMMW4qctFknu31XvvzTbu0tx9fmufOzMWJe+b97fWXmede2ekBYs/8sm3bJm1uLAry9jJt2jFq9Khl6XDL0vFr0ilr0pHXlMdf52ee5tdXU5b3diAN50IYHdCyYMINh1FIJpCnJmcRCGFQSqBdDNIJzhp5H4Su5FIx5PYYDzrjaVdcaxRS+qjyWWNdFlHL2jZBR27ECNdiqNX41l9HG1MYI0JtCWBtSTSjiTWnSz1pNCuZNKXKvWl0e4U0p/GhtLZcDodz2QjmWw0i42soiOZdDiDDaXToVQ6ms76k2lvEuuKZ71xbCBJ6o+nA7F0IIb260ifhg5p6EAkHdGycS0bjaJjGjYWxSY17IZOmtCQ61p6P0a6HU1vRtPbsfRePH2QQO8lkXtJdDqN4aRTfRbRryaQQ+Ucqs+mshj9GiqvocpLyKU8h0CueMwmPJtCDoE8CtlMn2cxnWsh51pCnrWca8FzzSHPAtZYyqusIdMG0s15hq2cOkdOniUnW8hxVI5V6WPpdDSd1kn3IsndKPZNOL2hZteD6HgAHfSnff6s1ZM1u9NmD9biKTW500Z3qdGDNnmxFi+pyYO2+7BWL9Lmy9q8WbuP1OHHegJZVwDr8qc9gawvkPYF0cEgOhTMhkPYcKhqIIj2BpP+IDoQQkfD2WgEG4mgY5EqPCPodS27FUfvJ5lPpVnJGVaQbS9n28o5c+V1j+rXzYWN8+RN9vCuLWyep99kL2901G+Yo19rAevw33p6vdX9XPM72Wwiiw2l0v5U1p9Ge1Kk1gRaH8dOR7Ayf/alh2qnk7RjhWrbUmnLO6p332DrX6fZr0iZL7KUF1jCn1TaP86K/P2siN9Zhj43R/1b68DfWPv+ysbrlw5uT9g6L7JducjeeZGjy6J5zo/buyxwdF9g77nIwfcJ+9Bfzo34pX3MMw4Jv7LP/K3tpj/b5L9gu/0Fq89fn130zpzyFXNOONuecZ1z0WtOnd+ctiDrjkCbwTDH4Qjrm9qf3on9yd34H02n/Jc+9TFIf1xOX6hPexwyF0Da49NJj00nPXYndt7tuB9N6hyGImx71datfrOueNHTrtKR5axkmVS2fHaN67wLvovq1c+26f7cl/zqZPbye5u99NuC4JMI2B8LFelwIodffg/qtkBzIbTthI5dvHMP7/4cp+dL3vcVH9jPBw/CUDEfKYPRMj5Wzscq+dgRPirOh5dK8VH5d04YKYVR8YOj5TBSir9kpIwPlcJwKQyXwHAJFwNDxfg4VGx6lAcP8YGHA/0H8bH/EO8Tl76DeOk7CP378Z+wfx/v3wf9+6Dva7kXT+jbB31fQe9X0P0V79mH0/0V71LmS979BXR9bjp59xe86wve+Tl07OWdnxtnL+/cCx2fKcM7PoP2T6H9Uy5OaPuEt38C7Z/wtj3Qsou37sZp2cNb9sgte3gzDjTv4U27efNO3vwxb/4Ip0lM807etBMaP4KGHdCwgzd+iO8bP+SNH0KT4aXhfcN2qC/k9dvlum1Qvw3qxGPdNj5joN74WFsw8z3eDW8KeJ34qLYA3xhHrsuH+nxel89r83ndVsPP1hZA7VbAx628Lh8atvLGfF6/Va4v4LVbceryeaPxfWM+NObzhgLegC+VAeXeUIAX/KgA3xu/gL+wYSv+lGmMH+GbpgLT4HdmPP7f780FvHnrw2nZyvHNNpyWfN4i7k3boLmAt4pp2cZbC7npbNnGWwrxo5Z8aM0X39kGbQWG6djK2/OhrYC35z+cjnxow/e8Ix/E8M4C6MjnnQUPp2sb79qGj8rZOeOufPS9E7rF
     ...[too long to view on UI. Please use the API to view the full content.]
     

Se l'azione ha esito positivo, il parametro UpdateUserPhoto della risposta connectorOutputPayload ha un valore simile al seguente:

 [{
  "Status": "Success"
  }]
  

Esempio: RemoveUserPhoto

1. Nella finestra di dialogo Configure connector task, fai clic su Actions.
2. Seleziona l'azione RemoveUserPhoto, quindi fai clic su Fine.
3. Nella sezione Input attività dell'attività Connettori, fai clic su connectorInputPayload e poi inserisci un valore simile al seguente nel campo Default Value:

    {
     "UserId": "9630c9d7-cf15-4406-8d21-598e41a058cc"
     } 
     

Se l'azione ha esito positivo, il parametro RemoveUserPhoto della risposta connectorOutputPayload ha un valore simile al seguente:

 [{
  "Status": "Success"
  }]
  

Esempio - AssignManager

1. Nella finestra di dialogo Configure connector task, fai clic su Actions.
2. Seleziona l'azione AssignManager, quindi fai clic su Fine.
3. Nella sezione Input attività dell'attività Connettori, fai clic su connectorInputPayload e poi inserisci un valore simile al seguente nel campo Default Value:

   {
     "UserId": "3558ca6e-2c2e-41d3-a854-bf9249a3c913",
     "ObjectId": "8cbe82b6-0dd5-4f10-bf67-82bf88ac6cb8",
     "ObjectName": "users"
     }
     

Se l'azione ha esito positivo, il parametro AssignManager della risposta connectorOutputPayload ha un valore simile al seguente:

 [{
  "Status": "True"
  }]
  

Esempio - RemoveManager

1. Nella finestra di dialogo Configure connector task, fai clic su Actions.
2. Seleziona l'azione RemoveManager, quindi fai clic su Fine.
3. Nella sezione Input attività dell'attività Connettori, fai clic su connectorInputPayload e poi inserisci un valore simile al seguente nel campo Default Value:

   {
     "UserId": "3558ca6e-2c2e-41d3-a854-bf9249a3c913"
     } 
     

Se l'azione ha esito positivo, il parametro RemoveManager della risposta connectorOutputPayload ha un valore simile al seguente:

 [{
  "Status": "True"
  }]
  

Esempio: RetrieveManagerChain

1. Nella finestra di dialogo Configure connector task, fai clic su Actions.
2. Seleziona l'azione RetrieveManagerChain, quindi fai clic su Fine.
3. Nella sezione Input attività dell'attività Connettori, fai clic su connectorInputPayload e poi inserisci un valore simile al seguente nel campo Default Value:

   {
     "UserId": "8cbe82b6-0dd5-4f10-bf67-82bf88ac6cb8",
     "Levels": "max"
     }
     

Se l'azione ha esito positivo, il parametro RetrieveManagerChain della risposta connectorOutputPayload ha un valore simile al seguente:

[{
  "id": "8cbe82b6-0dd5-4f10-bf67-82bf88ac6cb8",
  "displayName": "test1",
  "manager": "{\r\n  \"@odata.type\": \"#microsoft.graph.user\",\r\n  \"id\": \"9630c9d7-cf15-4406-8d21-598e41a058cc\",\r\n  \"deletedDateTime\": null,\r\n  \"accountEnabled\": true,\r\n  \"ageGroup\": null,\r\n  \"businessPhones\": [],\r\n  \"city\": null,\r\n  \"companyName\": null,\r\n  \"consentProvidedForMinor\": null,\r\n  \"country\": null,\r\n  \"createdDateTime\": \"2024-04-12T10:24:42Z\",\r\n  \"creationType\": null,\r\n  \"department\": null,\r\n  \"displayName\": \"Azure_AD_Test\",\r\n  \"employeeId\": null,\r\n  \"employeeHireDate\": null,\r\n  \"employeeLeaveDateTime\": null,\r\n  \"employeeType\": null,\r\n  \"externalUserState\": null,\r\n  \"externalUserStateChangeDateTime\": null,\r\n  \"faxNumber\": null,\r\n  \"givenName\": null,\r\n  \"isLicenseReconciliationNeeded\": false,\r\n  \"jobTitle\": null,\r\n  \"legalAgeGroupClassification\": null,\r\n  \"mail\": null,\r\n  \"mailNickname\": \"Azure_AD_Test\",\r\n  \"mobilePhone\": null,\r\n  \"onPremisesDistinguishedName\": null,\r\n  \"onPremisesDomainName\": null,\r\n  \"onPremisesImmutableId\": null,\r\n  \"onPremisesLastSyncDateTime\": null,\r\n  \"onPremisesSecurityIdentifier\": null,\r\n  \"onPremisesSamAccountName\": null,\r\n  \"onPremisesSyncEnabled\": null,\r\n  \"onPremisesUserPrincipalName\": null,\r\n  \"otherMails\": [],\r\n  \"passwordPolicies\": null,\r\n  \"officeLocation\": null,\r\n  \"postalCode\": null,\r\n  \"preferredDataLocation\": null,\r\n  \"preferredLanguage\": null,\r\n  \"proxyAddresses\": [],\r\n  \"refreshTokensValidFromDateTime\": \"2024-05-14T05:07:15Z\",\r\n  \"imAddresses\": [],\r\n  \"isResourceAccount\": null,\r\n  \"showInAddressList\": null,\r\n  \"securityIdentifier\": \"S-1-12-1-2519779799-1141296917-2388205965-3428360257\",\r\n  \"signInSessionsValidFromDateTime\": \"2024-05-14T05:07:15Z\",\r\n  \"state\": null,\r\n  \"streetAddress\": null,\r\n  \"surname\": null,\r\n  \"usageLocat
  ...[too long to view on UI. Please use the API to view the full content.]
  

Esempio: AddProfileCardProperty

1. Nella finestra di dialogo Configure connector task, fai clic su Actions.
2. Seleziona l'azione AddProfileCardProperty, quindi fai clic su Fine.
3. Nella sezione Input attività dell'attività Connettori, fai clic su connectorInputPayload e poi inserisci un valore simile al seguente nel campo Default Value:

    {
   "Annotations": "[{"displayName": "Attributes"}]",
   "DirectoryPropertyName": "CustomAttribute15"
   }

Se l'azione ha esito positivo, il parametro connectorOutputPayload della risposta AddProfileCardProperty ha un valore simile al seguente:

 [{
"Status": "True"
}]

Esempio - RemoveProfileCardProperty

1. Nella finestra di dialogo Configure connector task, fai clic su Actions.
2. Seleziona l'azione RemoveProfileCardProperty, quindi fai clic su Fine.
3. Nella sezione Input attività dell'attività Connettori, fai clic su connectorInputPayload e poi inserisci un valore simile al seguente nel campo Default Value:

   {
   "DirectoryPropertyName": "CustomAttribute12"
   } 

Se l'azione ha esito positivo, il parametro connectorOutputPayload della risposta RemoveProfileCardProperty ha un valore simile al seguente:

 [{
"Status": "True"
}]

Esempi di operazioni sulle entità

Questa sezione mostra come eseguire alcune delle operazioni sulle entità in questo connettore.

Esempio: elenca i gruppi

1. Nella finestra di dialogo Configure connector task, fai clic su Entities.
2. Seleziona Gruppi dall'elenco Entity.
3. Seleziona l'operazione LIST, quindi fai clic su Fine.
4. Nella sezione Input attività dell'attività Connettori, puoi impostare la filterClause in base ai requisiti del cliente.

Devi utilizzare gli apici singoli ("'") per racchiudere il valore della clausola di filtro. Puoi utilizzare la clausola di filtro per filtrare i record in base alle colonne.

Puoi anche eseguire operazioni LIST sulle seguenti entità:

• Utente
• GroupMembers
• Domini
• RoleAssignments
• Applicazioni
• Dispositivi
• Contatti
• DirectoryRoleTemplates
• DirectoryRoles
• AdministrativeUnits
• SubscribedSKUs
• PhoneAuthenticationMethod
• Organizzazione
• DeviceLocalCredentials
• ProfileCardProperties

Esempio: recuperare un singolo record dal gruppo

1. Nella finestra di dialogo Configure connector task, fai clic su Entities.
2. Seleziona Gruppi dall'elenco Entity.
3. Seleziona l'operazione GET, quindi fai clic su Fine.
4. Imposta l'ID entità su "bb4756c7-38c0-426b-97aa-03b6443e7f16", ovvero la chiave da trasferire. Per impostare l'ID entità, nella sezione Data Mapper di Mappatura dati, fai clic su Apri editor mappatura dati, inserisci "bb4756c7-38c0-426b-97aa-03b6443e7f16" nel campo Valore di input e scegli EntityId come variabile locale.

Puoi anche eseguire operazioni GET sulle seguenti entità:

• Utente
• GroupMembers
• Domini
• RoleAssignments
• Applicazioni
• Dispositivi
• Contatti
• DirectoryRoleTemplates
• DirectoryRoles
• AdministrativeUnits
• PhoneAuthenticationMethod
• Organizzazione
• UserManagers
• DeviceLocalCredentials

Esempio: elimina un record dal gruppo

1. Nella finestra di dialogo Configure connector task, fai clic su Entities.
2. Seleziona Gruppi dall'elenco Entity.
3. Seleziona l'operazione DELETE, quindi fai clic su Fine.
4. Imposta l'ID entità su "62008bbe-effa-4341-9d29-eac7f67b84fe", ovvero la chiave da trasferire. Per impostare l'ID entità, nella sezione Data Mapper di Mappatura dati, fai clic su Apri editor mappatura dati, inserisci "62008bbe-effa-4341-9d29-eac7f67b84fe" nel campo Valore di input e scegli EntityId come variabile locale.

   Se sono presenti due chiavi composite o primarie, il passaggio di un ID entità potrebbe generare un errore. In questi casi, puoi utilizzare la clausola di filtro, ad esempio id='62008bbe-effa-4341-9d29-eac7f67b84fe'.

Puoi anche eseguire operazioni DELETE sulle seguenti entità:

Esempio: crea un'entità gruppo (Microsoft 365)

1. Nella finestra di dialogo Configure connector task, fai clic su Entities.
2. Seleziona Gruppi dall'elenco Entity.
3. Seleziona l'operazione Create, quindi fai clic su Fine.
4. Nella sezione Data Mapper dell'attività Mappatura dati, fai clic su Open Data Mapping Editor, quindi inserisci un valore simile al seguente nel campo Input Value e scegli EntityId/ConnectorInputPayload come variabile locale.

   {
   "securityEnabled": true,
   "displayName": "GoogleGCP",
   "description": "This Group is creating for gcp testing.",
   "mailEnabled": false,
   "mailNickname": "GoogleGCP",
   "groupTypes": "Unified"
   }

   Questo esempio crea i record dei gruppi. Se l'integrazione ha esito positivo, il parametro di risposta connectorOutputPayload dell'attività Groups ha un valore simile al seguente:

   {
   "id": "30fc13b3-79b3-4ac5-a3ba-684d4e887ecc"
   } 

Esempio: aggiornare un utente

1. Nella finestra di dialogo Configure connector task, fai clic su Entities.
2. Seleziona Utenti dall'elenco Entity.
3. Seleziona l'operazione Update, quindi fai clic su Fine.
4. Nella sezione Data Mapper dell'attività Mappatura dati, fai clic su Open Data Mapping Editor, quindi inserisci un valore simile al seguente nel campo Input Value e scegli EntityId/ConnectorInputPayload/FilterClause come variabile locale.

   {
   "jobTitle": "Software Engineer"
   }

5. Imposta l'ID entità in Data Mapper sull'entità degli utenti. Per impostare l'ID entità, fai clic su Open Data Mapping Editor, quindi inserisci un valore simile al seguente nel campo Input Value e scegli EntityId/ConnectorInputPayload/FilterClause come variabile locale.

   In alternativa, anziché specificare entityId, puoi anche impostare filterClause su 7ad59ec3-1c37-4932-be51-7513fe98c3c3.

   Questo esempio restituisce una risposta simile alla seguente nella variabile di output connectorOutputPayload dell'attività Connettore:

   {
   "id": "7ad59ec3-1c37-4932-be51-7513fe98c3c3"
   }