> For the complete documentation index, see [llms.txt](https://docs.blazon.im/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.blazon.im/administrador/sincronismo/provisionamento/mapeamentos/usando-scripts-beanshell.md). # Usando scripts BeanShell Um script [BeanShell](https://beanshell.org/docs.html) é um programa na linguagem BeanShell, que pode ser usado para gerar o valor do mapeamento de um campo. O uso de um script BeanShell representa a forma mais flexível e abrangente de geração de valores dinamicamente nos mapeamentos de provisionamento. ### Estrutura de um script BeanShell O script pode ter várias linhas seguindo a sintaxe BeanShell, estilo Java, e o valor final da execução do script será o valor dado como retorno, através do comando '**return**'. {% hint style="info" %} #### Exemplo de script que busca o usuário com identificador 10L e retorna o seu nome de usuário `User usuario = userServiceAPI.get(10L);`\ `return usuario.username;` {% endhint %} Quando o script é executado um contexto com, [objetos disponíveis](#objetos-disponiveis-no-contexto-do-script) e [serviços disponiveis](#servicos-disponiveis-no-contexto-do-script), é injetado para serem usados. ### Objetos disponíveis no contexto do script Para cada um dos [eventos de provisionamento](/administrador/sincronismo/provisionamento.md#eventos-de-provisionamento) tem-se um **contexto**, com uma variável com o nome *entry*, com campos disponíveis para realizar o mapeamento. Pode-se ver nas tabelas abaixo a relação do **evento de provisionamento** com os objetos disponíveis na variável *entry* para serem usados nos scripts BeanShell, no mapeamento de atributos: ### Criação de nova conta

Variável	Objeto	Exemplo
entry	AccountWrapper	`return entry.account.accountIdentifier;`

### Atualização de conta

Variável	Objeto	Exemplo
entry	AccountWrapper	`return entry.account.accountIdentifier;`

### Inativação de conta

Variável	Objeto	Exemplo
entry	AccountWrapper	`return entry.account.accountIdentifier;`

### Ativação de conta

Variável	Objeto	Exemplo
entry	AccountWrapper	`return entry.account.accountIdentifier;`

### Revogação de conta

Variável	Objeto	Exemplo
entry	AccountWrapper	`return entry.account.accountIdentifier;`

### Troca de senha

Variável	Objeto	Exemplo
entry	AccountWrapper	`return entry.account.accountIdentifier;`

### Concessão de direito O evento de provisionamento de concessão de direito tem dois mapeamentos, um para o direito e outro para a conta. Isso ocorre porque um membro de direito é uma relação entre um direito e uma conta. #### Mapeamento do direito

Variável	Objeto	Exemplo
entry	EntitlementWrapper	`return entry.entitlement.name;`

#### Mapeamento da conta

Variável	Objeto	Exemplo
entry	AccountWrapper	`return entry.account.accountIdentifier;`

### Revogação de direito O evento de provisionamento de revogação de direito também tem dois mapeamentos, um para o direito e outro para a conta. Isso ocorre porque um membro de direito é uma relação entre um direito e uma conta. #### Mapeamento do direito

Variável	Objeto	Exemplo
entry	EntitlementWrapper	`return entry.entitlement.name;`

#### Mapeamento da conta

Variável	Objeto	Exemplo
entry	AccountWrapper	`return entry.account.accountIdentifier;`

### Criação de direito

Variável	Objeto	Exemplo
entry	EntitlementWrapper	`return entry.entitlement.name;`

### Atualização de direito

Variável	Objeto	Exemplo
entry	EntitlementWrapper	`return entry.entitlement.name;`

### Remoção de direito

Variável	Objeto	Exemplo
entry	EntitlementWrapper	`return entry.entitlement.name;`

### Serviços disponíveis no contexto do script Além da variável *entry*, no contexto de execução do script tem disponível a referência para vários serviços da API do Blazon, como destacados na tabela abaixo:

Variável	Serviço	Exemplo
userServiceAPI	Serviço de usuários	`User usuario = userServiceAPI.get(10L);` `return usuario.username;`
accountServiceAPI	Serviço de contas	`Account conta = accountServiceAPI.get(20L);` `return conta.accountIdentifier;`
entitlementServiceAPI	Serviço de direitos	`Entitlement dir = entitlementServiceAPI.get(30L);` `return dir.getName();`
roleServiceAPI	Serviço de papéis	`Role papel = roleServiceAPI.get(40L);` `return papel.name;`
resourceServiceAPI	Serviço de recursos	`List<User> owners = resourceServiceAPI.getOwners(25L);` `return owners.get(0).getLastName();`
organizationUnitServiceAPI	Serviços de organizações	`OrganizationUnit org = organizationUnitServiceAPI.get(12L);` `return org.getType();`
membershipEntitlementServiceAPI	Serviço de membros de direitos	`MembershipEntitlement me = membershipEntitlementServiceAPI.get(22L);` `return me.accountId;`
membershipRoleServiceAPI	Serviço de membros de papéis	`MembershipRole mr = membershipRoleServiceAPI.get(10L);` `return mr.roleId;`

### Exemplos de scripts de mapeamento A tabela abaixo ilustra alguns exemplos de scripts beanShell: | Script | Resultado | | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------- | | `return entry.user.firstName;` | Retorna o valor do campo *firstName* do usuário. | |

lastName = entry.user.lastName;
if(lastName == null) {
return "";
}
return lastName.toUpperCase();

| Retorna o valor do campo last*Name* do usuário, caso exista. Se não, retorna uma string vazia. | | `return entry.account.accountIdentifier;` | Retorna o valor do campo *accounIdentifier* da conta. | |

accId = entry.account.accountIdentifier;
return accId + "\_ID";

| Retorna o valor do campo *accounIdentifier* dda conta, concatenado com o termo "\_ID". | | `return entry.user.get('occupationCode');` | Retorna o valor do campo adicional *occupationCode* do usuário. | | `return entry.entitlement.name;` | Retorna o valor do campo *name* do direito. | | `return entry.user.department.name;` | Retorna o valor do campo *name* do departamento do usuário. | |

User user = userServiceAPI.get(10L);
return user.username;

| Retorna o valor do campo *username* do usuário de identificador 10L (long). | --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://docs.blazon.im/administrador/sincronismo/provisionamento/mapeamentos/usando-scripts-beanshell.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.