Exemplos: Ficheiros de alterações de aprovisionamento de utilizadores

Assim que for possível utilizar o servidor de integração e estiver familiarizado com os requisitos de especificação de atributos e nomenclatura de ficheiros, pode criar ficheiros de alterações de aprovisionamento de utilizadores para transferir informações do sistema de gestão de dados local.

Reveja o tópico Criar ficheiros de alterações de aprovisionamento de utilizadores antes de continuar.

O cabeçalho do ficheiro especifica os nomes dos campos de operações tal como são definidos na primeira coluna da Tabela 3 em Criar ficheiros de alterações de aprovisionamento de utilizadores (não sensível a maiúsculas e minúsculas). As restantes linhas definem os valores dos campos correspondentes. Cada linha tem de terminar com uma mudança de linha ou carácter de mudança de linha adequado. Em plataformas Windows, utilize \r\n (0x0D 0x0A) e em plataformas UNIX ou Linux, utilize \n (0xA). Embora o servidor de integração possa processar ficheiros com formato de fim de linha, utilize o formato de transferência TEXT para assegurar que os fins de linha adequados são enviados e recebidos a partir do servidor de FTP intermediário.

Deve respeitar e aplicar as regras que se seguem ao codificar operações num ficheiro de alterações de aprovisionamento:

Nota: Os ficheiros de alterações de aprovisionamento de utilizadores do servidor de integração utilizam um formato CSV (valores separados por vírgulas); consulte a RFC 4180 para obter mais informações. Estão disponíveis detalhes sobre este formato na Web, em sítios como o Wikipédia.

Adicione os dados de campo relevantes pela ordem correcta de campos CSV, tal como se segue; consulte a Tabela 3 em Criar ficheiros de alterações de aprovisionamento de utilizadores.

emailAddress,action,subscriptionId,subscriptionId2,givenName,familyName,
language,timeZone,password,altEmailAddress,notesTemplate,notesDN,
assignTo,department,jobTitle,country,telephone,mobile,fax,address,
suppressInvitation,federationType,

Utilize um conjunto de caracteres UTF-8.
Adicione um valor vazio para um campo opcional e não opcional utilizando vírgulas consecutivas.
Codifique uma cadeia de comprimento zero para um campo como “”.
Delimite os valores de campo com aspas duplas, caso o valor contenha vírgulas ou caracteres de aspas ou caso contenha espaços no início ou fim do valor. Outros valores de campo podem opcionalmente ser delimitados por aspas duplas (""):
- Os valores de campos podem ser delimitados por aspas duplas ("") independentemente dos caracteres no campo.
- As aspas duplas ("") têm de ser utilizadas para valores de campo que incluem uma vírgula.
- As aspas duplas ("") têm de ser utilizadas para valores de campo que têm um ou mais espaços no início ou no fim do valor.
- Codifique um carácter de aspa dupla ("") utilizando um par de aspas duplas (""), por exemplo, ...,"John ""that guy"" Doe", ...
Uma operação de actualização que contenha um valor de campo vazio (por exemplo ,,) mantém o conjunto de campo no respectivo valor existente.
Uma actualização que especifica uma cadeia de comprimento zero substitui um valor de campo existente por uma cadeia de comprimento de zero.
Os nomes de operações não são sensíveis a maiúsculas e minúsculas.
Pode omitir vírgulas de preenchimento no final de uma declaração. Por exemplo, as duas declarações que se seguem produzem o mesmo resultado:
```
sd@mailinator.com,Add,85180,,Sam,Daryn,en_US,America/New_York

sd@mailinator.com,Add,85180,,Sam,Daryn,en_US,America/New_York,,,,,,,,,,,,
```
Pode omitir nomes de campos e vírgulas, no final de uma declaração, caso estes não sejam necessários para a operação. Por exemplo, caso não sejam necessários quaisquer campos a seguir a TimeZone, os valores para os campos que se seguem são suficientes:
```
emailAddress,Action,SubscriptionId,SubscriptionId2,GivenName,FamilyName,Language,TimeZone
```

A imagem que se segue consiste num exemplo de um novo ficheiro de alterações de aprovisionamento de utilizadores:

Comma-separated file with provisioning data

Seguem-se alguns exemplos que ilustram bem os valores de campo de exemplo para vários objectos de operação:

Adicionar um subscritor com uma subscrição de colaboração.

sd@mailinator.com,Add,85180,,Sam,Daryn,en_US,America/New_York

rsf@mailinator.com,Add,,,Randi,Factor,en_US,America/New_York

zachjones@us.ibm.com,Add,85181,,Zach,Jones,en_US,America/New_York

Actualizar informações pessoais para um subscritor.

sd@mailinator.com,Update,,,,,zh_CN,Asia/Shanghai

rsf@mailinator.com,Update,,,,Jones

zachjones@us.ibm.com,Update,,,Zach

Suspender um subscritor.
```
sd@mailinator.com,Suspend
```
Retomar a actividade de um subscritor.
```
sd@mailinator.com,Resume
```
Atribuir uma subscrição do IBM SmartCloud Notes a um subscritor existente que já tenha um lugar de colaboração.
```
zachjones@us.ibm.com,AssignSeat,86796,,,,,,,zachjones@us.ibm.com
```
Alterar um lugar de subscrição existente, propriedade de um subscritor, de uma subscrição para outra, por exemplo, de Meetings15 para Meetings20.
```
sd@mailinator.com,ChangeSeat,85179
```
Revogar um lugar de colaboração existente atribuído ao subscritor.
```
sd@mailinator.com,RevokeSeat,COLLAB
```
Revogar um lugar de colaboração de um subscritor e atribuir novamente o conteúdo do lugar a um subscritor diferente (por exemplo, de sd@mailinator.com para lsuarez@mailinator.com).
```
sd@mailinator.com,RevokeSeat,COLLAB,,,,,,,,,,lsuarez@mailinator.com
```
Remover um subscritor.
```
sd@mailinator.com,Remove
```
Remover um subscritor e atribuir novamente o respectivo conteúdo de colaboração a outro subscritor.
```
sd@mailinator.com,Remove,,,,,,,,,,,lsuarez@mailinator.com
```
Adicionar um subscritor com apenas uma subscrição do SmartCloud Notes e definir uma palavra-passe que o utilizador terá de alterar na primeira utilização.
Nota: Defina sempre uma palavra-passe de utilização única ao adicionar um subscritor. Não envie um convite para um endereço de correio electrónico alternativo para definir a palavra-passe.
```
sdaryn@us.abx.com,Add,86796,,Sam,Daryn,en_US,America/New_York,secret,,
StdR85Mail,Sam Daryn/abx/IBM
```
Adicionar um subscritor com subscrições do Meetings e do SmartCloud Notes e definir uma palavra-passe que o utilizador tem de alterar ao utilizar o serviço pela primeira vez.
Nota: Defina sempre uma palavra-passe de utilização única ao adicionar um subscritor do SmartCloud Notes. Não envie um convite para um endereço de correio electrónico alternativo para definir a palavra-passe.
```
sdaryn@us.abx.com,Add,85180,86796,Sam,Daryn,en_US,America/New_York,secret,,
StdR85Mail,Sam Daryn/abx/IBM
```

Mudar o nome de um subscritor.

lucillesuarez@mailinator.com,Rename,,,,,,,,lusuarez@mailinator.com

Suprimir (anular) um convite.

lusuarez@mailinator.com,Add,85180,,Lu,Suarez,en_US,America/Boston,,,,,,,,,,,,,SUPPRESS_ALL

vivhanley@mailinator.com,Add,,,Viv,Hanley,en_US,America/Boston,,,,,,,,,,,,,SUPPRESS_ALL
 
vivhanley@mailinator.com,AssignSeat,85180,,,,,,,,,,,,,,,,,,SUPPRESS_ALL

Reenviar um convite.

lucsuarez@mailinator.com,ResendInvitation

vivhanley@mailinator.com,ResendInvitation

Especificar um tipo de federação.

jashaj@mailinator.com,Add,85180,,Jas,Haj,en_US,America/Boston,,,,,,,,,,,,,,MODIFIED_FEDERATED

vivhanley@mailinator.com,Update,,,,,,,,,,,,,,,,,,,,FEDERATED

Utilizando o campo notesTemplate, é possível especificar um modelo de correio do Notes utilizando um formato "name,version,locale,extension_forms_file" (as aspas duplas são necessárias), tal como é apresentado no exemplo que se segue, para especificar opções a utilizar para o modelo mencionado:
```
emailAddress,action,subscriptionId,subscriptionId2,givenName,familyName,language,timeZone,
password,altEmailAddress,notesTemplate 
Csmith@JRIBMTEST.LLC1test.net,add,143422,,Cheryl,Smith,en_US,,passw0rd,,"StdR85Mail,8.5.3,en_US"
```
Nota: Existem várias variações disponíveis ao utilizar o formato "name,version,locale,extension_forms_file".
Se não for especificada uma locale, será utilizado o modelo que corresponde ao idioma especificado nas preferências de idioma da sua conta. Tal equivale também ao idioma especificado no campo language do ficheiro CSV, caso esteja a adicionar o utilizador.
```
emailAddress,action,subscriptionId,subscriptionId2,givenName,familyName,language,timeZone,
password,altEmailAddress,notesTemplate
Csmith@JRIBMTEST.LLC1test.net,add,143422,,Cheryl,Smith,en_US,,passw0rd,,"StdR85Mail,8.5.2"
```
Se o ficheiro CSV especificar um valor de language diferente do valor especificado no campo notesTemplate (formato "name,version,locale"), a definição locale especificada no campo notesTemplate substitui o valor do campo language do ficheiro CSV. Por exemplo, o utilizador que se segue tem espanhol (es_ES) especificado no campo language, mas tem inglês especificado para a definição locale no campo notesTemplate, pelo que é utilizado o modelo inglês (en_US):
```
emailAddress,action,subscriptionId,subscriptionId2,givenName,familyName,language,
timeZone,password,altEmailAddress,notesTemplate,notesDN,assignTo,department,region,
regionAdministrated,jobTitle,country,telephone,mobile,fax,address 
Csmith@JRIBMTEST.LLC1test.net,add,143422,,Cheryl,Smith,es_ES,,passw0rd,,"StdR85Mail,8.5.3,en_US"
```
Se for especificada uma version, por exemplo, StdR85Mail,8.5.3,en_US tal como no exemplo anterior, será utilizada a versão especificada. Se a definição version for nula ou não for especificada, será utilizada a versão mais recente do modelo mencionado.
```
emailAddress,action,subscriptionId,subscriptionId2,givenName,familyName,language,
timeZone,password,altEmailAddress,notesTemplate
Csmith@JRIBMTEST.LLC1test.net,add,143422,,Cheryl,Smith,en_US,,passw0rd,,"StdR85Mail,,en_US"
```
Se a definição locale for nula ou não for especificada e a definição do campo language do ficheiro CSV não for especificada, será utilizado o idioma na conta.
```
emailAddress,action,subscriptionId,subscriptionId2,givenName,familyName,language,timeZone,
password,altEmailAddress,notesTemplate
Csmith@JRIBMTEST.LLC1test.net,update,,,,,,,,,"StdR85Mail,8.5.2"
```
Este exemplo ilustra a aplicação de um ficheiro de formulários de extensão a um novo utilizador da Web do SmartCloud Notes, utilizando a configuração regional e versão predefinidas para o modelo mencionado StdR9Mail, em que o nome do ficheiro de formulário de extensões corresponde a forms9_x.nsf.
```
emailAddress,action,subscriptionId,subscriptionId2,givenName,familyName,language,timeZone,
password,altEmailAddress,notesTemplate
Csmith@JRIBMTEST.LLC1test.net,add,,,,,,,,,"StdR9Mail,,,forms9_x.nsf"
```
Nota: Se estiver a eliminar a especificação do ficheiro de formulários de extensão, por exemplo numa operação de actualização, a omissão do nome do ficheiro de formulários de extensão não é suficiente para o remover; em alternativa, irá especificar um valor de <delete> no seguinte formato:
```
 emailAddress,action,subscriptionId,subscriptionId2,givenName,familyName,language,timeZone,
password,altEmailAddress,notesTemplate
Csmith@JRIBMTEST.LLC1test.net,add,,,,,,,,, ",,,<delete>"
```
Nota: Para obter informações relacionadas e de suporte sobre a especificação de um modelo de correio, consulte a descrição notesTemplate em Criar ficheiros de alterações de aprovisionamento de utilizadores.

Adicionar um utilizador híbrido do SmartCloud Notes que se encontra no directório do Domino.

emailAddress,action,subscriptionId,subscriptionId2,givenName,familyName,language,timeZone,password
jHybrid12@HybridSVTCoA.com,Add,57163,,Jayne,Hybrid12,,,passw0rd

Atribuir um lugar do SmartCloud Notes a um utilizador de colaboração existente.

emailAddress,action,subscriptionId,subscriptionId2,givenName,familyName,language,
timeZone,password,altEmailAddress
jhybrid06@hybridsvtcoa.com,Assignseat,57163,,Jayne,Hybrid06,,,,jhybrid06@HybridSVTCoA.com

Adicionar um utilizador híbrido do SmartCloud Notes e atribuir um modelo de correio para esse utilizador.

emailAddress,action,subscriptionId,subscriptionId2,givenName,familyName,language,timeZone,password,
altEmailAddress,notesTemplate
jHybrid11@HybridSVTCoA.com,Add,57163,,Jayne,Hybrid11,,,passw0rd,,callc10727mail

Atribuir um lugar do SmartCloud Notes e especificar um nome de modelo de correio, para um utilizador de colaboração existente.

emailAddress,action,subscriptionId,subscriptionId2,givenName,familyName,language,timeZone,password,
altEmailAddress,notesTemplate
jhybrid06@hybridsvtcoa.com,Assignseat,57163,,Jayne,Hybrid06,,,,jhybrid06@HybridSVTCoA.com,callc10727mail

Actualizar um ou mais utilizadores existentes para utilizarem um modelo de correio diferente.

Permitir que um utilizador existente utilize um modelo de correio diferente do que está a utilizar actualmente.

emailAddress,action,subscriptionId,subscriptionId2,givenName,familyName,language,timeZone,
password,altEmailAddress,notesTemplate,notesDN,Department,jobTitle,Country,telephone,mobile,fax,address
jHybridNew28@HybridSVTCoA.com,Update,,,Jayne,Hybridnew28,,,,,CALLC10727Mail

Permitir que todos os utilizadores existentes utilizem um modelo de correio diferente do que estão a utilizar actualmente.

emailAddress,action,subscriptionId,subscriptionId2,givenName,familyName,language,timeZone,
password,altEmailAddress,notesTemplate,notesDN,Department,jobTitle,Country,telephone,mobile,fax,address
maddiemorrie@ktpvmw2k8.swg.usma.abx.com,Update,,,,,,,,,CALLC10727Mail

Ao adicionar ou actualizar o nome de um utilizador híbrido ou não híbrido ou modelo de correio do SmartCloud Notes utilizando um ficheiros de alterações de aprovisionamento, existem advertências para a utilização do campo notesDN. É aplicável quando givenName ou familyName do utilizador diferem nas respectivas definições do notesDN. Em seguida, são apresentados exemplos:

Operações Update
Se um administrador pretender actualizar o givenName ou familyName de um utilizador do SmartCloud Notes, não poderá efectuar qualquer especificação no campo notesDN. A especificação de um valor nessa operação de actualização falha com a mensagem ERROR: Notes Attribute validation failed.
- Por exemplo, a seguinte operação Update iria falhar:
```
emailAddress,action,subscriptionId,subscriptionId2,givenName,familyName,notesDN
jHybridNew10@HybridSVTCoA.com,Update,,,Jaynerevised,HybridNew10revised,Jayne
HybridNew10/HighAvail
```
- Por exemplo, a seguinte operação Update seria bem sucedida:
```
emailAddress,action,subscriptionId,subscriptionId2,givenName,familyName,notesDN
jHybridNew10@HybridSVTCoA.com,Update,,,Jaynerevised,HybridNew10revised,
```
Se um administrador pretender actualizar o modelo personalizado de um utilizador do SmartCloud Notes, não poderá efectuar qualquer especificação no campo notesDN.
- Por exemplo, a seguinte operação Update iria falhar:
```
emailAddress,action,subscriptionId,subscriptionId2,givenName,familyName,notesTemplate,notesDN
annajones@jroct19.llc1test.net,Update,,,Anna,Jones,E3_2319A,Anna Jones/JR OCT 19
```
- Por exemplo, a seguinte operação Update seria bem sucedida:
```
emailAddress,action,subscriptionId,subscriptionId2,givenName,familyName,notesTemplate,notesDN
annajones@jroct19.llc1test.net,Update,,,Anna,Jones,E3_2319A
```

Operações Add

Se um administrador adicionar um utilizador do SmartCloud Notes e especificar um givenName ou familyName diferente do nome exclusivo local do utilizador, terá de especificar o nome exclusivo correcto no campo notesDN.

Por exemplo, a seguinte operação Add iria falhar:

emailAddress,action,subscriptionId,subscriptionId2,givenName,familyName,password,notesDN
jHybridNew13@HybridSVTCoA.com,Add,57163,,Jaynerevised,HybridNew13revised,passw0rd

Por exemplo, a seguinte operação Add seria bem sucedida:

emailAddress,action,subscriptionId,subscriptionId2,givenName,familyName,password,notesDN
jHybridNew13@HybridSVTCoA.com,Add,57163,,Jaynerevised,HybridNew13revised,passw0rd,Jayne HybridNew13/HighAvail

Operações AssignSeat
O comportamento de uma subscrição do SmartCloud Notes é o seguinte:
- Se givenName e familyName forem nulos e notesDN estiver especificado, utilize notesDN como DN do utilizador.
- Se givenName e familyName forem especificados e notesDN for nulo, utilize givenName e familyName para criar o DN.
- Se givenName e familyName forem especificados e notesDN for especificado, utilize notesDN como DN do utilizador e ignore givenName e familyName.
- Se givenName e familyName forem nulos e notesDN for nulo, utilize givenName e familyName da conta como DN do utilizador.
- Para utilizadores híbridos do SmartCloud Notes, tem de existir uma entrada no directório do IBM® Domino com o DN resultante.
- Para utilizadores não híbridos do SmartCloud Notes, não pode existir uma entrada no directório do IBM Domino com o DN resultante.
- O registo de conta de utilizador não é actualizado com quaisquer valores especificados pelos campos givenName ou familyName.

São fornecidas várias entradas do ficheiro de aprovisionamento de exemplo para subscrições em conjunto ao:

Revogar uma subscrição em conjunto de um utilizador e reatribuir os respectivos dados de utilizador de colaboração a outro utilizador.
```
sarahdavidson@try.lotuslive.com,RevokeSeat,BUNDLE,,,,,,,,,,jd@mailinator.com
```
Atribuir uma subscrição em conjunto a um utilizador que não tem um lugar.
```
mad@mailinator.com,AssignSeat,91319,,,,,,,meghandavidson@try.lotuslive.com
```
Remover um subscritor e reatribuir o conteúdo de colaboração a outro utilizador (apenas dados de Ficheiros e Actividades podem ser reatribuídos; os dados de todas as outras aplicações da nuvem e dados de correio são eliminados).
```
mad@mailinator.com,Remove,,,,,,,,,,,jd@mailinator.com
```
Revogar uma subscrição em conjunto de um utilizador e reatribuir os dados de colaboração do mesmo a outro utilizador.
```
smd@try.lotuslive.com,RevokeSeat,BUNDLE,,,,,,,,,,jd@mailinator.com 
```
Atribuir um lugar do IBM Traveler Traveler a um subscritor para um utilizador existente do SmartCloud Notes.
```
emailAddress,action,subscriptionId
jnotes06@notesdomain.com,Assignseat,57163 
```
Adicionar e aprovisionar um utilizador com uma subscrição do SmartCloud Notes e uma subscrição adicional do Traveler.
```
smd@try.lotuslive.com,Add,91319,91320,Sarah,Davidson,en_US,America/New_York
```
Alterar a atribuição de lugar de um utilizador aprovisionado numa subscrição em conjunto do SmartCloud Notes e IBM Connections Cloud S2 e Traveler para SmartCloud Notes. A subscrição do Traveler é mantida.
```
cjd@mailinator.com,ChangeSeat,85180,DELETECOLLAB
```
Alterar a atribuição de lugar de um utilizador aprovisionado numa subscrição em conjunto do SmartCloud Notes Traveler apenas para o IBM Connections Cloud 2. A subscrição do Traveler é removida.
```
cjd@mailinator.com,ChangeSeat,85180,DELETEMAIL
```
Adicionar um utilizador federado e simultaneamente forçar a sua verificação automática e activação utilizando a opção Activation como uma operação Add. Esta operação tem algumas advertências, requerendo que os utilizadores sejam federados e que a verificação de correio electrónico seja desactivada. Para obter mais informações, consulte Criar ficheiros de alterações de aprovisionamento de utilizadores. As condições que se seguem estão presentes nestes exemplos:
```
emailAddress,action,subscriptionId,subscriptionId2,givenName,familyName,language,timeZone,password,altEmailAddress,Activation,FederationType,notesTemplate,notesDN,assignTo
```
- A operação Add que se segue irá adicionar e activar automaticamente o utilizador:
```
federated_user16@blog.ivthouse.com,Add,,,Federated,User16,,,,,FORCE_ACTIVATION,FEDERATED
```
- A operação Add que se segue irá falhar com um erro 1095 (ERROR_INVALID_ACTIVATION_VALUE), uma vez que o valor Activation não está definido como FORCE_ACTIVATION:
```
nonfederated_user12@blog.ivthouse.com,Add,,,Nonfederated,User12,,,,,INVALIDABC,,,,
```
- As operações Add que se seguem irão falhar com um erro 1096 (ERROR_CANNOT_FORCE_ACTIVATION), uma vez que a operação Activation está definida como FORCE_ACTIVATION mas FederationType não está definida como FEDERATED:
```
nonfederated_user11@blog.ivthouse.com,Add,,,Nonfederated,User11,,,,,FORCE_ACTIVATION,,,,
```
```
federated_user17@blog.ivthouse.com,Add,,,Federated,User17,,,,,FORCE_ACTIVATION,NON_FEDERATED,,,
```
```
modfederated_user18@blog.ivthouse.com,Add,,,Federated,User18,,,,,FORCE_ACTIVATION,MODIFIED_FEDERATED,,,
```
- A operação Add que se segue irá falhar com um erro 1056 (ERROR_FEDERATION_ONLY_PARTIAL), uma vez que a organização não está configurada para permitir o início de sessão de utilizador federado:
```
federated_user6@nonFedCompany.com,Add,,,Federated,User6,,,,,FORCE_ACTIVATION,FEDERATED,,,
```