Tech Articles


Quick start for contributing to Open Source PFC


Given that not everyone is fluent in using Git and or Github (where the Open Source PFC is hosted now), I put together a quick introduction in how to get started.  The video below walks through the steps, which in summary are:

  • Create a GitHub account if you don't already have one.  https://github.com/join
  • Navigate to the Open Source PFC and "Fork" a copy of the code into your account.  The 2019 version of the PFC can be found at: https://github.com/OpenSourcePFCLibraries/2019
  • Chose Code -> Clone and copy the HTTPS URL for your fork.
  • Open the PowerBuilder 2019 IDE and with no workspace open select File -> Connect to Workspace.
    • Source Control System:  Choose Git
    • Repository URL: Paste in the URL you copied above
    • Workspace File: Give it any name you choose
    • User ID:  Your Github user id (normally your email address)
    • Password:  Your Github password
    • Checkout Directory:  Select or create a new empty subdirectory on your local machine for the code to be copied to
  • Wait until the source code is downloaded and refreshed (12 to 15 minutes)

Now you're ready to start making changes.  The process for doing that is:

  • Make the change in your workspace
  • Commit it to your local repository (using the PowerBuilder IDE)
  • Push it to your fork in Github (using the PowerBuilder IDE)
  • Create a Pull Request in your fork of the code in Github

The Pull Request sends the suggested change back to the main Open Source PFC project.  It is then reviewed and if approved is then is merged into the main project.

 

 

 

Comments (5)
Wednesday, Jan 27 2021

Great stuff Bruce!
(just in case anyone gets into the same trouble as I did)
I'm an absolute noob on GitHub and forgot to first do the "Fork", I stupidly enough tried to connect in the new powerbuilder workspace to your repo.
After that, I also realized I cannot connect in powerbuilder using my password and created a token in my own github account, which I then used as the "password" in the powerbuilder workspace when connecting to git.
Thank you!
MiguelL

0

Thursday, Oct 07 2021

Hello Bruce!

I done everything as you did in video, but I have problem with connection to workspace from PB (PB 2019 R2 2328).
I always get notice (Cannot connect to the repository. Please make sure you have specified the correct repository URL, user ID and password)
For sure I use correct credentials.
What could be the problem?
Tomaz

0
Thursday, Oct 07 2021

Since I wrote that article Github has moved to the user of personal access tokens rather than using the password for the Github account.

https://github.blog/2020-07-30-token-authentication-requirements-for-api-and-git-operations/

Just generate a personal access token for your repository and use that instead of the password.

0

Thursday, Sep 07 2023

Hi,

Recently we migrated our application into Powerserver 2021 version. While migrating we faced some below Unsupported Powerserver features in PFC libraries

sqlreturndata
previewinsert
previewdelete
previewupdate
when i searched help docs

https://docs.appeon.com/ps2021/bk06ch02s01s05.html

https://docs.appeon.com/ps2021/bk06ch02s01s06.html

not able to find the workaround for the above PFC feature



Kindly help me to identify the workaround for the above features.



Thanks

Vignesh

0
Thursday, Sep 07 2023

I just turned on discussions in the PFC project in Github. That would be the more appropriate location to discuss this.

https://github.com/orgs/OpenSourcePFCLibraries/discussions

0

Find Articles by Tag

External Functions Database Object Git Menu Window Windows 10 Icons Event Handling Design MessageBox Export JSON Database Table Data ODBC Installation RichTextEdit Control Web Service Proxy InfoMaker Validation Filter Outlook Charts Mobile RibbonBar Builder DataWindow OAuth 2.0 Open Source SVN XML API Variable Configuration PFC CrypterObject PowerBuilder (Appeon) Elevate Conference SqlModelMapper Stored Procedure Source Code Interface BLOB TFS PBVM SnapObjects C# TreeView PostgreSQL ODBC driver OAuth SnapDevelop .NET Assembly OrcaScript Automated Testing PowerBuilder JSONParser Database Connection Data Error Graph Database Table TLS/SSL Performance Resize UI Modernization Export Syntax Repository COM Authentication File RibbonBar UI 64-bit DataType Text .NET DataStore REST CoderObject DevOps TortoiseGit Event Handler PowerBuilder Compiler PowerServer Web HTTPClient ActiveX Authorization 32-bit JSONGenerator Debugging Database Painter PBDOM NativePDF JSON Application Source Control Web API UI Themes Deployment Bug Sort PowerServer Mobile OLE Encoding Database Database Profile License SQL Server Android Service SQL Transaction Azure Excel Messagging Import Model RESTClient Array Oracle Import JSON Visual Studio GhostScript iOS .NET Std Framework PostgreSQL Trial PDF DLL SDK DragDrop Icon Windows OS Debug DataWindow JSON WinAPI Event IDE WebBrowser Migration PBNI CI/CD Debugger PDFlib Platform Branch & Merge SqlExecutor PowerScript (PS) Jenkins Linux OS Script Database Table Schema Testing SOAP Expression Encryption Class