Skip To Content

Modulo PortalPy

In questo argomento della guida sono elencate le classi e i metodi del modulo PortalPy che è possibile utilizzare per creare script amministrativi per Portal for ArcGIS.

Classe: Portal

Oggetto che rappresenta una connessione URL a un portale. Per creare un'istanza di un oggetto Portal, eseguire codice simile al seguente:

PortalPy.Portal(portalUrl, user, password)

Nelle sezioni seguenti sono elencati i metodi disponibili per Portal. Prima di utilizzare i metodi, tenere presente quanto segue:

  • ID gruppo: per molte delle funzioni di gruppo è necessario un ID gruppo. L'ID è diverso dal nome o dal titolo del gruppo. Per determinare l'ID gruppo, utilizzare la funzione search_groups e specificare il titolo del gruppo per ottenere l'ID.
  • Ora: con molti dei metodi viene restituito un campo orario. L'ora viene restituita in millisecondi dal 1° gennaio 1970. Poiché in Python l'ora deve essere espressa in secondi dal 1° gennaio 1970, dividere per 1000 gli orari restituiti da PortalPy. Nel seguente esempio viene illustrato come convertire l'ora di PortalPy in ora di Python.
    group = portalAdmin.get_group('67e1761068b7453693a0c68c92a62e2e')
    pythontime = time.ctime(group['created']/1000)

Metodi di PortalPy

Di seguito sono descritti i metodi disponibili per Portal.

_init_

Costruttore di Portal. Richiede l'URL del portale e facoltativamente un nome utente e una password.

_init_(self, url, username=None, password=None, key_file=None, cert_file=None, expiration=60, referer=None, proxy_host=None, proxy_port=None, connection=None, workdir=r'c:\users\davi3690\appdata\local\temp\2')

add_group_users

Aggiunge utenti al gruppo specificato. Utilizzare questo metodo solo se l'utente dell'oggetto Portal è un amministratore dell'intero portale oppure il proprietario esplicito del gruppo.

add_group_users(self, user_names, group_id)

Argomenti

ParametroDescrizione

user_names

Stringa obbligatoria che indica un elenco di utenti con valori separati da virgole

group_id

Stringa obbligatoria che specifica l'ID gruppo

Valore restituito

Un dizionario con una chiave not_added, che contiene gli utenti non aggiunti al gruppo.

create_group

Crea un gruppo e, in caso di esito positivo dell'operazione, restituisce un ID gruppo.

create_group(self, title, tags, description=None, snippet=None, access='public', thumbnail=None, is_invitation_only=False, sort_field='avgRating', sort_order='desc', is_view_only=False)

Argomenti

ParametroDescrizione

titolo

Stringa obbligatoria che indica il nome del gruppo

tags

Stringa obbligatoria, elenco di tag con voci delimitate da virgole

descrizione

Stringa facoltativa che include una descrizione dettagliata del gruppo

snippet

Stringa facoltativa, che riepiloga il gruppo in meno di 250 caratteri

access

Stringa facoltativa il cui valore può essere private, public o org

thumbnail

Stringa facoltativa che indica l'URL dell'immagine del gruppo

isInvitationOnly

Valore booleano facoltativo che consente di specificare se gli utenti possono iscriversi su richiesta

sort_field

Stringa facoltativa che consente di specificare l'ordinamento degli elementi condiviso con il gruppo

sort_order

Stringa facoltativa il cui valore può essere asc o desc rispettivamente per l'ordinamento crescente o decrescente

is_view_only

Valore booleano facoltativo che consente di specificare se il gruppo consente le ricerche

Valore restituito

Una stringa che corrisponde all'ID gruppo.

create_group_from_dict

Crea un gruppo e, in caso di esito positivo dell'operazione, restituisce un ID gruppo. Nella maggior parte dei casi si consiglia di utilizzare create_group, in quanto questo metodo accetta un dizionario di gruppo restituito da un'altra chiamata di PortalPy e lo copia.

create_group_from_dict(self, group, thumbnail=None)

Argomenti

ParametroDescrizione

gruppo

dict object

thumbnail

URL dell'immagine

Esempio

create_group({'title': 'Test', 'access':'public'})

delete_group

Elimina un gruppo.

delete_group(self, group_id)

Argomenti

ParametroDescrizione

group_id

Stringa contenente l'ID del gruppo eliminato.

Valore restituito

Valore booleano che indica se l'operazione è o meno riuscita.

delete_user

Elimina un utente dal portale e se necessario elimina o riassegna gruppi ed elementi. Non è possibile eliminare un utente del portale se è proprietario di gruppi o elementi. Se si imposta cascade su True, tali elementi e gruppi verranno riassegnati dall'utente identificato dall'opzione reassign_to. Se si imposta cascade su False, l'eliminazione avrà esito positivo o negativo a seconda che gli elementi e i gruppi dell'utente siano già stati trasferiti.

Con l'opzione cascade questo metodo elimina fino a 10.000 elementi. Se l'utente dispone di più di 10.000 elementi, il metodo non avrà esito positivo.

delete_user(self, username, cascade=False, reassign_to=None)

Argomenti

ParametroDescrizione

nome utente

Stringa obbligatoria che indica il nome dell'utente

cascade

Valore booleano facoltativo in cui True indica che elementi e gruppi verranno riassegnati

reassign_to

Stringa facoltativa che indica il nuovo proprietario di elementi e gruppi

Valore restituito

Valore booleano che indica se l'operazione è riuscita o meno.

generate_token

Genera e restituisce un nuovo token, ma non effettua di nuovo l'accesso. Questo metodo non è necessario quando si utilizza la classe Portal per effettuare chiamate nel portale. Viene fornita per effettuare chiamate nel portale all'esterno della classe Portal.

Il portale utilizza un meccanismo di autenticazione basata su token, in cui un utente fornisce le proprie credenziali e per le chiamate viene utilizzato un token di breve durata. Per la maggior parte delle chiamate effettuate all'API REST di ArcGIS è necessario un token che può essere aggiunto a tali richieste.

generate_token(self, username, password, expiration=60)

Argomenti

ParametroDescrizione

nome utente

Stringa obbligatoria che indica il nome dell'utente

password

Password utente obbligatoria

expiration

Valore intero facoltativo che indica il numero di minuti alla scadenza del token

Valore restituito

Una stringa con il token.

get_group

Restituisce le informazioni sul gruppo per il valore di group_id specificato.

get_group(self, group_id)

Argomenti

ParametroDescrizione

group_id

Stringa obbligatoria che indica il gruppo

Valore restituito

Un oggetto dizionario con le informazioni del gruppo. Le chiavi dell'oggetto dizionario possono includere:

ParametroDescrizione

titolo

Nome del gruppo

isInvitationOnly

Se impostato su true, gli utenti non possono richiedere l'iscrizione al gruppo

proprietario

Nome utente del proprietario del gruppo

descrizione

Descrizione del gruppo

snippet

Breve riepilogo del gruppo

tags

Tag definiti dall'utente che descrivono il gruppo

phone

Informazioni di contatto per il gruppo

thumbnail

Nome file relativo a http://<community-url>/groups/<groupId>/info

creato

Data di creazione dell'account espressa in millisecondi dal 1° gennaio 1970

modified

Data dell'ultima modifica dell'account espressa in millisecondi dal 1° gennaio 1970

access

Può essere impostato su private, org o public

userMembership

Dizionario con le chiavi username e memberType

memberType

Fornisce l'accesso all'utente chiamante (owner, admin, member, none)

get_group_members

Restituisce i membri del gruppo specificato.

get_group_members(self, group_id)

Argomenti

ParametroDescrizione

group_id

Stringa obbligatoria che indica il gruppo

Valore restituito

Un dizionario con le chiavi owner, admins e users.

ParametroDescrizione

proprietario

Valore stringa che indica il proprietario del gruppo

admins

Elenco di stringhe; in genere è uguale al valore di owner

utenti

Elenco di stringhe corrispondente ai membri del gruppo

Esempio

Stampa degli utenti in un gruppo:

response = portal.get_group_members("67e1761068b7453693a0c68c92a62e2e")
for user in response['users'] :
   print user

get_group_thumbnail

Restituisce i byte che costituiscono l'anteprima per il valore di group_id specificato.

get_group_thumbnail(self, group_id)

Argomenti

ParametroDescrizione

group_id

Stringa obbligatoria che specifica l'anteprima del gruppo

Valore restituito

Byte che rappresentano l'immagine.

Esempio

response = portal.get_group_thumbnail("67e1761068b7453693a0c68c92a62e2e")
f = open(filename, 'wb')
f.write(response)

get_users

Restituisce tutti gli utenti all'interno dell'organizzazione del portale.

get_users(self, max_users=1000)

Argomenti

ParametroDescrizione

max_users

Valore intero facoltativo che indica il numero massimo di utenti da restituire

Valore restituito

Un elenco di dizionari. Per ogni dizionario sono disponibili le seguenti chiavi:

ChiaveValore

nome utente

Stringa

storageUsage

Intero

storageQuota

Intero

descrizione

Stringa

tags

Elenco di stringhe

regionale

Stringa

creato

Valore intero che indica la data di creazione dell'account espressa in millisecondi dal 1° gennaio 1970

modified

Valore intero che indica la data dell'ultima modifica dell'account espressa in millisecondi dal 1° gennaio 1970

e-mail

Stringa

culture

Stringa

orgId

Stringa

preferredView

Stringa

gruppi

Elenco di stringhe

role

Stringa (utente, editore, amministratore, <nome_ruolo_personalizzato> [dove <nome_ruolo_personalizzato> è il nome del ruolo personalizzato, ad esempio, hostedservicepublisher])

Legacy:

In Portal for ArcGIS 10.3 e versioni precedenti, i valori consentiti per i ruoli non personalizzati sono org_user, org_publisher e org_admin. Nella versione 10.3.1, questi valori sono stati sostituiti dai valori indicati sopra. È possibile continuare a utilizzare i valori legacy nella versione 10.3.1, ma tali valori potrebbero non essere accettati nelle versioni future.

fullName

Stringa

thumbnail

Stringa

idpUsername

Stringa

Esempio

Stampa tutti i nome utente presenti nel portale:

resp = portalAdmin.get_users() for user in resp:
   print user['username']

get_properties

Restituisce le proprietà del portale, utilizzando la cache a meno che force=True.

get_properties(self, force=False)

get_user

Restituisce le informazioni sull'utente per il valore di username specificato.

get_user(self, username)

Argomenti

ParametroDescrizione

nome utente

Stringa obbligatoria che indica il nome utente su cui si desidera ottenere informazioni

Valore restituito

Se viene trovato l'utente, restituisce un oggetto dizionario con le chiavi seguenti. Se non viene trovato nessun utente, non viene restituito nulla.

ChiaveValore

access

Stringa

creato

Valore intero che indica la data di creazione dell'account espressa in millisecondi dal 1° gennaio 1970

culture

Stringa che indica il codice lingua a due lettere ('it')

descrizione

Stringa

e-mail

Stringa

fullName

Stringa

idpUsername

Stringa che indica il nome dell'utente nel sistema aziendale

gruppi

Elenco di dizionari Per un elenco delle chiavi del dizionario, fare riferimento a get_group.

modified

Valore intero che indica la data dell'ultima modifica dell'account espressa in millisecondi dal 1° gennaio 1970

orgId

Stringa che indica l'ID organizzazione

preferredView

Stringa il cui valore è Web, GIS o null

regionale

Stringa il cui valore è none o un codice paese a due lettere

role

Stringa (utente, editore, amministratore, <nome_ruolo_personalizzato> [dove <nome_ruolo_personalizzato> è il nome del ruolo personalizzato, ad esempio, hostedservicepublisher])

Legacy:

In Portal for ArcGIS 10.3 e versioni precedenti, i valori consentiti per i ruoli non personalizzati sono org_user, org_publisher e org_admin. Nella versione 10.3.1, questi valori sono stati sostituiti dai valori indicati sopra. È possibile continuare a utilizzare i valori legacy nella versione 10.3.1, ma tali valori potrebbero non essere accettati nelle versioni future.

storageUsage

Intero

storageQuota

Intero

tags

Elenco di stringhe

thumbnail

Stringa

nome utente

Stringa

get_version

Restituisce il numero di versione del software utilizzando la cache a meno che force=True. Le informazioni sulla versione vengono recuperate quando si crea l'oggetto portale e quindi vengono memorizzate nella cache per richieste future. Se si desidera effettuare una richiesta al portale e non basarsi sulla cache, impostare l'argomento force su True.

get_version(self, force=False)

Argomenti

ParametroDescrizione

force

Valore booleano; se è true effettua una richiesta, se è false usa la cache

Valore restituito

Una stringa con la versione. La versione è un numero interno che potrebbe non corrispondere alla versione del prodotto installato.

invite_group_users

Invita utenti a un gruppo. L'elenco degli inviti di un utente invitato a un gruppo viene visualizzato nella scheda Gruppi del portale. L'utente può scegliere se accettare o rifiutare l'invito. L'utente che esegue il comando deve essere il proprietario del gruppo.

invite_group_users(self, user_names, group_id, role='group_member', expiration=10080)

Argomenti

ParametroDescrizione

user_names

Stringa obbligatoria costituita da un elenco degli utenti da invitare con valori separati da virgole

group_id

Stringa obbligatoria che specifica l'ID gruppo a cui invitare utenti

role

Stringa facoltativa il cui valore è group_member o group_admin

expiration

Valore intero facoltativo che specifica il periodo di validità dell'invito (in minuti)

Valore restituito

Valore booleano che indica se l'operazione è riuscita o meno.

is_all_ssl

Restituisce True se il portale richiede HTTPS.

is_all_ssl(self)

is_logged_in

Restituisce True se l'utente ha effettuato l'accesso al portale.

is_logged_in(self)

is_org

Restituisce True se il portale è un'organizzazione.

is_org(self)

leave_group

Rimuove l'utente connesso dal gruppo specificato. Per utilizzare questo metodo, l'utente deve essere connesso.

leave_group(self, group_id)

Argomenti

ParametroDescrizione

group_id

Stringa obbligatoria che specifica l'ID gruppo

Valore restituito

Valore booleano che indica se l'operazione è riuscita o meno.

logged_in_user

Restituisce informazioni sull'utente connesso.

logged_in_user(self)

Valore restituito

Un dizionario con le seguenti chiavi:

ChiaveValore

nome utente

Stringa

storageUsage

Intero

descrizione

Stringa

tags

Stringa di valori separati da virgole

creato

Valore intero che indica la data di creazione dell'account espressa in millisecondi dal 1° gennaio 1970

modified

Valore intero che indica la data dell'ultima modifica dell'account espressa in millisecondi dal 1° gennaio 1970

fullName

Stringa

e-mail

Stringa

idpUsername

Stringa che indica il nome dell'utente nel sistema aziendale

login

Accede al portale utilizzando un nome utente e una password. È possibile accedere a un portale quando si crea un oggetto portale oppure più avanti. Funzione utilizzata per accedere in seguito.

login(self, username, password, expiration=60)

Argomenti

ParametroDescrizione

nome utente

Stringa obbligatoria

password

Stringa obbligatoria

expiration

Valore intero facoltativo che indica la durata del token generato

Valore restituito

Una stringa che include il token.

logout

Effettua la disconnessione dal portale. Il portale disattiva gli eventuali token in uso e tutte le successive chiamate al portale saranno anonime finché non ne viene effettuata una con accesso.

logout(self)

Valore restituito

Nessun valore restituito.

reassign_group

Riassegna un gruppo a un altro proprietario.

reassign_group(self, group_id, target_owner)

Argomenti

ParametroDescrizione

group_id

Stringa obbligatoria che indica l'identificatore univoco del gruppo

target_owner

Stringa obbligatoria che indica il nome utente del nuovo proprietario del gruppo

Valore restituito

Valore booleano che indica se l'operazione è riuscita o meno.

remove_group_users

Rimuove utenti da un gruppo.

remove_group_users(self, user_names, group_id)

Argomenti

ParametroDescrizione

user_names

Stringa obbligatoria costituita da un elenco degli utenti con valori separati da virgole

group_id

Stringa obbligatoria che indica l'identificatore univoco del gruppo

Valore restituito

Un dizionario con una chiave notRemoved, che indica l'elenco di utenti non rimossi.

reset_user

Reimposta la password, la domanda di sicurezza e la relativa risposta per un utente. Questa funzione non è valida per i portali configurati con account che provengono da un archivio identità aziendale, come ActiveDirectory o LDAP. Può essere utilizzato solo per utenti incorporati del portale. Se viene specificata una nuova domanda di sicurezza, è necessario fornire una nuova risposta.

reset_user(self, username, password, new_password=None, new_security_question=None, new_security_answer=None)

Argomenti

ParametroDescrizione

nome utente

Stringa obbligatoria che indica l'account da reimpostare

password

Stringa obbligatoria che indica la password corrente

new_password

Stringa facoltativa che indica la nuova password nel caso di reimpostazione della password

new_security_question

Valore intero facoltativo che indica l'eventuale nuova domanda di sicurezza

new_security_answer

Stringa facoltativa che indica la risposta all'eventuale nuova domanda di sicurezza

Valore restituito

Valore booleano che indica se l'operazione è riuscita o meno.

cerca

search(self, q, bbox=None, sort_field='title', sort_order='asc', max_results=1000, add_org=True)

search_groups

Cerca gruppi del portale. Quando si utilizza questo metodo, tenere presente quanto segue:

  • La sintassi delle interrogazioni include molte funzionalità non descritte in questo articolo. Per esaminarle tutte, consultare il riferimento per la ricerca nell'API REST di ArcGIS.
  • Durante la ricerca di gruppi, in genere la ricerca viene effettuata nell'ambito dell'organizzazione. Per comodità, il metodo aggiunge automaticamente l'ID organizzazione all'interrogazione per impostazione predefinita. Se non si desidera che l'API aggiunga tale ID all'interrogazione, impostare add_org su False.

search_groups(self, q, sort_field='title', sort_order='asc', max_groups=1000, add_org=True)

Argomenti

ParametroDescrizione

q

Stringa obbligatoria che indica l'interrogazione

sort_field

Stringa facoltativa; i valori validi possono essere title, owner o created

sort_order

Stringa facoltativa; i valori validi sono asc o desc

max_groups

Valore int facoltativo che indica il numero massimo di gruppi restituiti

add_org

Valore booleano facoltativo che consente di controllare l'esecuzione di ricerche nell'organizzazione

Valore restituito

Un elenco di dizionari. Per ogni dizionario sono disponibili le seguenti chiavi:

ChiaveValore

access

Stringa; valori: private, org o public

creato

Valore intero che indica la data di creazione dell'account espressa in millisecondi dal 1° gennaio 1970

descrizione

Stringa

ID

Stringa che indica l'ID univoco del gruppo

isInvitationOnly

Booleano

isViewOnly

Booleano

modified

Valore intero che indica la data dell'ultima modifica dell'account espressa in millisecondi dal 1° gennaio 1970

proprietario

Stringa che indica il nome utente del proprietario

phone

Stringa

snippet

Stringa che indica un breve riepilogo del gruppo

sortField

Stringa che indica l'ordinamento degli elementi condivisi

sortOrder

Stringa che indica l'ordinamento crescente o decrescente

tags

Elenco di stringhe che include i tag forniti dall'utente per la ricerca

thumbnail

Stringa che indica il nome del file. Aggiungere a http://<community url>/groups/<group id>/info/

titolo

Stringa che indica il nome del gruppo visualizzato agli utenti

search_users

Cerca gli utenti del portale. Quando si utilizza questo metodo, tenere presente quanto segue:

  • La sintassi delle interrogazioni include molte funzionalità non descritte in questo articolo. Per esaminarle tutte, consultare il Search reference nell'API REST di ArcGIS.
  • Durante la ricerca di utenti, solitamente la ricerca viene effettuata nell'ambito dell'organizzazione. Per comodità, il metodo aggiunge automaticamente l'ID organizzazione all'interrogazione per impostazione predefinita. Se non si desidera che l'API aggiunga tale ID all'interrogazione, impostare add_org su False.

search_users(self, q, sort_field='username', sort_order='asc', max_users=1000, add_org=True)

Argomenti

ParametroDescrizione

q

Stringa obbligatoria che indica l'interrogazione

sort_field

Stringa facoltativa; i valori validi possono essere title, owner o created

sort_order

Stringa facoltativa; i valori validi sono asc o desc

max_users

Valore int facoltativo che indica il numero massimo di utenti restituiti

add_org

Valore booleano facoltativo che consente di controllare l'esecuzione di ricerche nell'organizzazione

Valore restituito

Un elenco di dizionari. Per ogni dizionario sono disponibili le seguenti chiavi:

ChiaveValore

creato

Valore intero che indica la data di creazione dell'account espressa in millisecondi dal 1° gennaio 1970

culture

Stringa che indica il codice lingua a due lettere

descrizione

Stringa

fullName

Stringa che indica il nome dell'utente

modified

Valore intero che indica la data dell'ultima modifica dell'account espressa in millisecondi dal 1° gennaio 1970

regionale

Stringa il cui valore può essere none

tags

Elenco di stringhe che include i tag forniti dall'utente per la ricerca

thumbnail

Stringa che indica il nome del file. Aggiungere a http://<community url>/groups/<group id>/info/.

nome utente

Stringa che indica il nome dell'utente

signup

Iscrive gli utenti a Portal for ArcGIS. Questo metodo è valido solo per Portal for ArcGIS e può essere chiamato in modalità anonima. È tuttavia possibile disabilitare l'iscrizione automatica anche nel portale. Vengono inoltre creati solo account incorporati; non funziona con account aziendali che provengono da un archivio identità aziendale.

Con Portal for ArcGIS 10.2.1 e versioni successive è comunque sempre possibile utilizzare un altro metodo denominato createUser. Tale metodo richiede l'accesso come amministratore e può essere utilizzato per creare utenti incorporati o aggiungere account aziendali al portale.

signup(self, username, password, fullname, email)

Argomenti

ParametroDescrizione

nome utente

Stringa obbligatoria; deve essere composta da più 4 caratteri ed essere univoca nel portale

password

Stringa obbligatoria; deve essere maggiore o uguale a 8 caratteri

fullname

Stringa obbligatoria che indica il nome dell'utente

e-mail

Stringa obbligatoria; deve essere un indirizzo e-mail valido

Valore restituito

Valore booleano che indica se l'operazione è riuscita o meno.

update_group

Aggiorna un gruppo. È necessario specificare i valori solo per gli argomenti che si desidera aggiornare.

update_group(self, group_id, title=None, tags=None, description=None, snippet=None, access=None, is_invitation_only=None, sort_field=None, sort_order=None, is_view_only=None, thumbnail=None)

Argomenti

ParametroDescrizione

group_id

Stringa obbligatoria che indica l'ID gruppo da modificare

titolo

Stringa obbligatoria che indica il nome del gruppo da modificare

tags

Stringa obbligatoria, elenco di tag con voci delimitate da virgole

descrizione

Stringa facoltativa che include una descrizione dettagliata del gruppo

snippet

Stringa facoltativa, che riepiloga il gruppo in meno di 250 caratteri

access

Stringa facoltativa il cui valore può essere private, public o org

thumbnail

Stringa facoltativa che indica l'URL dell'immagine del gruppo

isInvitationOnly

Valore booleano facoltativo che consente di specificare se gli utenti possono iscriversi su richiesta

sort_field

Stringa facoltativa che consente di specificare l'ordinamento degli elementi condiviso con il gruppo

sort_order

Stringa facoltativa il cui valore può essere asc o desc rispettivamente per l'ordinamento crescente o decrescente

is_view_only

Valore booleano facoltativo che consente di specificare se il gruppo consente le ricerche

Valore restituito

Valore booleano che indica se l'operazione è riuscita o meno.

update_user

Aggiorna le proprietà di un utente. Specificare i valori solo per gli argomenti che si desidera aggiornare.

update_user(self, username, access=None, preferred_view=None, description=None, tags=None, thumbnail=None, fullname=None, email=None, culture=None, region=None)

Argomenti

ChiaveValore

nome utente

Stringa obbligatoria che indica il nome dell'aggiornamento utente

access

Stringa facoltativa; valori: private, org, public

preferred_view

Stringa opzionale, valori: Web, GIS, null

descrizione

Stringa facoltativa che indica la descrizione dell'utente

tags

Stringa facoltativa che indica tag separati da virgole per la ricerca

thumbnail

Stringa facoltativa che indica il percorso o l'URL di un file. Può essere PNG, GIF o JPEG. La dimensione massima è pari a 1 MB.

fullName

Stringa facoltativa che indica il nome dell'utente (solo per utenti incorporati)

e-mail

Stringa facoltativa che indica l'indirizzo e-mail (solo per utenti incorporati)

culture

Stringa facoltativa che indica il codice lingua a due lettere, ad esempio "it"

regionale

Stringa facoltativa che indica il codice paese a due lettere, ad esempio "IT"

Valore restituito

Valore booleano che indica se l'operazione è riuscita o meno.

update_user_role

Aggiorna il ruolo di un utente.

update_user_role(self, username, role)

Argomenti

ChiaveValore

nome utente

Stringa obbligatoria che indica il nome dell'utente di cui cambiare il ruolo

role

Stringa obbligatoria, utente, editore, amministratore o <ID_ruolo_personalizzato> (dove <ID_ruolo_personalizzato> è l'ID del ruolo personalizzato, ad esempio 1eo7LSAhbNiG1q9t, disponibile nei ruoli nel percorso di condivisione della directory di Portal for ArcGIS. Il formato dell'URL è https://webadaptorhost.domain.com/<webadaptorname>/sharing/portals/0123456789ABCDEF/roles).

Legacy:

In Portal for ArcGIS 10.3 e versioni precedenti, i valori consentiti per i ruoli non personalizzati sono org_user, org_publisher e org_admin. Nella versione 10.3.1, questi valori sono stati sostituiti dai valori indicati sopra. È possibile continuare a utilizzare i valori legacy nella versione 10.3.1, ma tali valori potrebbero non essere accettati nelle versioni future.

Valore restituito

Valore booleano che indica se l'operazione è riuscita o meno.


In questo argomento
  1. Classe: Portal
  2. Metodi di PortalPy