4. O Sistema de Workflow

Workflow é o processo usado para gerenciar objetos em um website. Um exemplo é a publicação de reportagens em uma empresa: um funcionário escreve uma reportagem e envia a seu editor para revisão antes de publicá-la no site. Este processo de revisão ´e chamado de workflow e é usado pelos gerenciadores de sites para assegurar que o conteúdo do site está correto. O plone tem um sistema de workflow muito poderoso e flexível que é construído através dos Object States (Estados dos Objetos) e User Roles (Funções do Usuário).

Estados dos Objetos

Um estado do objeto determina se ele está disponível para vários tipos de usuários definidos no Plone, e em que outros estados o objeto pode ser colocado. O workflow padrão do Plone inclui quatro estados: visible (visível), pending (pendente), published (publicado) e private (privado). Os gerenciadores do site podem criar estados padrões - estes são explicados com mais detalhes no Capítulo 5.

• Por padrão, objetos são criados no estado visible. Todos os usuários podem achar os objetos visíveis através da função de busca e podem acessá-los diretamente visitando a url do objeto. Objetos visíveis não são mostrados na árvore de navegação. Objetos visíveis dentro de pastas privadas continuam visíveis para todos os usuários e disponíveis através da função de busca. Objetos visíveis são editáveis por seus donos e administradores do site.
• Objetos pending foram submetidos a publicação por membros do site. Da visão de um usuário final, eles se comportam como objetos no estado visível (visible). A diferença entre os dois tipos é que os objetos pendentes são revisados ; os revisores do site publicam ou rejeitam os objetos pendentes. Objetos pendentes são editáveis apenas pelos administradores
• Itens published são visíveis a todos os visitantes do site. Eles aparecem em resultados de buscas e na árvore de navegação. Quando um Item Notícias é publicado ele se torna visível na aba News e também na caixa News (veja o Capítulo 5). Itens publicados são editáveis somente pelos administradores, mas podem ser retirados pelos donos para edição (o estado de retirar faz com que o objeto vá para o estado visible).
• Objetos no estado private são visíveis e editáveis somente por seus donos e outros com acesso de administrador na pasta na qual eles estejam. Eles não aparecerão nos resultados das buscas ou na árvore de navegação para outros usuários. Itens provados são editáveis pelos administradores.

Nota: Embora a maioria dos objetos tenha seus próprios estados, alguns herdam seus estados de seus objetos pais. Os fóruns são um exemplo deste comportamento. Fóruns dentro de pastas visíveis ou publicadas ficam disponíveis para todos os usuários através da função de busca. Fóruns dentro de pastas privadas estão somente disponíveis para usuários com acesso a esta pasta privada.

Funções do Usuário

O Plone usa funções para definir o que diferentes usuários podem ver e fazer. Desta forma, o Plone tem segurança em todos os aspectos de sua operação. As funções definidas em uma instalação padrão do Plone incluem anonymous (anônimo), member (membro), owner (proprietário - dono), reviewer (revisor) e manger (administrador).

• Quanlquer um que visite o site e não se loga nele, possui a função de anonymous. Em sites públicos, usuários anônimos podem ver conteúdo publicado, pendente e visível visitando a url ou pesquisando sobre o conteúdo, entretando somente conteúdo publicado está visível na árvore de navegação. Se você configurou seu site como privado, usuários anônimos não podem ver nada.
• Members são usuários que estão logados no site. Membros têm a habilidade de adicionar para criar conteúdo dentro de sua própria pasta, que é submetido aos revisores do site para publicação. Em sites públicos, os membros podem ver o mesmo conteúdo dos usuários anônimos. Em sites privados, os membros têm acesso ao conteúdo publicado, pendente e visível. Os membros também podem configurar suas preferências.
• Como um reviewer, você pode publicar ou rejeitar conteúdo enviados pelos membros. Quando um revisor se loga, se há conteúdo para ser revisado uma mensagem de "pendência" aparecerá em sua barra pessoal. Uma lista de revisões também aparece na coluna da direita da página. Os revisores têm acesso ao mesmo conteúdo dos membros.
• Os membros têm a função de owner sobre todo o conteúdo que eles criam. Isto faz com que eles editem o conteúdo, enviem ou retire-no, ou façam dele privado. Atribuir a função de proprietário a outros usuários não é recomendado.
• Os managers do site podem ver o conteúdo em todos os estados (visible, pending, published e private). Além de todas as capacidades do membro e revisor, os administradores podem adicionar, editar, deletar e mover conteúdo. Os administradores podem também adicionar, editar e deletar usuários e atribuir a eles funções.

O Plone herda o modelo de função do Zope. Por favor para maiories informações Zope Book.

Transições - Alterando os Estados dos Objetos

Os proprietários e administradores podem alterar o estado dos objetos que eles controla. Os estados que estão disponíveis são controlados pelas transições pré definidas. Por exemplo, os membros do site podem submeter objetos visíveis a revisão ou fazê-los privados e revisores podem publicar items ou rejeitá-los. Os administradores do sote podem também customizar esta parte do sistema de workflow. (Veja o Capítulo 5)

Para alterar o estado de um objeto para conteúdo visualizado, marque a caixa próxima ao nome do objeto a ser mudado e então clique no botão change status no final da página. Vá até o botão Publishing Process da página e escolha o estado desejado, então clique submit (enviar).

O estado também pode ser alterado no item view. Simplesmente clique na aba state, vá até o final da página, escolha o estado desejado e clique em submit.

Funções Locais

Os administradires do site podem dar privilégios adicionais em certas seções do site a usuários específicos. Isto pode ser feito atribuindo funções locais às pastas. Os administradores e proprietários têm permissão para atribuir funções locais.

Para atribuir funções locais, mude para a visualização do conteúdo (contents view) da pasta e clique Local Roles na aba content. Busque pelo nome do usuário a quem você deseja atribuir uma função, e marque a caixa acima do seu nome. Escolha da lista a função para atribuir e clique "assign local roles to selected users" (atribuir funções locais aos usuários selecionados).

Esta mesma interface pode ser usada para deletar funções locais.

Publicando um objeto

Os proprietários do objeto podem alterar e editar ojetos no estado visible. Depois que um proprietário termina de editar um objeto, ele pode ser publicado clicando na aba State. Isto abre um formulário de publicação:

Este formulário oferece as seguintes opções:

• Status: Informa o estado atual do objeto.
• Effective Date e Expiration Date: A data efetiva é o primeiro dia que um objeto se torna disponível e a data de expiração é o último dia. Buscas e navegação somente mostram objetos dentro desta escala de datas. Deixando estes itens em branco faz com que o objeto fique disponível indefinidamente.
• Comments: Aqui você pode digitar qualquer comentário ou razão para a alteração do estado. Estes comentários serão preservados no change log do objeto.
• Change State: Os estados para os quais um usuário pode mover um objeto. Os membros podem submeter objetos ou fazê-los privados. Uma vez submetido, os objetos ficam disponíveis para usuários com privilégios de revisão, que podem então publicá-los ou rejeitá-los.

Revisando os objetos

Se você tem privilégios de revisor, quando você se loga no site, será apresentado uma indicação se qualquer objeto está esperando revisão. Isto é mostrado na personal bar como mostra a imagem:

Selelcione este link para obter uma lista de objetos prontos para revisão, então selecione cada objeto para revisá-lo. Clique na aba de publicação e será mostrado um formulário como o acima. Neste momento você tem basicamente três escolhas - tanto para aprovar um objeto e publicá-lo (a opção publish) como rejeitá-lo (a opção reject). Se você rejeitar o objeto você pode provavelmente querer colocar um comentário ao usuário explicando porque você rejeitou-o.

Editando um objeto depois que ele foi publicado

Os administradores pode editar objetos que estão em qualquer estado. Os membros não podem editar um objeto depois que ele foi publicado; eles devem primeiro fazê-los voltar ao estado visível para retirá-los. Para fazer isto, clique na aba de publicação para o objeto e clique retract. Então você pode editar o objeto quanto você quiser e re-submetê-lo. Isto garante que o processo de revisão é mantido para os objetos que foram editados.

Próximo: Configurando o Plone Anterior: Usando o Plone