Developing in Quickr

Hi All,

         Now i will compose one script to deploy my solution. Let's do this:

1) Create a normal room in your place;

2) Adjust your theme to have an DIV or SPAN, containing all actions and page content Quickr Skin Component, this DIV must have the ID: lotusContent;

3) Make a copy to your new room in this place. The copy must be in Domino Data Directory and you have to put the 2 agents, 3 files and the view ( containing in this post attachment ), in this copy.

4) Take the path of your new copy ( this will be the Special Template Room ), and put the tag:

              <script type="text/javascript" src="<NEW DB PATH>/scriptApoio.js"></script>

      In your theme.

5) At the end of your theme, call an javascript function called: CriacaoSala();

6) After this, you have to adjust two files:

            - scriptApoio.js: Change the variable called: var pathBaseApoio = "/<NEW DB PATH>/"

            - createRoomForm.htm: Change the value of: <input type=hidden name=TemplateRoom value="<NEW DB PATH>">

After all this, when you will create a new room in this place, the default form to do this will be chenged. When you will do this, the template used to create a nw room will be the copy you was make.

Support Files

Thanks in Advance,

Pedro Fernandes

( Amigos Brasileiros, eu vou postar em português depois )

( Sorry about my english)

Hi All,

        When we customize quickr, sometimes we need to create views to access document data. But if you have to take this view in new created rooms, or you will change the PageLibrary.ntf ( the default template to ALL rooms created in Quickr ), or .... you will do what i do.

         The first version of this solution i was tried to do this with Lotus Script, but when i will open the database using the "LotusQuickr" path, i don't got the databases. This occurs probably because when we install Quickr on server, they change the Lotus Script API. I got the Databases using the Lotus Notes Client. But When we put this on server, this crashes.

         The first thing to know is: What occur in Quickr Databases when i create a room ? Let's see:

          1) The System create a new database in place folder

          2) The System create a Document Link in the TOC of the Parent Room

          3) The System create a Document in Search Database

          With this we have to do this by an agent. We have to make:

           1) Creating a Room with the default tool. This database will be our RoomTemplate.

           2) Put three agents in this database and one view ( i will post this later),

           3) Change the default theme of the place to use our code to create room.

          I already do this. And i will put here. But I do two of this agents using Java.

See you later,

Pedro Fernandes

Hi All,

        Has Anyone tried to access quickr Databases form script ? This weken i tried a lot. When I instantiated a Domino Database by an agent using "LotusQuickr" Path i got an Error: "This Database has not been open yet". To do this, and to create a room by code ( I will post how to do this later ), i have to create a directory link ( by using .dir files on windows ) and i have to use this link to create database and to access it.

        Tomorrow i will post how to crete rooms using one specially template.

Thanks in advanced,
Pedro Fernandes

__________________________
Caros Leitores,
            
           Algum de vocês já tentou acessar uma base quickr em Domino por script ? Esse final de semanta eu tentei muito. Quando eu instanciava uma base domino utilizando um agente, passando o caminho "LotusQuickr", eu tinha o erro: "This Database has not been open yet". Para fazer isso e para criar uma sala por código ( vou postar isso depois ), eu tive que criar um link para o diretório ( usando arquivos .dir no windows ) e eu tive que utilizar ese link para acessar a base.

         Amanhã eu vou postar como criar salas usando um modelo especial.

Desde já agradeço,
Pedro Fernandes

Caros Leitores,

             Agora que já sabemos como sobre as três bases criadas no momento em que criamos um place, vamos entender melhor como esse procedimento ocorre:

1) Existe uma pasta comum aos templates das bases do quickr, é o AreaTypes, nela encontraremos templates como:

• Admin.ntf ( Template da Base de Administração do QP),
• Contacts.ntf( referente a contacts1.nsf),
• CreateHaiku.ntf( template da base responsável pela criação de places),
• HaikuCommonForms.ntf,
• HaikuSetupNT.ntf,
• MeetingRoom.ntf
• PageLibrary.ntf( Template padrão para criação de todas as salas do QuickPlace).

2) Toda vez que criamos uma sala no place, o QP cria uma base dentro da pasta do place que deve ter o nome PageLibraryXXXXXXXXX.nsf, essa base é criada em cima do template padrão da ferramenta, o PageLibrary.ntf.

Att,
Pedro Fernandes

__________________________________________________________________________________________

1) A common folder to templates of the quickr's databases exists, is the "AreaTypes", in it will find templates as:

• Admin.ntf (Template of the Base of Administration of the QP),
• Contacts.ntf (referring contacts1.nsf),
• CreateHaiku.ntf (template of the responsible base for the creation of places),
• HaikuCommonForms.ntf,
• HaikuSetupNT.ntf,
• MeetingRoom.ntf
• PageLibrary.ntf (Template standard for creation of all the rooms of the QuickPlace).

2) Everytime that we create a room in place, the QP inside creates a database in the folder of place, this base is created on of template standard of the tool, the PageLibrary.ntf.

Att, Pedro Fernandes

About Quickr Domino Architecture

 For that they do not know nothing on quickr domino, here overview goes one on the architecture of the solution, will promptly shape this through affirmations on the architecture of the tool. I give the right to be wrong and of somebody to fix some point that has not been in agreement:

1) When installing the quickrdomino, a DLL is incorporated the server making with that all the accesses to the /quickplace directory have an architecture of differentiated authentication.
 
2) This authentication allows that the security of places is attributed optionally to the contacts1.nsf database of place that we want to have access. However in case that he is an Domino user, that finds it in the Address Book, contact1.nsf will say that user is of the Address book of Notes, and not only an user of place.
 
3) When creating one place, first we will have 3 databases: Main.nsf, Contacts1.nsf, and Search.nsf. Where the Main.nsf will be the main room created by standard in place, the Contacts1.nsf will have the referring information to the users of places, and the Search.nsf will be the database of responsible research for making possible the search enters the different rooms of place.

It's All for today,
Pedro Fernandes

Sobre A Arquitetura do Quickr Domino
 

 Para aqueles que não conhecem nada sobre quickr domino, aqui vai um overview sobre a arquitetura da solução, modelarei isso pontualmente através de afirmações sobre a arquitetura da ferramenta. Eu me dou o direito de estar errado e de alguém consertar algum ponto que não tenha ficado de acordo:

1) Ao instalarmos o quickrdomino, uma DLL é incorporada ao servidor fazendo com que todos os acessos ao diretório /quickplace tenha uma arquitetura de autenticação diferenciada.

2) Essa autenticação permite que a segurança dos places sejam atribuídas opcionalmente a base contacts1.nsf do place que queremos acessar. No entanto caso seja um usuário Domino, que encontremos ele no Address Book, o contact1.nsf dirá que aquele usuário é do Address book do Notes, e não apenas um usuário do place.
 
3) Ao criarmos um place, primeiramente teremos 3 bases: Main.nsf, Contacts1.nsf, e Search.nsf. Onde o Main.nsf será a sala principal criada por padrão no place, o Contacts1.nsf terá as informações referentes aos usuários dos places, e o Search.nsf será a base de pesquisa responsável por viabilizar a busca entre as diferentes bases do place.
 
Pelo momento é só,
Pedro Fernandes

( Sorry about the language, i will translate as soon is possible )

Caros Visitantes,

           Para os que não conhecem, hoje a IBM disponibiliza dois tipos de Quickr: Domino e Portal. Apesar da semelhança entre os produtos, onde podemos até dizer que grande parte dos serviços encontrados no nosso já conhecido quickr domino está refletido no mais novo quickr portal, as semelhanças param aí.

           A customização de um quickr domino, exige do desenvolvedor um conhecimento de lotus script, javascript além dos elementos do quickr. Teremos o tema do quickr que pedirá conhecimentos de HTML e dos elementos SKIN COMPONENT do quickr, e os formulários a serem criados em HTML e controlados por documentos Notes.

            Passando para o Quickr Portal a coisa muda. Para começar não temos mais o Domino, mas sim um Portal provendo os serviços de colaboração do Quickr. Dessa forma para customizarmos a ferramenta precisaremos conhecer sobre páginas e portlets, o alicerce básico de desenvolvimento em portal. Agora para alterarmos a apresentação da ferramenta, precisaremos também conhecer como criamos um tema de portal. Para isso já precisaremos conhecer a estrutura do portal, como segurança e forma de organização, JSP ( para customização do tema de portal ) além do HTML, JAVA e o padrão JSR 168 ( Para desenvolvimento de portlets ), e WWCM ( Websphere Content Manager ) ferramenta utilizada no gerenciamento da informação do Quickr.

            Com isso acredito não bastar uma análise do ambiente do cliente para sabermos qual o melhor ambiente para implantarmos essa rotina de colaboração. Não pode ser algo tão simples como: "O Cliente possui Domino, então quickr domino, o cliente possui time java então quickr java".
 

             O Custo de customização no quickrportal será sempre, ou na maioria das vezes, superior ao custo dessa customização em Domino.

Atenciosamente,

Pedro Fernandes

(Sorry about the language, i will translate as soon is possible.)

Caros amigos,

               Primeiramente gostaria de explicar qual o objetivo desse blog. Aqui postaremos as principais dúvidas de quickr, como suas soluções. Trabalho muito com essa tecnologia e colocarei aqui os assuntos que julgar interessante sobre quickr.

               Todos os artigos serão postos inicialmente em português, e após um tempo eu mesmo traduzirei. Faço isso para que eu não perca o dinamismo das postagens por conta de não querer ficar escrevendo em inglês e tal.

               Colocarei aqui nesse blog dicas e padrões de desenvolvimento em Quickr, espero assim atrair pessoas interessadas no assunto, e conseguir me relacionar com outros desenvolvedores de modo a construir um conhecimento diferenciado nessa tecnologia. Acho que o saber é uma chama que ilumina, e quanto mais você espalha o conhecimento, mas você verá as coisas claras a sua volta. Realmente essa minha última fala foi deveras poética.

                Grato por sua atenção e visita,

Pedro Fernandes