Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision
Previous revision
org [2025/07/07 21:30] adminorg [2025/08/03 16:45] (current) admin
Line 1: Line 1:
-======Organization or Division code======+======Organization code======
  
-This is a code which is always needed for //Git Winch// to work.+This code is always needed for //Git Winch// to work fully. It represents the organization ...(or it can even be a division in an organization.) We sometimes call this the //"orgname"// in these docs
  
-If set correctly, this code can be seen at the bottom left corner of the //Git Winch Client Application// represents the organization ...or the division in the organization.+If this Org code was not found as the application started. Usually, that happens when running a fresh installation of //Git Winch// for the first timeIn such a situation, some of the activities cannot be done as //Git Winch// will not know which organization to work with. So you would get prompted to set this value as soon as possible.
  
-We call this the //"orgname"//. +This //Org Code// is set using the text stored in a special file named //orgname.txt// in the same folder where the application was installed.  The contents of this file is used as this code.  This file is NOT bundled in the installation zip file. If you are working for someone else, you can request this file from the owner/manager of the office you work for, and copy it into the application folder of //Git Winch//.
  
-This //"orgname"// is set using the text stored in a special file named //orgname.txt// in the same folder where the application was installed.  The contents of this file is used as this code.  This file is NOT bundled in the installation zip file. Get it from the owner/manager of the company.+If set correctly, this code will be seen at the bottom left corner of the //Git Winch Client Application.// 
  
-**Owner can create the orgname.txt **\\ +In short, //Git Winch// cannot work without the //orgname//
-If you are the owner yourselfthen you can create this //orgname// by attempting to create your first repository in the //Manage// page of //Git Winch.// Click the [+] button there and //Git Winch// will check if the //orgname// is given or not. If not, it will then ask you to create it first. Before creating, enter the owners PAT token in the PAT input-box. It will ask you for the Orgname you want to use. The server will check if that was booked by someone else, in which case you will be asked to do this process again.+
  
-**Manager can also create the orgname.txt **\\ +So when you start the applicationif it is found that the //orgname// is NOT available, it will ask you to select or set one. If you plan to create an //orgname// for yourself, then give 'own' for the //full name// of the owner of that orgname.
-If you have been assigned as a manager of a repository by the ownerthen you should NOT enter the owner's PAT token (as you would not have that) Leave it empty and it will ask you for the encrypted version of the PAT token that the owner had given you. And proceed as above.+
  
-//Once you; either as the owner or the managerhad created the Orgname, you will be able to see the orgname.txt in the application folder. Copy that and give it to your office workers so that they can save in their respective application folders.//+//**NOTE:** The Org Code can only have alphanumeric characters and optionally, you can also use underscores. A minimum of 4 characters is needed. If the file contains more than 8 characters, the rest would be ignored.//
  
-//NOTE: //Orgname// can only have alphanumeric characters and optionally, you can also use underscores. A minimum of 4 characters is neededIf the file contains more than 8 characters, the rest would be ignored.//+**What //Org code// to use?**\\ 
 +As an owner, you can choose whatever name you want, as long as it is as per the specs given here... and someone else must not have claimed it. Once you get the Org code you must communicate this name to other team members. Best way to do that is simply share the file "orgname.txt" to them. And ask them to save that file in the application's folder.
  
-**What //orgname// to use?**\\ +**Changing this Org Code**\\ 
-As an owner, you can choose whatever name you wantas long as it is as per the specs given hereAnd you must communicate this name to other team members. Best way to do that is simply share the file "orgname.txt" to them. And ask them to save that file in the application's folder.+Usually, you would use only ONE Org code and use that always. But in some offices, the same person may be working in different divisionsIn that case, that person may want to change this Org code, to switch to the correct organization or a division.
  
-**Changing this Org or Division Code**\\ +You can change the organization code when working inside the application: Double click on the //Org Code// displayed at the bottom left cornerand it will prompt you for the new //Org Code//.
-Usually, you would use only ONE //orgname// code and use that always. But in some offices, the same person may be working in two different divisions. In that casethat person may want to change this //orgname//, to switch to the correct organization/division.+
  
-You can change the organization code when working inside the applicationDouble click on the //orgname// at the bottm left cornerand it will prompt you for the new //orgname//.+{{ :setorgname.jpg?400 |}} 
 + 
 +//NOTE: If you want to create your own Org codemake sure you have sufficient credits balance. Some amount of credits would get deducted. Also, you would need to mark the checkbox. Do NOT give your own name if you do NOT plan to create a new code. If you are working for someone else, give the org code that they provided, along with the full name of the owner of that Org.// 
  
 **IMPORTANT**\\ **IMPORTANT**\\
-If you work on a repository which is from a different//orgname// then it will give a warning and/or work incorrectly.+If you work on a repository which is from a different Org or division, then it will give a warning and/or work incorrectly.
  
 **Why?**\\ **Why?**\\
 +The //Org Code// is needed as a kind of 'category' or 'set' into which all your repositories would be connected to. You are free to create as many //Org codes// that you may need to organize your office work. It would be the //owner// of an office who would usually set an //Org Code//. You can choose any name you want as along as the restrictions mentioned here are respected. Others who work along with you on the same repositories would also have to use the same //Org Code//.
 +
 //Git Winch// is used by many organizations. Some of them may have multiple divisions in them. This is used to differentiate between them. Also, it reduces the chance of "clashes" for the repository names that you use; as our coordination server may be handling the metadata for thousands of repositories.  //Git Winch// is used by many organizations. Some of them may have multiple divisions in them. This is used to differentiate between them. Also, it reduces the chance of "clashes" for the repository names that you use; as our coordination server may be handling the metadata for thousands of repositories. 
    
org.1751916612.txt.gz · Last modified: by admin