Код проєкту

Редакція Flowtly3 хвОновлено

Референс проєкту — це короткий ключ, який ви надаєте проєкту, щоб системи поза Flowtly могли його назвати. Усередині Flowtly проєкт визначається за назвою; системи, з якими ви працюєте поруч — бухгалтерія клієнта, інструмент звітності, електронна таблиця, узгоджена схема найменування тек — потребують чогось, що людина може набрати і що не змінюється. Саме для цього й потрібен референс.

Він необов'язковий. Більшість проєктів ніколи його не мають, і проєкт без референсу працює в усьому так само, як проєкт із референсом.

Який вигляд має референс

Ви вводите його самі, і Flowtly не нав'язує формату, тож його вигляд визначає та система, що по той бік. Він може містити до 64 символів. Команди, які користуються референсами, зазвичай узгоджують один вигляд і його дотримуються, наприклад LAT_LAC або LAT_NET_PR5.

Діють два правила, і саме вони роблять референс надійним ідентифікатором:

  • Референс унікальний у межах вашої організації. Під час порівняння регістр не враховується, тому PROJ-1 і proj-1 вважаються тим самим референсом, і мати його може лише один проєкт.
  • Референс залишається за тим проєктом, якому його надали. Видалення проєкту не звільняє його референс, тож ключ ніколи не почне згодом означати інший проєкт. Якщо ви введете вже зайнятий референс, Flowtly позначить поле Референс — а проєкт, який його утримує, може бути видаленим і вже не з'являтися у ваших списках.

Перейменування проєкту ніколи не змінює його референсу. Це зроблено навмисно: назва призначена для людей, які її читають, референс — для систем, що на нього спираються, і перейменування не повинно мовчки перенаправити інтеграцію.

Як надати референс

Під час створення проєкту поле Референс розташоване у формі додавання. Flowtly пропонує значення, доки ви вводите назву проєкту — малими літерами, з діакритичними знаками, зведеними до простих відповідників, і з кожною послідовністю пробілів чи розділових знаків, заміненою на підкреслення. Це лише пропозиція: перезапишіть її, і вона перестане слідувати за назвою, або очистьте поле, якщо цьому проєкту референс не потрібен.

Щоб додати або змінити референс наявного проєкту, відкрийте проєкт, перейдіть на вкладку Огляд і натисніть Редагувати в розділі Основна інформація. До зміни застосовується те саме правило унікальності, що й до нового проєкту, тож Flowtly повідомить, якщо введений референс належить іншому проєкту.

Фази проєкту мають власні референси, кожен незалежний від референсу батьківського проєкту. Нічого не виводиться з батьківського проєкту, тож фаза може мати той ключ, якого очікує її власна зовнішня система.

Де показано референс

  • На вкладці Огляд проєкту, у розділі Основна інформація, поряд із назвою проєкту. Проєкти без референсу показують тут тире.
  • У списку проєктів, як невеликий рядок моноширинним шрифтом безпосередньо під назвою проєкту — моноширинним, бо референс читають символ за символом і перенабирають в іншому місці, де 0 і O мають бути різними. Список показує цей рядок, коли принаймні один проєкт вашої організації має референс, і не показує нічого, коли його немає в жодного. Тут немає чого вмикати.
  • На вузькому екрані, де список проєктів перетворюється на картку для кожного проєкту, референс розташований під назвою проєкту на картці.

Примітка: поле пошуку над списком проєктів і засоби вибору проєкту, де ви вводите текст, щоб обрати проєкт, шукають як за референсом проєкту, так і за його назвою. Список не сортується за референсом.

Приклади використання

  • Узгодження Flowtly з бухгалтерією клієнта: надайте проєкту референс, який уже використовує облік клієнта, щоб експортовані години та рахунки збігалися без звіряння назв проєктів очима.
  • Збереження стабільної інтеграції попри перейменування: проєкт можна будь-коли перейменувати задля ясності, бо зовнішня система спирається на референс, а не на назву.
  • Звітність за фазами: надайте кожній фазі замовлення власний референс, щоб звіт, побудований поза Flowtly, міг їх розрізнити.
  • Передавання списку проєктів: вставте референси у стовпець, якого очікує зовнішній інструмент, замість того щоб змушувати його працювати з назвами, які в кожній системі звучать інакше.

Карта зв’язків

Код проєкту