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
Parametro | Descrizione |
---|---|
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
Parametro | Descrizione |
---|---|
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
Parametro | Descrizione |
---|---|
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
Parametro | Descrizione |
---|---|
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
Parametro | Descrizione |
---|---|
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
Parametro | Descrizione |
---|---|
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
Parametro | Descrizione |
---|---|
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:
Parametro | Descrizione |
---|---|
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
Parametro | Descrizione |
---|---|
group_id | Stringa obbligatoria che indica il gruppo |
Valore restituito
Un dizionario con le chiavi owner, admins e users.
Parametro | Descrizione |
---|---|
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
Parametro | Descrizione |
---|---|
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
Parametro | Descrizione |
---|---|
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:
Chiave | Valore |
---|---|
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 |
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
Parametro | Descrizione |
---|---|
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.
Chiave | Valore |
---|---|
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 |
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
Parametro | Descrizione |
---|---|
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
Parametro | Descrizione |
---|---|
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
Parametro | Descrizione |
---|---|
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:
Chiave | Valore |
---|---|
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 |
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
Parametro | Descrizione |
---|---|
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
Parametro | Descrizione |
---|---|
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
Parametro | Descrizione |
---|---|
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
Parametro | Descrizione |
---|---|
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
Parametro | Descrizione |
---|---|
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:
Chiave | Valore |
---|---|
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
Parametro | Descrizione |
---|---|
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:
Chiave | Valore |
---|---|
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
Parametro | Descrizione |
---|---|
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 |
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
Parametro | Descrizione |
---|---|
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
Chiave | Valore |
---|---|
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) |
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
Chiave | Valore |
---|---|
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.